You're looking at an older version of Totara Learn.

Please see Totara 13 help for the latest version.

All pages





Search

The Certificate module creates PDF certificates for learners of the course and is completely customisable. You can add borders, watermarks, seals, and even show grade information.

Add a certificate

  1. Click Turn editing on.
  2. Select Certificate from the Add an activity... dropdown menu.
  3. Enter a certificate name, this then appears on the course page for learners.
  4. Customise the available settings as required, see Certificate Settings to learn more.
  5. Click Save and display (or Save and return to course).

Edit a certificate

  1. Click Turn editing on.
  2. Click Edit next to the certificate activity.
  3. Make the required changes.
  4. Click Save and display (or Save and return to course).

Certificate Settings 

SettingDescriptionNotes

Email trainers

If enabled, then trainers are notified when a learner receives a certificate.

-

Email Others

Enter the email addresses here of others who need to be notified when a learner receives a certificate. Multiple addresses should be entered in a comma separated list.

-

Save Certificate

This option allows the system to store a copy of each learner's certificate in the course files moddata folder. A link to each learners saved certificate is displayed in the trainers View Issued Certificates report.

-

Delivery

Choose how the learner receives their certificate:

  • Open in Browser: Opens the certificate in a new browser window.
  • Force Download: Opens the browser file download window (note: Internet Explorer does not support the open option from the download window. The save option must be chosen first).
  • Email Certificate: Choosing this option sends the certificate to the student as an email attachment.

Once a learner receives the certificate they will see the date their certificate was issued and be able to review their certificate when they click on the Certificate link on the course page.

-

Before activity can be accessed

If the conditions above are not met, then choose whether the certificate activity is visible showing the conditions above, or if the certificate activity is hidden completely.

-

Print Date

This is the date that will be printed, if a print date is selected. If the course end date is selected, you must enable the date range and set the course end date in your course settings. If the course end date is not set, the date received will be printed. You can also choose to print the date an activity is graded. If a certificate is issued before that activity is graded, the date received will be printed.

Once a date is printed on a certificate, it cannot be changed unless you have customised your type/certificate.php file.

Date Format

Choose a date format to print the date on the certificate.

-

Printing a Code Number

A unique 10-digit code of random letters and numbers can be printed on the certificate. This number can then be verified by comparing it to the code number displayed in the trainer View Issued Certificates report.

-

Print Grade

You can choose any available course grade items from the gradebook to print the user's grade received for that item on the certificate. The grade items are listed in the order in which they appear in the gradebook. There are three available formats if you choose to print a grade on the certificate.

Once a user has received their certificate, their grade on the certificate will not change.

Grade Format

There are three available formats if you choose to print a grade on the certificate:

  • Percentage Grade: Prints the grade as a percentage.
  • Points Grade: Prints the point value of the grade.
  • Letter Grade: Prints the percentage grade as a letter. The values for the letter grades can be customised in type/certificate.php.
-

Print Outcome

You can choose any course outcome to print the name of the outcome and the user's received outcome on the certificate.

Example: Assignment Outcome: Proficient.

Print Credit Hours

Enter here the number of credit hours to be printed on the certificate.


-

Print trainer

For printing the trainer name on the certificate, set the role of the trainer at the module level. Do this if, for example, you have more than one trainer for the course or you have more than one certificate in the course and you want to print different trainer names on each certificate. Click to edit the certificate, then click on the 'Locally assigned roles' tab. Then assign the role of trainer (editing trainer) to the certificate (they do not have to be a trainer in the course, you can assign that role to anyone). Those names will be printed on the certificate for trainer.

-

Custom Text

If you want the certificate to print different names for the trainer than those who are assigned the role of trainer, do not select Print trainer or any signature image except for the line image. Enter the trainer names in this text box as you would like them to appear. By default, this text is placed in the lower left of the certificate. You can change this placement in your certificate/type/"type name"/certificate.php file. In that file, find the line of code similar to this at the very bottom of the page:

cert_printtext(150, 450, '', '', '', '', '');

The two numbers reflect the X placement (over from the left) and Y placement (down from the top) values for the text. You can change these if you like.

