Register and unregister page templates through configuration.

This component should be installed using Composer, with the command composer require d2/core-page-templates.

Within your config file (typically found at config/defaults.php) define an array of page templates you would like to register or unregister.

Please Note: Page templates only need to be registered if they are more than two levels deep, e.g ./resources/templates/example.php. This is because WordPress automatically scans themes for templates that are one or two levels deep.

There are already class constants defined for the Genesis archive and blog templates.

For example:

use D2\Core\PageTemplate;

$d2_page_templates = [
    PageTemplate::REGISTER   => [
        '/resources/templates/example.php' => 'Example Template',
    ],
    PageTemplate::UNREGISTER => [
        PageTemplate::ARCHIVE,
        PageTemplate::BLOG,
    ],
];

return [
    PageTemplate::class => $d2_page_templates,
];

Components should be loaded in your theme functions.php file, using the Theme::setup static method. Code should run on the after_setup_theme hook (or genesis_setup if you use Genesis Framework).

add_action( 'after_setup_theme', function() {
    $config = include_once __DIR__ . '/config/defaults.php';
    D2\Core\Theme::setup( $config );
} );