[Total : 7   Moyenne : 4.4/5]

Pour personnaliser vos pages selon vos besoins, vous savez déjà créer des Modèles de Page, n’est ce pas ? Et bien créer un Custom Post Type revient à créer un Modèle d’Article, ou traduit littéralement : Type d’Article Personnalisé.

Vous pouvez ainsi regrouper et afficher vos articles personnalisés sous forme de listes. Les cas d’utilisation sont nombreux : les cabinets d’architectes pour montrer leurs créations, les voyageurs blogueurs pour nous faire baver devant leurs escapades ou encore les adeptes de gastronomie qui souhaitent partager leurs meilleures recettes.

Et comme nous sommes dans le pays de la bonne bouffe, vous allez déguster tout au long de cet article (non pas que le tutoriel soit difficile, mais j’aime parler de bons petits plats).
 

Pour les adeptes du Plugin (solution simple)

Créer vos propres Custom Posts Types est possible très simplement grâce à une excellente extension gratuite nommée Custom Post Type UI. Ce module est une référence auprès de la communauté WordPress et fait un carton depuis plusieurs années.
 
Custom Post Type UI - Très bon PlugIn WordPress
 
Cependant, le choix de l’extension comprend quelques limites. Si elle se retrouve un jour désactivée (après une mauvaise manipulation ou une erreur de mise à jour), alors vos Custom Post Types n’apparaitrons plus dans votre interface d’administration.

Dans le cas ou vous travaillez avec prévoyance sur le site web d’un client, vous préférerez certainement l’option de la sécurité. Pour cela, la création manuelle de vos Custom Post Types reste encore la meilleure.

 

Créer manuellement un Custom Post Type

Si vous avez suivi, on passe à la solution virile et authentique. Ne fuyez pas, on va juste parler nourriture. Promis.

Nous imaginerons donc que nous souhaitons ajouter des fiches « Recettes » à notre site Internet.
D’abord, commencez par ajouter ce code à la suite dans votre fichier functions.php

 

[php] // Notre fonction Article Personnalisé (Custom Post)
function create_post_type() {

register_post_type( ‘recettes’,
array(
‘labels’ => array(
‘name’ => __( ‘Recettes’ ),
‘singular_name’ => __( ‘Recette’ ),
),
‘public’ => true,
‘has_archive’ => true,
‘rewrite’ => array(‘slug’ => ‘recettes’),
)
);
}
add_action( ‘init’, ‘create_post_type’ );

[/php]

 

 

Notre morceau de code enregistre un type de postrecettes‘ avec un ensemble d’arguments qui sont en fait des options attribuées à notre nouveau custom post type.

On distingue deux parties distinctes :

  • Le Label qui est lui même un argument comprenant le nom au singulier et au pluriel de notre Custom Post Type
  • La seconde partie contient 3 autres arguments tels que la visibilité publique, les archives et le slug (ou terminaison) qui sera utilisé dans les URLs de notre type de post.

 

Ajoutons maintenant ce code à la suite, afin de donner plus d’options à notre custom post type :

 

[php] /*
* Cette fonction va créer l’apparence de notre nouveau Custom Post,
* visible ensuite dans l’administration WordPress
*/

function custom_post_type() {

$labels = array(
‘name’ => _x( ‘Recettes’, ‘Post Type General Name’, ‘twentyseventeen’ ),
‘singular_name’ => _x( ‘Recette’, ‘Post Type Singular Name’, ‘twentyseventeen’ ),
‘menu_name’ => __( ‘Recettes’, ‘twentyseventeen’ ),
‘parent_item_colon’ => __( ‘Recette Parente’, ‘twentyseventeen’ ),
‘all_items’ => __( ‘Toutes les Recettes’, ‘twentyseventeen’ ),
‘view_item’ => __( ‘Voir la Recette’, ‘twentyseventeen’ ),
‘add_new_item’ => __( ‘Ajouter une Nouvelle Recette’, ‘twentyseventeen’ ),
‘add_new’ => __( ‘Ajouter’, ‘twentyseventeen’ ),
‘edit_item’ => __( ‘Éditer une Recette’, ‘twentyseventeen’ ),
‘update_item’ => __( ‘Mettre à jour une Recette’, ‘twentyseventeen’ ),
‘search_items’ => __( ‘Rechercher une Recette’, ‘twentyseventeen’ ),
‘not_found’ => __( ‘Aucune Recette’, ‘twentyseventeen’ ),
‘not_found_in_trash’ => __( ‘Aucune Recette dans la corbeille’, ‘twentyseventeen’ ),
);

// Paramètre d’autres options :

$args = array(
‘label’ => __( ‘recettes’, ‘twentyseventeen’ ),
‘description’ => __( ‘Les meilleures recettes des cuisines du Monde’, ‘twentyseventeen’ ),
‘labels’ => $labels,

// Ajoute les options suivantes à l’édition des articles Recettes
‘supports’ => array( ‘title’, ‘editor’, ‘excerpt’, ‘author’, ‘thumbnail’, ‘comments’, ‘revisions’, ‘custom-fields’, ),

// Vous pouvez associer le Type d’Article avec un taxonomie ou une taxonomie personnalisée.
‘taxonomies’ => array( ‘cuisine’ ),

‘hierarchical’ => false,
‘public’ => true,
‘show_ui’ => true,
‘show_in_menu’ => true,
‘show_in_nav_menus’ => true,
‘show_in_admin_bar’ => true,
‘menu_position’ => 5,
‘menu_icon’ => ‘dashicons-carrot’, //icône associé au menu, ici une Carotte pour illustrer les recettes (plus d’infos dans la suite du tuto)
‘can_export’ => true,
‘has_archive’ => true,
‘exclude_from_search’ => false,
‘publicly_queryable’ => true,
‘capability_type’ => ‘post’, );

// On enregistre notre Type d’Article Personnalisé (Custom Post Type)
register_post_type( ‘recettes’, $args ); }