You can also use the text box to enter html. For example, you can add a link or an image.

The following html tags are available:

  • <br> and <p>
  • <b>, <i> and <u>
  • <img> (src and width (or height) are mandatory)
  • <a> (href is mandatory)
  • <font>: possible attributes are:
  • color: hex color code
  • face: arial, times, courier, helvetica, symbol

Example html:

Mr. James Salesman, Manager<br><br>Sales Department<br><br><font color="#0000CC"><b>Your Company<font face="Symbol">&Ograve;</font></b></font><img src="http://yourtotara.com/mod/certificate/pix/seals/Logo.png" width="100"><p><a href="http://www.site.com/ target="_blank">Click here</a></p>

Certificate Type

This is where you determine the layout of the certificate. The certificate type folder includes four default certificates:

  • A4 Embedded: Prints on A4 size paper with embedded fonts - this makes pdf files large.
  • A4 Non-Embedded: Prints on A4 size paper using Helvetica and Times fonts - these need to be installed on the users computer to work.
  • Letter Embedded: Prints on letter size paper with embedded fonts - this makes pdf files large.
  • Portrait Letter: Prints on letter size paper using Helvetica and Times fonts - these need to be installed on the users computer to work.

New types can be added to the certificate/type folder. The names of the folders, and any new language strings for the new type, must be added to the certificate/lang/en_utf8/certificate.php file.

Most languages print a certificate with no problems, even if they contain accents or umlauts. However, if your language uses characters, you need to choose a unicode type. These types use a different pdf library that embeds the entire font in the pdf. This will make the pdf files rather large; thus it is not recommended to use this type unless you must.

Orientation

Choose either landscape or portrait.

-

Border Image

The Border Image option allows you to choose a border image from the certificate/pix/borders folder. Select the border image that you want around the certificate edges or select no border. The folder includes two different border images, each in 4 different colours.

Keep in mind that adding images to the certificate will increase the size of the pdf file. You can add your own border images to the certificate/pix/borders folder and they will also appear here, in the dropdown. The border images must be in the JPEG (.jpg) or PNG 8 (.png) format.

Border Lines

Since images can substantially increase the size of the pdf file, you may choose to print a border of lines instead of using a border image (be sure the Border Image option is set to No). The Border Lines option will print a nice border of three lines of varying widths in the chosen colour.


-

Watermark Image

A watermark file can be placed in the background of the certificate. A watermark is a faded graphic. A watermark could be a logo, seal, crest, wording, or whatever you want to use as a graphic background.

Keep in mind that adding images to the certificate increases the size of the pdf file. You can add your own images to the certificate/pix/watermarks folder and they appear here in the dropdown. The images must be in the JPEG (.jpg) or PNG 8 (.png) format.

Signature Image

This option allows you to print a signature image from the certificate/pix/signatures folder. You can print a graphic representation of a signature, or print a line for a written signature. A sample signature image and a line image are included. By default, this image is placed in the lower left of the certificate. You can change this placement in your certificate/type/"type name"/certificate.php file. In that file, find the line of code similar to this one toward the bottom:

print_signature($certificate->printsignature, $orientation, 110, 450, '', '');

The two numbers reflect the X placement (over from the left) and Y placement (down from the top) values for the image. You can change these if you would like.

Seal or Logo Image

This option allows you to select a seal or logo to print on the certificate from the certificate/pix/seals folder. Four seal images and an example logo image are included. By default, this image is placed in the lower right corner of the certificate. You can change this placement in your certificate/type/"type name"/certificate.php file. In that file, find the line of code similar to this one toward the bottom:

print_seal($certificate->printseal, $orientation, 590, 425, '', '');

The two numbers reflect the X placement (over from the left) and Y placement (down from the top) values for the image. You can change these if you would like.

Common module settings

See Common Module Settings to learn more.

-

Activity completion

See Activity Completion to learn more.

-

Restrict access

See Restrict Access to learn more.

-


Viewing Issued Certificates

