Affichage des données de thème dans WordPress

Article original : http://digwp.com/2011/12/displaying-theme-data-with-wordpress/

Voici un truc sympa que vous pouvez faire avec WordPress : afficher des informations directement depuis la feuille de style style.css de votre thème. L’auteur, Jeff Starr, a utilisé cette technique sur un site où le numéro de version du thème est repris à plusieurs reprises à travers le template.

get_theme_data()

La fonction à utiliser porte le nom de get_theme_data(), et renvoie tout simplement un tableau d’informations sur les données du thème spécifié en paramètre :

Le paramètre $theme_filename est obligatoire et correspond aux chemin et nom du fichier css du thème. Assurez-vous de correctement renseigner ce paramètre car la fonction n’accepte pas de valeur défaut.

Quelles informations est-il possible d’afficher grâce à get_theme_data()? Celle-ci renvoie un tableau de valeurs qui, en un mot, comprennent les différentes meta de la feuille de style. Voici une liste des possibilités (notons que ce sont toutes des chaînes de caractères):

Name – le nom du thème
Title – autre nom du thème ou nom de thème lié
URI – URI du thème
Description – wptexturized version of the theme name
AuthorURI – URI de l’auteur du thème
Template – modèle parent du thème (s’il existe)
Version – numero de version du thème
Status – statut du thème (par defaut: publish)
Tags – tags du thème
Author – nom de l’auteur ou nom de l’auteur du thème lié

Nota Bene : ces valeurs sont sensibles à la casse et ne fonctionneront donc pas si l’initiale n’est pas majuscule.

Examples

Le Codex fournit cet exemple pour récupérer puis afficher les nom et auteur du thème :

Copier/coller simplement ce code dans votre template et modifier le nom du thème à la première ligne de code, dans la variable $theme_name.
La seconde ligne appelle la fonction.
Les 3e et 4e lignes affichent le titre et l’auteur du thème.

Afficher d’autres données de votre thème n’est pas plus compliqué que cela :
recopier les deux dernières lignes et modifier les suivant les données que vous désirez afficher.

Maintenant que vous avez saisi le principe, vous pouvez l’utiliser pour faire des trucs cools, comme par exemple afficher la version de votre thème à travers votre site. Jeff Starr utilise cette technique pour ajouter les paramètres de version aux URLs de ses feuilles de style, comme ceci :

<link rel=’stylesheet’ href='<?php bloginfo(‘stylesheet_directory’); ?>/style.css<?php if(function_exists(‘theme_version’)) theme_version(); ?>’>

… ce qui donnera en sortie ceci :

<link rel=’stylesheet’ href=’http://example.com/wp-content/themes/xycss/style.css?v=1.3′>

On remarque bien l’ajout du paramètre de version, ?v = 1,3.

Pour ceux qui comme l’auteur utilisent le versionning des feuilles de style, cette méthode permet de gagner réellement beaucoup de temps et permet de garder la trace des évolutions.

Voici la fonction theme_version() à implémenter dans le fichier functions.php de votre thème :

// Affichage du numéro de version

function theme_version() {
$theme_name = ‘xycss’; // RENSEIGNER ICI VOTRE NOM DE THEME !
$theme_data = get_theme_data( get_theme_root() . ‘/’ . $theme_name . ‘/style.css’ );
echo ‘?v=’ . $theme_data[‘Version’];
}

Et, avec les quelques modifications suivantes, vous pouvez aussi afficher les informations de votre thème dans vos articles et vos pages via le shortcode :

// Shortcode du numéro de version

function theme_version_shortcode() {
$theme_name = ‘xycss’; // RENSEIGNER ICI VOTRE NOM DE THEME !
$theme_data = get_theme_data( get_theme_root() . ‘/’ . $theme_name . ‘/style.css’ );
return $theme_data[‘Version’];
}
add_shortcode(‘theme_version’, ‘theme_version_shortcode’);

Avec ce second code dans votre fichier functions.php, afficher vos infos de thème dans vos pages se fait par le simple appel :
[theme_version]
…ce qui donnera en sortie : 1.3

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *