Creando sitios complejos con ActionApps

De ActionApps Documentacion
Saltar a: navegación, buscar

Usando el Modulo de sitio

Origin: FAQ: id=1680 How to use Site Module


Modulo de sitio

Si usted ha utilizado las Aplicaciones de Acción para incluir contenidos dinámicos en las páginas de su sitio web es muy posible que le interese la idea de integrar la herramienta para lograr administrar todo el contenido de su sitio de manera global. La mayoría de sitios web están constituidos por un considerable número de páginas (archivos) que se vinculan entre si. El Modulo de Sitio le permite administrar todo el contenido de su sitio sin necesidad de realizar inclusiones dinámicas en cada una de las páginas, facilitando las labores de actualización de contenidos y reduciendo la carga administrativa.

Piense por un momento en que usted maneja su sitio enteramente a través de las AA sin necesidad de editar y transferir archivos HTML. Esta es la solución que provee el Modulo de Sitio. Los sitios basados en este módulo tampoco hacen uso de archivos especiales (como shtml). El sitio completo puede ser manejado usando la interface de administración de AA, con excepción del 'script principal de control', descrito más adelante.

En este artículo usaremos como ejemplo el sitio de Econnect para demostrar los principios básicos y el funcionamiento del módulo.

El Modulo de Sitio es parte de la interface de administración de AA, igual que otros módulos. Puede accederlo desde la caja de selección 'cambiar a', si usted tiene privilegios para ello. El modulo de sitio le permite describir la estructura de sus páginas como un árbol. La manera de construir la estructura de las páginas se describe más adelante.


La idea: estado y sesiones

La consideración principal durante la planificación del Modulo de sitio fue despempeño. Los sitios complejos solían tener muchos visitantes al día Para un mejor desempeño es mejor tener las paginas en cache. Sin embargo, con el enfoque previo al modulo de sitio, cada usuario obtiene su propia identificación de sesión, que es única para cada usuario y nos ayuda a almacenar el status, donde el usuario esta dentro del sitio (por ejemplo en que lugar del page scroller esta). Esta bien pero es muy difícil cachear esa información Debido a eso se desarrollo el modulo de sitio sin variables de sesión para cada usuario. Usamos en cambio una "cadena de estado". Allí almacenamos el estatus, en que lugar del sitio esta el usuario. A esta variable de estado la llamamos 'apc' (por 'Cache de apuntador de la aplicación' o 'Application Pointer Cache' :-). Tiene un comportamiento especial en AA y es agregada automáticamente a todas las ligas generadas por AA y de esa manera podemos saber donde estuvo el usuario en la transición anterior.

Por ejemplo: si Ud. obtiene la liga:

http://ecn.cz/index.stm?apc=zzvx1--

este usuario estuvo en la pagina "news-alerts-all_categories-all_regions-page1" del sitio. Como esta eso codificado en la cadena alfanumérica 'apc' es otro tema, y mas bien depende de Ud. y sera descrito mas adelante.


La cadena de estado 'apc'

La cadena de estado de Econnect (apc=zzvx1--) consiste en 7 variables de estado. Cada caracter de la cadena es una variable, sin embargo esto no es una regla general. De hecho, en nuestro ejemplo la quinta variable de estado p (página) podría tener una logitud mayor a un caracter. Todas las variables de estado están definidas en el script principal de control del sitio (/module/site/sites/site_xxx.php3) o, por razones de seguridad, es invocado mediante http:// alternativamente.

En el script principal de control se define el número de variables de estado y la expresión regular que permite extraer los valores de la cadena de estado apc, así como la manera en que cambiamos esa cadena de estado. Por ejemplo, si el código de <site>site_xxx.php3</site> obtiene el siguiente parámetro en el URL:

http://ecn.cz/index.stm?apc=zzvx1--&p=3

la variable de estado cambia de apc=zzvx1-- a apc=zzvx3--

A continuación se describen las variables usadas en el sitio de Econnect. Recuerde que las variables usadas en su sitio pueden ser diferentes y adaptarse a sus necesidades.

Posición en la cadena de estado

Nombre de la variable de estado

Posibles estados de la variable

Descripción

1

w (web)

z,e,n

Clasificación principal de las paginas Las paginas de Econect estas divididas en tres clases: z - zpravodajstvi (noticias) e - econnect n - nno (Noticias relacionadas con ONGs)

2

s (subweb)

z,m,k,t,a,s (for w=z) 1,2,3,4,5,6,7,8,9 (for w=e) N,F,P,I,J,V (for w=n)

Cada web (w) esta dividida en subwebs, por ejemplo la web z (noticias) contiene: z - noticias k - comentarios t - boletines de prensa ...

3

f (filtro)

Cualquier letra

El uso primario de esta variable es para seleccionar la categoría de los items visibles (ambiente, derechos humanos, cultura, ...), pero cada pagina podría usar esta variable para su propio propósito (tipo de apoyo, empleo, etc...)

4

r (región)

Cualquier letra

Igual que f - se usa para filtrar por región

5

p (pagina)

