Un manual para crear plantillas Mambo 4.5.1a con Dreamweaver añadiendo la extensión "mambo template extensión" y el Mambo Stand Alone [MSAS] de www.mambosolutions.com

www.mambosolutions.com

Fecha actualización: Diciembre 2004

Spanish translation by Jose alias jsn1

Bueno, habéis descubierto esta gran herramienta llamada Mambo y ahora queréis intentar crear vuestra propia plantilla de Mambo, eh? Bien, se muy bien como os sentís, y comparto vuestro entusiasmo. En el año 2002 trabajaba con Xoops, un sistema similar a Mambo, pero tras descubrir Mambo, no tarde mucho tiempo en cambiar de sistema, y empecé creando mis propias plantillas Mambo. En esa época no había ningúna guia ni manual en la web, así que como muchos otros, me fije en las plantillas que venían con el Mambo, y empecé haciendo reverse engineering. Aquí, intentare aclarar las etapas necesarias para crear una plantilla en Mambo, y así dispondréis de un buen recurso que no estaba disponible cuando empecé. Bien, a que estamos esperando? empecemos por el principio, que por supuesto es siempre una buen lugar para empezar.

Ante todo, hablemos de lo que es una plantilla (template) de Mambo. Una plantilla de Mambo define el conjunto 'look and feel' de vuestro website en mambo. Normalmente incluye cosas como, colores, imágen de encabezamiento (header image), un estilo (layout) de 2 o 3 columnas, footer, etc. La plantilla contenida en el fichero (index.php) trabaja a la par con el fichero CSS (template_css.css) para daros el control sobre varias cosas como por ejemplo la localización de un modulo, el color de la fuente, bordes, hyperlink, efectos hoverfect, y muchas mas cosas que descubriréis a medida que os familiarizáis con el producto.

Hay varias formas de crear/diseñar una plantilla en Mambo. En este manual, crearemos una tabla con un estilo (layout) de 100% con 3 columnas en 'autostretch'. el estilo o layout consiste en 3 tablas separadas de 100%, empiladas verticalmente. La tabla de arriba (top table) es para el área de encabezamiento (header área), la tabla de en medio es para las columnas de la izquierda, centro y derecha de Mambo, y la tabla de abajo es para el área de footer. Adicionalmente la tabla del medio contendrá 3 columnas 100% nested.

Usaremos Dreamweaver en la primera fase del estilo (layout) y codificación . Al llegar a cierto punto, tendremos que volver a nuestro servidor local de Mambo [MSAS] pare pre-visualizar como nuestra plantilla en la web . Bien, ya hemos tenido suficiente introducción, verdad? Os gustaría empezar a crear la plantilla...pues venga, vamos a por ello!!!!!

Lo que necesitareis para usar este manual:

  • Dreamweaver MX 2004: descargar versión de prueba (trial)
  • Mambo Stand Alone Server [MSAS]4.5.1a: descargar gratis
  • Mambo 4.5.1a Dreamweaver Template builder extension: descargar gratis
  • Un cierto tiempo. quizás 1 hora, quizás mas, o quizás menos
  • Quizás, una buena taza de café
  • Windows 2000 o XP, o Mac OS X o LinUx.
  • De hecho, he añadido un copiar/pegar de unos snippets de código para Mac/Linux/y usuarios que no usan Windows :) Por favor leedlos....

Primera Fase, necesitamos abrir el Dreamweaver y tener el template builder extension instalado.
*nota: Si necesitáis descargar la ultima versión del "extension manager" de Macromedia, aquí tenéis que ir aqui

  • Abrid Dreamweaver. En el menú de arriba (top menu), buscad 'Commands' y después 'manage Extensions'. Esto os abrirá el "extension manager".
  • En el "extension manager", elegid 'File' y 'Install Extension'. Navegad a este sitio donde esta mambosolutions451a2.mxp e instaladlo.
  • Después de la instalación, salid de la aplicación Dreamweaver.
  • Ahora re-inicializáis Dreamweaver. Deberíais ver una nueva barra de herramientas (toolbar) con el nombre ' MamboOS'
