|
|
|
list
|
encontrar los elementos y reproducirlos con el fragmento de código HTML dado
<nv object="list" source="item" items="10" paginator="true" order="newest">
<span class="title">
<nvlist source="item" value="title">
</span>
(más HTML y etiquetas nvlist)
</nv>
<nv object="list" source="rss" items="entries_per_page" url="http://www.navigatecms.com/rss">
<a href="{{nvlist value='url'}}" target="_blank">
{{nvlist value='title'}}
</a>
</nv>
<nv object="list" source="mywebsite" items="5" custom_source="true">
{{nvlist source='item' value='date'}}
</nv>
<nv object="list" source="block" items="5" order="random">
{{nvlist source='block' value='property' property='selected_video'}}
</nv>
|
- source
- [ item | structure | comment | website_comments | block | block_group | gallery | rss | twitter ]
- tipo de los elementos de la lista
- items
- número de elementos a mostrar (0 => todo)
nombre de la propiedad que indica cuantos elementos mostrar
- paginator
- true
classic
- navegar a través de lista mediante un paginador numérico
- false (opción por defecto)
- prev/next
- mostrar paginador sencillo: botones anterior y siguiente
- first/prev/next/last
- mostrar paginador sencillo ampliado: botones anterior y siguiente junto a ir al principio, ir al final
- prev/central/next
- mostrar página anterior, siguiente y centrales (4 5 *6* 7 8)
- first/prev/central/next/last
- mostrar página anterior, siguiente, centrales y primera/última (Primera Anterior 4 5 *6* 7 8 Siguiente Última)
- all_pages
- mostrar enlaces a todas las páginas de la lista
- paginator_prev
paginator_next
paginator_first
paginator_last
paginator_etc
- texto o código de cadena (en el diccionario) usada para los enlaces especiales en el paginador
- paginator_tag_id
- id del tag html tag (sin #) donde colocar el código generado por el paginador (sólo puede haber un paginador en la página)
- type
- código del tipo de bloques a recuperar
- categories
- [ (vacío) | all | IDs | property_id | nvlist_parent ]
- si vacío, toma la categoría actual como origen de los resultados
- "all" fuerza buscar resultados en todas las categorías de la web
- IDs separados por comas de las categorías dónde buscar resultados
- nombre de propiedad donde hay definida una selección de categorías
- si estamos definiendo una lista dentro de otra lista, usar la categoría actual de la lista padre
- children
- true
- incluye las categorías e hijos de los elementos de la estructura
- false
- sólo buscar en las categoría dadas
- only
- no buscar en las categorías dadas, sólo en sus hijos
- (number)
- buscar hasta un cierto número de subniveles
- order
- [ priority | newest | oldest | future | alphabetical | reverse_alphabetical | random | rating | votes | views | comments | hierarchy_newest ]
- ordenar resultados usando un criterio
- embedded
- [ false | true ]
- buscar sólo elementos no incrustados ("ruta propia") (por defecto) o sólo elementos incrustados (sin ruta asignada)
- exclude
- IDs del resultado de los elementos a olvidar, separados por comas
(utilizar "current" para eliminar el elemento de la página actual)
- templates
- recuperar sólo elementos que usen ciertas plantillas (IDs separados por comas)
- filter
- aplicar filtros especiales de búsqueda
- menu
- cuando source="structure" quedarse sólo con los elementos visibles en el menú
- (matriz de objetos json)
- cuando source="item", añadir condiciones en la consulta de búsqueda; sólo comillas simples por favor, ejemplo:
filter="[{'property.entry_type': 'image'}, {'id': { 'gte': 10 }}, {'date_to_display': {'lte': '$filter_date'}}, {'property.entry_featured_object_inside': {'in': [0, 1]}}]"
comparadores disponibles: eq, neq, lt, lte, gt, gte, in, nin (no entre), has, hasnot (no tiene)
usa property.nombre_propiedad para filtrar por valor de propiedad
campos básicos de elementos:: id, date_to_display, author, score, votes
precede un carácter de dólar si quieres usar un valor enviado en la petición, por ejemplo, si la URL tiene ?q=45, usa '$q' para usar ese valor en el filtro de consulta
- delayed
- [ true | false ]
- retrasar el procesamiento de nvlist hasta finalizar el tratamiento de los demás tags nv
(por defecto los tags nvlist se tratan antes que cualquier otro)
- custom_source
- [ true | false ]
- utilizar un widget-defined-function como fuente
(recuerda establecer nv list "source" a su nvweb_SOURCE_list)
- url
- url absoluta de la fuente (sólo para source="rss") o
- nombre de la propiedad que contiene la URL de la fuente
- username
- leer los tweets de este usuario (sólo para source="twitter")
- cache
- segundos para mantener el último twitter / rss consulta (sólo para las modalidades "twitter" y "rss")
(por defecto: 3600 segundos)
|
search
|
encontrar elementos que tengan un texto determinado y mostrarlos con el fragmento de código HTML dado
<nv object="search" request="search-field" items="10" paginator="true" order="rating">
<a href="{{nvlist source='item' value='url'}}">
<nvlist source="item" value="title">
</a>
<br>
</nv>
|
- request
- nombre del $ _REQUEST ['campo'], que contiene el texto a buscar
- items
- número de elementos a mistrar (0 => todos)
- paginator
- true
classic
- navegar a través de lista mediante un paginador numérico
- false (opción por defecto)
- prev/next
- mostrar paginador sencillo: botones anterior y siguiente
- first/prev/next/last
- mostrar paginador sencillo ampliado: botones anterior y siguiente junto a ir al principio, ir al final
- prev/central/next
- mostrar página anterior, siguiente y centrales (4 5 *6* 7 8)
- first/prev/central/next/last
- mostrar página anterior, siguiente, centrales y primera/última (Primera Anterior 4 5 *6* 7 8 Siguiente Última)
- all_pages
- mostrar enlaces a todas las páginas de la lista
- paginator_prev
paginator_next
paginator_first
paginator_last
paginator_etc
- texto o código de cadena (en el diccionario) usada para los enlaces especiales en el paginador
- paginator_tag_id
- id del tag html tag (sin #) donde colocar el código generado por el paginador (sólo puede haber un paginador en la página)
- categories
- [ (vacío) | all | IDs | property_id | nvlist_parent ]
- si vacío, toma la categoría actual como origen de los resultados
- "all" fuerza buscar resultados en todas las categorías de la web
- IDs separados por comas de las categorías dónde buscar resultados
- nombre de propiedad donde hay definida una selección de categorías
- si estamos definiendo una lista dentro de otra lista, usar la categoría actual de la lista padre
- request_categories
- nombre del parámetro enviado por un formulario y que indica la lista de categorías donde filtrar; las categorías indicadas deben formar parte de las seleccionadas por los parámetros categories + children, de lo contrario se descartarán
- children
- true
- incluye las categorías e hijos de los elementos de la estructura
- false
- sólo buscar en las categoría dadas
- only
- no buscar en las categorías dadas, sólo en sus hijos
- (number)
- buscar hasta un cierto número de subniveles
- order
- [ priority | newest | oldest | future | alphabetical | reverse_alphabetical | random | rating | votes ]
- ordenar resultados por una propiedad particular
- no_results_found
- texto or código de cadena (en el diccionario) usado cuando la búsqueda no encuentra resultados (asignar no_results_found="" si no se quiere mostrar ningún mensaje)
- delayed
- [ true | false ]
- retrasar el procesamiento de nvsearch hasta finalizar el tratamiento de los demás tags nv
(por defecto los tags nvsearch se tratan antes que cualquier otro)
|
<nvlist source="..." />
source='...' />
|
item
|
mostrar el valor de un elemento o propiedad
<nvlist source="item" value="title" />
<nvlist source="item" value="section" section="main" />
<nvlist source="item" value="score" />
<nvlist source="item" value="property" property="Main image" width="300" height="200" border="false" />
|
- id
- identificador numérico del elemento
- slug
- identificador textual basado en la ruta del elemento (útil para IDs en HTML)
- title
- título del elemento
- length
- muestra un máximo de caracteres (seguido por …)
- date
- fecha de publicación del elemento
- section / content
- sección del contenido de un elemento
- section
- código de la sección del elemento
- length
- muestra un máximo de caracteres (seguido por …)
- allowed_tags (al usar el parámetro "length")
- nombres de tag separados por comas que no se eliminarán del contenido, por ejemplo: "a,br"
- comments
- número de comentarios publicados asociados al elemento
- author
- nombre del usuario de Navigate CMS que creó el elemento
- gallery
- genera una galería de imágenes del elemento
definir las propiedades usando los mismos atributos que en gallery (nvweb)
- image / photo
- muestra la url de la primera imagen de la galería del elemento
- path / url
- url relativa del elemento (tal y como se ha introducido en Navigate CMS para ese idioma)
- score
- puntuación dada para un elemento
usar algunos atributos como en votes (nvweb) (mode="score" implícito)
- views
- número de veces que se ha visto este contenido
- votes
- número de usuarios web que han votado ese elemento
- tags
- lista de etiquetas asignadas al elemento para el idioma activo
admite los mismos parámetros que el nvweb content mode="tags"
- property
|
product
|
mostrar el valor de un elemento o propiedad
<nvlist source="product" value="title" />
<nvlist source="product" value="section" section="main" />
<nvlist source="product" value="score" />
<nvlist source="product" value="property" property="Main image" width="300" height="200" border="false" />
<nvlist source="product" value="price" />
<nvlist source="product" value="stock" out_of_stock="Not available!" />
<nvlist source="product" value="size" return="height" />
|
- id
- identificador numérico del producto
- slug
- identificador textual basado en la ruta del producto (útil para IDs en HTML)
- title
- nombre del producto
- length
- muestra un máximo de caracteres (seguido por …)
- date
- fecha de publicación del producto
- section / content
- sección de contenido de un producto
- section
- código de la sección del producto
- length
- muestra un máximo de caracteres (seguido por …)
- allowed_tags (al usar el parámetro "length")
- nombres de tag separados por comas que no se eliminarán del contenido, por ejemplo: "a,br"
- comments
- número de comentarios publicados asociados al producto
- author
- nombre del usuario de Navigate CMS que creó el producto
- gallery
- genera una galería de imágenes del producto
definir las propiedades usando los mismos atributos que en gallery (nvweb)
- image / photo
- muestra la url de la primera imagen de la galería del producto
- path / url
- url relativa del producto (tal y como se ha introducido en Navigate CMS para ese idioma)
- score
- puntuación dada para un producto
usar algunos atributos como en votes (nvweb) (mode="score" implícito)
- views
- número de veces que se ha visto este producto
- votes
- número de usuarios web que han votado este producto
- tags
- lista de etiquetas asignadas al producto para el idioma activo
admite los mismos parámetros que el nvweb content mode="tags"
- property
- size
- devolver el tamaño del producto, por defecto es "ancho x alto x profundo unidad"
- separator
- cadena usada como separación para cada dato (por defecto " x ")
- return
- [ width | height | depth | unit ]
- weight
- devolver el peso del producto, por defecto "valor_peso unidad_peso"
- stock
- devolver la cantidad de stock disponible para el producto, o una cadena del tema para enmascarar el número
- in_stock
- etiqueta del diccionario del tema cuando el producto está "en stock"
- out_of_stock
- etiqueta del diccionario del tema cuando el producto está "sin stock"
- price
- devolver el precio actual del producto
- return
- [ (empty) | value | internal | currency ]
ejemplo para un precio de 12,34 euros
(empty): 12,34 €
value: 12,34
internal: 12.34
currency: €
- old_price
- devolver el precio anterior del producto (ignorando cualquier oferta actual);
si precio_anterior = precio_actual, entonces esta llamada no devuelve nada
- return
- [ (empty) | value | internal | currency ]
- tax
- devolver los impuestos a aplicar para el producto
- return
- [ (empty) | value | amount ]
ejemplo para un precio de $10 + 10% impuestos
(empty): 10 %
value: 10 %
amount: $ 1
- tax_free
- etiqueta del diccionario del tema para usar cuando el producto está libre de impuestos
- tax_included
- etiqueta del diccionario del tema para usar cuando el producto ya tiene los impuestos incluidos
|
comment
|
mostrar la propiedad de un comentario
<nvlist source="comment" value="avatar" size="32" default="/img/default_avatar.png" />
|
- id
- username
- autor del comentario (nombre o alias del usuario)
- avatar
- avatar del usuario web
- size
- tamaño en píxeles (cuadrado, "32" => 32x32)
- default
- si el autor de un comentario no es un usuario registrado o es un usuario sin avatar, se muestra un avatar por defecto
opciones:
- ID numérico del fichero de la imagen en Navigate CMS
- url absoluta de una imagen (http://...)
- ruta relativa para una imagen en la carpeta del tema de la web
- none (no mostrar ninguna imagen)
- border
- [ true | false ]
- redimensionar el avatar dejando un borde transparente (por defecto) o escalar y cortar la imagen
- class
- nombre de la clase a añadir al tag img del avatar
- linked
- [ false | true ] añadir un enlace al sitio web del usuario registrado en los elementos avatar y nombre de usuario
- gravatar_default
- [ blank | none | identicon | mm | monsterid | wavatar | retro | 404 ]
- cómo mostrar el avatar por defecto cuando el usuario registrado no tiene ninguno asignado; ver ejemplos
- message
- texto del comentario
- length
- máximo número de caracteres a mostrar (seguidos de …)
- date
- item_title
- título del elemento asociado al comentario
- item_url
- ruta del elemento asociado al comentario
- reply_to
- id del comentario al que éste está respondiendo
- depth
- nivel de profundidad del comentario en la jerarquía (empieza en 0)
- webuser_comments
- número de comentarios escritos por el autor de este mensaje (¡sólo funciona para usuarios registrados!)
- property
|
structure
category
|
devuelve una propiedad de una categoría
<nvlist source="structure" value="title" />
{{nvlist source='structure' value='id'}}
<nvlist source="structure" value="property" property="background_color" />
|
- id
- identificador numérico de la categoría
- title
- título del elemento de la estrucutura
- slug
- nombre simplificado basado en el título
- url / path
- ruta relativa del elemento de la estrucutura
- count
- número de hijos que tiene la categoría
- property
- muestra una propiedad del elemento de la estructura
usar los mismos atributos que en properties (nvweb)
|
gallery
|
devuelve una propiedad de un elemento de la galería
<nvlist source="gallery" value="thumbnail" width="120" border="true" />
{{nvlist source='gallery' value='url'}}
{{nvlist source='gallery' width="200" height="150" border="false"}}
|
- thumbnail
- genera un tag img para la miniatura; acepta algunos parámetros: width, height, border
- url / path
- ruta absoluta a la imagen completa
- (empty) / no value
- genera un tag "<a>" con la imagen completa como enlace y un tag "img" para la miniatura
acepta algunos parámetros: width, height, border
|
block
|
generar etiquetas HTML basadas en el contenido de un bloque y sus propiedades
<nvlist source="block" value="title" />
<nvlist source="block" value="property" property="selected_video" />
|
- id
- identificador numérico del bloque
- title
- block
- contenido del bloque (trigger) y su acción (enlace) (puede variar según lo escogido por el usuario dentro de Navigate CMS)
puedes especificar atributos extra que serán procesados al renderizar el contenido: width, height, border, wrapper, wrapper_class...
si el bloque debe mostrar una imagen, con return="url" se devolverá la ruta, no el tag <img>
- content
- contenido puro del bloque, sin la acción (puede variar según lo escogido por el usuario dentro de Navigate CMS)
puedes especificar atributos extra que serán procesados al renderizar el contenido: width, height, border, wrapper, wrapper_class...
si el bloque debe mostrar una imagen, con return="url" se devolverá la ruta, no el tag <img>
- url / path
- enlace al que el usuario ha indicado que apunte el bloque
- target
- modificador de acción de destino (devuelve "_self" o "_blank")
- property
- poll_answers
- renderiza los resultados de una encuesta (sólo para bloques tipo "poll")
- separator
- añade la cadena indicada entre cada enlace a mostrar (sólo para bloques tipo "links")
- wrapper
- [ ul ]
- formatea los enlaces en un cierto tipo de estructura (sólo para bloques tipo "links")
ej. <ul><li>enlace 1</li><li>enlace 2</li><ul>
- wrapper_class
- asigna una clase en el tag que agrupa los enlaces
ej. <ul class="tu_clase">
|
block_group
|
carga todos los bloques de un grupo y los muestra según los condicionales
<nv object="list" source="block_group" type="sidebar">
<nvlist_conditional by="block" type="sidebar_blog_archive">
[...]
</nvlist_conditional>
<nvlist_conditional by="block" type="sidebar_blog_archive">
[...]
</nvlist_conditional>
</nv>
|
|
block_link
|
devuelve datos sobre cada enlace de un bloque con el contenido de tipo "enlaces"; se usa sólo dentro de otra lista que cargue el bloque
<nv object="list" source="block" type="social_links">
<nv object="list" source="block_link">
<div class="social_link">
<a href="{{nvlist source='block_link' value='url'}}"
target="{{nvlist source='block_link' value='target'}}"
title="{{nvlist source='block_link' value='title'}}">
<i class="fa {{nvlist source='block_link' value='icon'}}"></i>
</a>
</div>
</nv>
</nv>
|
- id
- identificador de posición del enlace (empieza con el cero)
- title
- título asignado al enlace
- url / path
- target
- modificador de acción de destino (devuelve "_self" o "_blank")
- icon
- clase de icono asignada al enlace
|
block_type
|
mostrar algún valor relacionado con el tipo de bloque que se está procesando (se usa principalmente al procesar una nvlist de tipo "block_group")
<nvlist source="block_type" value="title" />
|
- title
- devuelve el título asignado a esa zona de tipo de bloque
|
position
|
muestra un valor relacionado con la posición de la fila de resultado que se está tratando en ese bucle
<nvlist source="position" value="numeric" />
<nvlist source="position" value="alphabetic" absolute="true" />
|
- value
- numeric mostrar posición en número cardinal
- alphabetic mostrar posición con letras (a, b, c... luego aa, ab, ac... aaa, aab, aac...)
- absolute
- [ false | true ] si es "true", se tiene en cuenta la posición con respecto al paginador; desactivado o "false" sólo tiene en cuenta la posición en la página actual
|
query
|
muestra un valor de la columna de resultados (sólo para "custom_source")
<nvlist source="query" value="column_name" />
|
|
<nvlist_conditional by="..."> [html] </nvlist_conditional>
|
position
|
añade el código HTML sólo si cuando se trate una cierta posición de la lista
<nvlist_conditional by="position" each="4"><div class="separator"></div></nvlist_conditional>
<nvlist_conditional by="position" position="last"><div class="pre-footer"><hr /></div></nvlist_conditional>
<nvlist_conditional by="position" range="1-3"><div class="destacado"></div></nvlist_conditional>
|
- position
- mostrar el código html cuando se trate el elemento en la posición especificada
- first
- primer elemento de la lista en una página
- last
- último elemento de la lista en una página
- not_first
- no es el primer elemento de la lista en una página
- not_last
- no es último elemento de la lista en una página
- (número)
- posición concreta en la lista de elementos
ej.: mostrar el HTML cuando se trate el tercer elemento (position="3")
- each
- añadir el código HTML en cada múltiplo del entero dado (excluyendo el primer elemento)
ej.: mostrar un separador cada 4 elementos
- range
- procesar el código HTML sólo para un cierto rango de elementos (definidos por su posición)
- ej.: range="1-3" (sólo los tres primeros elementos)
|
template
templates
|
añadir el código HTML sólo cuando el elemento a mostrar tenga asociada cierta plantilla
<nvlist_conditional by="template" template="blog_entry"><div class="entry-author">{{nvlist source='item' value='author'}}</div></nvlist_conditional>
<nvlist_conditional by="templates" templates="blog_entry,blog_entry_fullwidth"><div class="entry-author">{{nvlist source='item' value='author'}}</div></nvlist_conditional>
|
- template / templates (los dos son válidos)
- identificadores de las plantillas que cumplen la condición, pueden ser varias separadas por comas (sin espacios)
|
access
|
añadir el código HTML dependiendo del nivel de acceso del visitante
<nvlist_conditional by="access" access="signed_in"><div class="webuser_usename">Rate this content!</div></nvlist_conditional>
|
- everyone
- mostrar ese contenido a todos
- signed_in
- mostrar ese contenido sólo cuando lo esté viendo un usuario registrado
- not_signed_in
- mostrar ese contenido sólo cuando lo esté viendo un usuario NO registrado (ni identificado)
- webuser_groups
- mostrar ese contenido sólo cuando lo esté viendo un usuario que forme parte de un grupo de usuarios
- navigate_user
- mostrar el contenido sólo cuando lo esté viendo un usuario identificado en navigate cms
|
block
|
al procesar un grupo de bloques, añadir el código HTML indicado dependiendo del tipo de bloque
<nvlist_conditional by="block" type="blog_archive"><[blog archive nvtag]</nvlist_conditional>
|
- type
- código del tipo de bloque
- linked
- [true | false]
- añadir el código HTML dependiendo de si el bloque tiene definido un enlace a seguir al hacer clic
|
block_type
|
al procesar un grupo de bloques, añadir el código HTML indicado si nos encontramos con una zona determinada de tipo de bloques
<nvlist_conditional by="block_type" type="sidebar_content"><[fragmento opcional]</nvlist_conditional>
|
- type
- código del tipo de bloque
|
gallery
|
añadir el código HTML dependiendo de si el contenido tiene una galería o no
<nvlist_conditional by="gallery" empty="false"><[código html galería activada]</nvlist_conditional>
|
|
tags
|
añadir el código HTML dependiendo de si el contenido tiene etiquetas o no
<nvlist_conditional by="tags" empty="false"><[código html cuando hay etiquetas]</nvlist_conditional>
|
|
structure
|
añadir el fragmento dependiendo de si la categoría a tratar es visible en el menú
<nvlist_conditional by="structure" show_in_menus="true"><[código html o nv tags]</nvlist_conditional>
|
|
comment
|
añadir el fragmento de código dependiendo de si el comentario en esta iteración cumple la condición
<nvlist_conditional by="comment" check="website" empty="false"><[código html]</nvlist_conditional>
|
- check
- website
- el comentario (o su autor) ha dejado una ruta a un sitio web
- empty
- [ true | false ]
- comprueba si el valor indicado en check está vacío o no
|
query
|
añadir el fragmento sólo cuando el resultado de la consulta SQL satisface cierta condición
<nvlist_conditional by="query" check="field" field="fieldname"><div class="special-field">{{nvlist source='query' value='fieldname'}}</div></nvlist_conditional>
<nvlist_conditional by="query" check="field_range" field="distance" max="10000"><div class="distance">{{nvlist source='query' value='distance'}} meters</div></nvlist_conditional>
|
- check
- field
- comprueba si la consulta ha devuelto un valor para el campo/columna especificado en el atributo "field"
- field_range
- comprueba si el valor de "field" devuelto por la consulta se encuentra entre los valores de "min" y "max" (opcionales)
|
property
|
añadir el código HTML sólo cuando una propiedad tiene un valor concreto
<nvlist_conditional by="property" property_id="blog_entry_type" property_value="video"><div class="video"></div></nvlist_conditional>
<nvlist_conditional by="property" property_name="mostrar_autor" property_value="si"><div class="entry-author">{{nvlist source='item' value='author'}}</div></nvlist_conditional>
<nvlist_conditional by="property" property_name="fecha_del_evento" property_compare="gt" property_value="today"><div>evento futuro</div></nvlist_conditional>
|
- property_id / property_name (los dos son válidos)
- el nombre de la propiedad a comprobar
- property_empty
- [ true | false ]
- en vez de comparar por valor, comprobar si la propiedad está vacía o no
- property_value
- el valor que debe estar asignado a la propiedad
- today: comprueba si el valor de la fecha de la propiedad es el día de hoy (00-24h)
- property_compare
- especifica cómo comparar el valor real con el indicado (en "property_value") para determinar la validez del condicional
- eq or = (por defecto)
- neq or !=
- gt or >
- gte or >=
- lt or <
- lte or <=
|
Chuleta v2.5