Joomla - Tạo mô-đun
Trong chương này, chúng ta sẽ nghiên cứu về Creating Modulestrong Joomla. Mô-đun là các tiện ích mở rộng linh hoạt, nhẹ và hữu ích cho việc hiển thị trang.
Tạo mô-đun
Sau đây là các bước đơn giản để tạo mô-đun trong Joomla.
Step 1 - Tạo một thư mục có tên mod_firstmodule trong của bạn Joomla → modules thư mục.
Step 2 - Trong mod_firstmodulethư mục tạo một tệp có tên là "helper.php". Tệp này chứa tên lớp là trình trợ giúp, nó giúp hiển thị dữ liệu đã truy xuất trong đầu ra của mô-đun.
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 - Tạo một tệp được gọi là mod_helloworld.php. Nó là một điểm vào cho mô-đun thực hiện các quy trình khởi tạo, thu thập dữ liệu cần thiết và hiển thị đầu ra của mô-đun bằng cách sử dụng mẫu.
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 - Tạo một mod_helloworld.xml file. Tệp này chứa thông tin về mô-đun. Tệp xml này chứa thông tin về các tệp sẽ được cài đặt trong Joomla cho mô-đun.
tệp 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 - Tạo một tệp html đơn giản được gọi là index.html. Mục đích của việc viết tệp này là, các thư mục đã tạo sẽ không được duyệt. Khi người dùng duyệt vào các thư mục này, tệp index.html sẽ được hiển thị. Bạn thậm chí có thể giữ cho tệp này trống.
index.html
<html>
<body> Welcome to Tutorials Point!!!!! </body>
</html>
Step 6 - Tạo một thư mục có tên là tmpl. Địa điểmdefault.php tệp như được hiển thị bên dưới và index.html (được tạo ở bước (5)) trong tmplthư mục. Tệp default.php là một mẫu hiển thị đầu ra của mô-đun.
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>
Sau khi bạn hoàn tất việc tạo tất cả các tệp này, hãy nén thư mục hoàn chỉnh mod_firstmodule.
Step 7 - Đi tới Extension → Extension Managertrong quản trị viên Joomla và bạn sẽ nhận được màn hình sau. Tại đây, bạn có thể tải lên và cài đặt các tệp mô-đun đã tạo của mình, tức làmod_firstmodulethư mục. Bấm vàoChoose Filevà chọn tệp mô-đun đã tạo (tệp nén). Bấm vàoUpload & Install để tải lên tệp mô-đun.
Step 8 - Sau khi tải lên và cài đặt, hãy truy cập Module Manager và nhấp vào New. Ở đó, bạn có thể xem tệp mô-đun đã tạo của mình như hình dưới đây.
Step 9 - Bạn có thể gán mô-đun này tương tự với các mô-đun khác và sau đó xuất bản nó.