Figure 1: Barra de Herramientas Mambo en Dreamweaver / Mambo Toolbar in Dreamweaver

Bueno si habéis llegado hasta aquí, entonces poneos cómodos, tomaos una taza de café, o una bebida refrescante, y preparaos para la segunda fase, que consiste en configurar la plantilla que estáis desarrollando en vuestro ambiente local: MSAS !

Segunda Fase. [MSAS] Preparemos nuestro servidor local para poder correr Mambo!

Mambo es una aplicación web que depende de otras aplicaciones web para poder funcionar correctamente. Estas aplicaciones son la base de datos MySql, PHP, y el   servidor web Apache. De todas formas no os preocupéis porque para instalar y configurar estas aplicaciones en Windows he creado un paquete 'todos-en -uno' basado en MiniServer para Windows llamado 'Mambo Stand Alone Server' or [MSAS]. Para Macintosh en OS X, podéis bajar las diferentes aplicaciones de este siti Para Mac OS X

Ahora, levantad las manos, y gritad, 'Genial, mambosolutions!' :) Bueno, prosigamos.

  • Si aun no lo habéis hecho, bajaos descarga MSAS -salvadlo en vuestro escritorio, y read un directorio llamado ' msas' en el escritorio, descargad las 7 .rar partes
  • necesitareis 'winrar' para extraer los ficheros comprimidos, entonces descargad winrar aqui
  • instalad winrar (es realmente muy simple de instalar)
  • localizad msas451a-part1.rar en vuestro directorio y pulsad el botón derecho del ratón y seleccionad en el menú 'extract files'
  • abrid el nuevo directorio que se llama msas451a en vuestro escritorio
  • localizad el fichero msas.exe (dentro del directorio Distribution) entonces hacéis doble click
  • Ahora podéis ver la ventana de la interface MSAS en vuestro escritorio
  • Login/Password para el administrador de mambo: admin/admin
Figure 2: MSAS Interface/MSAS Interface

Wow! creo que ahora os empezáis a divertir, no? Os puedo decir que yo si que me divierto. Bueno, dejadme tomar otro café. Ahora vuelvo! Bien, al fin hemos llegado a la parte en la que se construye la plantilla....

Veamos como mambosolutions construye una plantilla. Queréis verlo?

Estoy seguro que hay diferentes formas de construir una plantilla de mambo. De hecho, se muy bien que las hay. Mi objetivo es de enseñaros la forma mas simple que conozco de crear, una plantilla mambo, usando tablas, insertando todo el código mambo jambo   con la extensión ‘dreamweaver extension', y creando una especie de pre-visualización en directo ('live preview') del entorno usando MSAS. Os interesa ? Se validara el código? Probablemente no. Os enseñara la idea básica de como funcionan las plantillas de mambo y como podéis crearos una? O por lo menos eso espero! Vamos a por ello...

Tercera Fase: Construyendo una tabla con 3-columnas para la plantilla de Mambo

Etapa 1: Empecemos!

  • Abrid Dreamweaver y cread una nueva pagina de tipo 'dynamic page' --> php
Figure 3: Nuevo documento en Dreamweaver / New Document in Dreamweaver

  • Cambiaos a la vista en código y deberíais ver algo así :
Figure 4: Vista del Código en Dreamweaver / Code View in Dreamweaver


  • Seleccionad todo el código situado encima de la etiqueta</head> y borradlo
Figure 5: Borrar en código de encabezamiento con Dreamweaver/ Delete head code in Dreamweaver

  • Insertad el código de encabezamiento de mambo buscando y seleccionando el botón 'Insert Head Code' en la barra de herramientas Mambosolutions451
  • Deberíais de tener un código parecido a este:
Figure 6: Insertar Encabezamiento de Mambo en Dreamweaver / Insert Mambo Head Code in Dreamweaver

CODIGO DE ENCABEZAMIENTO (HEAD CODE) DE LA PLANTILLA DE MAMBO 4.5.1 (copiar/pegar de aqui abajo)

Selecionad y Copiad (Click para seleccionar el contenido y copiarlo en el clipboard)
Etapa 2: estilo de las tablas!

