^
 
referencia nv tags
objetos básicos widgets nvweb lista / búsqueda

<nv object="..." />

{{nv object='...'}}

root

url absoluta del sitio web <nv object="root" />  

dictionary

obtener una cadena traducida del diccionario del sitio web o tema <nv object="dictionary" id="1" default="Default text" />
<nv object="dictionary" id="signin" default="Sign in" />
  • id
    • ID numérico de la palabra en el diccionario
    • cadena que representa la palabra en el diccionario del tema
  • default
    • cadena por defecto usada cuando el ID no se encuentra
  • type
    • [ structure | item ]
      recuperar el título de una categoría o elemento comprobando el atributo id, que puede contener un ID numérico o el nombre de la propiedad que proporciona la relacion

url

URL relativa de un determinado elemento u opción de la estructura <nv object="url" />
<nv object="url" type="item" id="123" />
{{nv object='url' type='structure' id='12'}}
{{nv object='url' type='theme' id='search'}}
<nv object="url" type="item" id="123" lang="en" />
<nv object="url" type="structure" property="categoria_especial" />
  • (sin parámetros)
    • devuelve la url actual (sin variables)
  • type
    • [ item | structure | theme ] tipo de elemento para obtener su url
  • id
    • identificación numérica del elemento (si está vacío se utiliza el actual)
    • nombre de la plantilla (se buscará el primer elemento que la use) (sólo para type="theme")
  • property
    • ID of the property which contains the value needed to find the link (element ID or structure ID)
      (if property is given, "id" parameter is ignored)
  • lang
    • obliga a devolver una dirección URL en un determinado idioma,
      si está vacío se utiliza el actual

php

ejecuta algún código básico de PHP <nv object="php" code="date('Y/m/d H:i:s');" />
{{nv object='php' code='var_dump("test");'}}
  • code
    • código php a ejecutar

include

cargar una plantilla segmentada/parcial <nv object="include" id="8" />
<nv object="include" file="footer.nvt.html" />
  • id
    • ID numérico de la plantilla en Navigate CMS
  • file
    • nombre del fichero incluido en el tema usado en un sitio web

variable


constant

devolver el valor de una constante <nv object="variable" name="year" />
{{nv object='variable' name='structure'}}
<nv object="variable" name="lang_code" />
  • name
    • structure
      • recuperar el ID del elemento actual de la estructura
    • year
      • 4 dígitos del año en curso
    • website_name
      • nombre del sitio web
    • website_description
      • texto de descripción del sitio web
    • lang_code
      • código de 2 letras del idioma que se está mostrando

request

devolver el valor de un campo de formulario <nv object="request" name="email-address" />
  • name
    • nombre del campo enviado por un formulario (GET o POST)

theme

devolver un dato relacionado con el tema usado {{nv object='theme' mode='style'}}
<nv object="theme" mode="style" name="global" />
{{nv object='theme' mode='url'}}
  • url
    • ruta absoluta a la carpeta principal del tema
  • style
    • información sobre el estilo del tema aplicado en la web
      • (vacío)
        • internal codename of the style
      • name
        • global, color, (nombre del subestilo css definido en el tema)
          • ruta al fichero CSS correspondiente al subestilo aplicado
            ejemplo: { "blue": { global: "css/blue/global.css" } }

nvweb

ejecutar un widget de Navigate CMS o de un sitio web <nv object="nvweb" name="metatags" />
  • name
    • nombre del widget
referencia

nvajax

ruta absoluta del componente AJAX del tema <nv object="nvajax" />
  • navigate intentará ejecutar la función "nvweb_nombredeltema_nvajax", si existe

list


search

buscar elementos y mostrarlos con el fragmento de código HTML dado <nv object="list" items="10" paginator="true">html code</nv>
  • ten en cuenta que los objetos list, search y conditional son las únicas etiquetas nv que deben ser cerradas de forma completa (la forma corta no es válida)

referencia


<nv object="nvweb" name="..." />

{{nv object='nvweb' name='...'}}

archive

generar una lista de meses con el número de entradas publicadas en una categoría.

al hacer click el navegador lleva a una página habilitada para la búsqueda
<nv object="nvweb" name="archive" mode="month" search_page_type="theme" search_page_id="archive.nvt.html" />

