web-dev-qa-db-fra.com

Paramètres API vs thème personnalisateur

Quand serait-il approprié d'utiliser l'API de paramètres, et quand serait-il préférable d'utiliser le personnalisateur de thème?

Ayant cherché sur Google toute la matinée, je n’ai trouvé aucun conseil récent et bien pensé sur cette question. Bien qu'il soit encore trop tôt pour le dire, j’ai le sentiment que le personnalisateur de thème est un premier pas en avant vers l’intégration de nouvelles fonctions d’édition similaires à Squarespace. Est-ce que quelqu'un connaît des projets d'extinction de l'API de paramètres en faveur du personnalisateur de thème? Devrions-nous tous nous rapprocher lentement ou préférerions-nous nous en tenir à l’API des paramètres? Peuvent-ils vivre côte à côte et, le cas échéant, quelle serait la répartition des responsabilités?

settings-apitheme-customizer
20
Dre

La prémisse de la question est imparfaite. La API Customizer n’est pas une API options, mais plutôt une (options prévisualisation). L’API Customizer repose soit sur la Paramètres API ou API Theme Mods pour enregistrer les contrôles des paramètres existants ajoutés via l’une des deux API.

Le personnaliseur ne définit pas et ne peut pas définir/enregistrer nouveau paramètres qui n'ont pas encore été enregistrés via l'API Settings ou l'API Theme Mods. En d'autres termes: L'API Customizer n'est pas une API permettant d'ajouter des paramètres directement à ou d'extraire des paramètres directement à partir de la base de données; En revanche, l'API Customizer utilise _ l'API Paramètres ou l'API Thème Mods pour enregistrer les paramètres dans la base de données ou pour en extraire des paramètres.

Ainsi, l’API Customizer n’est pas une alternative à l’un des existants API d’options; c'est plutôt une alternative pour un page des paramètres. Le Customizer ne se soucie pas de savoir si un paramètre est enregistré via l'API Paramètres ou l'API Thème Mods. De tels paramètres peuvent être combinés et mis en correspondance dans le Customzer. En fait, dans la plupart des cas, ces paramètres sont sont combinés et mis en correspondance: l'en-tête personnalisé et l'arrière-plan personnalisé sont des mods de thème, et le titre et la description du site sont des paramètres de l'API.

Pour comprendre exactement comment les paramètres et les contrôles sont enregistrés via l'API Customizer, je vous recommande de lire les excellents tutoriels d'Otto:

La question n'est donc pas (ou/ou} _ par rapport aux API spécifiées. Les questions appropriées {ou/ou} seraient:

  • Utilisez soit le API de paramètresou le API Thème de Mods - pour enregistrer les paramètres existants pour prévisualiser via l 'API Customizer
  • Utilisez soit le API Customizerou a page des paramètres de thème personnalisé pour autoriser l'utilisateur à configurer les options de thème.
21
Chip Bennett

Aussi simple que parfois les choses peuvent l'être: L'API de configuration est pas le personnalisateur de thème. Les deux sont des choses différentes pour des tâches différentes.

API de paramètres

Vous êtes soit en train d'écrire un plugin ou vous avez un thème qui n'a pas d'options et qui n'a pas besoin de retour visuel? Aller avec cette option.

Personnalisateur de thème

Vous devez avoir des options qui ont un impact visuel que l'utilisateur devrait pouvoir voir? Aller avec cette option.

5
kaiser