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
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!!!!!
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)
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::
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:
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:
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:
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:
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:
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 '
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
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 '
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'
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