Diferencias

Muestra las diferencias entre dos versiones de la página.

--- otros:otros:howto:joomla [2009/12/07 16:44]
alfred
+++ otros:otros:howto:joomla [2020/05/09 09:25] (actual)
@@ Línea 28: / Línea 28: @@
-==== Gestionar el contenido ====
+==== Gestionar el contenido y estructura ====
 === Secciones y categorías ===
 El contenido de Joomla se gestiona a partir de los siguientes apartados:
@@ Línea 46: / Línea 51: @@
 La FrontPage de Joomla es un componente que permite controlar como se ve la página principal, la cual es un poco diferente a las otras. Generalmente se la llama ''Home'' y encontramos su configuración en ''Menu -> mainmenu -> Home -> Parameters''.
-==== Organizar Estructura de la página ====
 === Menús ===
 La estructura de la página la organizamos mediante menús, estos se gestionan en el **Menu Manager** y los apartados de la web corresponden a los elementos que el menú tiene, para agregarlos, en la lista de menús y por cada uno, tendremos un botón denominado ''Menu Items'' a partir del cual podremos cambiar los elementos de este. \\
 Los elementos más destacables son:
-  * **Internal Link -> Articles -> Article layout**: Muestra un sólo artículo (perfecto para los sobre nosotros y tal...).
+  * **Internal Link -> Articles -> Article layout**: Muestra un sólo artículo (perfecto para los "sobre nosotros" y tal...).
   * **External Link**: Agrega un link a un elemento externo de la página.
 El //Menu Item// por defecto del //Menu// por defecto será el elemento que se mostrará como índice.
-=== Módulos ===
+=== Agregar módulos a las páginas ===
-Los módulos son los elementos (que no son el contenido en sí) de cada página, como por ejemplo los menús. Gestionamos los módulos a partir del **Module Manager** y mediante este podemos agregar elementos a nuestras páginas; para ello al hacer new escogemos sus propiedades (si queremos que salga el título, su posición en la página (user1, top, left... todas dadas por la plantilla)...).
+Los módulos son los elementos (que no son el contenido en sí) de cada página, como por ejemplo los menús. Gestionamos los módulos a partir del **Module Manager** y mediante este podemos agregar elementos a nuestras páginas; para ello al hacer new escogemos sus propiedades (si queremos que salga el título, su posición en la página (user1, top, left... todas dadas por la plantilla)...). \\
+Desde el **Module Manager** podemos indicar dónde queremos que nos aparezca un módulo concreto, en qué apartado y tal. Para ello hemos de acceder a ese módulo, configurarlo como siempre y luego escoger en qué apartados aparecerá desde la zona **Menu Assignment**. \\
+Tenemos la posibilidad de, desde el mismo **Module Manager** duplicar un módulo (opción ''copy''), cambiar su configuración y asignarlo a otro ''Menu Item''.
@@ Línea 98: / Línea 101: @@
   * Para quitar el título de la página principal haremos: ''Menus -> Main Menu -> Home -> Parameters - System -> Page Title [Hide]''.
 ===== Avanzado =====
 ==== Creación de plantillas ====
 Las plantillas las colocaremos en una carpeta llamada ''templates'', dentro del directorio raiz de Joomla!. Cada plantilla estará en una carpeta con su nombre y contendrá:
@@ Línea 116: / Línea 125: @@
   * Para agregar los módulos de //bottom//: ''<jdoc:include type="modules" name="bottom" />''
   * Para agregar el contenido: ''<jdoc:include type="component" />''
+  * Para saber la url del sitio: ''<?php echo JURI::base();;?>''
+  * Para saber el nombre de la plantilla: ''<?php echo $this->template ?>''
+  * Para saber el mail del administrador: ''<?php echo $mainframe->getCfg('mailfrom'); ?>''
+  * Para saber el nombre del sitio: ''<?php echo $mainframe->getCfg('sitename'); ?>''
+  * Para consultar un parámetro: ''<?php echo $this->params->get('parametro'); ?>''
 Por ejemplo:
@@ Línea 137: / Línea 151: @@
 === Los CSS ===
