Configuración API vs Personalizador de temas

¿Cuándo sería apropiado usar la API de configuración y cuándo sería mejor usar el personalizador de temas?

Después de haber buscado en Google toda la mañana, no he podido encontrar ninguna orientación bien considerada y reciente sobre este asunto. Si bien aún es pronto para decir, creo que el personalizador de temas es un primer paso sugerente para traer más funciones de edición tipo Squarespace . ¿Alguien sabe de algún plan para anular la configuración API en favor del personalizador de temas? ¿Deberíamos avanzar lentamente hacia él, o sería mejor seguir la configuración API? ¿Pueden vivir codo con codo y, de ser así, dónde radicaría la división de responsabilidades?

settings-api theme-customizer

— Dre
fuente

Respuestas:

La premisa de la pregunta es errónea. La API del personalizador no es una API de opciones , sino más bien una API de vista previa de opciones . La API del personalizador se basa en la API de configuración o en la API de Modificaciones de tema para registrar controles para la configuración existente agregada a través de cualquiera de las dos API.

El Personalizador no define ni registra nuevas configuraciones que aún no se han registrado a través de la API de configuración o la API de Modificaciones de tema. Dicho de otra manera: la API Customizer no es una API para agregar configuraciones directamente o para recuperar configuraciones directamente de la base de datos; más bien, la API del personalizador usa la API de configuración o la API de Modificaciones de tema para guardar la configuración en la base de datos o para recuperarla.

Por lo tanto, la API del personalizador no es una alternativa a una de las API de opciones existentes ; más bien, es una alternativa para una página de configuración . Al Personalizador no le importa si una configuración se registra a través de la API de configuración o la API de Modificaciones de tema, y dichas configuraciones se pueden mezclar y combinar en el Personalizador. De hecho, en la mayoría de los casos, tales configuraciones son mixtas y coincidentes: el encabezado personalizado y el fondo personalizado son Modificaciones de tema, y el Título y la Descripción del sitio son API de configuración.

Para comprender exactamente cómo se registran las configuraciones y los controles a través de la API Customizer, recomiendo leer los excelentes tutoriales de Otto:

Entonces, la pregunta no es o con respecto a las API especificadas. Apropian o / o preguntas serían:

Uso o bien la API de configuración o el tema de la API de Mods para registrar los ajustes existentes a través de la vista previa de la API Personalizador
Uso o bien la API Personalizador o una página de configuración de tema personalizado para permitir al usuario opciones de configuración del tema .

— Chip Bennett
fuente

Gracias chip. Todavía no te sigo al 100% , pero me has dado lo suficiente como para investigar el problema un poco más. Creo que mi confusión proviene de la superposición en la funcionalidad y la similitud en los nombres. ¿Existe una página que documente claramente los casos de uso (de una manera más abstracta) de las diferentes API? No he tenido mucha suerte mirando a través del códice; solo se centra en los aspectos básicos de la aplicación de la API.

— Dre

He agregado más, para tratar de explicar un poco más en profundidad. Consulte también, especialmente, los enlaces a los tutoriales de Otto's Customizer; Creo que ayudarán a aclarar las cosas.

— Chip Bennett

Usted señor es un caballero.

— Dre

Tan simple como las cosas a veces pueden ser: la API de configuración no es el Personalizador de temas. Ambas son cosas diferentes para diferentes tareas.

API de configuración

¿Estás escribiendo un complemento o tienes un tema que no tiene opciones que no necesiten ningún comentario visual? Ve con esta opción.

Personalizador de temas

¿Necesita tener opciones que tengan un impacto visual que el usuario debería poder ver? Ve con esta opción.

— emperador
fuente

Esta fue mi conclusión inicial. Sin embargo, existe una gran superposición funcional entre los dos, que es lo que lleva a la (s) pregunta (s) original (es). Además, la idea de dividir las opciones de tema en dos ubicaciones dependiendo de si son visuales o no me parece problemático desde el punto de vista de UX. Eso no quiere decir que no estoy de acuerdo contigo; Solo estoy solicitando opiniones en esta etapa. Todo el tema en sí es algo turbio. Quizás alguna orientación bien definida "desde arriba" sería beneficiosa. ¡Gracias por tu contribución!

— Dre

@Dre Supongo que lo malinterpretaste un poco: si tienes incluso una sola opción que necesita comentarios visuales, ve con ThemeCustomizer. Entonces, la regla general es: Tema -> Personalizador de temas | Complemento -> Configuración API.

— Kaiser

Como regla general, todas las opciones definidas por el tema deben tener un impacto de presentación . :) Dicho esto: la API de personalización requiere ya sea la API de configuración o el tema de Mods API para existir. La API de personalización no es una alternativa para una de esas dos API, sino una alternativa para una página de configuración de tema personalizada .

— Chip Bennett

¿Tienen algún problema de capacidad de respuesta con el personalizador? Me parece bastante temperamental en 3.5.1 y aún más en 3.6 (troncal). Encuentro que los botones de encabezado y cerrar / guardar a menudo simplemente no responden correctamente a los clics y a veces tengo que hacer clic en ellos varias veces (y más aún en el tronco). Esto está en FF y Chrome.

— 31 de

@ t31os Tuve este problema antes, pero sin coherencia. Pero no lo he intentado durante bastante tiempo. Sugeriría a console.log()todas sus acciones para que vea lo que se dispara y lo que interrumpe. La depuración de JavaScript no es fácil ...

— kaiser