{{nv object='nvweb' name='archive' mode='adaptive' categories='1,2,3' search_page_type='structure' search_page_id='99'}}
  • mode
    • adaptive
      • mostrar las entradas por mes o año/mes según el número de resultados
    • month
      • mostrar las entradas por mes
    • year
      • mostrar las entradas por año y mes
  • collapsed
    • [ false | true ]
      • para el modo "year", ocultar o no todos los meses, incluyendo los del año actual
  • categories
    • IDs de las opciones de la estructura donde buscar, separados por comas
      nombre de la propiedad donde la categoría está definida
      si está vacío sólo muestra la categoría actual
      • (sólo en éste caso, las subcategorías de cada opción se incluyen por defecto)
  • children
    • [ true | false ]
      • activado tendrá en cuenta las entradas en las subcategorías del punto de estructura actual
      • desactivado sólo tendrá en cuenta la categoría actual de la entrada
  • search_page_type
    • [ structure | item | theme ]
      • tipo de página donde está vinculada la página de búsqueda
  • search_page_id
    • id del elemento de la página de búsqueda (estrucutra o elemento) en Navigate CMS
    • nombre del archivo de la página de búsqueda incluido en el tema actual

blocks

generar una serie de bloques de un tipo determinado

muy útil para banners y barras laterales
<nv object="nvweb" name="blocks" type="header-banner" mode="random" number="1" />

{{nv object='nvweb' name='blocks' type='sidebar-widget' mode='ordered' zone='content'}}
  • type
    • código del tipo de bloque (dado en Navigate CMS o en un tema)
  • mode
    • ordered
      • muestra los bloques ordenados por prioridad (según el orden dado en Navigate CMS)
    • random
      • muestra los bloques en orden aleatorio
    • single
      • muestra sólo un bloque (necesita el atributo "id" del bloque)
  • number
    • número de bloques a mostrar
  • position
    • muestra un bloque determinado según su número de posición
      • (for mode="single" or mode="ordered" with number="1")
  • id
    • id numérico del bloque a mostrar en Navigate CMS
  • categories
    • forzar la recuperación de bloques asociados a ciertas categorías, sin importar la categoría de la página donde se cargan
      ejemplo: categories="13,34,56"
  • zone
    • [ block | title | content ]
      • block: genera el bloque completo (contenido+acción)
      • title: muestra el título del bloque
      • content: muestra sólo el contenido del bloque, sin la acción asignada
  • 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 (wrapper) tag que agrupa los enlaces (sólo para bloques tipo "links")
      ej. <ul class="tu_clase">

breadcrumbs

generar una secuencia de los enlaces de la categoría actual a la raíz <nv object="nvweb" name="breadcrumbs" />
{{nv object='nvweb' name='breadcrumbs' separator='&nbsp;&gt;&nbsp;'}}
<nv object="nvweb" name="breadcrumbs" separator=" - " from="1" />
<nv object="nvweb" name="breadcrumbs" separator="image" image="img/dot.png" />
  • separator
    • incluye un texto separador entre las secuencias de enlaces
      si el texto es "image", entonces se creará un tag img
      si el texto es "base64", se decodificará la cadena del atributo base64
  • image
    • ruta a la imagen usada como separador (necesita separator="image")
  • base64
    • código html codificado en base64
  • from
    • establece el primer nivel a mostrar (0 => raíz, 1 => primer nivel, etc.)
  • links
    • [ true | false ]
      • cada parte de la ruta es un enlace (por defecto) o sólo mostrar el texto

comments

componente para controlar todo lo relativo a los comentarios en una página web

también puedes usar <nv object="list" /> para mostrar los comentarios de forma completamente personalizada
<nv object="nvweb" name="comments" mode="process" alert_callback="alert" />

{{nv object='nvweb' name='comments' mode='reply'}}

<nv object="nvweb" name="comments" mode="comments" date_format="%d %B %Y %H:%M" avatar_size="48" order="newest" />

<nv object="nvweb" name="comments" mode="comments" order="hierarchy_oldest" />

{{nv object='nvweb' name='comments' mode='process' field-name='new-comment-name' field-email='new-comment-email' field-url='new-comment-url' field-message='new-comment-message' callback='comentario_mensaje_exito' callback_error='comentario_mensaje_error'}}
  • mode
    • process
      • comprueba si el visitante ha enviado un nuevo comentario, notificando el resultado
    • reply
      • genera un formulario del estilo "deja tu comentario" (detectando los usuario que están identificados)
    • comments
      • muestra todos los cometnarios relatios al elemento actual
  • date_format
    • formato de la fecha mostrada en los comentarios(PHP strftime)
  • avatar_size
    • tamaño en píxeles para los avatares de los usuarios web
  • order
    • [ oldest | newest | hierachy_oldest | hierarchy_newest ]
  • field-name, field-email, field-url, field-message,
    field-subscribe, field-reply_to
    • se usan para indicar el nombre de los campos que se envían (en el modo "process") con los datos de nombre, e-mail, sitio web, mensaje, el autor quiere recibir respuestas[valor=1], id del comentario al que responde el nuevo
      nota: para los usuarios identificados sólo es necesario mostrar el campo mensaje; utiliza <nv object="conditional" by="webuser" signed_in="false"> para ocultar los demás campos en tu formulario
  • field-properties-prefix
    • indica el prefijo de los campos enviados que contienen valores para los propiedades del comentario
      ejemplo: field-properties-prefix="comment-property-"; <input type="hidden" name="comment-property-rating" value="5" />
  • notify
    • cómo mostrar el resultado del proceso:
      • callback
        • (por defecto) llamar a una función javascript enviando como parámetro el texto del resultado
      • inline
        • incluir el texto en una etiqueta div (con la clase "comment-success" o "comment-error")
  • callback
    • llamar a una función después de tratar de insertar un nuevo comentario;
      la función tiene que aceptar un solo parámetro: un mensaje de texto (por defecto "alert")
  • callback_error
    • (tu propia función, p.e. "$.prompt", por defecto es "alert")
      • llama a tu propio callback cuando el comentario no se ha podido guardar, sólo necesita tratar un parámetro: el texto de error
        ej.: $.prompt(argv[0]);
        nota: si no especificas un "error_callback", se llamará al método especificado en "callback"
  • element
    • usado en llamadas PHP, elemento de contenido donde se incluye el comentario

conditional

