Les composantes d'une page de Wordpress

Les éléments qui composent une page sous Wordpress sous prédéfinis dans le code du CMS, et représentés par un appel de fonction en PHP.
Comme les briques du Lego, ils peuvent êtres assemblés pour composer l'interface choisie par l'auteur du thème.

Boucle d'affichage d'articles

La boucle principale affiche un simple billet ou plusieurs ou les extraits des derniers billets.

Début de la boucle
 if (have_posts()) : while (have_posts()) : the_post(); 

Affiche un ou plusieurs articles. Le nombre est défini dans la panel d'administration.

Fin de la boucle
 endwhile;  else:
_e('Sorry, no posts matched your criteria.');
endif;

_e est une fonction du CMS et la chaîne en argument est traduite par le module de localisation.

Date

the_date('format','avant','après');

Les paramètres sont dans l'ordre:
- Le format d'affichage. Il dépend du pays.
- Le code HTML à placer avant. Exemple: <h4>
- Le code HTML à placer après. Exemple: </h4>
Il vaut mieux ne pas indiquer de format pour permettre à l'utilisateur du template de le configurer lui-même selon son pays.

Catégorie

the_category(','),

Les arguments dans l'ordre:
- Le séparateur. Par exemple une virgule comme ci-dessus. Autre exemple: '&bull;' pour un rond.
- Mode d'affichage: multiple ou single pour la hiérarchie de catégorie s'il en est.

L'auteur

the_author();

On ajoute l'auteur sur un site collaboratif, il est superflu autrement. Cette fonction n'a plus de paramètre.
On si les auteurs ont des sites web différents, on peut remplacer le lien sur le profil par un lien sur le site de l'auteur.

the_author_link();

D'autres options sont décrites dans le codex.

Le titre de l'article

the_title();

Il ne fait pas partie de l'article mais est stocké dans un champ particulier dans la base de données.
Les arguments optionnels sont:
- Avant: code HTML à insérer avant le titre, par exemple <h1>.
- Après: code HTML à insérer après.

Exemple: the_title('<h1>', '</h1>');

Le contenu du billet

the_content(__('(more...)'));

L'argument ___() est pour le texte à affiché quand le contenu est coupé. Il ne s'affiche pas quand la page est consacrée à un article seul. Le texte est traduit automatiquement par le module de localisation.

Les commentaires

comments_template();

Affiche en bloc tout ce qui concerne les commentaire et peut donc être supprimé en bloc aussi.

Boutons de navigation

wp_link_pages('before=<p>&after=</p>');

Les articles suivants et précédents.
Un seul argument qui est un chaîne de paramètres séparés par &.
Les valeurs sont sont:
- before: code HTML à insérer avant.
- after: code HTML à insérer après.

Bouton d'édition

 edit_post_link('Edit this entry.', '<p>', '</p>');

Il se place dans la boucle. Les trois arguments optionels sont:
- Le libellé. Par exemple 'Editer'.
- Code HTML à insérer avant.
- Code HTML à insérer après.

Le bouton s'affiche quand on a les droits d'édition.

Format d'une page

Le format complet d'une page d'article peut ressembler à ceci:

<?php
get_header();  

if(have_posts()): while (have_posts(): the post();

the title('<h1>', '<h1>');
the_content();
edit_post_link();
wp_link_pages();
endwhile;

endif;

get_sidebar();
get_footer();
?>

Voir aussi