gfpdf_multisite_template_location_uri

Jump To Section

• Description
• Parameters
• Usage
• Source Code

Description

By default, the PDF working directory is found in your http://example.com/wp-content/uploads/PDF_EXTENDED_TEMPLATES folder. For multisite installations we also create a subdirectory inside the PDF_EXTENDED_TEMPLATES folder using each multisite's ID. This filter allows you to change that location (but you'll normally want to use the gfpdf_template_location_uri filter instead). .

The multisite working directory MUST be accessible by your web browser and MUST be used in conjunction with the gfpdf_multisite_template_location filter. Both the gfpdf_multisite_template_location and gfpdf_multisite_template_location_uri filters should point to the same directory – one is the path and one is the URL.

Note: your web server needs write access to the folder you move the working directory to.

You can also use this filter by targeting the multisite ID directly: gfpdf_multisite_template_location_uri_$blog_id.

Parameters

$url | string : The URL of the multisite PDF working directory

$working_folder | string : The working directory folder name. By default this is PDF_EXTENDED_TEMPLATES.

$upload_path | string : The URL to your uploads directory (where the PDF working directory is stored by default).

$blog_id | integer : The current ID of the multisite being processed

Usage

The following snippet shows you how you can move the multisite PDF working directory for site #3 to your wp-content directory (instead of its original location in your uploads folder):

add_filter( 'gfpdf_template_location_uri', function( $url, $working_folder, $upload_url, $blog_id ) {
    if ( 3 == $blog_id ) {
        /* Make sure you include the forward slash! */
        return WP_CONTENT_URL . '/' . $working_folder . '/';
    }

    return $url;
}, 10, 4 );

/**
 * You must use the `gfpdf_multisite_template_location_uri` filter in conjunction with the `gfpdf_multisite_template_location` filter
 * Both filters should point to the same directory (one is the path and one is the URL)
 */
add_filter( 'gfpdf_multisite_template_location', function( $directory, $working_folder, $upload_path, $blog_id ) {
    if ( 3 == $blog_id ) {
        /* Make sure you include the forward slash! */
        return WP_CONTENT_DIR . '/' . $working_folder . '/';
    }

    return $directory;
}, 10, 4 );

Source Code

This filter is located in the Model_Install::setup_multisite_template_location() method of /src/model/Model_Install.php.