; $Id$

CERTIFY

A module for issuing PDF certificates upon completion of quizzes from the Quiz
module.

Developed by the Norwegian Center for integrated care and Telemedicine.

REQUIREMENTS

- The tool pdftk installed somewhere on the server
  (available from http://www.pdfhacks.com/pdftk/ ).
- Drupal 6.x
- Quiz module >= v4.0

HOW TO INSTALL

1. Upload and extract to your modules directory as a normal Drupal module.
2. Install pdftk on the server.
3. Create a directory for storage of certificates and templates. This should be
   a directory outside of your webroot, both readable and writable by the web
   server.
4. Enable the module and configure it using the paths to your pdftk executable
   and the certificate directory.

HOW TO USE

1. Create content of type certificate.
    - Mark which quizzes are required to pass in order to receive the
      certificate.
    - (OPTIONAL) Upload a certificate template in PDF form format. Fields
      available:
      * 'site_name' (Site name)
      * 'full_name' (Full name of user)
      * 'email' (User email address)
      * 'certificate_name' (Certificate title)
      * 'score' (Score)
      * 'issued_date' (Date)
2. Let users take tests.
3. Users will have certificates available for download upon completion.
4. ???
5. Profit!

KNOW BUGS

The module becomes confused if the quizzes are edited (generating new revisions
of the same quiz). This is due to shortcomings of the Quiz module. The author of
the Quiz module has promised to add better support for versioning of Quiz
content type before release of Quiz v4.0.
