Utiliser vos propres templates de pages dans votre plugin WordPress

Vous souhaitez, dans le cadre de votre plugin, afficher un contenu sur une nouvelle page ? Cet article montre comment créer une page WordPress automatiquement depuis votre plugin et y associer une page de template créée pour l’occasion.

Première étape : créer la page dans WordPress

Cette étape n’est pas obligatoire, elle permet de créer une page WordPress pour que l’utilisateur n’aie pas à le faire manuellement. Selon les cas de figure cette étape n’est pas forcément nécessaire.

Pour créer la page , utilisez ce bout de code :

$my_post = array(
'post_title' => 'Nom de la page',
'post_content' => '',
'post_status' => 'publish',
'post_author' => 1,
'post_type' => 'page'
);

// Insert the post into the database
wp_insert_post( $my_post );

Il faut l’inclure dans un code qui vérifie si la page existe, sinon la page sera créée à chaque fois. Utilisez la fonction get_pages() pour savoir si la page existe déjà.

L’avantage de créer une page est que vous pouvez faire un lien vers elle dans vos menus WordPress.

Deuxième étape : utiliser le template pour cette page

On va maintenant ajouter le code pour remplacer le template choisi par le template hierarchy WordPress pour afficher celui que l’on a fait et mis dans notre plugin :

Mettez ce code au début de votre plugin (dans votre fonction __construct si vous êtes en POO) :

function override_template( $page_template )
{

if (is_page( 'nom-de-la-page' )) {
$page_template = dirname( __FILE__ ) . '/templates/mon-template.php';
}

}

Si vous êtes en POO, mettez public function au début. Dans cet exemple j’appelle une page mon-template.php située dans un dossier templates qui est lui même dans le dossier de mon plugin.

Et voilà, lorsque vous afficherez votre page, c’est le template du plugin qui sera chargé.