Categorías de Marcas

Las marcas pertenecen a las siguientes categorías:

Marcas de Valor

Son aquellas marcas que serán sustituidas por el valor que tiene el elemento en el artículo. Son similares a las variables de un lenguaje de programación.

Por ejemplo:

%%TXT_cuerpo%% %%link%%
%%_TXT_TITULAR%%
%%_PF_formatoX(%%hora%%)%%

Las marcas que comienzan con un subrayado (underscore) "_" corresponden a marcas predefinidas en Prontus y sirven a un propósito específico.

 

Marca

Descripción

%%_ALTA%%

Despliega el checkbox para controlar el alta de un artículo. Si en el archivo de configuración < nombre prontus >-var.cfg se ha especificado
CONTROLAR_ALTA_ARTICULOS = 'NO', entonces esta marca no tendrá efecto alguno y puede ser omitida
en los FIDs.

%%_ART%%

Despliega el TS del artículo más la extensión, por ejemplo: 20070126130303.html.

%%_ART_AUTOINC%%

Identificador (id) del artículo.

%%_CMB_TEMP%%

Despliega el combo-box de plantillas de artículo disponibles para cada FID.

%%_CMB_TIPO%%

Despliega el combo-box con los distintos FIDs (tipos de artículo) disponibles.

%%_FILE%%

Path y nombre del archivo correspondiente al artículo, por ejemplo:
/prontus_nots/site/artic/20080912/pags/20080912104347.html

%%_FILEURL%%

Path y nombre del archivo amigable correspondiente al artículo, por ejemplo:
/este-es-el-titular/prontus_nots/2009-05-28/115643.php

Siempre y cuando la variable FRIENDLY_URL sea igual a SI en el archivo de configuración prontus_< prontus_id >-var.cfg. En el caso que sea igual a NO, el comportamiento es igual a la marca _FILE.

%%_INIT_VTXT%%

Inicializa el control VTXT.
Esta marca debe insertarse al final del tag < /body > del FID.

%%_NOMEDIC%%

Nombre de la edición a la que pertenece una portada.
Tiene la forma: aaaa_mm_dd_i. A partir de ésta se puede obtener la fecha de la edición.
En el caso de un artículo, se deduce de la variable _FECHAP y el sufijo es siempre "_1".

%%_PRONTUS_ID%%

Nombre de la instancia de Prontus, el cual corresponde al directorio bajo el cual ésta reside.
Esta marca facilita la portabilidad de plantillas entre instancias de Prontus.

%%_REL_PATH_PRONTUS%%

Nombre de la carpeta principal donde se encuentra instalado Prontus.
Tiene el mismo significado que _PRONTUS_ID, pero se usa exclusivamente en los FIDs.

%%_SERVER_NAME%%

Nombre o IP del servidor donde se encuentra instalado Prontus.
Corresponde a la variable PUBLIC_SERVER_NAME del archivo de configuración < nombre prontus >-id.cfg
Si no está definido ahí, se adopta el valor de la variable de ambiente HTTP_HOST

%%_SIZE_HTML%%

Tamaño del archivo HTML correspondiente al artículo.

%%_SIZE_TOTAL%%

Tamaño total del artículo incluyendo html, imágenes, adjuntos, etc.

%%_TAX%%

Define la taxonomía manual, que corresponde a una serie de identificadores de artículo separados por comas.

%%_TAXONOMIA%%

Despliega los combo-box para la selección de secciones, temas y subtemas.
Despliega 1, 2 o 3 tríos de combo-box dependiendo del parámetro TAXONOMIA_NIVELES del archivo de
configuración < nombre prontus >-tax.cfg

%%_TAXPORT_ARTXPAG%%

Altera la cantidad de artículos por página en portadas taxonómicas, definido mediante el parámetro
TAXPORT_ARTXPAG del archivo de configuración < nombre prontus >-tax.cfg

%%_TSDIR%% (Deprecated)

Entrega el día de creación del artículo, en formato aaaammdd, la cual corresponde al directorio donde queda
almacenado el artículo. Por ejemplo 20060920.

Esta marca está deprecated, se debe utilizar en su reemplazo la marca %%_FECHAC%%

%%_TXT_BAJADA%%

Bajada (resumen) del artículo, incluyendo tags html.
Para no incluir tags html, usar la marca %%_BAJADA%%

%%_TXT_TITULAR%%

Texto del titular del artículo, incluyendo tags html.
Para no incluir tags html, usar la marca %%_TITULAR%%
Esta es la única marca obligatoria de Prontus. Debe ser incluida en todos los tipos de artículo.

%%_FECHAC%%

Fecha de creación del artículo en formato aaaammdd.

%%_FECHACSHRT%%

Fecha de creación del artículo en formato dd/mm/aaaa.

%%_FECHACLONG%%

Fecha de creación del artículo en formato: [día de la semana] [día del mes] de [nombre_mes] de [aaaa].

%%_HORAC%%

Hora de creación del artículo en formato hh:mm.

%%_FECHAHORA%%

Genera las cajas de texto en el FID para el ingreso de las fechas y horas de publicación y de expiración en
caso de tenerla.

