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..
wp_list_bookmarks ()
Cette balise de modèle renvoie ou reprend une liste de signets, une ancienne fonctionnalité de WordPress..
Cette balise de template accepte un seul paramètre:
$ args
(tableau optionnel):'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).'ordre'
(chaîne): S'il faut commander les éléments dans l'ordre croissant ('ASC') ou décroissant ('DESC').'limite'
(entier): Nombre d'éléments à afficher.'Catégorie'
(chaîne): ID de catégorie séparés par des virgules pour obtenir des éléments.'exclude_category'
(chaîne): ID des catégories de signets à exclure.'Nom de catégorie'
(chaîne): un nom de catégorie pour afficher les signets (substitue 'catégorie').'hide_invisible'
(entier): faut-il masquer les liens invisibles ou les afficher?.'show_updated'
(entier): Indique si le dernier horodatage mis à jour doit être affiché ou non.'écho'
(entier): Indique s'il faut renvoyer la sortie (1) ou la renvoyer (0).'classer par catégories'
(entier): S'il faut grouper les favoris en fonction de leurs catégories (1) ou non (0).'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.'title_before'
(chaîne): code HTML à ajouter avant chaque titre.'title_after'
(chaîne de caractères): code HTML à ajouter après chaque titre.'classe'
(chaîne): noms de classe CSS à ajouter à chaque catégorie.'catégorie_avant'
(chaîne de caractères): code HTML à ajouter avant chaque catégorie.'category_after'
(chaîne de caractères): code HTML à ajouter après chaque catégorie.'category_orderby'
(chaîne de caractères): Comment ordonner les catégories. Accepte 'nom', 'id', 'slug' et 'count'.'category_order'
(chaîne): S'il faut ordonner les catégories par ordre croissant ('ASC') ou décroissant ('DESC').'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); ?>
get_bookmarks ()
Cette balise de modèle renvoie un tableau de vos signets WordPress..
Cette balise de template accepte un seul paramètre:
$ args
(tableau optionnel):'commandé par'
(chaîne de caractères): Comment commander les liens. Accepte les champs de publication tels que 'nom', 'ID', 'titre', 'date', etc..'ordre'
(chaîne): S'il faut commander les éléments dans l'ordre croissant ('ASC') ou décroissant ('DESC').'limite'
(entier): Nombre d'éléments à afficher.'Catégorie'
(chaîne): ID de catégorie séparés par des virgules pour obtenir des éléments.'Nom de catégorie'
(chaîne): Nom de la catégorie pour obtenir les éléments.'hide_invisible'
(entier ou booléen): afficher ou masquer les liens marqués comme "invisibles".1 | VRAI
) 'show_updated'
(entier ou booléen): Indique s'il faut afficher l'heure de la dernière mise à jour du signet..0 | FAUX
) 'comprendre'
(chaîne): liste d'ID à inclure séparés par des virgules.'exclure'
(chaîne): liste d'ID à exclure séparés par des virgules.'title', 'order' => 'ASC', 'limit' => 15, 'hide_invisible' => false, 'exclude' => '12, 16,23 '); $ bookmarks_array = get_bookmarks ($ args); ?>
get_bookmark ()
Cette balise de modèle renvoie toutes les données d’un signet donné..
Cette balise de modèle accepte trois paramètres:
$ bookmark
(requis-mélangé):NUL
) $ sortie
(chaîne optionnelle):OBJET
) filtre $
(chaîne optionnelle):get_bookmark_field ()
Cette balise de modèle vous permet de récupérer les données du champ d'un seul signet..
Cette balise de modèle accepte trois paramètres:
champ $
(chaîne obligatoire):NUL
) $ bookmark
(requis-entier):NUL
) $ contexte
(chaîne optionnelle):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..
get_edit_bookmark_link ()
accepte qu'un seul paramètre:
$ bookmark_id
(requis-entier):Et edit_bookmark_link ()
accepte quatre paramètres:
$ text
(chaîne optionnelle):$ avant
(chaîne optionnelle):$ après
(chaîne optionnelle):$ bookmark_id
(requis-entier):NUL
) ',''); // Affiche le lien "Editer le signet" d'un signet spécifique. edit_bookmark_link (__ ('Edit', 'translation-domain'), ",", 98); ?>
get_bloginfo ()
Et bloginfo ()
Ces balises de modèle extrêmement populaires renvoient et affichent les informations générales de votre site..
get_bloginfo ()
accepte deux paramètres:
$ show
(chaîne optionnelle):'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.filtre $
(chaîne optionnelle):'filtre'
filtrer l'URL renvoyée par cette balise de modèle.Et bloginfo ()
accepte qu'un seul paramètre:
$ show
(chaîne optionnelle):
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.
Les deux balises de modèle n'acceptent qu'un seul paramètre:
$ classe
(chaîne optionnelle ou tableau):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..
Cette balise de template accepte un seul paramètre:
$ args
(tableau optionnel):'menu'
(chaîne): l'ID, le slug ou le nom du menu.'menu_class'
(chaîne): classe CSS du UL
élément du menu.'menu_id'
(chaîne): l'ID du UL
élément du menu.'récipient'
(chaîne): S'il faut envelopper le UL
, et avec quoi l'envelopper.DIV
) 'conteneur_class'
(string): classe CSS de l'élément wrapper.'conteneur_id'
(chaîne): l'ID de l'élément wrapper.'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.'wp_page_menu'
) 'avant'
(chaîne): Texte avant le texte du lien.'après'
(chaîne): texte après le texte du lien.'link_before'
(chaîne): texte avant le lien.'link_after'
(chaîne): texte après le lien.'écho'
(booléen): Indique s'il faut faire écho à la balise template.VRAI
) 'profondeur'
(entier): combien de niveaux de la hiérarchie doivent être inclus.'marcheur'
(objet): instance d'une classe de marcheur personnalisée.'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.'items_wrap'
(chaîne): Comment les éléments de la liste doivent être encapsulés.% 3 $ s
) 'primary-nav', 'link_before' => '',' theme_location '=>' primaire '); wp_nav_menu ($ args); ?>
wp_title ()
Cette balise de modèle renvoie ou reprend le titre de la page..
Cette balise de modèle accepte trois paramètres:
$ sep
(chaîne optionnelle):$ echo
(optionnel-booléen):VRAI
) ou retourner (FAUX
) la balise.VRAI
) $ déplacement
(chaîne optionnelle):get_home_url ()
Et home_url ()
Ces balises de modèle renvoient simplement l'URL de la maison.
get_home_url ()
accepte trois paramètres:
$ blog_id
(optionnel-entier):NUL
) $ path
(chaîne optionnelle):régime $
(chaîne optionnelle):NUL
) Et home_url ()
accepte deux paramètres:
$ path
(chaîne optionnelle):régime $
(chaîne optionnelle):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!
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é.
get_site_url ()
accepte trois paramètres:
$ blog_id
(optionnel-entier):$ path
(chaîne optionnelle):régime $
(chaîne optionnelle):is_ssl ()
) Et URL du site()
accepte deux paramètres:
$ path
(chaîne optionnelle):régime $
(chaîne optionnelle):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!
get_current_blog_id ()
Cette balise de modèle renvoie simplement l'ID du site actuel dans un réseau multisite..
Cette balise de template n'accepte aucun paramètre.
get_admin_url ()
Et admin_url ()
Ces balises de modèle renvoient et affichent une URL du tableau de bord de votre site Web..
get_admin_url ()
accepte trois paramètres:
$ blog_ID
(optionnel-entier):$ path
(chaîne optionnelle):régime $
(chaîne optionnelle):is_ssl ()
fonction), mais vous pouvez le remplacer en définissant ce paramètre. Accepte 'http', 'https', 'admin', 'rpc', 'login' et 'login_post'.Et admin_url ()
accepte deux paramètres:
$ path
(chaîne optionnelle):régime $
(chaîne optionnelle):is_ssl ()
fonction) mais vous pouvez le remplacer en définissant ce paramètre sur 'http' ou 'https'.get_feed_link ()
Et the_feed_link ()
Ces balises de modèle renvoient et affichent le lien permanent d'un flux.
get_feed_link ()
accepte qu'un seul paramètre:
$ feed_type
(chaîne optionnelle):Et the_feed_link ()
accepte deux paramètres:
$ ancre
(chaîne obligatoire):NUL
) $ feed_type
(chaîne optionnelle):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..
Cette balise de modèle accepte deux paramètres:
$ chaîne
(chaîne obligatoire):NUL
) $ type_de_url
(chaîne obsolète):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.!
Cette balise de template accepte un seul paramètre:
numéro $
(requis-entier):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.
Cette balise de modèle accepte deux paramètres:
$ initial
(optionnel-booléen):VRAI
) ou pas (FAUX
).VRAI
) $ echo
(optionnel-booléen):VRAI
) ou retourner (FAUX
) le résultat.VRAI
) 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!