Joomla - Crear módulos

En este capítulo, estudiaremos sobre Creating Modulesen Joomla. Los módulos son las extensiones que son flexibles, ligeras y útiles para la representación de páginas.

Crear módulos

A continuación se muestran los sencillos pasos para crear módulos en Joomla.

Step 1 - Crea una carpeta llamada mod_firstmodule en tus Joomlamodules carpeta.

Step 2 - En el mod_firstmodulecarpeta crea un archivo llamado "helper.php". Este archivo contiene el nombre de la clase como ayudante, ayuda a mostrar los datos recuperados en la salida del módulo.

helper.php

<?php
   /**
      * Helper class for Hello World! module
      *
      * @package    Joomla.Tutorials
      * @subpackage Modules
      * @link http://docs.joomla.org/J3.x:Creating_a_simple_module/Developing_a_Basic_Module
      * @license        GNU/GPL, see LICENSE.php
      * mod_helloworld is free software. This version may have been modified pursuant
      * to the GNU General Public License, and as distributed it includes or
      * is derivative of works licensed under the GNU General Public License or
      * other free or open source software licenses.
   */
		
   class ModHelloWorldHelper {
      /**
         * Retrieves the hello message
         *
         * @param   array  $params An object containing the module parameters
         *
        * @access public
      */
		
      public static function getHello($params) {
         return 'Hello, World!';
      }
   }
	
?>

Step 3 - Crea un archivo llamado como mod_helloworld.php. Es un punto de entrada para el módulo que realiza rutinas de inicialización, recopila los datos necesarios y muestra la salida del módulo usando una plantilla.

mod_helloworld.php

<?php
   /**
      * Hello World! Module Entry Point
      *
      * @package    Joomla.Tutorials
      * @subpackage Modules
      * @license    GNU/GPL, see LICENSE.php
      * @link       http://docs.joomla.org/J3.x:Creating_a_simple_module/Developing_a_Basic_Module
      * mod_helloworld is free software. This version may have been modified pursuant
      * to the GNU General Public License, and as distributed it includes or
      * is derivative of works licensed under the GNU General Public License or
      * other free or open source software licenses.
   */

   // No direct access
   defined('_JEXEC') or die;

   // Include the syndicate functions only once
   require_once dirname(__FILE__) . '/helper.php';

   $hello = modHelloWorldHelper::getHello($params);
   require JModuleHelper::getLayoutPath('mod_helloworld');
?>

Step 4 - Crea un mod_helloworld.xml file. Este archivo contiene la información sobre el módulo. Este archivo xml contiene información de los archivos que se instalarán en Joomla para el módulo.

archivo mod_helloworld.xml

<?xml version = "1.0" encoding = "utf-8"?>

<extension type = "module" version = "3.1.0" client = "site" method="upgrade">

   <name>Hello, World!</name>
   <author>Tutorials Point</author>
   <version>1.0.0</version>
   <description>A simple Hello World! module.</description>
	
   <files>
      <filename>mod_helloworld.xml</filename>
      <filename module = "mod_helloworld">mod_helloworld.php</filename>
      <filename>index.html</filename>
      <filename>helper.php</filename>
      <filename>tmpl/default.php</filename>
      <filename>tmpl/index.html</filename>
   </files>
	
   <config>
   </config>
	
</extension>

Step 5 - Cree un archivo html simple llamado index.html. El propósito de escribir este archivo es que los directorios creados no deben ser explorados. Cuando un usuario navega por estos directorios, se muestra el archivo index.html. Incluso puede mantener este archivo vacío.

index.html

<html>
   <body> Welcome to Tutorials Point!!!!! </body>
</html>

Step 6 - Crea una carpeta llamada como tmpl. Sitiodefault.php archivo como se muestra a continuación e index.html (creado en el paso (5)) en tmplcarpeta. El archivo default.php es una plantilla que muestra la salida del módulo.

default.php

<?php
   /**
      * @package Joomla.Site
      * @subpackage mod_firstmodule
      * @copyright Copyright (C) 2005 - 2012 Open Source Matters, Inc. All rights reserved.
      * @license GNU General Public License version 2 or later; see LICENSE.txt
   */
defined('_JEXEC') or die;
>

<p>Hello World!!!!!!</p>

Una vez que haya terminado de crear todos estos archivos, comprima la carpeta completa mod_firstmodule.

Step 7 - Ir a ExtensionExtension Manageren el administrador de Joomla y obtendrá la siguiente pantalla. Aquí puede cargar e instalar sus archivos de módulo creados, es decirmod_firstmodulecarpeta. Haga clic enChoose Filey seleccione el archivo de módulo creado (comprimido). Haga clic enUpload & Install para cargar el archivo del módulo.

Step 8 - Después de cargar e instalar, vaya a Module Manager y haga clic en New. Allí puede ver su archivo de módulo creado como se muestra a continuación.

Step 9 - Puede asignar este módulo de manera similar a los otros módulos y luego publicarlo.