Comment ajouter la prise en charge des formats d’article à votre thème

Description

Que sont les formats d’article, comment pouvez-vous les utiliser et comment développez-vous des formats d’article ? Cette présentation étape par étape vous permettra de comprendre ce que sont les formats d’article et comment créer les vôtres.

Compétences préalables

• Connaissances de base en HTML/CSS/PHP
• Connaissances de base de l’installation et de l’activation de thèmes WordPress
• Compréhension de la structure des dossiers et des fichiers
• Capacité à modifier des fichiers avec un éditeur de texte

Objectifs

• Les étudiants créeront chaque format d’article à l’aide d’un thème WordPress par défaut
• Les étudiants activeront la prise en charge des formats d’article sur un thème qui ne les prend pas encore en charge
• Les étudiants styliseront chaque type de format d’article

Ressources

• WordPress installé localement
• Thème Twenty Thirteen installé (tous les formats d’article sont créés et stylisés)
• Thème Twenty Twelve installé (pour montrer comment activer et styliser les formats d’article lorsqu’ils ne sont pas déjà pris en charge par le thème sélectionné)
• Thème enfant pour activer les formats d’article
• Contenu de remplissage provenant des données de test de l’unité de thème

Questions de sélection

• Savez-vous installer et activer des thèmes via le tableau de bord WordPress ?
• Avez-vous au moins des connaissances de base en HTML/CSS/PHP ?
• Êtes-vous à l’aise avec l’utilisation d’un éditeur de texte pour modifier du code ?
• Disposerez-vous d’un site WordPress bac à sable hébergé localement ou à distance à utiliser pendant le cours ?

Notes pour l’enseignant

• Effectuer une démonstration en direct tout en enseignant les étapes de création d’un thème enfant est essentiel pour que le contenu soit bien compris par les étudiants.
• Il est plus facile pour les étudiants de travailler sur une copie installée localement de WordPress. Prévoyez du temps avant le cours pour aider les étudiants à installer WordPress localement s’ils en ont besoin. Pour plus d’informations sur l’installation locale de WordPress, veuillez consulter Installation sur un serveur local.
• Les réponses attendues aux questions de sélection sont « oui ». Les participants qui répondent « non » aux 4 questions ne sont peut-être pas prêts pour cette leçon.

Présentation pratique

Introduction : que sont les formats d’article ?

Les formats d’article existent dans WordPress depuis la version 3.1. Cependant, peu de thèmes les prennent nativement en charge et encore moins d’utilisateurs les mettent en œuvre. Un format d’article est une information méta qui peut être utilisée par un thème pour personnaliser la présentation d’un article. La fonctionnalité des formats d’article fournit une liste standardisée de formats disponibles pour tous les thèmes qui prennent cette fonctionnalité en charge. Les thèmes ne sont pas obligés de prendre en charge tous les formats de la liste. De nouveaux formats ne peuvent pas être introduits par des thèmes ni même par des extensions. La standardisation de cette liste assure à la fois la compatibilité entre de nombreux thèmes et un moyen pour les outils de blog externes d’accéder à cette fonctionnalité de manière cohérente. En bref, avec un thème prenant en charge les formats d’article, un blogueur peut modifier l’apparence de chaque article en choisissant un format dans une liste de boutons radio. Les types de formats d’article comprennent :

En passant – Généralement affiché sans titre. Semblable à une mise à jour sous forme de note sur Facebook.

Galerie – Une galerie d’images. L’article contiendra probablement un code court de galerie et des pièces jointes d’images.

Lien – Un lien vers un autre site. Les thèmes peuvent utiliser la première balise du contenu de l’article comme lien externe de cet article. Une autre approche consiste à considérer que, si l’article se compose uniquement d’une URL, celle-ci sera l’URL et que le titre (post_title) sera le nom associé à son ancre.

Image – Une seule image, avec ou sans légende. La première balise de l’article peut être considérée comme l’image. Autrement, si l’article se compose uniquement d’une URL, celle-ci sera l’URL de l’image et le titre de l’article (post_title) sera l’attribut title de l’image.

