Fermer

octobre 1, 2018

Comprendre les pages WordPress et l'API Pages –


Il existe des différences entre les pages WordPress et . Il y a des moments où une publication est plus appropriée à utiliser, tandis que pour d'autres types de contenu, une page est plus appropriée. Dans cet article, je couvrirai les pages et pourquoi elles diffèrent des articles. Je vous montrerai ensuite comment gérer des pages sur un site WordPress. Enfin, nous allons examiner certaines fonctions de l'API WordPress Pages et avoir un jeu avec les pages.

Qu'est-ce qu'une page WordPress?

Une page WordPress est une page de contenu sur votre site Web – par exemple, une page “Contact” ou “À propos”. Nous voyons souvent des liens vers ces pages dans la navigation principale, la barre latérale ou le bas de page du site Web.

La principale différence entre une publication et une page est le contexte dans le temps: une publication dépend généralement du temps, alors que le contenu d'une page est souvent permanent.

Lorsque vous publiez des nouvelles, ou même un didacticiel, le contexte est important. Une nouvelle fonctionnalité ne sera pas nouvelle pour toujours et, dans certains cas, pourrait ne pas exister quelques années plus tard. C'est pourquoi un article est plus adapté lors de l'écriture de ce type de contenu.

D'autre part, si vous souhaitez décrire le but de votre site Web, ou si vous souhaitez fournir un formulaire de contact, vous voudrez utiliser un page. C'est le type de contenu statique qui ne changera pas dans le temps.

Comment gérer des pages WordPress

Ajouter, modifier et supprimer une page

Si vous disposez d'autorisations Éditeur ou Administrateur, vous pouvez gérer les pages dans WordPress . Pour ce faire, accédez à Pages dans le tableau de bord WordPress, vous verrez une liste de toutes vos pages ou créez une nouvelle page via le bouton Ajouter un nouveau .

 API WordPress Pages

Cette liste est similaire à celle trouvée dans Posts et peut être utilisée de la même manière. Vous pouvez cliquer sur le titre d’une page pour le modifier et d’autres liens rapides utiles apparaissent lorsque vous déplacez votre souris sur le titre de la page.

Lorsque vous cliquez pour modifier ou ajouter une page ou une publication, vous pouvez ensuite spécifier le titre, le contenu et même ajouter une image sélectionnée si votre thème le prend en charge. Le bouton Publish permet de publier la page. Sinon, si vous n'êtes pas prêt à le faire fonctionner, vous pouvez l'enregistrer en tant que brouillon.

Organisation des pages

Pour organiser vos messages, vous pouvez utiliser des catégories et des balises. Cependant, il n’existe pas de méthode similaire pour organiser les pages. Les pages peuvent toujours être organisées dans une hiérarchie. En fait, vous pouvez indiquer des pages en tant que sous-pages d'autres pages. C’est exactement comme si vous créiez des sous-catégories pour vos catégories.

Pour créer une sous-page, accédez à la zone Attributs de page où vous trouverez une liste déroulante intitulée Parent . Dans cette liste, sélectionnez la page de votre choix en tant que parent de la page que vous créez ou modifiez actuellement. Remarque: vous pouvez également créer des sous-sous-pages, des sous-sous-sous-pages, etc. pour créer votre propre hiérarchie.

Par défaut, les pages sont triées alphabétiquement (par leurs titres). Vous pouvez personnaliser cet ordre grâce au champ Order de la section Attributs de page . Ensuite, les pages seront triées en fonction du numéro que vous indiquez dans ce champ. Par exemple, si vous avez trois pages intitulées et elles seront affichées dans cet ordre par défaut. Si vous voulez faire apparaître en premier, indiquez 0 comme ordre et de plus grands chiffres pour les autres pages ( 1 et 2 . ]

L'API WordPress Pages

Affichage d'une liste de pages

Pour afficher une liste de pages, WordPress fournit la fonction wp_list_pages () . Par défaut, il affiche le code HTML d'une liste ul contenant toutes les pages publiées, encapsulée dans une balise li avec un en-tête h2 indiquant Pages. . Il accepte également un paramètre: un tableau associatif répertoriant certaines options pour personnaliser la sortie.

Filtrage de la sortie

Il est possible de restreindre le nombre de pages affichées grâce à certaines options. Le premier que nous verrons est child_of . Cela nous permet d'afficher les pages qui ont une page donnée en tant que parent. L'exemple suivant affiche les enfants de la page avec l'ID 2:

  2
));
?>