aplicar cierta condición para incluir o no cierto código html; sólo se aplica al elemento actual de la página (NO listas) <nv object="conditional" by="property" property_name="post_type" property_value="video">
<span>título del vídeo:</span>
{{nv object='nvweb' name='properties' property='post_video' return='title'}}
</nv>
  • by
    • property
      • incluye el fragmento sólo si cierta propiedad del elemento tiene un cierto valor
    • template, templates
      • incluye el fragmento sólo si el elemento actual utiliza una cierta plantilla
    • webuser
      • incluye el fragmento sólo si un usuario web está identificado o no (necesita el atributo "signed_in")
    • comments
      • incluye el fragmento sólo si los comentarios están habilitados en este elemento (necesita el atributo "allowed")
    • language
      • incluye el fragmento sólo el idioma activo corresponde con el indicado en la condición (necesita el atributo "lang")
    • languages
      • incluye el fragmento sólo el número de idiomas activados en la web está entre el valor mínimo y máximo especificados
    • gallery
      • incluye el fragmento sólo si el contenido cumple cierta condición sobre su una galería (existente o min/max elementos)
    • section
      • incluye el fragmento sólo si cierta sección tiene contenido
    • tags
      • incluye el fragmento sólo si el contenido tiene etiquetas asignadas o no
    • access
      • incluye el fragmento dependiendo del nivel de acceso del visitante
  • scope
    • [ element | structure ]
      • al mostrar una página de una categoría de estructura, forzar a realizar las comprobaciones sobre el propio objeto de estructura (por defecto) o sobre el primer elemento asociado a esa categoría
  • property_name
    • nombre de la propiedad a comprobar
  • property_value
    • valor que debe tener la propiedad especificada en "property_name"
  • 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)
        • igual
      • neq or !=
        • distinto
      • gt or >
        • mayor que
      • gte or >=
        • mayor o igual que
      • lt or <
        • menor que
      • lte or <=
        • menor o igual que
  • property_empty
    • [ true | false ]
      • en vez de comparar un valor, comprobar si la propiedad está vacía o no
  • property_scope
    • [ element | structure | website ]
      • forzar la lectura de la propiedad en un objeto específico
  • section
    • código de la sección del elemento sobre la que realizar una comprobación
  • template
    • nombre o identificador numérico de la plantilla que debe usar el elemento
  • templates
    • lista de plantillas (separadas por comas) que puede usar un elemento para cumplir con la condición
  • signed_in
    • [ true | false ]
      • comprobar si el usuario web está identificado o no
  • allowed
    • [ true | false ]
      comprueba si el visitante actual tiene permiso para dejar comentarios en el elemento actual
  • categories
    • identificadores numéricos de las categorías (separadas por comas) donde buscar el primer elemento con el que se comprobará la condición
      (útil si la página actual no pertenece a un elemento concreto y se quiere definir un cierto origen)
  • order
    • [ newest | priority | oldest | future | alphabetical | reverse_alphabetical | random | rating | votes | views ]
      indica qué orden aplicar cuando se busca el elemento sobre el que comprobar la condición
  • lang
    • (código de idioma)
      indica qué idioma debe estar activo para cumplir la condición (para usar con by="language")
  • empty
    • [ true | false ]
      aplicar la condición sólo si el elemento está vacío o no (para usar con by="gallery", "tags" o "section")
  • min
    • (número)
      (by="languages") indica cuántos idiomas activados como mínimo debe tener la web para cumplir la condición
      (by="gallery") indica cuántas imágenes como mínimo debe tener la galería del elemento para cumplir la condición
      (by="comments") cuántos comentarios debe tener la entrada como mínimo
  • max
    • (número)
      (by="languages") indica cuántos idiomas activados como máximo debe tener la web para cumplir la condición
      (by="gallery") indica cuántas imágenes como máximo debe tener la galería del elemento para cumplir la condición
      (by="comments") cuántos comentarios debe tener la entrada como máximo
  • access
    • [ everyone | signed_in | not_signed_in | webuser_groups | navigate_user ]

contact

facilita el envío de e-mails de contacto en los formularios de los sitios web

los destinatarios se especifican en la configuración del sitio web dentro de Navigate CMS
<nv object="nvweb" name="contact" mode="send" fields="name,email,message" labels="Nombre,E-Mail,Mensaje" form="tipo_formulario=valor_unico" />

{{nv object='nvweb' name='contact' mode='send' fields='name,email,message' labels='Name,E-Mail,Message' notify='inline'}}

<nv object="nvweb" name="contact" mode="send" fields="name,email,message" labels="Name,E-Mail,Message" required="email,message" notify="$.prompt" />
  • mode
    • send
      • intenta enviar un e-mail de contacto (si el formulario ya se ha enviado)
  • fields
    • lista de los nombres de campos a tratar
  • labels
    • lista de los títulos de los campos a tratar
      Nota: pueden ser códigos de cadena del diccionario del tema
  • required
    • lista de los campos que no pueden quedar vacíos (opcional)
  • subject
    • define el asunto del mensaje (el nombre del sitio web se añade al principio)
  • form
    • enviar el email sólo si se cumple la condición "nombre_campo=valor_campo"
      (útil si tienes varios formularios que usen el webget contact en una página)
      ej.: <input type="hidden" name="tipo_formulario" value="valor_unico" />
  • notify
    • alert
      • mostrar un alert javascript
    • inline
      • devolver el resultado reemplazando la llamada al webget
    • (tu propia función, p.e. "$.prompt")
      • llamar a tu propio callback, sólo se envía un parámetro: el texto del resultado
        ej: $.prompt("Mensaje enviado correctamente.");
  • error_callback
    • (tu propia función, p.e. "$.prompt")
      • llama a tu propio callback cuando el email no pudo ser enviado, sólo necesita tratar un parámetro: el texto de error
        ej.: $.prompt(argv[0]);
        nota: si no especificas un "error_callback", el método de "notify" que elijas se usará en su lugar

content

