Add fonts for embedding

Revision as of 03:39, 12 July 2018 by Mark Nelson 2 (talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Additional fonts can be included in Moodle and used by the Certificate and Custom certificate module, embedding them in the PDF.

Before adding custom TCPDF fonts

The default location for fonts that are included with TCPDF is lib/tcpdf/fonts/. If PDF_CUSTOM_FONT_PATH exists, this directory will be used instead of lib/tcpdf/fonts/, the default location is $CFG->dataroot.'/fonts/'.

If you are adding custom fonts you need to copy all fonts from lib/tcpdf/fonts/ to your PDF_CUSTOM_FONT_PATH and then add the extra fonts. Alternatively you may download all TCPDF fonts from http://www.tcpdf.org/download.php and extract them to PDF_CUSTOM_FONT_PATH directory.

From /lib/tcpdf/fonts/readme_moodle.txt:

This directory contains just selected set of original tcpdf fonts in order to keep the standard Moodle distribution lightweight. You may want to manually download tcpdf package and extract its fonts/ directory into your $CFG->dataroot/fonts/. In such case, pdflib.php will use this directory. In the future, we plan to have fonts downloadable in a same way as languages are. (TODO MDL-18663).

Add a font from TTF file

Assuming you have a font licensed for converting and embedding...

Using an online converter

You can upload TTF (or OTF) fonts to http://fonts.snm-portal.com/, and download converted versions.

Fonts created this way seem to handle accented characters better than converting locally.

Converting locally

Fonts created this way may not handle accented characters correctly; this is probably dependant on the specific software versions. If you encounter this problem, you might want to try using an online converter (above).

1. Copy the .ttf file to /lib/tcpdf/fonts

2. Create a "convertfont.php" file in /lib/tcpdf/fonts (and ensure the web server has permissions to run it), containing:

include('../tcpdf.php');
$pdf = new TCPDF_FONTS('P', 'mm', 'A4', true, 'UTF-8', false);
$pdf->addTTFfont('./MyFont.ttf', 'TrueTypeUnicode');

3. View the file at http://hostname/lib/tcpdf/fonts/convertfont.php (it should just show a blank page).

4. Verify that new files have been created in /lib/tcpdf:

  • myfont.ctg.z
  • myfont.php
  • myfont.z

See below for using the font in a certificate.

Using a new font

This sections applies to the old mod_certificate plugin, in the mod_customcert plugin the fonts will automatically be listed in the select drop-down.

Once added, there are two ways to use the new font:

  1. Go to the Certificate module setting page and set it as the new Serif or Sans-serif font. This will apply to all standard certificates.
  2. Create a custom certificate type in /mod/certificate/type, and replace the $fontserif and $fontsans variables, as needed.
  • Replacing font for the whole file:
// $fontsans = get_config('certificate', 'fontsans'); // Comment out old code
 
$fontsans = 'myfont'; // Add new code.
  • Replacing font for just the student name:
//certificate_print_text($pdf, $x, $y + 36, 'C', $fontsans, '', 30, fullname($USER)); // Comment out old code
 
certificate_print_text($pdf, $x, $y + 36, 'C', 'myfont', '', 30, fullname($USER)); // Add new code.