Who is this article for?
Administrators customising certificates.
Professional Version Access is required.
Tailor certificates to meet your specific needs by customising their appearance and content. Utilise simple pre-defined tags such as <course>, <grade>, and <completion_date> to personalise the information displayed on certificates.
- Customising a Certificate
- Text Elements
- Logo
- Orientation Element
- Label Elements
- Line Elements
- Further Reading
1. Customising a Certificate
- When creating or editing a certificate template, you can use the XML content field to customize the design of the certificate.
- The default XML content can be seen when adding or editing a certificate template.
- The header elements are described below:
| Header Elements |
Description |
| Creator |
Used to populate the creator for the PDF document header. |
| Author |
Used to populate the author for the PDF document header. |
| Subject |
Used to populate the subject for the PDF document header. |
| Keywords |
Used to populate the list of keywords for the PDF document header. |
Note: The information for these elements are not displayed on the certificate.
- Below are the properties of header elements:
| Header Properties |
Description |
| Name |
The value that will appear in the PDF document header. |
Example: <creator name=”Ideagen”></creator>
2. Text Elements
- The text elements are described below:
| Text Elements |
Description |
| Organisation |
Used to display the organisation name. |
| Student |
Used to display the full name of the learner. |
| Course |
Used to display the name of the course. |
| Grade |
Used to display the overall grade of the course. |
| Date |
Used to display the date the certificate was issued. |
| Serial |
Used to display the serial number of the certificate. |
| Description |
Used to display the description of the course. |
| CEUs |
Used to display the continuous education units (CEUs) of the course. |
| Trainer |
Used to display the name of trainer(s) of the course. |
| Expire |
Used to display the expiration date of the certificate. |
| Print Date |
Used to display the date the certificate was printed. |
- Below are the properties of text elements:
| Text Properties |
Description |
| Text |
Text to appear on the certificate (applies only to the organisation element). |
| Font |
Name of the font to use. |
| Weight |
The font weight. Values: bold, italic, bold|italic. For normal font, leave the value empty. |
| Size |
Size of the font to use. |
| Colour |
Hex value for text colour (e.g.: #000000 is black). |
| X |
X Coordinate |
| Y |
Y Coordinate |
| Align |
The text alignment. Possible values: center, left, right. |
Example: <organization text=”Ideagen” font=”Freeserif” weight=”bold” size=”60” color=”#000000” x=”120” y=”12” align=”left”></organization>
3. Logo
The logo is used to display a logo image on the certificate. By default, the logo you have applied in your system settings is used. If you have not changed the logo, the default Ideagen Academy logo is used instead. Below are the properties of a logo:
| Properties |
Description |
| File |
Name of the image file to use (leave this set to “default”). |
| X |
X Coordinate. |
| Y |
Y Coordinate. |
Example: <logo file=”default” x=”14” y=”14”></logo>
4. Orientation Element
The orientation element is used to define the page orientation. The properties of orientation elements are below:
| Orientation Element |
Description |
| Name |
The page orientation. Possible values: landscape, portrait. |
Example: <orientation name=”landscape”></orientation>
5. Label Elements
A label is a line of text that will appear on the certificate. A label element must appear within the labels section, and you can add any number of labels. Here are the properties for label elements:
| Label Elements |
Description |
| Text |
Text to appear on the certificate. |
| Font |
Name of the font to use. |
| Weight |
The font weight. Possible values: bold, italic, bold|italic. For normal font, leave the value empty. |
| Size |
Size of the font to use. |
| Colour |
Hex value for text colour (e.g.: #000000 is black). |
| X |
X Coordinate. |
| Y |
Y Coordinate. |
Example: <label text=”This certificate is awarded to:” font=”Freeserif” weight=” ” size=”18” color=”#000000” x=”95” y=”120”></label>
6. Line Elements
A line is a graphical line that is drawn on the certificate. A line element must appear within the lines section, and you can add any number of lines. The properties for line elements are below:
| Line Elements |
Description |
| X1 |
Starting X coordinate. |
| X2 |
Ending X coordinate. |
| Y1 |
Starting Y coordinate. |
| Y2 |
Ending Y coordinate. |
| Colour |
Hex value for text colour (e.g.: #000000 is black). |
| Thickness |
The line thickness (e.g.: Thin: .25, Thick: 2). |
| Note |
A note for user reference (does not appear on the certificate). |
Example: <line x1=”5” y1="204" x2="292" y2="204" color="#000000" thickness="2" note="Bottom Thick"></line>
7. Further Reading