muestra secciones del contenido
(cuando la página actual pertenece a un elemento)
<nv object="nvweb" name="content" mode="body" />

{{nv object='nvweb' name='content' mode='date_post' format='%c'}}

<nv object="nvweb" name="content" mode="structure" return="title" />

{{nv object='nvweb' name='content' mode='title' function='strtolower'}}

  • mode
    • title
      • título del elemento
    • body
      • muestra la sección principal del elemento
    • section
      • muestra una sección del contentido del elemento
    • summary
      • muestra un fragmento del contenido principal del elemento
        • length
          • máximo de caracteres a mostrar (seguido por …)
    • date
      • fecha del elemento (asignada como fecha a mostrar)
    • date_created
      • muestra la fecha de creación del elemento
    • comments
      • muestra el número de comentarios pertenecientes al elemento
    • views
      • número de visualizaciones del elemento
    • author
      • nombre del usuario de Navigate CMS que creó el elemento
    • structure
      • devuelve algo sobre el padre del elemento (ten en cuenta el atributo "return")
    • tags
      • devuelve la lista de etiquetas asociadas al elemento
        • separator
          • texto usado como separador entre cada etiqueta
  • section
    • nombre de la sección del elemento a mostrar ("main", "custom_section_1", etc.)
  • function
    • función php que será llamada: strtoupper, ucfirst... (sólo para el modo título)
  • format
  • return
    • title
      • título de la opción de estructura a la que pertenece el elemento
    • path
      • ruta relativa a la opción de estructura a la que pertenece el elemento
    • action
      • acción de la opción de estructura a la que pertenece el elemento

gallery

crear una galería de imágenes / slideshow <nv object="nvweb" name="gallery" mode="image" position="3" width="120" height="90" border="false" />

{{nv object='nvweb' name='gallery' mode='prettyphoto' width='132' height='99'}}

<nv object="nvweb" name="gallery" mode="images" border="true" />
  • mode
    • image
      • primera imagen de la galería del elemento de la página actual
    • images
      • etiquetas simples para todas las imagenes en la galería
    • prettyphoto
      • código HTML generado para ver una galería con prettyphoto
        (prettyphoto debe cargarse y llamarse manualmente)
    • greybox
      • código HTML y JS para una galería usandogreybox
    • piecemaker
      • XML generados "Image Source" etiquetas para su uso con piecemaker 2
  • only_first
    • [ true | false ] (sólo para mode="prettyphoto")
      • mostrar sólo la primera imagen, el resto están ocultas (display: none)
  • width
    • ancho de las miniaturas de la galería (la imagen original se muestra en tamaño completo)
  • height
    • altura de las miniaturas de la galería (la imagen original se muestra en tamaño completo)
  • border
    • true
      • las imágenes generadas se escalan con bordes transparentes
    • false
      • las imágenes generadas se amplían para evitar los bordes transparentes
  • return
    • thumbnail
      • devuelve un tag "img" con la miniatura (sólo para mode="image")
    • url / path
      • devuelve una ruta absoluta a la imagen completa (sólo para mode="image")
  • order
    • [ priority | random ]
      • determinar el orden de las imagenes en la galería
  • position
    • devuelve la imagen colocada en una determinada posición de la galería
  • item
    • ID numérico (u objeto php) del elemento del cual cargar la galería

languages

mostrar una lista de idiomas disponibles para un sitio web <nv object="nvweb" name="languages" mode="code" />
<nv object="nvweb" name="languages" mode="select" />
{{nv object='nvweb' name='languages' mode='name' separator=' | ' class='idiomas-opcion'}}
<nv object="nvweb" name="languages" mode="flag" separator="&nbsp;" />
  • mode
    • code
      • lista de códigos de idiomas (en, es_ES, fr_CA...))
    • select
      • control "select" con nombres de idiomas (en, es_ES, fr_CA...))
    • name
      • lista de enlaces con nombres de idiomas (Inglés, Español (ES), Francés (CA) ...)
    • flag (no recomendado)
      • iconos de las banderas de los países de idioma (famfamfam)
  • separator
    • cadena HTML que se coloca entre las opciones de idioma (se añade dentro de un tag <span>)
  • class
    • nombre de la clase que se añadirá a cada opción de idioma (o al tag <select> cuando se usa mode="select")