%%_FECHAP%%

Fecha de publicación del artículo en formato aaaammdd.

%%_FECHAPSHRT%%

Fecha de publicación del artículo en formato dd/mm/aaaa.

%%_FECHAPLONG%%

Fecha de publicación del artículo en formato: [día de la semana] [día del mes] de [nombre_mes] de [aaaa].

%%_HORAP%%

Hora de publicación del artículo en formato hh:mm.

%%_FECHAE%%

Fecha de expiración del artículo en formato aaaammdd.
Campo disponible cuando opción Control-Fecha se encuentra activa a través del parámetro
CONTROL_FECHA = 'SI' del archivo de configuración < nombre prontus >-var.cfg

%%_FECHAESHRT%% Fecha de expiración del artículo en formato dd/mm/aaaa.
Campo disponible cuando opción Control-Fecha se encuentra activa a través del parámetro
CONTROL_FECHA = 'SI' del archivo de configuración < nombre prontus >-var.cfg
%%_FECHAELONG%% Fecha de expiración del artículo en formato: [día de la semana] [día del mes] de [nombre_mes] de [aaaa].
Campo disponible cuando opción Control-Fecha se encuentra activa a través del parámetro
CONTROL_FECHA = 'SI' del archivo de configuración < nombre prontus >-var.cfg
%%_HORAE%% Hora de expiración del artículo en formato hh:mm.
Campo disponible cuando opción Control-Fecha se encuentra activa a través del parámetro
CONTROL_FECHA = 'SI' del archivo de configuración < nombre prontus >-var.cfg
%%_NOM_SECCION1%% (2-3) o %%_SECCION1%% (2-3)
%%_NOM_TEMA1%% (2-3) o %%_TEMA1%% (2-3)
%%_NOM_SUBTEMA1%% (2-3) o %%_SUBTEMA1%% (2-3)
Nombres y ID de sección, tema y subtema.
_NOM_SECCION1 entrega el nombre, por ejemplo "Ping Pong"
_SECCION1 entrega el identificador, que es un número. Por ejemplo: 34
%%_VERMAS%% Permite delimitar el html que contiene el link hacia la portada taxonómica, en el sector de artículos
relacionados.
Todo el html entre las marcas _VERMAS será omitido en caso de no haber más artículos que los que se están
mostrando.
%%_SECC_TEMA_STEMA_NOM%% nserta el nombre de la sección, tema y subtema del artículo, con links hacia las portadas taxonómicas
correspondientes.
Esta marca se usa para insertar breadcrumbs.
%%_HTML_NROS_PAG%% Inserta links a otras páginas de portadas taxonómicas.
Si esta marca y el texto explicativo que la acompaña es rodeado por la marca %%_msg%% .. %%/_msg%%,
entonces, en caso que no haya varias portadas taxonómicas, todo lo rodeado por las marcas %%_msg%%
será sustituido por el mensaje:
No se encontraron resultados.
Este mensaje puede cambiarse si se inserta un comentario con otro valor, de la forma:
< !-- MSG no_results = Nuevo mensaje -- >
%%_SUBTIT_LOOP%%
%%_SUBTIT_KEY%%
%%_SUBTIT_TARGET%%
%%_SUBTIT%%
%%_SUBTIT_HTML%%
%%_SUBTIT_ANAME%%
Los subtítulos permiten crear artículos con secciones accesibles mediante un menú.
Para esto Prontus toma todos los párrafos que poseen el estilo subtit:
< p >Subtítulo dentro del texto< /p >
les agregará un tag "a" (anchor) y los dispondrá en un menú.
Las marcas disponibles para la construcción del menú son:
- %%_SUBTIT_LOOP%%: inicio del loop.
- %%_SUBTIT_KEY%%: link.
- %%_SUBTIT_TARGET%%: target
- %%_SUBTIT%%: texto asignado como subtítulo por el operador
- %%/_SUBTIT_LOOP%%: fin del loop

Las marcas disponibles para definir la apariencia de cada subtítulo son:
- %%_SUBTIT_HTML%%: inicio del loop.
- %%_SUBTIT_ANAME%%: nombre del link.
- %%_SUBTIT%%: texto asignado como subtítulo por el operador
- %%/_SUBTIT_HTML%%: fin del loop

 

Marcas de Control

Son marcas que permiten controlar la aparición o no de bloques de HTML. Son similares a las estructuras de control de un lenguaje de programación.

Estas son:

Marca

Descripción

Ejemplo

IF

Permite incluir un trozo de código siempre que el dato exista (fue ingresado por el operador) o que corresponda a un valor específico.

Debe utilizarse %%IF(< marca prontus >)%% para abrir una condición y cerrarla con %%/IF%%.

Si se usa %%IF(< marca prontus >)%% entonces el trozo delimitado se incluirá siempre que la variable exista, o sea, posea algún valor distinto de vacío.

Si se usa %%IF(< marca prontus >=< valor >)%% entonces el trozo delimitado se incluirá siempre que la variable posea un valor igual al que se indica dentro de la condición.

Otros operadores válidos son:

  • =
  • !=
  • ~
  • >
  • <
  • >=
  • < =

