Estructura de directorios

Comprender para qué sirve cada directorio de Prontus CMS te ayudará a implementar mejor y más rápidamente tus sitios.

Publicado: Martes 25 de septiembre de 2018 por David García
Última modificación: Martes 28 de mayo de 2024

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

Directorios de archivos ejecutables

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.

Directorios de archivos de instancia 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.
Directorio Prontus

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
Repositorios de datos

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.

Archivos de configuración

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.

Multivistas

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

Logs

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.

Post-procesos

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

Nombre de la edición vigente

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.