liveedit

mostrar una barra en la parte superior de la página para permitir modificar el contenido actual (sólo para usuarios identificados en Navigate CMS)) <nv object="nvweb" name="liveedit" />

menu

mostrará una lista de los elementos del menú (estructura) <nv object="nvweb" name="menu" mode="ul" />

{{nv object='nvweb' name='menu' mode='a' levels='1' from='0' option='3' }}

<nv object="nvweb" name="menu" mode="ul" levels="1" from="1" of="1" />

<nv object="nvweb" name="menu" mode="current_title" />
  • mode
    • ul
      • crear elementos UL > LI (y sus hijos si están habilitados)
    • a
      • crear elementos DIV > A (div class determina el nivel de la estrucutura)
    • select
      • crear elementos SELECT > OPTION ("selected" determina el nivel de la estrucutura)
    • previous
      • enlace al elemento anterior de la categoría actual (si existe)
    • next
      • enlace al elemento posterior de la categoría actual (si existe)
    • current_title (o también "category_title")
      • muestra el título del elemento actual de estructura
    • current_url
      • devuelve la ruta al elemento actual de estructura
  • levels
    • cuántos niveles se muestran(0 => todos)
  • from
    • desde que nivel de la estructura se empieza a mostrar (0 => desde la raíz)
  • of
    • obtener hijos de una determinada posición de un elemento raíz (0 => todos los elementos de la raíz)
  • parent
    • ID de uno de los padres de la estructura (que figuran en Navigate CMS) (0 => elemento raíz)
  • option
    • mostrar un hijo específico del primer nivel de la estructura
  • class
    • asignar una clase CSS al elemento que engloba al menú (div, ul o select)

metatags

generar etiquetas HTML baadas en el contenido <nv object="nvweb" name="metatags" />
  • generator
    • [ true | false ]
      • incluye un generador de etiquetas Navigate CMS
  • title_separator
    • cadena de texto a usar como separador entre el título de la página y el nombre de la web

product

devuelve información sobre un producto
(cuando la página actual pertenece a un producto)
<nv object="nvweb" name="product" mode="title" />

{{nv object='nvweb' name='product' mode='structure' return='title'}}

<nv object="nvweb" name="product" mode="price" />

{{nv object='nvweb' name='product' mode='stock' out_of_stock='etiqueta_diccionario_fuera_de_stock'}}

  • mode
    • title
      • nombre del producto
    • body
      • devuelve el contenido principal de un producto
    • section
      • devuelve una sección de contenido del producto
    • date
      • fecha del producto (fecha asignada en el campo "fecha a mostrar")
    • date_created
      • fecha de creación del producto
    • comments
      • número de comentarios sobre el producto
    • views
      • número de visualizaciones del producto
    • author
      • nombre del usuario de Navigate CMS user quien ha creado el producto
    • structure
      • recuperar información sobre la categoría associada al producto
      • return
        • [ title | path | action ]
    • tags
      • devuelve la lista de etiquetas (tags) asociadas al producto
        • separator
          • cadena usada como separación para cada etiqueta
    • 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"
        • return
          • [ value | unit ]
    • 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
  • section
    • nombre de la sección de contenido del producto ("main", "custom_section_1", etc.)
  • function
    • función PHP que se va a llamar: strtoupper, ucfirst... (sólo para el modo "title")
  • format
    • formato de fecha usando PHP strftime, si no se proporciona, se usa el formato por defecto asignado en el sitio web
  • pid
    • fuerza a cargar un producto específico por su id (que debe pertenecer al sitio web actual)

properties

muestra una propiedad de la página actual <nv object="nvweb" name="properties" property="Main image" width="250" height="180" border="false" />

{{nv object='nvweb' name='properties' property='Date of the event' mode='item' id='123'}}

<nv object="nvweb" name="properties" property="SKU" />

<nv object="nvweb" name="properties" property="related_item" return="title" />

<nv object="nvweb" name="properties" property="related_item" return="section" section="main" />