-Podremos colocar los css de los elementos del sitio de la siguiente forma:
+Podremos colocar los css de los elementos del sitio indicandolos por sus ids, de la siguiente forma:
 <code css>
 * {padding: 0; margin: 0; }
@@ Línea 147: / Línea 161: @@
 ...
 </code>
+Aunque Joomla tiene algunas clases que aparecen por defecto: \\
+:!: [[http://www.compassdesigns.net/joomla-tutorials/joomla-15-template-tutorial/page-4]]
 === TemplateDetails ===
 El archivo ''TemplateDetails.xml'' es un archivo con formato .xml que nos sirve para especificar las propiedades de la plantilla y se coloca en la raíz de la carpeta de esta. En él se escriben, entre otros los datos de autor y nombres, y será importante indicar los archivos de la plantilla en su correspondiente carpeta contenedora. Si no indicásemos algún archivo ese no sería reconocido ni instalado.
@@ Línea 187: / Línea 201: @@
 </code>
-=== Más... ===
-  * Podemos cambiar el favicon substituyendo el archivo: ''templates/template_name/favicon.ico''.
+=== Template Parameters ===
+Los parámetros de plantillas permiten pasar valores a la plantilla desde el back-end. Para usuarlos en el archivo ''templateDetails.xml'' agregaremos lo siguiente:
+<code xml>
+<params>
+  <param name="template_width" type="list" default="fluid" label="Template Width" description="Width style of the template">
+    <option value="fluid">Fluid with maximum and minimum</option>
+    <option value="medium">Medium</option>
+    <option value="small">Small</option>
+  </param>
+</params>
+</code>
+También necesitaremos agregar un fichero llamado ''params.ini'' en el directorio de la plantilla, aunque este esté vacío Joomla lo necesita para guardar la configuración seleccionada, por ejemplo únicamente podría tener lo siguiente:
+<code>
+template_width=2
+</code>
+Luego podremos consultarlos desde el php.ini:
+<code php>
+<body class="width_<?php echo $this->params->get('template_width'); ?>">
+</code>
+=== Sobreescribir la salida ===
+Podemos indicar el formato en el que queramos recibir el resultado de un módulo para que así no nos salga en la forma por defecto. Para ello cada módulo en su carpeta dentro de Joomla tiene una carpeta denominada ''tmpl'', esta indica el formato por defecto de dicho módulo, por ejemplo los del módulo newflash:
+<code>
+/modules/mod_newsflash/tmpl/default.php
+/modules/mod_newsflash/tmpl/horiz.php
+/modules/mod_newsflash/tmpl/vert.php
+/modules/mod_newsflash/tmpl/_item.php
+</code>
+Podremos cambiarlos para nuestra plantilla, cogiendo el archivo que queramos y colocándolo en un nuevo directorio ''html/<nombre_modulo>/fichero'' de nuestra plantilla, por ejemplo:
+<code>
+templates/nuestra_plantilla/html/mod_newsflash/_item.php
+</code>
-===== Notas =====
+De la misma forma que los módulos podremos cambiar los componentes, por ejemplo en la carpeta components de joomla podríamos encontrar:
+<code>
+/components/com_content/views/
+/components/com_content/views/archive
+/components/com_content/views/article
+/components/com_content/views/category
+/components/com_content/views/section
+...
+/components/com_content/views/category/blog.php
+/components/com_content/views/category/blog_item.php
+/components/com_content/views/category/blog_links.php
+/components/com_content/views/category/default.php
+/components/com_content/views/category/default_items.php
+</code>
+Esta carpeta corresponde al componente que muestra el contenido, archivo, artículo, categoría... Dentro de un directorio ''views'' encontramos otro directorio ''tmpl''. :!:
+=== Otros ===
+  * Cambiar el título de la página:
+<code php>
+<?php
+$document =& JFactory::getDocument();
+$document->setTitle($mainframe->getCfg('sitename') . " - " . $document->title);
+?>
+</code>
+===== Notas =====
+==== Módulos útiles ====
+  * [[http://extensions.joomla.org/extensions/directory-a-documentation/downloads/6125|Jx List Files]], carga de un directorio una lista con los ficheros existentes en este.
 ==== Links ====

Programming

Herramientas de usuario

Herramientas del sitio

Diferencias

Herramientas de la página