The Tuts + Guide des balises modèles huitième lot

Dans la huitième partie de la série, nous avons parcouru le septième lot de balises de modèles WordPress. Dans cette neuvième partie, nous allons passer en revue le dernier lot de près de 200 balises de modèle. Tout au long du didacticiel, nous verrons des balises de modèle concernant les signets, ainsi que d'autres balises de modèle "diverses"..

Avertissement concernant les signets: À partir de WordPress 3.5, les "signets" sont masqués par défaut dans le panneau d'administration. Pour utiliser les signets, vous devez installer le plugin Link Manager..

Obtenir et afficher une liste de signets: wp_list_bookmarks ()

Cette balise de modèle renvoie ou reprend une liste de signets, une ancienne fonctionnalité de WordPress..

Paramètres

Cette balise de template accepte un seul paramètre:

  • $ args (tableau optionnel):
    Un tableau des arguments suivants:
    • 'commandé par' (chaîne de caractères): Comment commander les signets. Accepte les champs 'name', 'link_id', 'url', 'target', 'description', 'propriétaire' (l'utilisateur qui a ajouté le signet), 'rating', 'updated' (dates de mise à jour), 'rel' (XFN relation signet), 'notes', 'rss', 'longueur' (longueur du nom du signet), 'rand' (aléatoire).
      (Défaut: 'nom')
    • 'ordre' (chaîne): S'il faut commander les éléments dans l'ordre croissant ('ASC') ou décroissant ('DESC').
      (Défaut: 'ASC')
    • 'limite' (entier): Nombre d'éléments à afficher.
      (Par défaut: -1, ce qui signifie tous les signets)
    • 'Catégorie' (chaîne): ID de catégorie séparés par des virgules pour obtenir des éléments.
      (Par défaut: "ce qui signifie toutes les catégories)
    • 'exclude_category' (chaîne): ID des catégories de signets à exclure.
      (Défaut:")
    • 'Nom de catégorie' (chaîne): un nom de catégorie pour afficher les signets (substitue 'catégorie').
      (Défaut:")
    • 'hide_invisible' (entier): faut-il masquer les liens invisibles ou les afficher?.
      (Par défaut: 1)
    • 'show_updated' (entier): Indique si le dernier horodatage mis à jour doit être affiché ou non.
      (Défaut: 0)
    • 'écho' (entier): Indique s'il faut renvoyer la sortie (1) ou la renvoyer (0).
      (Par défaut: 1)
    • 'classer par catégories' (entier): S'il faut grouper les favoris en fonction de leurs catégories (1) ou non (0).
      (Par défaut: 1)
    • 'title_li' (chaîne): Enveloppe la sortie avec un
    • tag et affiche un titre avant la liste des signets. Vous voudrez probablement définir ceci sur une chaîne vide et désactiver le wrapping.
      (Par défaut: 'Bookmarks')
    • 'title_before' (chaîne): code HTML à ajouter avant chaque titre.
      (Défaut: '

      ')

    • 'title_after' (chaîne de caractères): code HTML à ajouter après chaque titre.
      (Défaut: '')
    • 'classe' (chaîne): noms de classe CSS à ajouter à chaque catégorie.
      (Défaut: 'linkcat')
    • 'catégorie_avant' (chaîne de caractères): code HTML à ajouter avant chaque catégorie.
      (Défaut: '
    • ')
    • 'category_after' (chaîne de caractères): code HTML à ajouter après chaque catégorie.
      (Défaut: '
    • ')
    • 'category_orderby' (chaîne de caractères): Comment ordonner les catégories. Accepte 'nom', 'id', 'slug' et 'count'.
      (Défaut: 'nom')
    • 'category_order' (chaîne): S'il faut ordonner les catégories par ordre croissant ('ASC') ou décroissant ('DESC').
      (Défaut: 'ASC')

Usage

 'rand', // Ne prenez que 5 favoris. 'limit' => 5, // Prend des signets dans une catégorie spécifique. 'category_name' => 'Amis', // Ne pas faire écho. 'echo' => 0, // classe personnalisée. 'class' => 'friends-bookmark-list'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Obtenir un tableau de tous les signets: get_bookmarks ()

Cette balise de modèle renvoie un tableau de vos signets WordPress..

Paramètres

Cette balise de template accepte un seul paramètre:

  • $ args (tableau optionnel):
    Un tableau des arguments suivants:
    • 'commandé par' (chaîne de caractères): Comment commander les liens. Accepte les champs de publication tels que 'nom', 'ID', 'titre', 'date', etc..
      (Défaut: 'nom')
    • 'ordre' (chaîne): S'il faut commander les éléments dans l'ordre croissant ('ASC') ou décroissant ('DESC').
      (Défaut: 'ASC')
    • 'limite' (entier): Nombre d'éléments à afficher.
      (Par défaut: -1 qui signifie tout)
    • 'Catégorie' (chaîne): ID de catégorie séparés par des virgules pour obtenir des éléments.
      (Par défaut: vide)
    • 'Nom de catégorie' (chaîne): Nom de la catégorie pour obtenir les éléments.
      (Par défaut: vide)
    • 'hide_invisible' (entier ou booléen): afficher ou masquer les liens marqués comme "invisibles".
      (Défaut: 1 | VRAI)
    • 'show_updated' (entier ou booléen): Indique s'il faut afficher l'heure de la dernière mise à jour du signet..
      (Défaut: 0 | FAUX)
    • 'comprendre' (chaîne): liste d'ID à inclure séparés par des virgules.
      (Par défaut: vide)
    • 'exclure' (chaîne): liste d'ID à exclure séparés par des virgules.
      (Par défaut: vide)

Usage

 'title', 'order' => 'ASC', 'limit' => 15, 'hide_invisible' => false, 'exclude' => '12, 16,23 '); $ bookmarks_array = get_bookmarks ($ args); ?>

Obtenir des données de signet: get_bookmark ()

Cette balise de modèle renvoie toutes les données d’un signet donné..

Paramètres

Cette balise de modèle accepte trois paramètres:

  • $ bookmark (requis-mélangé):
    L'ID de signet ou l'objet.
    (Défaut: NUL)
  • $ sortie (chaîne optionnelle):
    OBJECT, ARRAY_N ou ARRAY_A constant.
    (Défaut: OBJET)
  • filtre $ (chaîne optionnelle):
    Que ce soit pour échapper à la sortie ou non. Si vous voulez filtrer la sortie, définissez ceci sur 'afficher'.
    (Par défaut: 'raw')

Usage

Obtenir les données d'un champ de signet unique: get_bookmark_field ()

Cette balise de modèle vous permet de récupérer les données du champ d'un seul signet..

Paramètres

Cette balise de modèle accepte trois paramètres:

  • champ $ (chaîne obligatoire):
    Le nom du champ.
    (Défaut: NUL)
  • $ bookmark (requis-entier):
    L'identifiant du marque-page.
    (Défaut: NUL)
  • $ contexte (chaîne optionnelle):
    Comment filtrer la valeur du champ: "raw", "edit", "attribut", "js", "db" ou "display".
    (Défaut: 'display')

Usage

Obtenir et afficher le lien "Modifier le favori": get_edit_bookmark_link () Et edit_bookmark_link ()

Ces balises de modèle vous permettent d’obtenir ou de renvoyer en écho un lien "modifier ce signet" à utiliser dans vos modèles..

Paramètres

get_edit_bookmark_link () accepte qu'un seul paramètre:

  • $ bookmark_id (requis-entier):
    L'identifiant du marque-page.
    (Défaut: 0)

Et edit_bookmark_link () accepte quatre paramètres:

  • $ text (chaîne optionnelle):
    Texte pour afficher le lien.
    (Par défaut: 'Edit This')
  • $ avant (chaîne optionnelle):
    Le texte ou le code HTML à afficher avant la sortie.
    (Par défaut: vide)
  • $ après (chaîne optionnelle):
    Le texte ou le code HTML à afficher après la sortie.
    (Par défaut: vide)
  • $ bookmark_id (requis-entier):
    L'identifiant du marque-page.
    (Défaut: NUL)

Usage

',''); // Affiche le lien "Editer le signet" d'un signet spécifique. edit_bookmark_link (__ ('Edit', 'translation-domain'), ",", 98); ?>

Obtenir et afficher les informations de votre site: get_bloginfo () Et bloginfo ()

Ces balises de modèle extrêmement populaires renvoient et affichent les informations générales de votre site..

Paramètres

get_bloginfo () accepte deux paramètres:

  • $ show (chaîne optionnelle):
    Le bit d'information à récupérer. Une des valeurs suivantes:
    • 'url' (chaîne): l'URL de la maison.
    • 'wpurl' (chaîne): l'URL où WordPress est installé.
    • 'la description' (chaîne): Description du site.
    • 'rdf_url' (string): l'URL du flux RDF / RSS 1.0.
    • 'rss_url' (chaîne): l'URL du flux RSS 0.92.
    • 'rss2_url' (chaîne): l'URL du flux RSS 2.0.
    • 'atom_url' (chaîne): l'URL du flux Atom.
    • 'comments_rss2_url' (string): l'URL du flux RSS 2.0 pour les commentaires.
    • 'comments_atom_url' (chaîne): l'URL du flux Atom pour les commentaires.
    • 'pingback_url' (chaîne): l'URL du fichier XML-RPC de pingback.
    • 'stylesheet_url' (chaîne): l'URL du fichier CSS principal du thème.
    • 'stylesheet_directory' (chaîne): l'URL du répertoire du fichier CSS principal du thème.
    • 'template_directory' ou 'template_url' (chaîne): l'URL du répertoire du thème actif.
    • 'admin_email' (chaîne): l'adresse e-mail entrée lors de l'installation de WordPress.
    • 'charset' (chaîne de caractères): le jeu de caractères du site.
    • 'type_type' (chaîne): Le type de contenu des pages HTML WordPress.
    • 'version' (chaîne de caractères): version WordPress.
    • 'la langue' (string): Langue de l'installation de WordPress.
    • 'text_direction' (chaîne): direction du texte de la langue.
    • 'prénom' (chaîne): nom du site.
    (Défaut: 'nom')
  • filtre $ (chaîne optionnelle):
    Réglez-le sur 'filtre' filtrer l'URL renvoyée par cette balise de modèle.
    (Par défaut: 'raw')

Et bloginfo () accepte qu'un seul paramètre:

  • $ show (chaîne optionnelle):
    Mêmes détails que ci-dessus.
    (Défaut: 'blogname')

Usage

Obtenir et afficher automatique Des classes: get_body_class () Et body_class ()

Ces balises modèles très populaires génèrent des classes sémantiques et nous permettent de les renvoyer ou de les répercuter. Ils nous ont également laissé ajouter des noms de classe supplémentaires.

Paramètres

Les deux balises de modèle n'acceptent qu'un seul paramètre:

  • $ classe (chaîne optionnelle ou tableau):
    Noms de classe CSS supplémentaires à ajouter.
    (Par défaut: vide)

Usage

Obtenir et afficher un menu de navigation: wp_nav_menu ()

Cette balise de modèle renvoie ou affiche les menus de navigation, une fonctionnalité essentielle de WordPress. Vous pouvez voir ce modèle de balise dans, probablement, tous les nouveaux thèmes WordPress publiés en 2013 ou plus tard..

Paramètres

Cette balise de template accepte un seul paramètre:

  • $ args (tableau optionnel):
    Un tableau des arguments suivants:
    • 'menu' (chaîne): l'ID, le slug ou le nom du menu.
      (Par défaut: vide)
    • 'menu_class' (chaîne): classe CSS du UL élément du menu.
      (Par défaut: 'menu')
    • 'menu_id' (chaîne): l'ID du UL élément du menu.
      (Par défaut: slug de menu, incrémenté)
    • 'récipient' (chaîne): S'il faut envelopper le UL, et avec quoi l'envelopper.
      (Défaut: DIV)
    • 'conteneur_class' (string): classe CSS de l'élément wrapper.
      (Par défaut: 'menu- menu slug -container')
    • 'conteneur_id' (chaîne): l'ID de l'élément wrapper.
      (Par défaut: vide)
    • 'fallback_cb' (callback ou boolean): Nom d'une fonction de secours à exécuter si le menu n'existe pas. Défini sur false pour éviter tout repli.
      (Défaut: 'wp_page_menu')
    • 'avant' (chaîne): Texte avant le texte du lien.
      (Par défaut: vide)
    • 'après' (chaîne): texte après le texte du lien.
      (Par défaut: vide)
    • 'link_before' (chaîne): texte avant le lien.
      (Par défaut: vide)
    • 'link_after' (chaîne): texte après le lien.
      (Par défaut: vide)
    • 'écho' (booléen): Indique s'il faut faire écho à la balise template.
      (Défaut: VRAI)
    • 'profondeur' (entier): combien de niveaux de la hiérarchie doivent être inclus.
      (Par défaut: 0, ce qui signifie tous les niveaux)
    • 'marcheur' (objet): instance d'une classe de marcheur personnalisée.
      (Par défaut: vide)
    • 'emplacement_thème' (chaîne de caractères): emplacement du thème à utiliser. Doit être enregistré avec register_nav_menu () pour pouvoir être sélectionné par l'utilisateur.
      (Par défaut: vide)
    • 'items_wrap' (chaîne): Comment les éléments de la liste doivent être encapsulés.
      (Défaut:
        % 3 $ s
      )

Usage

 'primary-nav', 'link_before' => '',' theme_location '=>' primaire '); wp_nav_menu ($ args); ?>

Obtenir et afficher les titres de page: wp_title ()

Cette balise de modèle renvoie ou reprend le titre de la page..

Paramètres

Cette balise de modèle accepte trois paramètres:

  • $ sep (chaîne optionnelle):
    Le texte à utiliser comme séparateur.
    (Défaut: '"')
  • $ echo (optionnel-booléen):
    Faire écho (VRAI) ou retourner (FAUX) la balise.
    (Défaut: VRAI)
  • $ déplacement (chaîne optionnelle):
    Position du séparateur et direction du fil d'Ariane. Réglez-le sur 'droit' pour inverser le fil d'Ariane.
    (Par défaut: vide)

Usage

Obtenir et afficher l'URL de la maison: get_home_url () Et home_url ()

Ces balises de modèle renvoient simplement l'URL de la maison.

Paramètres

get_home_url () accepte trois paramètres:

  • $ blog_id (optionnel-entier):
    L'identifiant du blog.
    (Défaut: NUL)
  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Schéma pour donner le contexte de l'URL de base ('http', 'https' ou 'relatif').
    (Défaut: NUL)

Et home_url () accepte deux paramètres:

  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Schéma pour donner le contexte de l'URL de base ('http', 'https' ou 'relatif').
    (Défaut: NUL)

Ne confondez pas ces deux fonctions avec les expressions "l'une renvoie la sortie et l'autre l'affiche". Je sais que je l'ai fait. La différence est un peu bizarre: alors que le get_home_url () la fonction retourne l'URL de la maison d'un blog spécifique, la home_url () la fonction retourne l'URL de la maison du site actuel. Rappelez-vous: ni l'un ni l'autre ne fait écho!

Usage

Obtenir et afficher l'URL du site: get_site_url () Et URL du site()

Ces balises de modèle obtiennent et font écho à "l'URL du site", l'adresse où WordPress est installé.

Paramètres

get_site_url () accepte trois paramètres:

  • $ blog_id (optionnel-entier):
    L'identifiant du blog.
    (Par défaut: site actuel)
  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Schéma pour donner le contexte de l'URL de base ('http', 'https' ou 'relatif').
    (Par défaut: connexion normale ou sécurisée, selon is_ssl ())

Et URL du site() accepte deux paramètres:

  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Schéma pour donner le contexte de l'URL de base ('http', 'https' ou 'relatif').
    (Par défaut: connexion normale ou sécurisée, selon is_ssl ())

Comme avec home_url () et get_home_url (), ne confondez pas ces deux fonctions avec les expressions "l'une renvoie la sortie et l'autre l'affiche". Tandis que le get_site_url () la fonction retourne URL du site d'un blog spécifique, la URL du site() la fonction renvoie l'URL du site du site actuel. Rappelez-vous: ni l'un ni l'autre ne fait écho!

Usage

Obtenir l'identifiant du site actuel: get_current_blog_id ()

Cette balise de modèle renvoie simplement l'ID du site actuel dans un réseau multisite..

Paramètres

Cette balise de template n'accepte aucun paramètre.

Usage

Obtenir et afficher l'URL du panneau d'administration: get_admin_url () Et admin_url ()

Ces balises de modèle renvoient et affichent une URL du tableau de bord de votre site Web..

Paramètres

get_admin_url () accepte trois paramètres:

  • $ blog_ID (optionnel-entier):
    L'identifiant du blog.
    (Par défaut: site actuel)
  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Le schéma à utiliser. 'admin' respecte le schéma défini (avec le is_ssl () fonction), mais vous pouvez le remplacer en définissant ce paramètre. Accepte 'http', 'https', 'admin', 'rpc', 'login' et 'login_post'.
    (Défaut: 'admin')

Et admin_url () accepte deux paramètres:

  • $ path (chaîne optionnelle):
    Chemin facultatif à ajouter à l'URL.
    (Par défaut: vide)
  • régime $ (chaîne optionnelle):
    Le schéma à utiliser. 'admin' respecte le schéma défini (avec le is_ssl () fonction) mais vous pouvez le remplacer en définissant ce paramètre sur 'http' ou 'https'.
    (Défaut: 'admin')

Usage

Obtenir et afficher le lien permanent d’un type de flux: get_feed_link () Et the_feed_link ()

Ces balises de modèle renvoient et affichent le lien permanent d'un flux.

Paramètres

get_feed_link () accepte qu'un seul paramètre:

  • $ feed_type (chaîne optionnelle):
    Type de flux.
    (Par défaut: type de flux par défaut)

Et the_feed_link () accepte deux paramètres:

  • $ ancre (chaîne obligatoire):
    Texte à afficher pour le lien.
    (Défaut: NUL)
  • $ feed_type (chaîne optionnelle):
    Type de flux.
    (Par défaut: type de flux par défaut)

Usage

Mettre fin à la chaîne avec ou sans barre oblique: user_trailingslashit ()

Cette balise de modèle vérifie votre structure de lien permanent et ajoute une barre oblique finale ou supprime la barre oblique existante à la fin de l'URL donnée..

Paramètres

Cette balise de modèle accepte deux paramètres:

  • $ chaîne (chaîne obligatoire):
    L'URL avec ou sans barre oblique.
    (Défaut: NUL)
  • $ type_de_url (chaîne obsolète):
    Ce n'est pas techniquement obsolète, mais il n'est pas utilisé dans la fonction, il n'a donc aucun effet.

Usage

Obtenir le nombre de jours depuis le début de la semaine: calendar_week_mod ()

Cette balise de modèle étrange obtient le nombre de jours depuis le début de la semaine. C'est fondamentalement une "opération modulo".

Honnêtement, je ne sais pas comment utiliser ceci ou Pourquoi utiliser cela. Si vous savez pourquoi ce modèle existe, envoyez un commentaire pour l’informer, ainsi que nos lecteurs.!

Paramètres

Cette balise de template accepte un seul paramètre:

  • numéro $ (requis-entier):
    Jours depuis le début de la semaine.
    (Défaut: 0)

Usage

Obtenir et afficher le calendrier: get_calendar ()

Vous souvenez-vous de ces calendriers que nous avions l'habitude de placer dans les barres latérales de nos blogs? Cette balise de modèle fait exactement cela: elle retourne ou affiche le calendrier.

Paramètres

Cette balise de modèle accepte deux paramètres:

  • $ initial (optionnel-booléen):
    Utiliser les noms de calendrier initiaux (VRAI) ou pas (FAUX).
    (Défaut: VRAI)
  • $ echo (optionnel-booléen):
    Faire écho (VRAI) ou retourner (FAUX) le résultat.
    (Défaut: VRAI)

Usage

Conclusion

J'espère que vous avez aimé ce dernier lot de balises de modèle. Dans la partie suivante, finale de la série, nous allons passer en revue ce que nous avons appris et terminer la série..

Si vous avez des questions, des commentaires ou des corrections, vous pouvez partager votre opinion avec nous dans la section Commentaires. Et si vous avez aimé l'article, n'oubliez pas de le partager avec vos amis!