Bien, trabajemos el estilo de las tablas en nuestra plantilla.

  • Cambiaos a la vista de diseño ('Design View') en Dreamweaver.
  • Click en cualquier sitio en el área blanca para activar el cursor
  • Vamos a crear 3 tablas separadas con el valor 100% en la variable width 'auto-stretch' de la plantilla. La parte de arriba de la tablas será para el encabezamiento (header area); el medio será para las columnas de la izquierda y la derecha ; y la parte de abajo será para el área del footer (footer area).
  • Dede el menu de arriba (top menu), ir a Insert>Table (Ctrl+Alt+T) Esto os abre la ventana de para crear tablas
  • Entrad los siguientes valores:
Figure 8: Insertar Tabla de dialoguo en Dreamweaver / Insert Table Dialogue in Dreamweaver

  • Repetid el proceso un total de tres veces - hasta que tengais 3 tablas empiladas verticalmente con 100% width en cada una
  • Consejo: Localizad el 'Layout' tab, y seleccionad vista 'Expanded' -esto es opcional pero a veces ayuda a ver lo que estamos haciendo
Figure 9: Expandiendo la Vista de Diseño en Dreamweaver / Expanded Design View in Dreamweaver

  • Click una vez en el medio de la tabla para seleccionarla
  • Después, váis a ' Insert' >'Table' (CTRL+ALT+T) y creáis una tabla de 3 columnas y 100% width
Figure 10: Insertar una Tabla Encajada (nested) en Dreamweaver / Insert nested table in Dreamweaver

  • Ahora deberíais ver algo así:

Figure 11: Tabla de 3 columnas encajadas / Nested 3 column table in Dreamweaver

  • Podéis ver como funciona la plantilla? Vamos a redimensionar las celdas de la derecha y de la izquierda de esta tabla - estas serán nuestras columnas izquierda y derecha en la plantilla - el área del medio será para el contenido principal de la página
  • poned el cursor en la celda izquierda y pulsad el ratón para seleccionarla
  • en las Propiedades entrad 18% para el width (yo eleji 18% para el width, pero podeis ajustarlo al valor que queráis )
  • Inicializad el alineamiento vertical a 'Top'
  • Click en la columna de la derecha, y repetid la operación con los mismos valores
  • mirad aqui abajo:
Figure 12: Redimensionar columnas en Dreamweaver / Resize columns in Dreamweaver

Etapa 3: Llamando Todo el código Monkeys!
Ahora podemos empezar insertando código php especifico de mambo en nuestras plantillas, no os preocupéis si no conocéis PHP, no será muy complicado!

  • Localizad el botón del código Insert Main Body en la barra de herramientas Mambosolutions451a en Dreamweaver
  • Click una vez en la columna del medio. Seleccionad 'Main Content Area' - entonces seleccionáis el botón 'Insert Main Body'
  • para los que tengáis Macs o Linux el código 'Main Body' a insertar es::

  • Seleccionad y Copiad (Click para seleccionar el contenido y copiarlo en el clipboard)

    Abajo esta el código del layout de la tabla con el código Mambo 'Main Body' (con comentarios que he añadido)

Bueno, que tal estáis? Comprendéis como funciona? Espero que si!!! Normalmente hacer algo que merezca la pena, nos obliga a tomar el tiempo de hacerlo correctamente, y en nuestro caso especifico, significa dedicarle bastante tiempo :)
Continuemos añadiendo mas código. de acuerdo?

  • Pulsad una vez en la columna de la izquierda y seleccionadla. Después pulsad en el botón de inserción 'Insert Left Modules' para añadir el código siguiente:
Seleccionad y Copiad (Click para seleccionar el contenido y copiarlo en el clipboard )
  • Genial? Os gusto? Prosigamos y añadamos el modulo 'user1' posicionado directamente debajo de la posición izquierda
  • Aseguraos de que el código de la etiqueta placeholder no este seleccionado mientras estéis en modo wysiwyg pulsando en el área blanca de la celda izquierda.
  • Localizad el botón del modulo 'Insert User1 Modules' y pulsadlo para insertar el siguiente código en la columna de la izquierda:
Seleccionad y Copiad (Click para seleciconar los contenidos y copiarlos en el clipboard)
  • Ahora vayamos a la columna de la derecha, pulsad en la columna de la derecha para seleccionarla
  • Localizad el botón que posiciona el modulo 'Insert Right Modules' y al pulsarlo añadirá el código:
Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)
  • Ahora añadamos la posición del User2 debajo a la derecha ('Right'), aseguraos que el código de la etiqueta placeholder no este seleccionado mientras en el modo wysiwyg hacéis click con el ratón en cualquier zona en el área blanca de la celda de la derecha.
  • Localizad in haced clik en el botón 'Insert User2 ' para añadir el código PHP del User2:
Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)

Nuestras tablas en 'code view' deberían verse así:

Figure 13: Estilo (layout) de las Tablas en ódigo PHP Mambo añadido con Dreamweaver / Mambo Tables layout with Mambo php code added in Dreamweaver

  • Añadamos el código de la función búsqueda 'search code', (nota: el modulo de búsqueda , esta incluido en Mambo 4.5.1- este ejemplo es opcional, por si os apetece codificarlo)
  • Vamos a poner el campo de búsqueda 'search field' en el tope de la columna de la derecha, con el objeto de explicar como funciona; el objetivo de este ejemplo es puramente pedagógico
  • En la columna de la derecha, donde añadisteis el código para las posiciones 'Derecha' y 'Usuario2' ('Right' and 'User2'), pulsad el ratón a la izquierda de la primera etiqueta placeholder de código php
Figure 14: Posicionar el cursor a la derecha del código del placeholder en Dreamweaver / Insert cursor to the left of the existing code placeholder in Dreamweaver

  • Pulsad en el botón 'Insert Search' para añadir el código de Busqueda (Search code)
  • Debería parecerse a esto:
Figure 15: Campo de Busqueda en Dreamweaver / Search field in Dreamweaver

  • Moviéndonos hacia la derecha, añadamos el área de banners.
  • Pulsad con el ratón en cualquier sitio en la parte de abajo de la tabla la llamada 'footer table' para seleccionarla.
  • Centrad el alineamiento de los banners seleccionando 'Center Align' en el panel de propiedades
Figure 16: Alinear al centro con Dreamweaver / Align center in Dreamweaver
  • Pulsad con el ratón el botón 'Insert Banners' para añadir el código de los banners:
Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)
  • Añadamos el código del 'Footer' también:
  • Aseguraos que el código de la etiqueta placeholder no esta seleccionado en estáis en modo wysiwyg pulsando el ratón en cualquier sitio dentro del área blanca en la parte de abajo de la tabla. De hecho para poner el footer debajo de los banners, solo tenéis que posicionar el cursor a la derecha del código de la etiqueta placeholder.
  • Añadid el código del footer pulsando el botón 'Insert Footer '
Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)

Esto es todo para el footer, vayamos ahora al encabezamiento o header, de acuerdo?
Crearemos una nueva tabla incrustada (nested) en la parte de arriba de la tabla, para indicar la ruta o ' pathway' y visualizar la fecha

  • Pulsad con el ratón en cualquier sitio en la parte superior (top) de la tabla para seleccionarlo
  • Desde el menú superior (top menú) de Dreamweaver. Añadid una nueva tabla con 2 columnas de 100% width seleccionado la opcion Insert>Table
  • Pulsad con el ratón en la celda derecha de la nueva tabla, id a Properties Inspector y manualmente inicializad el width a 30%
Figure 17: Fecha y Pathway / Date and Pathway

  • Con vuestro cursor en la columna de la derecha de la tabla superior (top table), pulsad el botón Insert Date
  • Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)
  • Ahora añadamos nuestro 'breadcrumb trail', o Pathway
  • Pulsad en cualquier sitio en la columna de la izquierda de la tabla superior para seleccionar la celda
  • Buscad y seleccionad el botón 'Insert Pathway '
Seleccionad y Copiad (Click para seleccionar y copiar los contenidos en el clipboard)

