Créer un template Wordpress
Emmanuel Gautier / September 22, 2013
4 min read
Il peut arriver que le template par défaut de wordpress ne suffise pas et que vous soyez obligé d’en créer un de toute pièce. En effet, si vous souhaitez avoir une page sur votre site web qui se démarque des autres ou alors vous avez besoin d’un agencement de votre page plus particulier, vous allez devoir passer par la création d’un nouveau template. Pour ce faire rien de plus simple avec wordpress, nous allons le voir tout de suite.
Prérequis
Tout d’abord, intéressons-nous à la structure du template par défaut fourni par wordpress. Le template de base est situé dans le fichier ' page.php ' situé dans le dossier du thème que vous utilisez, en voici le code source (WordPress 4.0) :
<?php
/**
* The template for displaying all pages
*
* This is the template that displays all pages by default.
* Please note that this is the WordPress construct of pages and that
* other 'pages' on your WordPress site will use a different template.
*
* @package WordPress
* @subpackage Twenty_Fourteen
* @since Twenty Fourteen 1.0
*/
get_header(); ?>
<div id="main-content" class="main-content">
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
// Include the featured content template.
get_template_part( 'featured-content' );
}
?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php
// Start the Loop.
while ( have_posts() ) : the_post();
// Include the page content template.
get_template_part( 'content', 'page' );
// If comments are open or we have at least one comment, load up the comment template.
if ( comments_open() || get_comments_number() ) {
comments_template();
}
endwhile;
?>
</div><!-- #content -->
</div><!-- #primary -->
<?php get_sidebar( 'content' ); ?>
</div><!-- #main-content -->
<?php
get_sidebar();
get_footer();
Nous n’allons pas expliquer chaque fonction php contenu dans le template mais arretons-nous tout de même sur les plus importantes.
Les fonctions get_header(), get_sidebar() et get_footer() sont les fonctions vitales à la page car elles permettent de mettre en place toute la structure générale de la page. Prenons les fonctions les unes après les autres. get_header vous permet d’appeler toute la partie d’entête de la page, ce qui comprend tout ce qui se situe entre les balises <head>, la bannière du haut et le menu principal. La fonction get_sidebar vous permet de récupérer les widgets placés sur vos pages. La fonction get_footer, quant à elle, permet de récupérer le pied de page. Ces trois fonctions sont donc la base même de la structure de votre page, ne les oubliez surtout pas !
Maintenant que nous savons comment récupérer la structure de la page, il serait bon de savoir comme afficher son contenu. La fonction qui joue se rôle sur la page est la fonction get_template_part( 'content', 'page' ). Elle vous affichera le template content-page.php contenant le corps de l’article que vous aurez rentré dans l’espace d’administration.
Une autre fonction qui pourra vous intéresser est la fonction comments_template() qui affichera le formulaire de commentaire pour l’article si vous n’avez pas désactivé les commentaires dans les paramètres de wordpress.
Création de la base de notre template
Sachant maintenant comment est constitué un template, à nous de jouer. En premier lieu, il faut créer un fichier dans le dossier page-templates du thème que vous utilisez. Nommez ce fichier avec le nom que vous voulez, pour ma part je l'appellerai custom.php. Commencez votre fichier par le commentaire php ci-dessous en remplaçant ‘ Custom ‘ par le nom de template que vous voulez lui donner. Ce nom sera celui qui s’affichera plus tard dans le panneau d’administration quand vous choisirez le template pour votre page.
<?php
/**
*
* Template Name: Custom
*
*/
Et voici un exemple de template que vous pourriez créer :
<?php
/**
*
* Template Name: Custom
*
*/
get_header(); ?>
<div id="main-content" class="main-content">
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
// Include the featured content template.
get_template_part( 'featured-content' );
}
?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php while ( have_posts() ) : the_post(); ?>
<?php get_template_part( 'content', 'page' ); ?>
<?php echo get_sidebar('disqus'); ?>
<?php endwhile; ?>
</div>
</div>
</div>
<?php
get_sidebar();
get_footer();
Utilisation du template
Pour utiliser votre template, rendez-vous à l’onglet d’écriture de page, et regardez la zone de choix des templates. Et magique, le nom de votre template apparait dans la liste !
Consulting
Si vous recherchez des solutions à un problème ou avez besoin de conseils, je suis là pour vous aider ! N'hésitez pas à réserver un call avec moi pour une session de consulting personnalisée. Discutons de votre situation et trouvons ensemble la meilleure solution à implémenter.
Articles sur le même sujet
Mettre en place memcached sous Ubuntu
Memcached est un système de cache permettant de stocker des données directement en mémoire. Ce système de cache permet aux sites web et aux bases de données, entre autres, d'accroître leur vitesse. Le principe de ce gain de vitesse est d'échanger des temps d'accès disque assez lents par des temps d'accès mémoire beaucoup plus rapide, le seul désavantage étant la consommation mémoire pouvant être importante selon les données stockées.
Creer un serveur Linux, Nginx, MySQL, PHP
Apache n'est pas le seul serveur HTTP existant pour desservir des applications écrites en PHP, de nombreux autre existent dont Nginx. Dans le cas de l'utilisation de Nginx pour desservir des applications PHP on appellera cela une pile LEMP pour Linux, Nginx, Mysql et PHP.
Importante mise à jour de Composer
Il semblerait que Noël soit fêté avant l'heure au sein de la communauté PHP. Le gestionnaire de paquets PHP, Composer, a reçu une importante amélioration de performance aujourd'hui.
Articles mis en avant
Comment activer la vérification de typage pour Python dans VSCode
Python supporte désormais le [type hints](https://docs.python.org/3/library/typing.html). Dans cet article, nous allons voir comment avoir de l'IntelliSense pour le typage ainsi qu'avoir les erreurs de typage sur Visual Studio Code.
Comment gérer l'internationalisation avec NextJS SSG
Générer statiquement un site avec le framework NextJS pour différentes langues n'est pas si simple.
Utilisateurs et privilèges sous MySQL
L'administration d'une base de données inclue la gestion des utilisateurs et de leurs privilèges. La plupart du temps, une interface graphique, telle que MySQL Workbench ou PHPMyAdmin, est disponible pour réaliser de façon simple les actions liées à cette gestion. Dans ce tutoriel, nous allons voir comment réaliser la gestion des utilisateurs MySQL au moyen de requêtes SQL.