Estructura de directorios

La estructura de directorios del servidor se divide en dos grupos, los archivos ejecutables y los archivos de las instancias Prontus.

Los directorios de archivos ejecutables contienen los archivos CGIs encargados de la compilación de los archivos de las instancias Prontus y la generación de las salidas. Los directorios de archivos ejecutables (CGIs) son dos:

Directorio		Descripción	Acceso
/cgi-cpn		Directorio de los archivos ejecutables utilizados en el panel de administración de contenidos.	Sólo para los operadores
	/coment	CGIs y librerías para la solución de comentarios (implementación futura)
	/dam	CGIs y librerías para la solución Prontus Digital Asset Manager (biblioteca de multimedia)
	/multitag	CGIs y librerías para manejo de tags jerárquicos.
	/pproc	CGIs y librerías de las soluciones Prontus Postprocesos.
	/prontus_error_log	Archivos de log de cada CGI del panel de administración.
	/prontus_plugins	Directorio para CGIs y librerías para los plugins Prontus que crees en tus sitios.
	/prontus_temp	Archivos temporales utilizados por procesos Prontus.
	/sitemaps	CGIs y librerías de la solución Prontus Mapa de sitio.
	/xcoding	CGIs y librerías de la solución Prontus de transcodificación de video.
	/wizard	CGIs y librerías para el asistente de instalación.
/cgi-bin		Directorio de los archivos ejecutables usados para el funcionamiento de los sitios web públicos	Público
	/coment	CGIs y librerías de la solución Prontus de comentarios (implementación futura)
	/prontus_error_log	Archivos de log de cada CGI pública
	/prontus_temp	Archivos temporales utilizados por procesos Prontus.

Todo el contenido de la Instancia Prontus reside en un directorio principal, cuyo nombre corresponde al otorgado en el paso 1 del asistente: Nombre del sitio Prontus.

Dentro del sitio los directorios utilizados son los siguientes:

Directorio				Descripción	Acceso
/cpan				Contiene la página index.html (página de acceso hacia el administrador Prontus)y los archivos de configuración.	Sólo Operadores
	/data				Ninguno
		/cache
		/coment
			/ip_control
			/log
		/procs
		/search		Archivos y directorios utilizados por el buscador.	Ninguno
		/user_lock		Contiene los archivos que bloquean a un usuario cuando se ha equivocado en más de tres oportunidades al ingresar sus claves.	Ninguno
		/users		Archivos de claves y atributos de los usuarios. El archivo prontus_flag_admin.txt, se debe eliminar cuando queda bloqueado el acceso del usuario Administrador tras repetidos intentos fallidos de login.	Ninguno
	/fid			Contiene los formularios de ingreso de datos.	Sólo operadores
		/macros
	/log			Contiene los archivos de bitácora con el registro de las operaciones realizadas por los usuarios en el panel de administración de Prontus.	Sólo operadores
	/procs			Contiene los archivos de datos generados por procesos de Prontus, como exportación de taxonomía y formularios; y páginas de avance de procesos iniciados por el administrador del sitio.	Sólo operadores