Cualquier numero

Almacena el numero de pagina, donde este el usuario (acorde con el page-scroller). Puede ser mas de un caracter en nuestro caso.

6

t (tipo)

Cualquier letra

Tipo especial de salida, como 'solo texto', 'para impresión', ...

7

x (item)

Cualquier numero

identificación del item a desplegar (como 12345) - como se puede ver, puede tener una longitud variable.


Ud. puede usar cualquier numero de variables de estado en su sitio y combinarlas en la cadena de estado llamada 'apc'. Lo único que hay que tener en cuenta es que la cadena de estado 'apc' debe ser divisible en variables de estado. En el ejemplo de Econnect usamos la siguiente expresión regular para obtener las variables de estado a partir de la cadena de estado 'apc'.


              {w}          {s}            {f}           {r}         {p}        {t}       {x}
ereg( "^([a-zA-Z0-9_])([a-zA-Z0-9_])([a-zA-Z0-9_-])([a-zA-Z_]+)([-]|[0-9]+)([a-zA-Z_-])([0-9]*)", $apc, $vars ))


Script principal de control

El script principal de control es el único archivo que usted necesitará editar en el proceso de creación del sitio. El archivo contiene un script (probablemente en PHP) y su propósito es convertir la cadena de estado 'apc' en variables de estado y, posiblemente, cambiar el estado de las variables en base a los parámetros que se obtienen en la URL.

El script se invoca antes que cualquier pagina del sitio se despliegue. Aquí está un ejemplo sencillo pero funcional del script. Los comentarios están adentro.

