Skip to main content
Version: v6

Gravity PDF API – add_pdf_font()

Description

This function allows you to add custom fonts to Gravity PDF using code. It accepts an associative array, and only the font_name and regular array keys are required.

The font_name can only contain alphanumeric characters, or a space. Only .ttf font files are supported, and all fonts should be referenced with the full server path.

Version

This method was introduced in Gravity PDF 4.1.

Parameters

font | array | required

  • An associative array with information about the font. Only the font_name and regular array keys are required.

    font_name | string | required

    • The name of the custom font

      regular | string | required

    • The full path to the regular variant of the font.

      italics | string | optional

    • The full path to the italic variant of the font.

      bold | string | optional

    • The full path to the bold variant of the font.

      bolditalics | string | option

    • The full path to the bold-italic variant of the font.

Return

boolean | WP_Error

  • Returns true if the font is installed correctly, or WP_Error on failure

Usage

This sample shows the simplest usage of add_pdf_font():

/* This should be used in a one-time filter or action */
$font_data = [
'font_name' => 'Brandon Grotesque',
'regular' => '/path/to/ttf/font/file/BrandonGrotesqueLight.ttf',
];

$results = GPDFAPI::add_pdf_font( $font_data );

if ( ! is_wp_error( $results ) ) {
/* Successfully installed */
}

If you want to install the italic, bold and bold italic variants pass all the associative key options:

/* This should be used in a one-time filter or action */
$font_data = [
'font_name' => 'Brandon Grotesque',
'regular' => '/path/to/ttf/font/file/BrandonGrotesqueLight.ttf',
'italics' => '/path/to/ttf/font/file/BrandonGrotesqueLight-i.ttf',
'bold' => '/path/to/ttf/font/file/BrandonGrotesque-b.ttf',
'bolditalics' => '/path/to/ttf/font/file/BrandonGrotesqueLight-bi.ttf',
];

$results = GPDFAPI::add_pdf_font( $font_data );

if ( ! is_wp_error( $results ) ) {
/* Successfully installed */
}

Source Code

This method is located in api.php.