/css				Directorio utilizado normalmente para alojar hojas de estilo de los sitios públicos.	Público
/imag				Directorio utilizado normalmente para alojar las imágenes estáticas de los sitios públicos.	Público
/js-local				Directorio utilizado para alojar archivos con código javascript incluidos en los sitios públicos.	Público
/plantillas				Contiene las plantillas tanto de artículos, como de portadas. La estructura de directorios interna replica la del contenido que se generará en el directorio site/	Sólo operadores
	/artic				Sólo operadores
		/fecha		Contiene los directorios de plantillas de articulo.	Sólo operadores
		/macros		Contiene las macros utilizadas en las plantillas de artículos.	Sólo operadores
		/pags		Contiene las plantillas de los artículos	Sólo operadores
		/pags-vvv		Contiene las plantillas de los artículos asociadas a la vista 'vvv'.	Sólo operadores
	/cache			Contiene los directorios de plantillas de página que son generadas en tiempo de ejecución, es decir, cuando los visitantes gatillan determinados procesos.	Sólo operadores
		/taxonomia			Sólo operadores
			/pags	Contiene la plantilla para los artículos relacionados.	Sólo operadores
			/pags-vvv	Contiene las plantillas de artículos relacionados asociadas a la vista 'vvv'	Sólo operadores
	/edic				Sólo operadores
	/edic/nroedic				Sólo operadores
		/home		Contiene un frameset o una redirección a la portada de inicio del sitio web.	Sólo operadores
		/macros		Contiene las macros utilizadas en las plantillas de portada.	Sólo operadores
		/port		Contiene las plantillas para las portadas	Sólo operadores
		/port-vvv		Contiene las plantillas asociadas a la vista 'vvv'	Sólo operadores
		/port_recambio		Contiene las plantillas de recambio de las plantillas de portadas.	Sólo operadores
		/rss		Contiene las plantillas de las veriones XML de las portadas, usadas para crear salidas RSS.	Sólo operadores
	/extra			Plantillas de portlets y otros agregados.	Sólo operadores
		/enviar			Sólo operadores
			/pags	Plantillas utilizadas para el envío de artículos por e-mail.	Sólo operadores
		/form			Sólo operadores
			/pags	Plantillas de páginas de error y éxito usadas por los formularios Prontus.	Sólo operadores
		/imprimir
			/pags	Plantillas utilizadas para la impresión de artículos.	Sólo operadores
		/mapa
			/pags	Plantillas utilizadas para la generación automática del mapa del sitio.	Sólo operadores
			/pags
			/pags
		/search
			/pags	Archivos de Plantillas de resultados de la búsqueda. Ejemplo: search.html	Sólo operadores
	/snippets			Archivos con código reusable para el editor de archivos del panel de administración.	Sólo operadores
	/tax | /tag			Directorios de plantillas de taxonomía o tags
		/port
			/all
			/all-vvv
		/macros		Archivos de macros de taxonomías
	/list
		/macros
		/port
	/multitag			Directorio de plantillas de tags jerárquicos
/stat				Directorio para almacenar archivos o soluciones usados en un sitio Prontus pero que no deban ser administrados con Prontus. Por ejemplo, un reproductor específico de video o audio.

