WordPress.org

fr:Marqueurs de Modele/previous post

Page d'accueil du Codex en français - Télécharger WordPress en français
Les utilisateurs francophones se retrouvent sur le site WordPress-Francophone, notamment sur son forum d'entraide.

Description

Utilisé sur les pages d'articles seuls ou de permalien (en anglais), ce marqueur liste l'article précédent dans l'ordre chronologie à partir de l'article en cours. Il peut fonctionner en conjonction avec le marqueur next_post(). Ce marqueur doit être utilisé dans la Boucle (en anglais).

Pour les modèles d'index, de catégorie et d'archive, utilisez le marqueur posts_nav_link().

Cette fonction a été rendue obsolète. Ce qui signifie qu'elle a été remplacée par une nouvelle fonction ou qu'elle n'est plus supportée et qu'elle peut être retirée dans une prochaine version. Toute programmation l'utilisant doit être convertie par un équivalent s'il en existe.

Utilisation

<?php previous_post('format', 'previous', 'title', 'in_same_cat', limitprev, excluded_category); ?>

Exemples

Utilisation par Défaut

Par défaut, affiche le texte "article précédent :" comme lien avec le titre de l'article.

<?php previous_post(); ?>

article précédent: Titre de l'Article Précédent

Utiliser le Texte Comme Lien, Sans Titre de l'Article

Affiche le texte spécifié comme lien, sans inclure le titre de l'article. Si les titres d'articles excessivement longs déforment la disposition de votre site, vous souhaiterez l'utiliser. "« Précédent" est le texte spécifié dans cet exemple ; vous pouvez utiliser ce que vous voulez à la place.

<?php previous_post('%','« Précédent', 'no'); ?>

« Précédent

Utiliser un Texte Spécifique

Affiche les liens vers les articles précédents et suivants dans un format avec un texte avant le titre de l'article et sans créer de lien.

<p><?php previous_post('%', 'Précédent :', 'no'); ?> | <?php next_post('%', 'Suivant :', 'no'); ?></p>

Précédent : Titre de l'Article Précédent | Suivant : Titre de l'Article Suivant

Utiliser des Flèches et pas du Texte

Pour afficher du texte, comme des flèque («), au début du lien vers l'article précédent et à la fin du lien vers l'article suivant pour que cela ressemble à ça :

« « Titre de l'Article Précédent | Titre de l'Article Suivant » »

<?php previous_post('&laquo; &laquo; %', '', 'yes'); ?>
| <?php next_post('% &raquo; &raquo; ', '', 'yes'); ?>

Paramètres

format

(chaîne) Chaîne de formattage pour le lien. '%' dans la chaîne sera remplacé par le lien, donc 'Aller à %' génèrera "Aller à <a href=...". '%' par défaut.

previous

(chaîne) Texte du lien à afficher. 'article précédent : ' par défaut.

title

(chaîne) Détermine si le titre doit être utilisé comme texte du lien. Si défini sur 'yes' (oui), suit immédiatement la valeur du paramètre previous ci-dessus. Les options sont :

'yes' (oui) (Default)
'no' (non)

in_same_cat

(chaîne) Détermine si le lien vers l'article précédent doit porter sur des articles de la même ou des mêmes catégories que l'article en cours. Ce paramètre fonctionne avec les versions de WordPress 1.5.1.3 et ultérieures. Si un article est affectée à plus d'une catégorie, cela affichera les articles de la catégorie parente, mais pas de la catégorie enfant. Les options sont :

'yes' (oui)
'no' (non) (Default)

limitprev: (entier) Définit le lien vers l'article précédent d'après une valeur numérique (article en cours moins limitprev). 1 par défaut. La valeur par défaut est recommandée.
excluded_category: (entier -ou- chaîne) Identifiants numériques (ID) des catégories dont les articles ne doivent pas être listés. Séparez les catégories multiples avec un 'and' : '1 and 5 and 15'. Il n'y a pas de valeur par défaut. Ce paramètre fonctionne avec WordPress version 1.5.2 et ultérieures.

Remplacée Par

Utilisez previous_post_link().

En relation

Consultez également next_post().

the_ID, the_title, single_post_title, the_title_rss, the_content, the_content_rss, the_excerpt, the_excerpt_rss, previous_post_link, previous_post (obsolète), next_post_link, next_post (obsolète), posts_nav_link, the_meta

Retour à la Liste des Marqueurs