It is possible for the trainer, manager, or administrator to view a report of all issued certificates.

  1. Select the course.
  2. Click the 'Certificate activity'.
  3. Click 'View issued certificates'.

This shows the following fields:

Awarded To: The name of the person.

Date Received: The date the certificate was issued.

Grade: The grade the learner received.

Code: If unique code option has been used.

Customising certificates & scenarios

Create a customised Certificate format

It is possible to create your own custom certificate type. Your customised certificate appears on the list with the standard certificate types.

  1. Choose the certificate/type folder with the size/orientation you desire, copy and paste it in the certificate/type folder, and give the copied folder a new name. For example copy the /type/letter_landscape folder and rename it 'mycertificate'.
  2. Open the certificate/lang/en_utf8/certificate.php file and add the name of your new folder type. Following the above example, you would add: $string['typemycertificate'] = 'My New Certificate';

Now, when you add a certificate to a course, your new type should appear on the drop down list as "My New Certificate".

Changing printed text

There are different lang strings in the certificate/lang/en_utf8/certificate.php file for each certificate type, so be sure to change the correct one for the type you are using. For example, if you want to customise the text for the landscape type, you can change these lines in the above mentioned lang file:

Default:

$string['titlelandscape'] = 'CERTIFICATE OF ACHIEVEMENT';

$string['introlandscape'] = 'This is to certify that';

$string['statementlandscape'] = 'has successfully completed the course';


Customised:

$string['statementlandscape'] = 'has successfully passed the final exam';

Adding a New Line of Text

  • Open the certificate/lang/en_utf8/certificate.php file and add your new lang string giving it a unique name, e.g.:

$string['mynewtext'] = 'This is what I want to print on the certificate';

Open the file for your certificate type, e.g. certificate/type/mycertificate/certificate.php. At the bottom of the page below '// Add Text' is the code that prints--you guessed it--text on the certificate. Find the current line below which you would like your new text to be printed. For example, if you want your text to print below the course name, find the line:

cert_printtext(170, 330, 'C', 'Helvetica', '', 20, utf8_decode($classname));

Add a new line below that to print your new text using the name you gave your new lang string like this:

cert_printtext(170, 350, 'C', 'Helvetica', '', 20, utf8_decode(get_string('mynewtext', 'certificate')));

Make sure you add a string to the language file called mynewtext. The above line of code gets that string.
  • You can adjust the placement over from the left by increasing or decreasing the '170' number. You can adjust the placement down on the page by increasing or decreasing the '350' number. Changing 'C' to 'L' or 'R' will print on the left or right side. For different fonts, see the totara/lib/fpdf font folder for non-unicode types, and the totara/lib/tcpdf/fonts folder for unicode types, for available fonts.

    For unicode certificates, using more than one font is not recommended since the entire font gets embedded in the certificate which will increase the certificate's file size.

    After the font name, you can add 'B' for bold, 'I' for italic, or 'U' for underline. Changing the '10' number will change the font size.

cert_printtext(170, 350, 'C', 'Times', , 10, utf8_decode($USER->idnumber));

You can add a hard coded line of text. For example, a signature title block line:

cert_printtext(150, 490, 'L', 'Times', , 10, utf8_decode('Martin Dougiamas, Lead Developer'));

Add your string to the PDF image

You can add your own custom string to the PDF print section. We wanted to add 'These Continuing Credits are from Our University' below the title of the course. We used the landscape certificate type.

We added the string to the language file.

$string(ceusfromus) = 'These Continuing Credits are from Our University';

In the type folder's certificate.php file, in the PDF area near the end of the file, we put the following line:

cert_printtext(170, 380, 'C', 'Helvetica', '', 16, utf8_decode (get_string('ceusfromus', 'certificate')));


The Certificate module creates PDF certificates for learners of the course and is completely customisable. You can add borders, watermarks, seals, and even show grade information.

Adding a certificate for completion of a program

There isn't a way to do this directly but you can simulate this by creating a course with a certificate awarded on completion of the course or other criteria. Make this course the last courseset in the program. This means that the certificate course will only be available when the other courses in the program have been completed.

On this page



Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?

  • No labels