Es importante notar que no deberías hacer cambios a los archivos en este directorio, ya que se actualizan con cada nueva release de Prontus, y esto implica que tus cambios desaparecerán. Si necesitas hacer cambios que afecten a tu Prontus de modo global, deberías usar el directorio /[nombre del prontus]/stat o algún otro dentro del directorio /[nombre del prontus/.

Si tu ambiente contiene múltiples Prontus interrelacionados, por ejemplo usando Single Sign-On, la recomendación es usar un directorio aparte en el webroot de tu ambiente, como por ejemplo /comunes.

Directorio				Descripción	Acceso
/prontus				Elementos de uso común	Público
	/cpan			Elementos de uso común para el panel de administración de las instancias Prontus.
	/front				Público
		/css		Estilos de uso común en las instancias Prontus	Público
		/js-local		Scripts de uso común en las instancias Prontus	Público
		/player		Archivos HTML con los cuales son embedded los archivos de reproductores de multimedia.	Público
		/prontusAudioPlayer		Archivos de reproductor de audio para las instancias Prontus	Público
		/prontusPlayer		Archivos de reproductor de video para las instancias Prontus	Público
					Público

Prontus almacena los datos ingresados por el operador en archivos XML, y además integra una base de datos MySql o MariaDB. Los archivos XML son almacenados en el directorio /[ nombre del sitio ]/site/artic/[fecha]/xml.

Estos archivos determinan la forma como operará Prontus. Entre los datos relevantes se encuentran: nombre, ubicación, FIDs disponibles, portadas disponibles, opciones activas, etc.

Los archivos de configuración se almacenan en el directorio /[ nombre del sitio ]/cpan

y se denominan igual que la carpeta principal de Prontus, más un sufijo que indicará el tipo de información que contiene cada uno.

[nombre del sitio]-bd.cfg #Archivo de configuración de la BD del Sitio

Contiene los parámetros para la configuración de la base de datos.

• NOM_BD: Nombre de la base de datos.
• USER_BD: Nombre del usuario de la base de datos.
• PWD_BD: Contraseña de la base de datos.
• SERVER_BD: Nombre o IP del servidor donde se encuentra instalada la base de datos

Identificador Prontus, el cual debe ser el mismo nombre asignado a la carpeta que contiene Prontus.

[nombre del sitio]-tax.cfg //Archivo de configuración de las Portadas Taxonómicas

Contiene los parámetros para la administración de la taxonomía.

• TAXONOMIA_NIVELES: Indica el número de tríos de sección, tema y subtema a utilizar en el FID, con un máximo de tres.
• NUM_RELAC_DEFAULT: Número de links hacia artículos relacionados que aparecerán junto a cada articulo.
• TAXPORT_ARTXPAG: Número de artículos por página que aparecerán en las Portadas taxonómicas.
• TAXPORT_MAXARTICS: Número máximo de artículos a considerar para construir las portadas taxonómicas. De eta manera se puede limitar su número por razones estéticas o de rendimiento del servidor. El valor por defecto es 500.
• TAXPORT_ORDEN: Permitir definir el orden del listado de artículos en las portadas taxonómicas.
• TAXPORT_TIPO_PAGINACION: Permite definir si se debe usar la paginación estándar (lista con todas las páginas disponibles) o la paginación breve (lista con enlaces a la página inicial, X páginas alrededor de la página actual, y la página final). El número de enlaces a páginas alrededor de la actual se define en la variable TAXPORT_PAGCORTA_MAXPAGS.
• TAXPORT_PAGCORTA_MAXPAGS: Si TAXPORT_TIPO_PAGINACION está configurada a 1, esta variable indica el número de enlaces a páginas a mostrar alrededor de la página actual.
• TAXPORT_FECHA_DESDE: El formato de la fecha debe ser 'YYYYMMDD',También puede tomar el valor 'now' para tomar la fecha actual.

[nombre del sitio]-tag.cfg //Archivo de configuración de las Portadas Tags

Contiene los parámetros para la administración de las portadas tagonómicas. MAX_LAST_TAGS_4FID: Define el número de tags que se mostrarán en el FID.

[nombre del sitio]-list.cfg //Archivo de configuración de las Listas de Artículos

Parámetros para la administración de las listas.

• LIST_MAXARTICS: Cantidad máxima de artículos a incluír en una lista. El valor por defecto es 20.
• LIST_ORDEN: Permite definir el orden del listado de artículos en las listas.
• LIST_PROCESO_INTERNO: Permitir activar o desactivar la generación automática de listas de artículos. En caso de desactivar esta opción, los listados se pueden generar vía cron.
• LIST_SECCION: Secciones específicas a procesar dentro de la lista, separadas por coma. LIST_TEMA: Temas específicos a procesar dentro de la lista, separados por coma. LIST_SUBTEMA: Subtemas específicos a procesar dentro de la lista, separados por coma. LIST_FIDS: Fids a procesar dentro de la lista, separados por coma. LIST_ORDEN: Permite definir el orden de la lista de artículos para la plantilla.

Ver Archivos de Configuración.

Las multivistas son representaciones múltiples para un mismo conjunto de datos de artículo y portada, cuya finalidad es adaptarse al ambiente del usuario en cuanto a tipo de dispositivo (PC, WebTV, PDA, etc.), idioma, tamaño de pantalla o cualquier otra característica que requiera de un formato de salida especial.

Las multivistas se declaran en el archivo de configuración < nombre prontus >-var.cfg y consisten en la generación simultánea de artículos, portadas y otros archivos dentro de directorios identificados con el nombre de la vista, por ejemplo:

pags-[ nombre de la vista ]
port-[ nombre de la vista ]
taxport-[ nombre de la vista ]

Estos directorios se ubican a la misma altura que los directorios de la "vista" principal, lo cual facilita su referencia y uso.

Ver Multivistas

Son archivos de texto plano cuya función es guardar la información sobre las distintas operaciones que fueron realizadas durante una sesión de usuario. Se genera uno por día (siempre y cuando se haya realizado alguna operación) con el formato [nombre del sitio]_año-mes-dia.log y se almacenan en el directorio /[ nombre del sitio ]/cpan/data/log.

Prontus posee la capacidad de ejecutar programas externos (.cgi, .exe, .pl), invocados en el momento de guardar un artículo o una portada. Por razones de seguridad, es conveniente que estos programas sean almacenados en la carpeta donde residen los ejecutables de administración de Prontus (directorio /cgi-cpn). Ver Multivistas

En un Prontus multiedición, el nombre de la edición vigente es escrito en el archivo /[nombre del sitio]/cpan/data/ed_vigente.txt. Este archivo puede ser incrustado o leído por distintas aplicaciones que requieran de este dato. El formato de la edición vigente es aaaa_mm_dd_i, con i = número correlativo.