Une chose que j’ai toujours détestée dans les pages de paramètres de thème, c’est à quel point elles seraient très différentes. Imaginez chaque constructeur automobile essayant d’ajouter sa propre touche en ayant un placement de roue unique et vous verrez pourquoi c’est une mauvaise chose pour les éditeurs WordPress.
Heureusement, depuis 3.4 et grâce à API de personnalisation de thème nous n’avons pas du tout besoin de pages de paramètres.
@slobodanmanic le Customizer a en quelque sorte rendu mon blog inutile, ce qui est aussi une bonne chose
– Konstantin Kovshenin (@kovshenin) 19 décembre 2012
Le blog en question est Galerie d’options de thème, vitrine des « meilleurs (et des pires) écrans d’options thématiques en ville ». Surtout le pire, mais je suppose que c’est ce qui l’a rendu populaire. Selon Konstantin, c’est Theme Customizer qui le rendra obsolète.
Tout au long de cette série d’articles, nous examinerons les avantages de l’utilisation de Theme Customizer par rapport aux «anciennes» pages de paramètres, expliquerons comment fonctionne Theme Customizer, verrons comment vous pouvez l’étendre et enfin créer un passe-partout Theme Customizer qui peut être utilisé avec n’importe quel thème WordPress. .
Avantages du personnalisateur de thème
Maintenant, je ne dis pas que les pages de paramètres de thème sont (étaient ?) toutes mauvaises – si elles sont bien faites, elles ressemblent à une extension naturelle du tableau de bord WordPress – juste qu’il y a quelque chose de mieux maintenant. Comparé à une page de paramètres, Customizer facilite le processus de configuration du thème en enlevant le bandeau de la tête de l’utilisateur.
Si vous ne l’avez jamais vu en action, cette vidéo de Otto est à voir absolument :
Alors, qu’est-ce que le personnalisateur de thème exactement ? Selon le Codex :
L’écran de personnalisation du thème (c’est-à-dire « Personnalisateur de thème ») permet aux administrateurs du site de modifier les paramètres d’un thème et de voir un aperçu de ces changements en temps réel.
Personnalisateur de thème en quelques mots
Personnalisateur de thème a trois composants principaux – les sections, les paramètres et les commandes. Si Theme Customizer était une maison, votre salon serait l’une des sections, chaque lumière à l’intérieur serait un réglage et chaque interrupteur de lumière une commande. C’est si simple.
Pour interagir avec Theme Customizer, vous devez vous connecter à l’action Customize_register. En faisant cela, vous chargerez objet $wp_customize, une instance de WP_Customize_Manager classe qui fait tout le gros du travail. Plus à ce sujet dans la partie 2 de cette série.
C’est déjà là
Si vous ne voulez pas interagir avec Theme Customizer et que vous avez juste besoin de le laisser faire dans votre thème, cela devient encore plus facile. Lorsque vous créez un thème à partir de zéro, Theme Customizer sera déjà là, affichant ses sections intégrées. En fait, voici à quel point un index.php vierge et un style.css avec rien d’autre que des lignes d’en-tête de commentaire vous permettront d’obtenir :
Bien sûr, il n’y a rien à prévisualiser dans cette capture d’écran, car index.php ne fait rien, mais c’est le point – si vous êtes un développeur de thème, Theme Customizer crie simplement « Quand vous êtes prêt ! » donc aucune raison de ne pas l’utiliser dans votre thème WordPress.
Il y a plus de sections par défaut, mais elles ne s’affichent que si votre thème les prend en charge, voici la liste complète des sections intégrées :
- Titre et slogan du site
- Couleurs*
- Image d’en-tête*
- Image de fond*
- La navigation*
- Page d’accueil statique
Marqué les sections n’apparaîtront que si votre thème prend en charge leurs fonctionnalités respectives, si vous souhaitez que la section Image d’en-tête apparaisse, tout ce dont vous avez besoin est add_theme_support( ‘custom-header’ )
quelque part dans votre fichier functions.php.
Contrôles existants
- Avec toutes ces sections intégrées, il doit y avoir des commandes existantes (interrupteurs d’éclairage, vous vous souvenez ?) pour les remplir. Voici ce que WordPress vous offre, prêt à l’emploi :
- Champ de texte
- Case à cocher
- Radio
- Sélectionner
- Pipette à couleurs
- Téléchargement de fichiers
- Téléchargement d’images
- Image de fond
Image d’en-tête
Probablement assez bon pour la plupart des thèmes, mais si votre thème est spécial (laissez-moi deviner, n’est-ce pas ?) et a besoin de contrôles personnalisés, vous pouvez le faire aussi. La création de contrôles personnalisés est l’une des choses que nous aborderons dans cette série, alors restez à l’écoute.
C’est tout pour le moment WordPress dispose actuellement de seize API
(essayez de les nommer tous !)
Avez-vous déjà rendu service à vos utilisateurs et êtes-vous passé des pages de paramètres à la personnalisation de thème ? Sinon, j’aimerais savoir pourquoi et si vous l’avez fait, qu’en pensez-vous jusqu’à présent ?