Bien ahora, supongo que estaréis ansiosos de ver como todo esto se ve directamente desde Mambo, verdad? Por supuesto que si...pero acordaos -aunque hemos estado creando el estilo (layout) de nuestra plantilla y hemos añadido código php que le permitirá a Mambo correr. No hemos hecho aun ningún diseño, entonces no esperéis ver un resultado final impresionante al mirar la plantilla...es mas a este nivel serán simplemente texto y tablas!

Etapa 4: Creando nuestra estructura de directorio para Mambo y copiando la plantilla en el directorio de 'templantes' en Mambo y moviendolo a MSAS.

Una plantilla de Mambo esta estructurada de la forma siguiente.

Figure 18: Estructura del directorio de una Plantilla / Directory structure of a template

  • Arrancad MSAS.exe si no esta corriendo
  • Navegad al folder de plantilla 'templates' de Mambo en MSAS
  • W:\www\mambo45\templates
  • Cread un nuevo directorio con el nombre de 'ms_dwtutorial'
  • Abrid el directorio llamado 'ms_dwtutorial', y cread 2 directorios - uno llamado 'CSS' y otro llamado 'images'
  • Salvad el fichero en el que habeis estado trabajando en Dreamweaver con el nombre index.php en el directorio 'ms_dwtutorial'
  • ahora necesitamos crear el fichero 'templateDetails.xml'. Cread un nuevo fichero xml (consiste en un fichero texto con la extensión .xml en windows o macinthosh), copiad el código que sigue y ponedlo en el directorio 'ms_dwtutorial' - salvadlo como un 'templateDetails.xml'
Seleccionad and Copiad (Click para seleccionar y copiar los contenidos en el clipboard)
  • Ahora ya es el mmento de crear el stylesheet que controlara cosas como tipo de fuente, colores, link rollovers, bordes alrededor del contenido, etc....todo ello esta en el template_css.css
  • Abrid el directorio CSS y cread un nuevo fichero css llamado 'template_css.css'
  • Copiad/pegad el siguiente código css dentro del fichero 'template_css.css' y salvadlo.
  • Para obteber una lista de todos los estilos CSS usados in Mambo 4.5 mirad esta gran lista que Visualdensity recompilo

Seleccionad y Copiad (Click to select contents and copy them to the clipboard)

Etapa 5: Añadir la imágen del encabezameinto (header)

Quizás queráis añadir una imágen grafica in el encabezamiento (header área). Aqui se indica como hacerlo

Primero abro Photoshop and y creo mi imágen de encabezamiento (header image), en este caso decido de crear una imágen de 700px de ancho y 100 px de alto. Asumo que conocéis los comandos basicos de Photoshop, si no fuese el caso, tenéis a vuestra disposicion muchos manuales de Photoshop en internet. Mirad las imágenes en este ejemplo de plantilla.

La clave, la centrar la imágen en el encabezameinto con una variable de 100%, esta en la imágen de fondo en forma de tiles. Para crear esta imágen, simplemente seleccionad la imágen de encabezamiento y en la parte de la derecha de la imágen haceis otra seleccion de aproximadamente 3 pixels de ancho (width) y toda la altura. Después copiad esta seleccion (CTRL +C), abrid un nuevo documento en Photoshop, y pegadla dentro. Entonces pulsad (CTRL +T) para poneros en el modo Scale. Agarrad los handles y estirad vuestra imágen de ambos lados. Salvad esta imágen con le nombre 'header_bg.jpg' en el folder de las imágenes.

Después añadamos el código HTML pertinente en nuestra plantilla que esta en el fichero 'index.php'. Solo necesitamos añadir el siguiente código:

ahora ya podéis ir a MSAS, abrid el panel del administrador....

Navegad al enlace http://localhost/mambo451/administrator

login como : username: admin
password: admin

Id a la sección 'Template Manager' y seleccionad 'dw_tutorial' como plantilla por defecto (default template). Después vais a Site>Preview para ver vuestra plantilla.

Deberia de parecerse a esta pagina:)

