Joomla - Twórz moduły
W tym rozdziale będziemy się uczyć Creating Modulesw Joomla. Moduły to rozszerzenia, które są elastyczne, lekkie i przydatne do renderowania stron.
Utwórz moduły
Poniżej przedstawiono proste kroki tworzenia modułów w Joomla.
Step 1 - Utwórz folder o nazwie mod_firstmodule w Twoim Joomla → modules teczka.
Step 2 - W mod_firstmodulefolder utwórz plik o nazwie „helper.php”. Ten plik zawiera nazwę klasy jako pomocnika, pomaga wyświetlić pobrane dane w wyjściu modułu.
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 - Utwórz plik o nazwie as mod_helloworld.php. Jest to punkt wejścia dla modułu, który wykonuje procedury inicjalizacyjne, zbiera niezbędne dane i wyświetla wyjście modułu za pomocą szablonu.
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 - Utwórz plik mod_helloworld.xml file. Ten plik zawiera informacje o module. Ten plik xml zawiera informacje o plikach, które mają zostać zainstalowane w Joomla dla modułu.
plik 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 - Utwórz prosty plik html o nazwie index.html. Celem zapisu tego pliku jest to, że utworzone katalogi nie powinny być przeglądane. Gdy użytkownik przegląda te katalogi, wyświetlany jest plik index.html. Możesz nawet pozostawić ten plik pusty.
index.html
<html>
<body> Welcome to Tutorials Point!!!!! </body>
</html>
Step 6 - Utwórz folder o nazwie jako tmpl. Miejscedefault.php plik, jak pokazano poniżej i index.html (utworzony w kroku (5)) w sekcji tmplteczka. Plik default.php jest szablonem wyświetlającym dane wyjściowe modułu.
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>
Po utworzeniu wszystkich tych plików skompresuj cały folder mod_firstmodule.
Step 7 - Idź do Extension → Extension Managerw administratorze Joomla, a pojawi się następujący ekran. Tutaj możesz przesłać i zainstalować utworzone pliki modułów, tjmod_firstmoduleteczka. KliknijChoose Filei wybierz utworzony plik modułu (skompresowany). KliknijUpload & Install przycisk, aby załadować plik modułu.
Step 8 - Po przesłaniu i instalacji przejdź do Module Manager i kliknij New. Możesz tam wyświetlić utworzony plik modułu, jak pokazano poniżej.
Step 9 - Możesz przypisać ten moduł podobnie do innych modułów, a następnie go opublikować.