Citation – Une citation. Elle contiendra probablement une balise blockquote contenant le texte de la citation. Autrement, la citation peut constituer le contenu lui-même, la source ou l’auteur étant alors le titre.

Vidéo – Une seule vidéo ou une liste de lecture vidéo.

Pourquoi utiliser les formats d’article ?

Grâce aux formats d’article, les visiteurs de votre blog sauront exactement quel type de contenu ils consultent.  Des styles différents pour chaque format d’article rendront votre blog plus intéressant visuellement. Auparavant, les développeurs tentaient de créer ces styles uniques pour le contenu en modifiant les catégories ou en utilisant des types de contenu personnalisés.  Ces types personnalisés étaient destinés à autre chose qu’au contenu d’un blog. L’utilisation des formats d’article permet de conserver tout votre contenu dans la partie blog de votre site et, une fois configurée, il vous suffira d’indiquer le format utilisé. Les formats d’article apparaîtront dans votre flux RSS et pourront être modifiés dans la section Articles de votre site.

Comment fonctionnent les formats d’article

Lorsque vous modifiez un article individuel, vous verrez un module Format :

Une fois que vous avez attribué des articles à un format d’article particulier, des icônes apparaîtront dans le tableau de bord pour indiquer le format de chaque article.  Accédez à Articles > Tous les articles :

Lorsque vous consultez votre blog, le contenu aura une apparence unique pour chaque format.

Ajout de la prise en charge dans un thème

Les thèmes doivent utiliser add_theme_support() dans le fichier functions.php pour indiquer à WordPress quels formats d’article prendre en charge, en transmettant un tableau de formats comme suit :

add_theme_support( 'post-formats', array( 'aside', 'quote', 'status', 'image', 'gallery', 'chat', 'link', 'audio', 'video' ) );

Ajout de la prise en charge aux types d’articles

Si vous souhaitez utiliser le style des formats d’article sur les pages ou les types de contenu personnalisés, c’est possible. Les types d’articles doivent utiliser add_post_type_support() dans le fichier functions.php pour indiquer à WordPress quels formats d’article prendre en charge :

// add post-formats to post_type 'page'
add_post_type_support( 'page', 'post-formats' );

// add post-formats to post_type 'my_custom_post_type'
add_post_type_support( 'my_custom_post_type', 'post-formats' );

Utilisation des formats d’article

Dans le thème, utilisez get_post_format() pour vérifier le format d’un article et modifier sa présentation en conséquence. Notez que les articles utilisant le format par défaut renvoient la valeur FALSE. Vous pouvez également utiliser la has_post_format(), une balise conditionnelle :

if ( has_post_format( 'video' )) {
  echo 'this is the video format';
}

Une autre manière d’utiliser les formats consiste à employer des règles de style. Les thèmes doivent utiliser la fonction post_class() dans le code conteneur qui entoure l’article afin d’ajouter des classes de style dynamiques. Les formats d’article entraînent l’ajout de classes supplémentaires de cette manière, utilisant le nom « format-foo ». Par exemple, on pourrait masquer les titres des articles au format statut en ajoutant ceci dans la feuille de style de votre thème :

.format-status .post-title {
display:none;
}

Styliser les formats d’article