%%IF(FOTOFIJA_ART200)%%

< div class="rightContent" >
< img src="%%FOTOFIJA_ART200%%" width="%%_WFOTOFIJA_ART200%%" height="%%_HFOTOFIJA_ART200%%" >

%%IF(TXT_piefoto)%%

< div class="piefoto" >< p >%%TXT_piefoto%%< /b >< /div >

%%/IF%%

< /div >

%%/IF%%

NIF

Permite incluir un trozo de código siempre que el dato no exista (no fue ingresado por el operador) o que no corresponda a un valor específico.

Debe utilizarse %%NIF(marca reservada o variable)%% para abrir una condición y cerrarla con %%/NIF%%.

%%NIF(FOTOFIJA_PORT200)%%

%%IF(FOTOFIJA_PORT150)%%

< td width="%%_WFOTOFIJA_PORT150%%" align="left" valign="top" >

< a href="%%_FILE%%" >

< img src="%%FOTOFIJA_PORT150%%" width="%%_WFOTOFIJA_PORT150%%" height="%%_HFOTOFIJA_PORT150%%" border="0" >

< /a >

< /td >

%%/IF%%

%%/NIF%%

IFV

La marca IFV corresponde a una variable de iteración para cada área de una plantilla de portada. Se utiliza defiendo dos parámetros denominados:

  • div: número por el cual se divide el valor actual de la iteración. Esta división es modular (%).

  • res: resto de la división (o bien el resultado de una división "módulo").

Cuando el número de la iteración módulo div es igual a res, entonces lo que va dentro del tag es publicado en la portada.

La marca a utilizar para abrir una condición es %%IFV(div,res)%% y para cerrarla %%/IFV%%.

El ejemplo de a continuación es para crear una lista con colores de fondo alternativos.

%%LOOP1%%

%%IFV(2,1)%%

< div class="blanco" >%%_TXT_TITULAR%%< /div >

%%/IFV%%

%%IFV(2,0)%%

< div class="gris" >%%_TXT_TITULAR%%< /div >

%%/IFV%%

%%/LOOP%%

IFVC

La marca IFVC (IFV-Continuar) permite agregar el código HTML que esté incluido en el siguiente IFV, con el objetivo de que el código HTML no quede sin terminar. Por ende, esta marca se utiliza en conjunto con la marca IFV. Su formato es idéntico a ésta.

La marca a utilizar para abrir una condición es %%IFVC(div,res)%% y para cerrarla %%/IFVC%%.

El ejemplo muestra la creación de una tabla de 4 celdas por fila.

Se usa IFVC para crear cada celda e IFV para crear la última celda de la fila, de manera que la tabla siempre quede bien cuadrada.

Si no hay datos, Prontus continúa iterando en el loop hasta que no se cumpla la condición IFVC, es decir, incluye todas las celdas dentro de condiciones IFVC hasta completar cada fila.

< table >

%%LOOP1%%

%%IFVC(4,1)%%

< tr >

< !-- Primera celda de la fila. Aparece siempre que exista el artículo. Si aparece, fuerza una nueva iteración. -- >

< td >%%_TXT_TITULAR%%< /td >

%%/IFVC%%

%%IFVC(4,2)%%

< !-- Segunda celda de la fila. Aparece debido al IFVC anterior (4,1) y fuerza una nueva iteración. -- >

< td >%%_TXT_TITULAR%%< /td >

%%/IFVC%%

%%IFVC(4,3)%%

< !-- Tercera celda de la fila. Aparece debido al IFVC anterior (4,2) y fuerza una nueva iteración. -- >

< td >%%_TXT_TITULAR%%< /td >

%%/IFVC%%

%%IFV(4,0)%%

< !-- Cuarta celda de la fila. Aparece debido al IFVC anterior (4,3), pero no fuerza una nueva iteración, por lo tanto, si no existe un siguiente artículo, la tabla terminará aquí. -- >

< td >%%_TXT_TITULAR%%< /td >

< /tr >

%%/IFV%%

%%/LOOP%%

< /table >

NIFV

Para el caso de la marca NIFV, responde de manera contraria a la marca IFV; tal como sucede con las marcas IF y NIF.

La marca a utilizar para abrir una condición es %%NIFV(div,res)%% y para cerrarla %%/NIFV%%.

En el ejemplo el área 1 está programada para que resalte sólo el primer artículo publicado y el resto lo publique con un diseño normal.

%%LOOP1%%

%%IFV(2000,1)%%

< div class="resaltado" >%%_TXT_TITULAR%%< /div >

%%/IFV%%

%%NIFV(2000,1)%%

< div class="normal" >%%_TXT_TITULAR%%< /div >

%%/NIFV%%

%%/LOOP%%

 

Macros

Son las que insertan una macro en la plantilla.

Durante el proceso de un artículo o portada, Prontus primero inserta todas las macros y luego procesa la plantilla resultante como un todo, de una sola vez.

La marca de macro es:

%%MACRO(< nombre_de_archivo >)%%

 

Las macros se definen y depositan en directorios específicos (ver capítulo Estructura de Directorios).

Para más información acerca de Macros, revisar este artículo.