Si la variable $apc no esta definida, probablemente estamos accediendo la pagina principal (ej. http://ecn.cz).

if( !$apc )  $apc = 'zzvx--';      # inicializamos la cadena de estado si aun no existe
                                   # en su valor inicial


Separamos la cadena de estado $apc en variables de estado (en el ejemplo se agrega el prefijo 'o' a las variables de script)

if( ereg( "^([a-zA-Z0-9_])([a-zA-Z0-9_])([a-zA-Z0-9_-])([a-zA-Z_]+)([-]|[0-9]+)([a-zA-Z_-])([0-9]*)", $apc, $vars ))
  list($ostate,$ow,$os,$of,$or,$op,$ot,$ox) = $vars;
 else                        #  si la cadena $apc tiene un formato erróneo, 
                             # inicializamos las variables de estado
  list($ow,$os,$of,$or,$op,$ot) = array( 'z', 'z', 'v', 'x', '-', '-');


Ahora tenemos que programar las reacciones a solicitudes especiales en el URL. Por ejemplo, si estamos en el sitio y hacemos clic en una liga que contiene w=z (por ejemplo http://ecn.cz/index.stm?apc=zzvx1--&w=z), cambiamos el estado a la sección 'noticias':

if( isset($w) ) {   # w corresponde a WEB
  switch($w) {
   case 'z':
    list($ow,$os,$of,$or,$op,$ot,$ox)=array('z','z','v','x','-','-',); break;
   case 'n':
    list($ow,$os,$of,$or,$op,$ot,$ox)=array('n','N','1','-','-','-',); break;
   case 'e':
    list($ow,$os,$of,$or,$op,$ot,$ox)=array('e','1','1','-','-','-','73161');
    break;
  }
}


Lo mismo con la variable de estado s, pero el cambio es dentro de la misma WEB (la variable {w} permanece sin cambios)

if( isset($s) ) {   # s corresponde a SUBWEB
  $os=$s;
  $ox=;             # $ow queda igual – cambiamos subweb, no web
  $op='1';
  if( $old_w != 'z' ) # el formato de noticias queda igual
    $old_f=;
}


Regla de reescritura para cada solicitud posible en el URL:

if( isset($f) ) {$of=$f; $ox=; $op='1';}    # f corresponde a FILTRO
if( isset($r) ) {$or=$r; $ox=; $op='1';}    # r corresponde a REGION
if( isset($p) ) {$op=$p; $ox=;}             # pagina
if( isset($t) ) {$ot=$t; $ox=;}             # cambia a modo especial
if( isset($x) ) {$ox=$x;}                     # id del item id a desplegar
if( isset($scrl) ) {                          # page scroller
  $pagevar = "scr_".$scrl."_Go";
  $op = $$pagevar;
  $ox=;
}


Finalmente, grabamos el estado final de las variables de estado en el arreglo $apc_state. La clave 'state' se usa para almacenar la nueva cadena de estado 'apc'. Otras claves en el arreglo son variables, las cuales usamos en la administración del módulo de sitio. No solo deben haber variables de estado, sino también cualquier otra variable que usted desee usar.

$apc_state = array ('state' => "$ow$os$of$or$op$ot$ox",
                    'w' => $ow,
                    's' => $os,
                    'f' => $of,
                    'r' => $or,
                    't' => $ot,
                    'p' => $op,
                    'x' => $ox,
 # variables opcionales usadas en el sitio – usted puede definir tantas
 # variables como usted quiera
                   'archive' =>      (($op>10)? 'archive' : ),
                   );


Usted puede encontrar ejemplos de estos archiso en el directorio /modules/site/sites/ de su instalación de ActionApps.


Administración del sitio

Todo el código HTML que define la diagramación de las páginas es administrado desde el módulo de sitio. La idea es dividir su página web en secciones/pedazos y estructurarlos en un árbol llamado el sitetree. Usted puede encontrar el sitetree de su sitio en la sección izquierda de la interface de administración del módulo. En el momento en el que se despliega una página las AA comienzan por imprimir la primera sección/pedazo de HTML y luego continúa hacia abajo e imprime la rama correcta del árbol, basándosse en las variables de estado que usted defina. Cada una de las secciones/pedazos pueden contener HTML y, como se explicará más adelante, pueden incluir diseños de vistas de los canales.

Existen dos tipos de secciones/pedazos HTML: los 'nodos' y sus respectivas 'opciones'.

Nodos

Un nodo tiene código HTML que simplemente se imprime. Las AA imprimen los contenidos de un nodo y continuan con la evaluación del siguiente (hacía abajo). De otro lado, los 'nodos' pueden ser la raíz de nuevas ramas de HTML. Un 'nodo' se convierte en la raíz de una ramificación cuando se le asigna una 'variable de desición'. Por ejemplo, si usted le asigna la variable 'w' al nodo 'inicio', usted puede crear ramificaciones ('opciones') de esa sección/pedazo y la evaluación continuará en la ramificación donde 'w' satisfaga las condiciones necesarias.

Opciones

Cada 'opción' pertenecerá a un 'nodo' en el que se ha definido una 'variable de desición'. Para cada 'opción' se debe definit una condición basada en la 'variable de desición'. Las AA imprimen solamente la PRIMERA 'opción' que satisfaga la condición. Tan pronto como se cumple una condición, se imprime el código que contiene esa 'opción' y se continua con la evaluación del siguiente 'nodo' del sitetree.

Dentro de las condiciones usted puede usar expresiones regulares. También puede incluir más de una 'variable de desición' en las condiciones de cada 'opción'. Tenga en cuenta que si utiliza mas de una condición, éstas son evaluadas con el operador lógico Y.


Incorporación de diseños de vistas al código HTML

Dentro de los 'nodos' y 'opciones' usted puede utilizar el HTML y, adicionalmente, incoprporar diseños de vistas de cualquiera de los canales existentes En el módulo de sitio no se pueden utilizar los diseños de 'Listado' y 'Texto completo' del canal, solamente pueden utilizarse diseños de 'vistas'. Si usted quiere mostrar la información de uno de sus canales al interior de un 'nodo' o una de sus 'opciones' debe utilizar la siguiente sintáxis:

{view.php3?vid=353}

Esto incluirá el resultado de la vista nñumero 353 dentro del código del 'nodo' u 'opción' que se despliega. Aunque {view.php3...} es sólamente la sintáxis de inclusión (no tiene nada que ver con el archivo view.php3), usted puede usar todos los parámetros que acepta view.php3. Por ejmplo, el siguiente código es utilizado para desplegar el texto completo del item 'x' con el diseño de la vista 217:

{view.php3?vid=217&cmd[217]=x-217-{x}}

Como puede darse cuenta en el ejemplo, la sintáxis permite usar {x} para ser sustituido por el contenido de la variable x (x pertenece a la variable de estado definida en el arreglo $apc_state al interior del 'main control file').


Uso de la sintáxis en el módulo de sitio

Sintáxis

Descripción

{<variable>}

Imprime el contenido de la variable.

Por ejemplo: {w}

{view.php3?vid=<vid>&<parámetros de la vista>}

Imprime el contenido de la vista número <vid>. En esta sintáxis se usan los <parámetros de la vista> exactamente igual que con el script view.php3.

Por ejemplo: {view.php3?vid=122&cmd[122]=c-1-{f}})

{switch(var1,var2,..)val1,val2,..:<texto 1>:val1,val2,..:<texto 2>}

Imprime <texto 1> o <texto 2> o ... con base en las condiciones val1 y val2 para las variables var1, var2, ... Solamente se imprime la primera condición que se cumple. Las condiciones pueden incluir expresiones regulares.

Por ejmplo: {switch(w)z:News:e:Econnect:.*:NGO}

{# cualquier texto}

Comentarios - no se imprimen

Está sintáxis puede anidarse en tantos niveles como se requiera.


Archivos de control

Aquí puede descargar algunos archivos de control que le pueden servir


1. Este script sirve para trabajar con 5 variables. En cada variable se pueden almacenar minusculas, mayusculas, numeros, minusculas y mayusculas acentuadas, ñ, :, ",',espacio en blanco, guion y raya abajo de cualquier longitud. Bueno para cadenas vacias en busquedas. De esa forma se pueden usar nodos tipo a=inicio, b=documentos

Descargar

2. Este script sirve para trabajar con sites de dos idiomas. Solo permite 3 variables minusculas, mayusculas o numeros de longitud de un solo caracter.

Descargar