Diferencia entre revisiones de «Creando sitios complejos con ActionApps»

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 lograr integrar la herramienta para lograr administrar todo el contenido de su sitio. La mayoría de sitios web están constituidos por un número considerable 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.

Hasta este momento, el mejor enfoque para construir o administrar un sitio web de complejidad mediana/grande con ActionApps es usando el Modulo de Sitio. Este modulo es de gran ayuda pues le permite integrar varias vistas y canales en una misma pagina.

Vamos a usar el sitio de Econnect como ejemplo, para demostrar los principios básicos.

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 ud. tiene permiso. El modulo de sitio le permite describir la estructura del sitio como una arborescencia. Los sitios basados en el modulo no necesitan 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 después La manera de describir la estructura del sitio sera expuesta en este texto, mas adelante.

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

Como se puede ver (apc=zzvx1--), la cadena de estado de Econnect consiste en 7 variables de estado - cada caracter el la cadena es una variable en nuestro caso, pero no es una regla (de hecho la quinta variable de estado p, pagina, podria tener una logitud mayor a uno). Todas variables de estado están definidas en el script principal de control del sitio - /module/site/sites/site_xxx.php3 (o alternativamente es invocado, por razones de seguridad, mediante http://). En este script se define no solo en numero de variables de estado y la expresión regular que permite extraer los valores de la cadena de estado apc, sino también 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 se cambia a apc=zzvx3--, lo que significa que esta en la misma pagina web, pero en la pagina numero 3.

Describamos a continuación las variables usadas en el sitio de Econnect, pero tengamos en mente que las variables usadas en su sitio pueden ser diferentes, si desea.

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 Ud. necesitara 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 sensillo 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 (por ahora con prefijo 'o')

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 url. Por ejemplo, si estamos en el sitio y hacemos clic en una liga que contiene w=z (como 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 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' de usa para almacenar la nueva cadena de estado apc. Otras claves en el arreglo son variables, las cuales usamos en la administración del modulo de sitio (en el próximo capitulo). No solo deben haber variables de estado, sino también cualquier otra variable que Ud. 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,
 # helper variables used in site module – you can define as many such
 # variables as you want
                   '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 correcra 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 vistas y canales.

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

a) 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.

b) 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

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