Plantillas de FID (Formularios de Ingreso de Datos)
Un FID está compuesto por:
-
Pestañas que contienen los campos que ingresará el operador.
-
Sector de botones de operación (guardar, previsualizar, etc.).
-
Combo-boxes para selección de FID y plantilla de artículo.
-
Banco de imágenes.
-
Control VTXT (Visual Text) que permite un interfaz más amigable al operador para la modificación de formatos (negrita, cursiva, etc.).
- Desde la versión Prontus v11.2.95, el límite el límite máximo de archivos es de 2000 y 10 minutos de máxima antigüedad.
El código del FID es separado por comentarios para ayudar al desarrollador a realizar modificaciones más fácilmente. Los comentarios que más se distinguen son:
< !-- Taxonomia -- >
...
< !-- /Taxonomia -- >
< !-- Rutinas y variables estandar -- >
< script >..........< /script >
< !-- /Rutinas y variables estandar -- >
< !-- Estilo para ocultar inicialmente los DIVs (NEW_VTXT)-- >
< !-- fila titular -- >...< !-- /fila titular -- >
< !-- fila botones -- >
< !-- Guardar -- > < !-- /Guardar -- >
< !-- Guardar y Nuevo-- > < !-- /Guardar y Nuevo-- >
< !--Ver Actual-- > < !--/Ver Actual-- >
< !--Previsualizar-- > < !--/Previsualizar-- >
< !--Cerrar-- > < !--/Cerrar-- >
< !-- /fila botones -- >
< !-- fila tabs -- >
< !--TABS-- >
corresponden a las pestañas, por ejemplo:
< !--cabecera-- >........< !--/cabecera-- >
< !--cuerpo-- >..........< !--/cuerpo-- >
< !--fotos-- >...........< !--/fotos-- >
< !--/TABS-- >
< !-- /fila tabs -- >
< !-- A continuacion, los bodys de las diferentes secciones de este FID -- >
< !-- cabecera -- >..........< !-- /cabecera -- >
< !-- cuerpo -- >............< !-- /cuerpo -- >
< !-- Fotos fijas -- >.......< !-- /Fotos fijas -- >
< !-- recuadro -- >..........< !-- /recuadro -- >
El FID denominado fid_general.html es obligatorio y debe estar asociada con la plantilla de artículo general.html. En caso de no existir el sistema desplegará un error en el momento de presionar el botón Nuevo Artículo.
La única marca obligatoria es la marca Titular (_TXT_TITULAR), por ende todo FID deberá contenerla. Recordar que en caso de que el operador no ingrese datos en este campo, se llenará automáticamente con el valor 'Sin título'.
Ubicar en el código los comentarios HTML < !-- fotosextras -- >........< !-- /fotosextras -- >, dentro de ellas se puede configurar el número de fotos utilizando la marca FOTO_N(nº), tal como muestra el ejemplo:
< !-- fotosextras -- > < div id="bodyupload" class="BODYS" > < table width="100%" cellspacing="0" class="TW" > < tr > < td align="center" colspan="2" > Escoja las imágenes que desea subir simultáneamente.< br > < span class="ST" >Estas quedarán disponibles en la columna "Imágenes" de este formulario.< /span >< br >< /td > < /tr > < tr > < td align="center" >< input type="file" name="FOTO_N1" >< /td > < td align="center" >< input type="file" name="FOTO_N2" >< /td > < /tr > < tr > < td align="center" >< input type="file" name="FOTO_N3" >< /td > < td align="center" >< input type="file" name="FOTO_N4" >< /td > < /tr > < tr > < td align="center" >< input type="file" name="FOTO_N5" >< /td > < td align="center" >< input type="file" name="FOTO_N6" >< /td > < /tr > < tr > < td align="center" colspan="2" >< br > < input type="button" value="Guardar fotos" onclick="document.f1._ACCI.value='Guardar'; document.f1.action='prontus_art_sbmit.cgi'; document.f1.target='_self'; on_submit('actualiza'); return false;" STYLE="color:black;width:95px;height:18px;" >< br >< br >< /td > < /tr > < /table > < /div > < !-- /fotosextras -- > |
Los botones disponibles son: Guardar, Guardar y Nuevo, Ver artículo actual, Previsualizar y Cerrar.
Es posible quitar alguno o darles un orden distinto, para esto ubicar los comentarios HTML < !-- fila botones -- > < !-- /fila botones -- >, dentro de estos se encuentran definido los botones, los que fácilmente pueden ser reconocidos porque su código se encierran entre comentarios.
< !-- fila botones -- > < !-- Guardar -- > < td class="TBNSEC" align="left" width="7" > < /td > < !-- /Guardar -- > < !-- Guardar y Nuevo-- > < td class="TBNSEC" align="left" width="10" > < /td > < !-- /Guardar y Nuevo-- > < td class="TBNSEC" align="left" width="5" > |
< !--Ver Actual-- > |
Las marcas resaltadas de color verde se utilizan para:
-
%%_CMB_TIPO%%: se reemplaza por una combobox con el listado de FIDs.
-
%%_PLT%%: se reemplaza por una combobox con el listado de plantillas de artículo asociado al FID, generalmente es sólo uno.
-
%%_CMB_MV%%: se reemplaza por una combobox con el listado de multivistas.
Las pestañas son configurables, las que típicamente existen son: cabecera, cuerpo, foto, recuadro, archivos, multimedia. Un FID puede tener menos pestañas o con distintos nombres.
Para ingresar una nueva pestaña, se debe:
-
Ir a la carpeta /prontus_< nombre >/cpan/fid y editar el FID.
-
Dentro del código ubicar el comentario HTML < !--TABS-- >, copiar una de las pestañas existentes, por ejemplo el de la cabecera.
< !--cabecera-- > < div id="DBOT" > < table border="0" cellspacing="0" cellpadding="0" class="TBUTTONS" > < tr > < td width="1%" >< img src="%%_REL_PATH_PRONTUS%%/cpan/core/imag/cpan/corner1.gif" width="20" height="19" >< /td > < td width="99%" class="TBUTTONS" nowrap >< a href="javascript:void(0)" id="a1" onclick="show_body('body1');return false;" class="TAB" >< b >Cabecera< /b >< /a >< /td > < td width="1%" >< img src="%%_REL_PATH_PRONTUS%%/cpan/core/imag/cpan/corner2.gif" width="7" height="19" >< /td > < /tr > < /table > < /div > < !--/cabecera-- > |
-
Modificar los valores de id y show_body por el número correlativo que corresponda, es decir, si existen dos pestañas la nueva correspondería id=a4 y show_body('body4'). Además modificar del texto que diferenciará la pestaña y el nombre del comentario HTML que ayuda a diferenciarla.
< !--recuadro-- > < div id="DBOT" > < table border="0" cellspacing="0" cellpadding="0" class="TBUTTONS" > < tr > < td width="1%" >< img src="%%_REL_PATH_PRONTUS%%/cpan/core/imag/cpan/corner1.gif" width="20" height="19" >< /td > < td width="99%" class="TBUTTONS" nowrap >< a href="javascript:void(0)" id="a4" onclick="show_body('body4');return false;" class="TAB" >< b >Recuadro< /b >< /a >< /td > < td width="1%" >< img src="%%_REL_PATH_PRONTUS%%/cpan/core/imag/cpan/corner2.gif" width="7" height="19" >< /td > < /tr > < /table > < /div > < !--/recuadro-- > |
-
Agregar los campos que contendrá la nueva pestaña. Copiar uno de los contenidos de pestañas existentes que se encuentran después del comentario < !-- A continuacion, los bodys de las diferentes secciones de este FID -- >y realizar las modificaciones. Se debe modificar el atributo id del tag < div > de inicio, debe tener el mismo valor que la función show_body, definida en el paso anterior.
< !-- recuadro -- > < div id="body4" class="BODYS" vtxt_id="VTXT_RECUADRO" > < table width="100%" cellspacing="0" class="TW" > < tr > < td align="right" width="150" >Titular del Recuadro:< /td > < td align="left" > < INPUT name="TXT_titurecuadro" size="50" value="%%TXT_titurecuadro%%" > < /td > < /tr > < /table > < BR > < table width="100%" cellspacing="0" > < tr > < td > < !-- CONTROL VTXT -- > < textarea id="VTXT_RECUADRO" name="VTXT_RECUADRO" vtxt="1" style="display:none; height:355px;" bordetablas="#000000" > %%VTXT_RECUADRO%%< /textarea >< /td > < /tr > < /table > < /div > < !-- /recuadro -- > |
Para artículos que no necesitan incorporar fotos, es posible quitar del FID el banco de imágenes. Para esto eliminar el código que existe entre los comentarios:
< !-- fotosextras -- > < !-- /fotosextras -- > y < !-- fotos -- >< !-- /fotos -- >.
Para identificar el tipo de artículo creado, se puede incorporar un campo oculto en el FID: < input type="hidden" name="tgeneral" value="1" >, donde el atributo name contiene el tipo de artículo. Generalmente se usa la nomenclatura t+< nombre plantilla > (la letra t es de tipo).
Esto es de mucha utilidad al momento de crear las áreas en la plantilla de portada.
Se realiza ingresando al archivo de configuración prontus_< nombre >-art.cfg, un nuevo parámetro con el nombre del FID y de la plantilla de artículo asociada, por ejemplo: FORM_PLTS = 'fid_link.html:Link(link.html)
Para asociar un FID a Prontus a tráves del cpan se debe ingresar a Administración > Configuración > Artículos donde se muestra la lista de los FIDs y sus plantillas ya asociadas a Prontus. Al final de la lista se encuentra el siguiente campo en donde debemos ingresar los datos de nuestro nuevo FID.
Se ingresa nombre para el nuevo FID, se debe seleccionar de la lista el nuevo FIDs e indicar cual es la plantilla para el nuevo FID, para finalmente guardar la configuración.
En el popup que aparece al hacer click, la línea "Datos Guardados" contiene un enlace que muestra el XML del artículo Prontus.
Desde la versión 11.2.81, se puede especificar un segundo parámetro opcional en las marcas MACRO, para indicar un identificador. Por ejemplo:
%%MACRO(macro_campo.html, 1)%%Permitirá usar la marca %%id%% dentro de esa macro, con el valor indicado (1):
< input type="text" name="txt_campo%%id%%" / >Resultando en un archivo final con el siguiente código:
< input type="text" name="txt_campo1" / >