Joomla - Crea moduli
In questo capitolo, studieremo Creating Modulesin Joomla. I moduli sono le estensioni flessibili, leggere e utili per il rendering delle pagine.
Crea moduli
Di seguito sono riportati i semplici passaggi per creare moduli in Joomla.
Step 1 - Crea una cartella chiamata mod_firstmodule nel tuo Joomla → modules cartella.
Step 2 - Nel mod_firstmodulecartella crea un file chiamato "helper.php". Questo file contiene il nome della classe come helper, aiuta a visualizzare i dati recuperati nell'output del modulo.
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 file chiamato come mod_helloworld.php. È un punto di ingresso per il modulo che esegue le routine di inizializzazione, raccoglie i dati necessari e visualizza l'output del modulo utilizzando il modello.
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 file mod_helloworld.xml file. Questo file contiene le informazioni sul modulo. Questo file xml contiene informazioni sui file che devono essere installati in Joomla per il modulo.
file 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 - Crea un semplice file html chiamato index.html. Lo scopo della scrittura di questo file è che le directory create non dovrebbero essere sfogliate. Quando un utente accede a queste directory, viene visualizzato il file index.html. Puoi anche lasciare vuoto questo file.
index.html
<html>
<body> Welcome to Tutorials Point!!!!! </body>
</html>
Step 6 - Crea una cartella chiamata come tmpl. Postodefault.php file come mostrato di seguito e index.html (creato nel passaggio (5)) in tmplcartella. Il file default.php è un modello che mostra l'output del modulo.
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>
Dopo aver finito di creare tutti questi file, comprimere l'intera cartella mod_firstmodule.
Step 7 - Vai a Extension → Extension Managernell'amministratore di Joomla e otterrai la seguente schermata. Qui puoi caricare e installare i file dei moduli creati, ad esmod_firstmodulecartella. Clicca suChoose Filee seleziona il file del modulo creato (compresso). Clicca suUpload & Install pulsante per caricare il file del modulo.
Step 8 - Dopo il caricamento e l'installazione, vai a Module Manager e fare clic su New. Qui puoi visualizzare il file del modulo creato come mostrato di seguito.
Step 9 - Puoi assegnare questo modulo in modo simile agli altri moduli e quindi pubblicarlo.