FM_EmailCertificatesToAdmin

Overview

FM_EmailCertificatesToAdmin is a FiLMS module that send emails (with an earned certificates attachment in PDF format) to admin. This is triggered when an user within a organization (depending which organization this module is installed under) has earned the certificate (i.e. earned certificate is created). Assuming that the learner has met the requirement(s) to earn a certificate, (s)he earn it when:

  • (s)he views the list of earned certificates (Top Menu -> Education ->Earned Certificates)
  • the earned certificate is generated overnight (daily cron)

Installation & Configuration

Installation

It is recommended to install this module non-globally.

Note that FM_EmailTemplates must be installed beforehand.

Configuration

There are 2 organization detail field for this module. Certificate email will not be sent if either of those detail fields is null or empty.

Organization Detail Field

Email Address to send certificates to

Template ID for Certificate Earned

Description

The E-Mail address to send any certificates earned by this organization's users.

The ID of the e-mail template to use for the e-mail sent out.

Usage

For the Email Template (FM_EmailTemplates), additional labels are provided:

Label

certificateName

CertificateLink

Description

Certificate Name

URL to certificate ([FiLMS URL]/includes/modules/FM_EmailCertificatesToAdmin/show_cert_pdf?intId=[EARNED CERTIFICATE ID]

Like FM_EmailCertificates, certificate design / layout can be changed. See this for more details.

For deploying, create a new folder called "FM_EmailCertificatesToAdmin" inside either of the global or specific organization id folder in orgresources directory. If that folder is placed inside a specific organization folder, the certificate design will be applied to that organization. If it is placed inside the global folder, the design will be applied to all organizations. The folder will contain a PHP file (how_cert_html.php) along with the assets (e.g. logo, background image) that are added to the certificate.

To make sure that the HTML certificate (page where CertificateLink is directed to) looks good, go to [ENTER FILMS URL]/includes/modules/FM_EmailCertificatesToAdmin/show_cert_html.php?intId=[ENTER EARNED CERTIFICATE ID].

To make sure the PDF-generated certificate looks good, go to [ENTER FILMS URL]/includes/modules/FM_EmailCertificatesToAdmin/show_cert_pdf.php?intId=[ENTER EARNED CERTIFICATE ID].

Limitation

  • Only limit to 1 email address per organization.
  • The design of the certificate is limited on the PDF generator's capabilities.