<nv object="nvweb" name="properties" property="related_item" return="property" element-property="main_image" element-property-width="64" element-property-height="64" element-property-border="false" />
  • property
    • Nombre EXACTO de la propiedad (mayúsculas y minúsculas)
      ID de la propiedad (en la definición del tema del sitio web)
  • mode
    • [ website | item | structure | product | webuser ]
      • forzar la recuperación de la propiedad del sitio web, de un elemento, de una categoría de la estructura, de un producto o del usuario web actual
  • id
    • ID del elemento, categoría de la estructura o del producto del que queremos mostrar la propiedad
  • format
    • strftime formato de fecha (sólo para las propiedades tipo "date" y "datetime")
  • link
    • [true | false] muestra una etiquea o una url de un <a> (sólo para la propiedad tipo "link")
  • floor
    • [true | false] calcular el número entero más próximo hacia abajo (sólo para la propiedad tipo "rating")
  • width
    • tamaño del ancho de una imagen (sólo para propiedades tipo "image" o "video")
  • height
    • tamaño del alto de una imagen (sólo para propiedades tipo "image" o "video")
  • border
    • [ true | false ]
      • redimensionar a escala una imagen con bordes transparentes o zoom evitando márgenes a su alrededor (sólo para la propiedad tipo "image")
  • precision
    • define cuántas cifras decimales deben devolverse para una propiedad de tipo decimal (por defecto se devuleve el número completo)
  • return
    • devolver un dato relacionado con una propiedad según su tipo
      • propiedades tipo "image"
        • url
          • devuelve la ruta para mostrar una imagen, sin generar la etiqueta <img> completa
        • quality
          • porcentaje de calidad aplicado al escalar imágenes JPEG
      • propiedades tipo "item"
        • id
        • title
        • path, url
          • ruta de enlace al elemento
        • section
          • section="main"
              nombre de la sección a mostrar
        • property
          • element-property
              nombre de la propiedad a mostrar del elemento relacionado
          • element-property-{atributo_modificador}
              precede "element-property-" a cualquier nobmre de attibuto a procesar; por ejemplo: element-property-width="80"
      • propiedades tipo "file"
        • url
        • url-inline
        • url-download
      • propiedades tipo "option" y "moption"
        • value
      • propiedades tipo "link"
        • title
        • link
        • target
      • propiedades tipo "category"
        • title
        • url
      • propiedades tipo "categories"
        • title (necesita atributo "position")
        • url (necesita atributo "position")
      • propiedades tipo "country"
        • id
        • code
        • name
      • propiedades tipo "video"
        • embed
          • código HTML de incrustación
        • title
        • provider
          • youtube, vimeo...
        • reference
          • referencia del vídeo en la plataforma de origen
        • mime
        • author
          • autor o propietario del video
        • path, url
          • ruta original al vídeo
        • thumbnail_url
        • thumbnail
          • etiqueta img para la miniatura del vídeo

tags

mostrar una lista de etiquetas usadas en el sitio web <nv object="nvweb" name="tags" mode="top" />
{{nv object='nvweb' name='tags' mode='top' tag='li'}}
<nv object="nvweb" name="tags" mode="top" request="text" tag="a" number="5" separator=" | " />
  • mode
    • top
      • ordenar las etiquetas por número de apariciones
    • random
      • ordenar aleatoriamente las etiquetas
  • tag
    • [ a | li | span ]
      • qué etiqueta html usar para cada etiqueta
  • separator
    • texto a usar como separador entre cada etiqueta
  • items
    • número de etiquetas a devolver
  • categories
    • recupera etiquetas sólo de ciertos elementos de la estructura, por ejemplo: "4,8"
  • class
    • asignar una clase CSS a los enlaces
  • request
    • nombre del parámetro de la url que se va a usar para la búsqueda (por defecto "q")

votes

muestra la información de los votos y puntuaciones de los elementos <nv object="nvweb" name="votes" mode="webuser" />

{{nv object='nvweb' name='votes' mode='score' round='1' max='10' min='1'}}

