Simple certificate module
Simple certificate module | |
---|---|
Type | activity |
Set | N/A |
Downloads | https://moodle.org/plugins/view.php?plugin=mod_simplecertificate |
Issues | https://github.com/bozoh/moodle-mod_simplecertificate/issues |
Discussion | https://moodle.org/mod/forum/discuss.php?d=222296 |
Maintainer(s) | Carlos Alexandre Fonseca |
Description
This module is based on certificate module, maintained by Mark Nelson, but simpler to use, no need to change any code to add a new certificate format, and Moodle's administrator don't need to upload image files or change language variables. The certificate text are full customizable, using special text marks that will be replaced by variables (like student name, course name, grade, ...).
Installation
Using git repository
If you do not have git installed, please see the below link. Please note, it is not necessary to set up the SSH Keys. This is only needed if you are going to create a repository of your own on github.com.
Information on installing git - http://help.github.com/set-up-git-redirect/
Once you have git installed, simply visit the Moodle mod directory and clone git://github.com/bozoh/moodle-mod_simplecertificate.git, remember to rename the folder to certificate if you do not specify this in the clone command.
E.g. Linux command line would be as follow -
git clone git://github.com/bozoh/moodle-mod_simplecertificate.git simplecertificate
Once cloned, checkout the branch that is specific to your Moodle version. e.g., MOODLE_22 is for Moodle 2.2, MOODLE_23 is for 2.3, ...
Use git pull to update this branch periodically to ensure you have the latest version.
If you don't want install git you can visit https://github.com/bozoh/moodle-mod_simplecertificate, choose the branch that matches your Moodle version (e.g. MOODLE_22 is for Moodle 2.2, MOODLE_23 is for 2.3) and download the zip, uncompress this zip and extract the folder. The folder will have a name similar to bozoh-moodle-mod_simplecertificate-c9fbadb, you MUST rename this to simplecertificate. Place this folder in your mod folder in your Moodle directory.
Using the plugins
This plugin is design to be simple to create a certificate, without any PHP knowledge In this plugins you can create:
- One or Two pages certificate
- Verification code
- QRCode with verification URL
- Multi language support, using Multi Language content filterhttp://docs.moodle.org/26/en/Multi-language_content_filter
- Bulk operations (send certificate via email to the users, ...)
- and more ...
To create a custom certificate, you add a simple certificate activity, in the Certificate Text you will type you custom certificate text, and you will use some Text marks which will be replace to right values in the certificate creation process.
For example, Certificate of Achievement {COURSENAME}
to
{USERNAME}
The texts marks {COUSENAME} and {USERNAME} will be replaced to course full name and user full name, respectively .
Here a more complete example image:
A sample pdf file
File:Simple certificate example 01.pdf
How to report a bug
You can report in:
Text marks
In this version other user profile data can be added, like email, first name, country, and the custom profile data too.
Text Mark | Description | Since version |
---|---|---|
{USERNAME} | Full user name | 1.x.x |
{COURSENAME} | Full course name (or what is in Alternate course name option) | 1.x.x |
{GRADE} | Formatted Grade | 1.x.x |
{DATE} | Formatted Date | 1.x.x |
{OUTCOME} | Outcomes | 1.x.x |
{HOURS} | Defined hours in course | 1.x.x |
{TEACHERS} | Teachers List | 1.x.x |
{IDNUMBER} | User id number | 2.x.x |
{FIRSTNAME} | User first name | 2.x.x |
{LASTNAME} | User last name | 2.x.x |
{EMAIL} | User e-mail | 2.x.x |
{ICQ} | User ICQ | 2.x.x |
{SKYPE} | User Skype | 2.x.x |
{YAHOO} | User yahoo messenger | 2.x.x |
{AIM} | User AIM | 2.x.x |
{MSN} | User MSN | 2.x.x |
{PHONE1} | User 1° Phone Number | 2.x.x |
{PHONE2} | User 2° Phone Number | 2.x.x |
{INSTITUTION} | User institution | 2.x.x |
{DEPARTMENT} | User department | 2.x.x |
{ADDRESS} | User address | 2.x.x |
{CITY} | User city | 2.x.x |
{COUNTRY} | User country | 2.x.x |
{URL} | User Home-page | 2.x.x |
{PROFILE_xxxx} | User custom profile fields | 2.x.x |
{CERTIFICATECODE} | Unique certificate code text | 2.1.x |
{USERROLENAME} | User role name in course | 2.2.0 |
{TIMESTART} | User Enrollment start date in course | 2.2.0 |
{USERIMAGE} | User profile image | 2.2.0 |
{USERRESULTS} | User results (grade) in others course activities | 2.2.0 |
In order to use custom profiles fields you must use "PROFILE_" prefix, for example: you has created a custom profile with shortname of "birthday," so the text mark used on certificate must be {PROFILE_BIRTHDAY}
Languages with special character
Some languages have non Latin characters, like Russian or Japanese. In order to work these languages properly, you must use: style="font-family: freeserif;" or something as font style, for example:
<span style="font-family: freeserif;">простой сертификат</span>
<span style="font-family: hysmyeongjostdmedium;">かんたん証明書</span>
<span style="font-family: kozgopromedium;">かんたん証明書</span> (it is better for Japanese characters, but under lib/tcpdf/fonts/ you need kozgopromedium.php which is included in the latest version of TCPDF)
See also
- Discussion forum
- Basic Usage Video, thanks Matthew Nagy
- Mark Nelson certificate plugin