Guía de herencia
La herencia se introdujo en Gantry 5.3. La mayor parte del contenido discutido en esta sección de la documentación solo se aplicará a sitios web que ejecuten Gantry 5.3+.
En esta guía, revisaremos cómo funciona la herencia en Gantry 5. La herencia es esencialmente la capacidad de que un esquema herede atributos, partículas y configuraciones de diseño de otro. Esta guía se centrará principalmente en cómo funciona la herencia en relación con el Gestor de Diseño.
Sin embargo, para entender la herencia, primero desglosaremos qué es y cómo puedes usar el sistema de herencia de Gantry 5 para hacer que la creación y administración de tu sitio web sea increíblemente fácil.
Entendiendo la Herencia
Para comenzar, revisemos la jerarquía básica de herencia tal como existe en el nivel superior de Gantry 5. El Esquema Base actúa como el valor predeterminado global para cualquier sitio web de Gantry. Aquí es donde se configuran el estilo global, los valores predeterminados de las partículas, las configuraciones de página y las opciones de diseño. El esquema base establece el valor predeterminado, y cada esquema por debajo de él hereda o cambia estas configuraciones.
Las reglas de herencia pueden aplicarse a muchas cosas diferentes. Por ejemplo, puedes heredar lo siguiente:
- El diseño completo de un esquema a otro.
- Los atributos de una sección de un esquema a otro.
- Los elementos hijos de una sección (partículas) de un esquema a otro.
- Los atributos de una partícula de un diseño de un esquema a otro.
- Las configuraciones de bloque de una partícula de un esquema a otro.
- Los atributos de un átomo de un esquema a otro.
El estilo y los valores predeterminados de partículas de tu sitio se heredan naturalmente del esquema base y se modifican desde los paneles de administración del esquema hijo.
Gantry no admite herencia anidada. Por ejemplo, si ya estás heredando secciones en un esquema, la herencia de esquema completo no sobrescribirá estas secciones heredadas individualmente. Esas secciones seguirán heredando de su esquema asignado originalmente.
Herencia de Diseño
No puedes configurar la herencia activa para un esquema completo, a menos que crees un nuevo esquema duplicándolo y no cambies absolutamente nada en él. Pero, si deseas vincular tu diseño a otro esquema por completo, puedes hacerlo muy fácilmente.
Puedes, si lo deseas, heredar o clonar un diseño completo de un esquema a otro. Esto es útil si deseas heredar varias secciones y/o partículas de otro esquema y no quieres tener que recrear todos estos elementos individualmente. Hacer esto creará herencia en cada sección y partícula. Por supuesto, puedes deshabilitar manualmente la herencia y/o eliminar partículas individuales después de configurarlo.
Simplemente selecciona el botón Cargar en el Gestor de Diseño para el esquema al que deseas heredar el diseño, luego selecciona Esquemas y activa la opción Heredar todas las secciones e hijos del esquema seleccionado y elige el esquema del que deseas heredar el diseño. Esto activará la herencia para todas las secciones y partículas de ese esquema.
Puedes eliminar manualmente la herencia de secciones y/o partículas individuales después de hacer esto, deshabilitándola desde las configuraciones de la sección individual y luego desde las partículas.
Herencia de Secciones
Las secciones individuales pueden ser objeto de herencia. Esto incluye tanto sus atributos de sección, incluidos el diseño de la sección, la clase CSS y los atributos de etiquetas, como los elementos hijos de las secciones, que incluyen partículas, así como sus posiciones de fila y configuraciones de ancho.
Puedes acceder a las configuraciones de herencia de una sección seleccionando su ícono de configuración y luego la pestaña Herencia. Aquí puedes configurar cómo la sección hereda información.
-
1234
- Modo: Te permite elegir entre clonar la sección de otro esquema como una copia única o heredar para sincronización.
- Esquema: Este menú desplegable te permite seleccionar un esquema del cual obtener los atributos y/o hijos de la sección.
- Atributos de Sección: Esta opción te permite heredar/clonar los atributos de una sección o configuraciones específicas de partículas.
- Hijos de Sección: Esta opción te permite heredar/clonar los hijos de una sección, incluidas partículas, sus posiciones, anchos, atributos y configuraciones de bloque.
Cuando heredas los hijos de una sección, estás importando las partículas de esa sección y configurándolas para que también hereden. Entonces, si más tarde decides eliminar los Hijos de Sección de las configuraciones de herencia de esa sección, las partículas permanecerán y seguirán heredando atributos y configuraciones de bloque del esquema original hasta que se desconecten y eliminen manualmente.
Si eliminas una partícula, cualquier sección que esté heredando los hijos de su sección tendrá la partícula eliminada también. Esto no ocurre si los Hijos de Sección están desactivados en las configuraciones de herencia de la sección.
Herencia de Partículas
Una partícula es esencialmente el elemento que se ve más afectado por la herencia. Se encuentra en el nivel más bajo del árbol de herencia y puede heredarse directamente o como parte de una sección o esquema.
Aquí tienes un desglose rápido de los diferentes niveles de herencia de una Partícula.
| Nivel | Descripción |
|---|---|
| Archivo YAML de Partícula | Cualquier valor predeterminado asignado en este archivo actúa como el valor predeterminado de nivel superior para la partícula. Estos valores predeterminados son reemplazados por cualquier cambio realizado en el esquema base o en otros esquemas. |
| Valores Predeterminados de Partícula del Esquema Base | Los cambios realizados en el panel de Valores Predeterminados de Partícula en el esquema base se convierten en valores predeterminados globales para el sitio. |
| Valores Predeterminados de Partícula en Esquemas No Base | El panel Valores Predeterminados de Partícula en este nivel establece los valores predeterminados de la partícula para ese esquema en particular, afectando solo a ese esquema. |
| Configuraciones de Partículas Individuales en el Gestor de Diseño, Editor de Menú, módulo o widget | Los cambios realizados en este nivel son las configuraciones sobrescritas para la partícula solo en esta instancia o en cualquier instancia directamente heredada. |
En resumen, la herencia de configuraciones de partículas sigue este orden: Archivo YAML de Partícula > Valores Predeterminados de Partícula del Esquema Base > Valores Predeterminados de Partícula del Esquema No Base > Instancia Individual, con cada paso heredando y/o sobrescribiendo configuraciones del anterior.
El panel de Valores Predeterminados de Partícula está siendo eliminado en los esquemas creados por usuarios ya que no es necesario bajo el nuevo sistema de herencia. Lo verás en el esquema base ya que te permitirá establecer valores predeterminados globales para la partícula. Sin embargo, el panel está oculto por defecto en cualquier esquema definido por el usuario, ya que la mayoría de los usuarios definirán partículas en un esquema individual a través del gestor de diseño la mayor parte del tiempo.
Si deseas acceder al panel Valores Predeterminados de Partícula para un esquema definido por el usuario, aún puedes hacerlo navegando al panel Valores Predeterminados de Partícula en el Esquema Base, luego seleccionando el esquema del usuario en el menú desplegable de esquemas. Inicialmente verás un aviso que te explicará por qué este panel está oculto y te dará la opción de acceder manualmente a él.
Configuración de Herencia de Partículas
La herencia puede configurarse para una partícula desde su ventana emergente de configuraciones. Puedes configurarlo desde la pestaña Herencia, que se encuentra a la derecha en la ventana de configuraciones de la partícula. La herencia de una partícula en Gantry 5 puede incluir cualquiera de los siguientes atributos de la partícula.
| Configuración | Descripción |
|---|---|
| Heredar atributos | Hereda los atributos de la partícula, incluidos su contenido y configuraciones. |
| Heredar bloque | Hereda las configuraciones del bloque de la partícula, incluidos la clase CSS, los atributos de la etiqueta, las configuraciones de ancho y más. |
| Eliminar partícula | Eliminará la partícula y, por lo tanto, las partículas que la hereden en el mismo nivel se eliminarán también. |
Una vez más, puedes eliminar o modificar atributos de una partícula, independientemente de que se herede en una sección.
Si se elimina la partícula fuente original, cualquier copia heredada activamente se convierte en un clon y se mantiene en sus respectivos diseños. Tendrás que eliminar la partícula de cada diseño para eliminarla por completo de tu sitio. Esto solo aplica para partículas heredadas individualmente, y no para secciones o esquemas completos.
Herencia de Átomos
La herencia de átomos funciona de manera muy similar a la herencia de partículas. Por ejemplo, si tienes un código de Google Analytics que quieres aplicar a varios esquemas específicos, pero no al esquema base, puedes hacerlo fácilmente a través de la configuración de herencia de los átomos.
A continuación, hemos creado un cuadro que facilita determinar en qué casos deberías usar la herencia para un átomo.
| Esquema Base | Esquema A | Esquema B | Esquema C | |
|---|---|---|---|---|
| Todos los esquemas usan la configuración base | Base | Predeterminado Base | Predeterminado Base | Predeterminado Base |
| Esquema A y B usan las mismas configuraciones no base | Base | Átomo Personalizado | Heredado del Esquema A | Predeterminado Base |
| Esquema A no usa el átomo, pero otros sí | Base | Átomo Eliminado | Predeterminado Base | Predeterminado Base |
| Solo Esquema B y C usan el átomo con las mismas configuraciones | Sin Átomo | Sin Átomo | Átomo Personalizado | Heredado del Esquema B |
Como ejemplo, crearemos un átomo en el Esquema A y haremos que ese átomo herede al Esquema B.
Primero, querrás crear el nuevo átomo. En nuestro ejemplo, crearemos un átomo de Google Analytics en el Esquema A. En este punto, el único esquema que se verá afectado por este átomo es el Esquema A.
Luego, cambiaremos al Esquema B y crearemos otro átomo de Google Analytics. Esta vez, en lugar de configurarlo, navegaremos a la pestaña Herencia y seleccionaremos Esquema A, el átomo Analytics, y activaremos los Atributos del Átomo para heredar tanto el átomo como sus atributos.
A continuación se muestra un desglose de las opciones en la pestaña Herencia.
-
1234
- Modo: Te permite elegir entre clonar el átomo desde otro esquema como una copia única o heredar para sincronización.
- Esquema: Este desplegable te permite seleccionar un esquema para obtener los atributos de tu nuevo átomo.
- Instancia de Átomo: Selecciona un átomo para heredar/clonar desde una lista de átomos del mismo tipo en el esquema seleccionado.
- Atributos del Átomo: Esta opción te permite heredar/clonar los atributos de un átomo.
Cómo Saber Qué Esquemas Están Heredando un Recurso
Si deseas saber qué esquemas están heredando una partícula, átomo o sección en particular, puedes hacerlo accediendo al elemento original y navegando a su pestaña de herencia. Esto te dará una lista de esquemas que actualmente están heredando ese elemento.