add_action( ‘init’, ‘custom_post_type’, 0 );
[/php]

 

Je vous vois venir : « Ouhla c’est quoi tout ça, j’y comprend rien et en plus je commence à avoir vraiment faim ». Pas de panique, voici les explications simples de cet ajout de lignes à notre code de départ :

  • Des fonctionalités (ligne 33) : vous pouvez choisir pour chacun de vos Articles Personnalisés un titre (title), un auteur (author), un résumé (excerpt), une image à la une (thumbnail)…
  •  

  • Une Taxonomie (ligne 36) : nous avons associé notre custom post type à la taxonomie « cuisine »
  •  

  • L’usage de twentyseventeen répété (ligne 10 à 22, et 28-29) : ‘twentyseventeen’ est un text domain. Remplacez le par celui de votre propre thème WordPress afin de permettre à vos Custom Post Types d’être traduisibles en d’autres langues. Vous trouverez le text domain de votre thème dans l’en-tête du fichier style.css à la racine de votre site.
  •  

  • L’ajout d’un icône à notre menu (ligne 45) : Ici une carotte pour représenter nos Recettes. Vous pouvez personnaliser le choix de l’icône pour représenter vos Custom Post Type grâce aux icônes proposés par WordPress Dashicons

 

Afficher vos Custom Post sur votre site

On arrive au bout. Pour vous récompenser, n’hésitez pas à vous faire livrer des sushis tout en poursuivant ce tutoriel.
A présent, nous souhaitons afficher nos succulentes Recettes sur une Page nommée « Mes recettes préférées ».
 

1 – Ajouter de nouvelles recettes

En passant par le menu Recettes > Ajouter. Veillez à bien remplir le champs titre, saisir le contenu de la recette dans l’éditeur de texte, et saisir un extrait. C’est le moment de faire baver vos internautes en mettant vos clichés les plus appétissants en Image à la Une.

Vous devez ensuite mettre à jour vos permaliens via Réglages > Permaliens depuis l’administration de WordPress. Sinon vous risquez de voir vos articles Recettes renvoyer vers une page 404.
 
Créer un Custom Post Type en quelques minutes !

 

2 – Créer un modèle de page

Nos articles de Recettes sont prêts. Encore faut-il une Page sur laquelle les afficher. Dupliquez page.php situé à la racine de votre thème WordPress et renommez la copie en page-recette.php. Ouvrez page-recette.php avec votre éditeur de texte préféré et insérez le code suivant :
 

Ajoutez d’abord ce bout de code tout en haut de votre fichier page-recette.php :
[php] <?php
/*
Template Name: Modèle de Page Recettes
*/
?>
[/php]

 

Puis insérez les lignes de codes suivantes dans votre fichier page-recette.php comme ci-dessous :
[php] <?php
query_posts(array(
‘post_type’ => ‘recettes’,
‘showposts’ => 10
) );
?>
<?php while (have_posts()) : the_post(); ?>
<div class="recette">
<?php the_post_thumbnail(); ?>
<div class="text">
<h2><b><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></b></h2>
<p><i>Recette proposée par : <?php the_author(); ?></i></p>
<p><?php echo get_the_excerpt(); ?></p>
</div>
</div>
<?php endwhile;?>
[/php]

 
Afficher les Custom Posts dans une Page

 

Ce code va afficher nos articles de type ‘recettes’ et limiter leur affichage à 10 par page (ligne 3).
Vient ensuite la requête qui va appliquer la mise en forme de l’affichage de nos articles recettes : ici nous souhaitons voir l’image de la recette (thumbnail), le titre (title), l’auteur (author) et l’extrait (excerpt). Libre à vous de choisir vos balises et d’en ajouter, selon vos besoins.

 

3 – Ajouter une nouvelle Page via l’administration de WordPress

Donnez le titre « Mes recettes préférées » à cette nouvelle Page. Enfin, sélectionnez le « Modèle de Page Recette » dans le bloc à droite nommé Attributs de page comme ci-dessous.
 
Créer un modèle de page WordPress

C’est le moment de voir si tout ça a de la gueule. Allez maintenant voir la page « Mes recettes préférées » et constatez avec beaucoup d’émotions que vos articles sont affichés (pour fêter ça, repassez une deuxième commande de sushis).

Il ne reste plus qu’à les styliser selon vos envies avec du CSS. Voici le résultat obtenu avec quelques lignes de style à partir du thème Twentyseventeen :

 
Afficher Custom Posts dans une Page

La mission est accomplie : vous avez gagné en compétences et j’ai tenu ma promesse de placer cet enseignement sous le signe de la gastronomie.
 

Cet article vous a plus ? Dîtes-le en commentaire et rejoignez-nous sur Facebook pour partager d’autres astuces et tutoriels gratuits !