Salvad este fichero (click derecho -save as...) para la forma final del código de la plantilla index.php (podeis bajaros esta y cambarle el nombre). esto tiene algunos colores de fondo añadidos y alineamientos. Podeis copiar/pegar este fichero como 'index.php' y usarlo como base de vuestra plantilla. aqui podeis descargar todos los ficheros incluyedo los ejemplos de Photoshopuff

Bueno, os he enseñado las bases necesarias para crear vuestras plantillas en Mambo, pero no os conforméis con esto - hay muchísimas cosas mas que aprender. El fichero CSS es vuestro amigo, en verdad lo es :) Exploradlo, jugad con el, con los diferentes valores que tiene, sentíos cómodos con el. El fichero CSS es la clave para hacer soluciones complejas y pequeños detalles en vuestra plantilla. No entrare mucho en detalles con el fichero CSS, pero cubriré unos puntos importantes. . También os sugiero que si quereis aprender un poco mas sobre CSS que exploréis las siguientes fuentes de información :
a list apart
the noodle incident
blue robot
brainjar
htmldog
csszengarden

Si os parece este manual útil, o tenéis alguna sugestión para mejorarlo, corregirlo , o para cualquier consulta, por favor enviad un correo en el hilo de los foros de mamboserver:

http://forum.mamboserver.com/showthread.php?t=15295

No os olvidéis de crear una imágen thumbnail de vuestra plantilla. Para ello, hacéis un pantallazo de vuestra versión final en vuestro navegador , lo editáis en Photoshop formato200px X 200px, y lo salváis en vuestro directorio 'ms_dwtutorial' con el nombre de fichero 'template_thumbnail.png'

Para tener la lista de las diferencias del código entre las versiones 4.5 y 4.5.1 en las plantillas de Mambo mirad este grafico de Arthur konze en www.mamboportal.com

Bonos para los usuarios de Flash! Como añadir un encabezamiento 'flash header' y usar un objeto compartido flash, de tal forma que la introducción flash solo se ejecute una vez.

descargar el ejemplo de plantilla con fuente .fla (Flash MX)

Es importante que recordéis que cuando usáis flash en una plantilla Mambo el path del swf debe de ser relativo al directorio raiz del sitio de mambo. En mi ejemplo, puse el fichero .swf en el directorio templates/ms_dwtutorial_flash/images/ y el código es este:

 

<OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0"
WIDTH="780" HEIGHT="100" id="ms_flash_playonce_demo" ALIGN="">
<PARAM NAME=movie VALUE="templates/ms_dwtutorial/images/ms_flash_playonce_demo.swf"> <PARAM NAME=quality VALUE=high> <PARAM NAME=bgcolor VALUE=#FFFFFF> <EMBED src="templates/ms_dwtutorial/images/ms_flash_playonce_demo.swf" quality=high bgcolor=#FFFFFF WIDTH="780" HEIGHT="100" NAME="ms_flash_playonce_demo" ALIGN=""
TYPE="application/x-shockwave-flash" PLUGINSPAGE="http://www.macromedia.com/go/getflashplayer"></EMBED>
</OBJECT> Para codificar vuestro flash de forma que solo aparezca una vez, añadid este código en la primera frame de vuestra pelicula flash: function checkSO()
{
// If a shared object called siteSO already exists this will retrieve it otherwise it
// creates a new shared object called siteSO
var SO = SharedObject.getLocal("siteSO");
if(SO.data.visitedAlready)
{
gotoAndPlay("end");
}
else
{
SO.data.visitedAlready = true;
SO.flush();
}
}
// Put that and this in the first keyframe of your movie, before the intro
checkSO(); entonces la ultima frame de vuestra pelicula, cread un frame llamada: end Ya esta. Esto es todo!!!!

 

 

 

 

Gracias por leer este manual, espero que os hayáis divertido con Mambo, y espero haber tenido la oportunidad de enseñaros algo, sobre como crear plantillas Mambo.
Si os gusta este manual, y quereis agradecermelo, por favor os pido que penseis en hacer una donacion o inscribiros en el Template of the Month Club - estos son los links.

Top