Agregando posiciones con Gantry

Gantry FramegorkSiguiendo la serie de tutoriales sobre Gantry, en esta oportunidad te presentamos una completa guía para agregar posiciones en tus templates basados en este potente Framework. Así vas a ampliar las posibilidades, logrando cualquier combinación posible.

Paso 1. Preparando todo

Determinar el nombre de la posición y lugar en la plantilla donde deseamos que se vea el nuevo "módulo". En nuestro ejemplo vamos a utilizar "ejemplo" como nombre de la posición.

Paso 2. Agregar la posición al archivo index.php

Abrimos el archivo index.php de la plantilla y vamos a donde queremos agregar la nueva posición. Vamos a usar la etiqueta $gantry  para hacer una llamada mediante el objeto displayModules (positionname, modulelayouttype, modulechromelayout).

Por ejemplo:

<div id="pos-ejemplo">
<?php echo $gantry->displayModules('ejemplo','standard','standard'); ?>
<div class="clear"></div>
</div>

La posición por el momento no funcionará, aparecerá después de haber configurado algunas cosas más sobre Framework. Hasta entonces todo va a lucir igual.

Paso 3. Agregar posición en el Framework Gantry

Abrimos el archivo templateDetails.xml dentro del directorio /templates y vamos a las "posiciones" donde están ya enumeradas todas las posiciones por defecto de Gantry. Y aquí tenemos que agregar el nombre de nuestra posición con el siguiente formato:

<position>ejemplo-a</position>
<position>ejemplo-b</position>
<position>ejemplo-c</position>
<position>ejemplo-d</position>
<position>ejemplo-e</position>
<position>ejemplo-f</position>
 
En el mismo archivo, más abajo vamos a buscar los parámetros ("params"). Aquí es donde todos los parámetros de la plantilla Gantry se definen, (como la posición de los módulos). Vamos hacia abajo hasta encontrar este código:
 
<param name="layouts" type="gspacer" default="" description="" label=" " glabel="LAYOUTS" />
 
Luego de esa línea es donde añadimos nuestras nuevas posiciones. Tenemos que añadir el bloque de XML siguiente para tener disponibles las opciones en el Administrador de plantillas:
 
<param name="examplePosition" type="positions" default="6,6" label="Label" description="Descripcion de la posicion">
<schemas>1,2,3,4,5,6</schemas>
<words>2,3,4,5,6,7,8,9,10</words>
</param>
 
Donde cada variable significa:
  • name - nombre de la posición + Posición
  • type - siempre debe ser "positions"
  • default - diseño por defecto para la "fila del módulo". Cualquier combinación de 12 separados por comas.
  • label - Etiqueta en el Administrador de plantilla de este módulo.
  • description - descripción que aparecerá en el administrador y que nos va a indicar para qué usar esta zona.

Paso 4. Asignar módulos

Las nuevas posiciones deberían estar disponibles en el gestor de módulos y los módulos pueden ahora ser asignados. Una vez asignados aparecerán en el sitio como cualquier otro módulo de Gantry.

Es bastante fácil de utilizar y nos permite armar grillas o diagramas de sitios sin fronteras, ya que podemos presentar casi cualquier combinación de filas y columnas con Gantry y ahora agregando esta posibilidad.
 
Espero les sea de mucha utilidad y en breve más ayuda sobre este tema. Dejen sus comentarios y aportes para mejorar el contenido y ver cuál será el próximo tutorial...
 
(Material traducido y adaptado de la documentación oficial de Gamtry)

 

Escribir un comentario


Código de seguridad
Refescar

You are here