<nv object="nvweb" name="votes" mode="votes" />
  • mode
    • votes
      • número de votos recibidos en ese elemento
    • score
      • puntuación media recibida por ese elemento
    • webuser
      • puntuación otorgada por el usuario web registado/li>
  • round
    • (sólo para mode="score" )
      floor
      • el entero más cercano hacia abajo
    • ceil
      • el entero más cercano hacia arriba
    • 2 (o cualquier otro entero)
      • número de decimales de la puntuación media
  • half
    • divide la puntaución entre 2,es decir, si no quieres que se muestren "medias estrellas" (sólo para mode="score")
  • min
    • valor mínimo permitido (sólo para mode="score")
  • max
    • valor mínimo permitido(sólo para mode="score")

webuser

devuelve datos del usuario web identificado o realiza alguna acción sobre él <nv object="nvweb" name="webuser" mode="username" />

{{nv object='nvweb' name='webuser' mode='authenticate' username_field='signin_username' password_field='signin_password' notify='inline'}}

<nv object="nvweb" name="webuser" mode="newsletter_subscribe" email_field="newsletter_subscribe_email" notify="callback" callback="newsletter_subscription_callback" />
  • mode
    • id
      • identificador numérico del usuario web
    • username
      • nombre del usuario web
    • fullname
      • nombre real del usuario web
    • email
      • email del usuario web
    • avatar
      • imagen del usuario web
    • comments
      • número de comentarios publicados
    • gender
      • devolver el género del usuario web [ male / female / company / (empty) ]
    • newsletter
      • devolver si el usuario web está suscrito al boletín [ 0: no, 1: si ]
    • authenticate
      • intentar autenticar el usuario tras proporcionar nombre de usuario y contraseña
    • signout_link
      • genera una url para cerrar la sesión iniciada por un usuario web
    • newsletter_subscribe
      • intentar suscribir un correo electrónico como receptor de boletines de noticias
    • forgot_password
      • enviar un e-mail para reestablecer la contraseña del usuario web
  • username_field
    • (sólo para mode="authenticate")
      nombre del campo en el formulario enviado que contiene el nombre de usuario; por defecto "signin_username"
  • password_field
    • (sólo para mode="authenticate")
      nombre del campo en el formulario enviado que contiene la contraseña; por defecto "signin_password"
  • email_field
    • (sólo para mode="newsletter_subscribe" y "forgot_password")
      nombre del campo en el formulario enviado que contiene la dirección de correo electrónico; por defecto "newsletter_email"
  • notify
    • (sólo para mode="authenticate", "newsletter_subscribe" y "forgot_password" )
      forma de notificar el resultado del proceso
      • inline
        • el mensaje de resultado aparece en el lugar de llamada al webget
      • alert
        • el mensaje de resultado aparece en un diálogo tipo "alert" del navegador
      • callback
        • el mensaje de resultado se pasa a una función javascript (definida con el atributo "callback")
      • false
        • se ignora el mensaje de resultado
  • callback
    • (sólo para notify="callback")
      el mensaje de resultado positivo se pasa como parámetro de una función javascript
  • error_callback
    • (sólo para notify="callback")
      el mensaje de resultado de error se pasa como parámetro de una función javascript
  • form
    • enviar el email sólo si se cumple la condición "nombre_campo=valor_campo"
      (útil si tienes varios formularios que usen el webget modo="newsletter_subscribe" en una página)
      ej.: <input type="hidden" name="tipo_formulario" value="valor_unico" />
  • avatar
    • 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
    • gravatar_default


<nv object="list" >..</nv><nv object="search" >..</nv>

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)
      • no mostrar paginador
    • 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)
      • no mostrar paginador
    • 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
  • 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
  • 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"
      • return
        • [ value | unit ]
  • 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
    • comment date posted
      • format
        • formato de fecha usando el parámetroPHP strftime(optional)
  • 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
    • muestra una propiedad del comentario
      usar los mismos atributos que en properties (nvweb)

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
    • título del bloque
  • 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
    • url asignada al enlace
  • 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>
  • empty
    • [ true | false ]

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>
  • empty
    • [ true | false ]

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>
  • show_in_menus
    • [ true | false ]

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)
        • igual
      • neq or !=
        • distinto
      • gt or >
        • mayor que
      • gte or >=
        • mayor o igual que
      • lt or <
        • menor que
      • lte or <=
        • menor o igual que
{referencia nv tags} {documentación completa}

© 2012-2019, Naviwebs