Bien que vous puissiez styliser et concevoir vos formats pour les afficher comme bon vous semble, chacun des formats se prête à un certain type de « style », comme le veut l’usage moderne. Il est utile de garder à l’esprit l’utilisation prévue de chaque format, car cela permettra aux lecteurs de les reconnaître facilement visuellement comme un type de contenu spécifique. Par exemple, les formats « en passant », lien et statut sont généralement affichés sans titre ni informations sur l’auteur. Ils sont simples, courts et secondaires. Le format « en passant » peut contenir un ou deux paragraphes, tandis que le lien ne comportera probablement qu’une phrase contenant un lien vers une URL. Les formats lien et « en passant » peuvent tous deux comporter un lien vers la page de l’article individuel (à l’aide de the_permalink()) et autoriser ainsi les commentaires, mais le format statut ne comportera très probablement pas un tel lien. Un article au format image, en revanche, contiendra généralement une seule image, avec ou sans légende ou texte l’accompagnant. Un article audio ou vidéo sera similaire, mais avec un contenu audio ou vidéo. Ces trois formats peuvent utiliser des extensions ou les contenus intégrés standard pour afficher leur contenu. Les titres et les informations sur l’auteur peuvent également ne pas être affichés, car le contenu peut se suffire à lui-même. Le format citation est particulièrement adapté à la publication d’une simple citation d’une personne sans informations supplémentaires. Si vous placez uniquement la citation dans le contenu de l’article et le nom de la personne citée dans le titre de l’article, vous pouvez styliser l’article afin d’afficher the_content() seul, mais reformaté en bloc de citation, et utiliser the_title() pour afficher le nom de la personne citée comme signature. Un format discussion aura généralement tendance à utiliser une police à chasse fixe. Avec un peu de style sur .format-chat, vous pouvez afficher le contenu de l’article avec une police à chasse fixe, par exemple dans une div avec un arrière-plan gris ou similaire, afin de le distinguer visuellement comme une session de discussion. Consultez Formats d’article : discussion pour plus d’informations sur le style.

Formats dans un thème enfant

Les thèmes enfants héritent des formats d’article définis par le thème parent. L’appel de add_theme_support() pour les formats d’article dans un thème enfant doit être effectué avec une priorité ultérieure à celle du thème parent et remplacera la liste existante au lieu de lui ajouter des éléments.

add_action( 'after_setup_theme', 'childtheme_formats', 11 );
function childtheme_formats(){
     add_theme_support( 'post-formats', array('aside', 'quote', 'status', 'image', 'gallery', 'chat', 'link', 'audio', 'video') ); }

L’appel de remove_theme_support('post-formats') supprimera entièrement cette prise en charge.

Exercices en groupe

1. À l’aide du thème Twenty Thirteen, créez un article avec chacune des options de format d’article.
2. Avec Underscores :
   1. Créer chaque format d’article

1. content-aside.php
2. content-audio.php
3. content-chat.php
4. content-gallery.php
5. content-image.php
6. content-link.php
7. content-quote.php
8. content-status.php
9. content-video.php
10. content-none.php

Styliser les formats d’article (en s’inspirant de la ligne 1380 de Style.css de Twenty Thirteen)

Quiz

1. Que sont les formats d’article ? Les formats d’article sont utilisés par un thème pour personnaliser la présentation d’un article. La fonctionnalité des formats d’article fournit une liste standardisée de formats disponibles pour tous les thèmes qui prennent cette fonctionnalité en charge.
2. Quelles sont les différentes options de format d’article ? En passant, audio, discussion, galerie, image, lien, citation, statut, vidéo
3. Les formats d’article sont-ils identiques aux types de contenu personnalisés ? Quand choisiriez-vous un type de contenu personnalisé plutôt qu’un format d’article ? Non, les types de contenu personnalisés apparaissent comme une autre option dans le tableau de bord d’administration, près des articles et des pages.  Les types de contenu personnalisés sont utiles lorsque vous ne souhaitez pas que le contenu apparaisse sur /blog, par exemple pour un calendrier d’événements ou des annonces immobilières.
4. Où activez-vous les formats d’article pour votre thème ? Dans Functions.php, plus précisément dans le fichier functions.php d’un thème enfant
5. Que devez-vous faire lors de la rédaction d’un article qui doit utiliser un format d’article ? Sélectionner le format d’article à utiliser
6. Où personnalisez-vous l’apparence des formats d’article ? Dans Style.css, ou plus précisément dans le fichier style.css du thème enfant
7. Tous les thèmes prennent-ils en charge les formats d’article ? Non
8. Quels thèmes WordPress par défaut prennent en charge les formats d’article ? Twenty Thirteen et Twenty Fifteen
9. Pouvez-vous ajouter la prise en charge des formats d’article à votre thème ou à votre thème enfant ? Oui