L'option auteurs est utile lorsque nous voulons afficher des pages écrites par un ou plusieurs auteurs. Cette option admet une chaîne en tant que valeur: la liste des identifiants des auteurs séparés par des virgules. Avec le paramètre suivant, la fonction affichera les pages écrites par deux auteurs:

  '2,7'
));
?>

Pour afficher uniquement certaines pages, vous pouvez utiliser l'option include . Vous donnez à cette option une liste de pages séparées par des virgules et vous obtiendrez une liste de ces pages:

  '7,53,8'
));
?>

Au contraire, si vous souhaitez masquer certaines pages, vous pouvez utiliser l'option exclure qui accepte le même type de valeur:

  '2,4'
));
?>

Vous pouvez également choisir de filtrer par profondeur. Si vous voulez voir uniquement les pages de niveau supérieur, par exemple, vous pouvez utiliser l'option depth .

Par défaut, il est défini sur 0 et toutes les pages sont affichées. Définissez-le sur un nombre positif et vous n’obtiendrez que des pages à cette profondeur. Par exemple, indiquer 1 affichera uniquement les pages de niveau supérieur. L'exemple suivant affiche ces mêmes pages et leurs enfants directs:

  2
));
?>

Par défaut, wp_list_pages () n'affiche que les pages publiées. Mais vous pouvez également afficher d'autres pages, grâce à l'option post_status .

Utilisez cette option pour afficher les statuts que vous voulez voir, séparés par une virgule. L'exemple suivant affiche les pages publiées et les brouillons:

  'publish, draft'
));
?>

En plus de filtrer la liste des pages que vous récupérez, vous pouvez également limiter le nombre de pages récupérées grâce à l'option number . Si vous utilisez un nombre positif, vous ne récupérerez qu'un nombre limité de pages.

Personnalisation de la sortie

Vous pouvez personnaliser l'en-tête avec l'option title_li qui accepte une chaîne comme valeur. Par défaut, il est défini sur Pages et vous pouvez ensuite choisir n'importe quel texte à afficher. Vous pouvez également définir une chaîne vide.

Ainsi, wp_list_pages () n'encapsulera pas vos pages dans une balise li et vous obtiendrez directement les balises li pour les pages.

Récupération des pages

La fonction wp_list_pages () permet d'obtenir une liste HTML de pages. Si vous souhaitez créer votre propre code HTML ou si vous devez appliquer des actions aux pages avant de les afficher, ce n’est pas la meilleure fonction à utiliser. Au lieu de cela, vous préférerez get_pages () récupérer un tableau répertoriant les différentes pages.

Cette fonction accepte également un tableau comme argument, répertoriant les options souhaitées. La bonne nouvelle est que vous connaissez déjà certaines de ces options, comme nous les avons couvertes dans la description de la fonction wp_list_pages () : child_of auteurs comprend exclut post_status numéro sort_column et sort_order .

Par défaut, la hiérarchie de vos pages est indiquée dans get_pages () : les enfants apparaîtront juste après leurs parents. Vous pouvez désactiver ce comportement grâce à l'option hiérarchisée définie sur false . De cette façon, toutes les pages seront traitées de la même manière et la hiérarchie sera totalement ignorée.

Récupération d'une seule page

La fonction get_pages () renvoie un tableau répertoriant les pages souhaitées, chacune représentée par un objet WP_Post . Nous allons maintenant voir ce qui est contenu dans cet objet en récupérant une seule page. Pour récupérer une page, utilisez la fonction get_post () . Donnez à cette fonction l'ID d'une page et vous obtiendrez un objet représentant cette page:

  

Plusieurs informations sont disponibles dans cet objet, chacune étant un attribut. Par exemple, l'identifiant de la page peut être obtenu grâce à l'attribut ID :

 ID;
?>

Le post_content permet de récupérer le contenu de la page, alors que son titre se trouve dans l'attribut post_title . L’attribut post_name contient le slug de la page (la partie de son URL représentant le titre de la page).

L’ID de l’auteur de la page est donné avec l’attribut post_author . Vous pouvez également récupérer sa date de création avec post_date et sa date de dernière modification avec post_modified . L'attribut post_status vous permet de connaître l'état de la page (publié ou brouillon, par exemple).

L'ID de la page parente peut être obtenu avec l'attribut post_parent et menu_order vous donnera l'ordre indiqué lors de la création de la page.

Conclusion

Si vous souhaitez ajouter des informations statiques et permanentes à votre site Web, WordPress Pages est la solution.

Les fonctions de l’API WordPress Pages sont utiles si vous développez un thème. Vous pouvez, par exemple, répertorier certaines pages dans le pied de page ou créer un widget pour le faire, afin que vos utilisateurs puissent afficher les pages où ils le souhaitent.




Source link