Desarrolladores

Este capítulo documenta la superficie pública y estable de Fenómenus: el modelo de contenido, las claves meta que guardan precios y texto, los shortcodes y las etiquetas de combinación que usan las plantillas, los filtros disponibles para ampliar el comportamiento y las convenciones de las que dependen las herramientas.

Está escrito para desarrolladores que integran con un sitio Fenómenus: crear plantillas, ampliar archivos o leer datos de menús desde otro sistema.

En este capítulo

Tema Artículo
Tipos de contenido, taxonomías y cómo se relacionan Modelo de contenido
Dónde viven los precios Contrato de datos de precio
Dónde viven los datos de alérgenos Contrato de datos de alérgenos
Los shortcodes disponibles en el front end Shortcodes del front end
Plantillas de archivo y feed, y etiquetas de combinación Integración de plantillas
La navegación por categorías y su comportamiento Referencia de navegación por categorías
Ampliar archivos basados en carrusel Extensión del carrusel
Cómo empareja y escribe la importación masiva Contrato de importación de Excel
Qué produce el generador de QR Contrato de generación de QR
Qué consume y produce el generador de PDF Contrato de generación de PDF
Comportamiento multilingüe Integración de idiomas
Particularidades de POM Translate Compatibilidad con POM Translate
Comportamiento de la caché durante el trabajo masivo Estrategia de caché en operaciones masivas
Características de rendimiento Rendimiento
Capacidades y seguridad de las solicitudes Seguridad y capacidades

Qué es estable

Los identificadores siguientes forman parte del contrato público y es seguro depender de ellos:

  • los diez slugs públicos de tipos de contenido de menú;
  • la convención de taxonomía <post_type>_category;
  • las claves meta de precio;
  • los slugs de taxonomía allergen y featured;
  • los shortcodes documentados;
  • los filtros documentados.

Qué no es estable

Todo lo que no se documenta aquí: nombres de clases internas, el marcado de las pantallas de administración, los nombres de acciones AJAX, las rutas de hojas de estilo generadas y la estructura de los archivos de plantilla generados. Construye sobre la superficie documentada.

Las suposiciones de diseño que conviene conocer

El tema posee el registro. Fenómenus configura los tipos de contenido de menú, las taxonomías y los campos; el tema POM los registra. El código que se ejecute antes del registro no los verá.

Las categorías son la navegación. Cada tipo de menú tiene una taxonomía de categorías, ordenada por una posición de término almacenada, y ese orden dirige por igual los archivos, la navegación, los PDF y las listas de administración.

Los hechos se comparten, el texto se traduce. Los precios, alérgenos, imágenes, orden y estado se comparten entre todas las traducciones de un elemento; solo el texto es por idioma. Las integraciones deben leer los hechos desde cualquier traducción y esperar que coincidan.