posts - 4,comments - 30,trackbacks - 0

按: 本教程非原创,版权归Keliix06所有.

快速创建一个简单的MAMBO组件
作者:Keliix06
译者:Applebee
本教程将安装一个“Hello World”组件,你可以去编辑或者加入你自己想要的消息。本教程不涉及如何设置分类,搜索功能和页面导航。并假定你对PHP有一个基本的了解。
创建本组件将用到以下文件:
hello_world.xml- 组件安装配置文件
hello_world.php- 显示界面信息
admin.hello_world.php- 数据库查询和设置HTML输出
admin.hello_world.html.php- 控制所有的输出
class.hello_world.php- 数据库类文件
install.hello_world.php- 安装文件
uninstall.hello_world.php- 卸载文件
toolbar.hello_world.php- 设置工具栏
toolbar.hello_world.html.php- 控制工具栏的输出

现在我们已经清楚了要制作什么样的文件,下面我们一个文件一个文件的介绍它们如何实现各自的功能。


Hello_world.xml- 组件安装配置文件

<?xml version="1.0" ?>
<mosinstall type="component">
<name>hello_world</name>
<creationDate>04/15/2004</creationDate>
<author>Doyle Lewis</author>
<copyright>This component in released under the GNU/GPL License</copyright>
<authorEmail> support@mambo-hosting.com

</authorEmail>
<authorUrl>www.mambo-hosting.com</authorUrl>
<version>1.0</version>
<files>
<filename>hello_world.php</filename>
</files>
<install>
<queries>
<query>DROP TABLE IF EXISTS `mos_hello_world`;</query>
<query>CREATE TABLE `mos_hello_world` (
`id` INT NOT NULL AUTO_INCREMENT,
`text` TEXT NOT NULL,
`published` TINYINT(1) NOT NULL,
PRIMARY KEY (`id`)
)
</query>
</queries>
</install>
<uninstall>
<queries>
<query>DROP TABLE IF EXISTS `mos_hello_world`;</query>
</queries>
</uninstall>
<installfile>
<filename>install.hello_world.php</filename>
</installfile>
<uninstallfile>
<filename>uninstall.hello_world.php</filename>
</uninstallfile>
<administration>
<menu>Hello World</menu>
<submenu>
<menu act="all">Show Text</menu>
</submenu>
<files>
<filename>admin.hello_world.php</filename>
<filename>admin.hello_world.html.php</filename>
<filename>class.hello_world.php</filename>
<filename>toolbar.hello_world.php</filename>
<filename>toolbar.hello_world.html.php</filename>
</files>
</administration>
</mosinstall>

我们来看它是如何工作的:

<?xml version="1.0" ?>
XML的开头语,为所有XML文件所必需。

<mosinstall type="component">
告诉MAMBO将开始安装一个组件

<name>hello_world</name>
<creationDate>04/15/2004</creationDate>
<author>Doyle Lewis</author>
<copyright>This component in released under the GNU/GPL License</copyright>
<authorEmail> support@mambo-hosting.com

</authorEmail>
<authorUrl>www.mambo-hosting.com</authorUrl>
<version>1.0</version>
组件的详细信息,所有有关组件的信息只能在这加入。

<files>
<filename>hello_world.php</filename>
</files>
所有需要安装在组件界面需要的文件,将被安装到components/com_hello_world/目录下。

<install>
<queries>
<query>DROP TABLE IF EXISTS `mos_hello_world`;</query>
<query>CREATE TABLE `mos_hello_world` (
`id` INT NOT NULL AUTO_INCREMENT,
`text` TEXT NOT NULL,
`published` TINYINT(1) NOT NULL,
PRIMARY KEY (`id`)
)
</query>
</queries>
</install>
安装组件所需的数据库查询语句,本组件中将创建一个有三个字段的表。你可以运行phpMyadmin来得到一所需的查询语句的,这是一个很简单易行的办法。

<uninstall>
<queries>
<query>DROP TABLE IF EXISTS `mos_hello_world`;</query>
</queries>
</uninstall>
卸载组件所需的查询语句,这里只是简单的删除了数据库表格。

<installfile>
<filename>install.hello_world.php</filename>
</installfile>
<uninstallfile>
<filename>uninstall.hello_world.php</filename>
</uninstallfile>
这几行代码是用来说明安装和卸载组件所用到的文件名。

<administration>
从这行起所有的东东将安装到管理员目录下。

<menu>Hello World</menu>
这行将被显示到管理面板中的“组件”的下拉菜单中。

<submenu>
<menu act="all">Show Text</menu>
</submenu>
这几行代码将产生一个二级菜单(相对于刚才产生的Hello World菜单选项),这也将告诉MAMBO你的组件将有些什么功能。
<files>
<filename>admin.hello_world.php</filename>
<filename>admin.hello_world.html.php</filename>
<filename>class.hello_world.php</filename>
<filename>toolbar.hello_world.php</filename>
<filename>toolbar.hello_world.html.php</filename>
</files>
所有将被安装到administrator/components/com_hello_world/目录下的文件。

</administration>
</mosinstall>
结束MAMBO组件安装

hello_world.php-界面显示文件

<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
global $database;
$query = "SELECT * FROM mos_hello_world LIMIT 1";
$database->setQuery( $query );
$rows = $database->loadObjectList();
$row = $rows[0];
echo $row->text;
?>

让我们来看一下这个文件。

defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
这个将验证是否由MAMBO来调用此文件,防止非法直接运行本文件,对于安全性非常重要。

global $database;
将$database设置为全局变量,你可以在你的函数中使用$database。
$query = "SELECT * FROM mos_hello_world LIMIT 1";
输出mos_hello_world表中的第一个记录。

$database->setQuery( $query );
用database类中的数据库查询函数调用上述的查询。

$rows = $database->loadObjectList();
用变量$rows 以数列方式存储查询结果。

$row = $rows[0];
用变量 $row 存储$row中的第一个元素。

echo $row->text;
打印输出text.

admin.hello_world.php -数据库查询和设置HTML输出
<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
require_once($mosConfig_absolute_path."/administrator/components/com_hello_world/class.hello_world.php");
require_once( $mainframe->getPath( 'admin_html' ) );
switch ($act) {
default:
$task = "showText";
break;
}
switch ($task) {
case "save":
save( $option );
break;
case "delete":
delete( $option, $id );
break;
case "new":
$id = '';
edit( $option, $id );
break;
case "edit":
save( $option, $id[0] );
break;
case "showText":
showText( $option );
break;
}
function save( $option ) {
global $database;
$row = new mosHello_world( $database );
if (!$row->bind( $_POST )) {
echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n";
exit();
}
if (!$row->store()) {
echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n";
exit();
}
mosRedirect( "index2.php?option=$option", "Saved" );
}
function edit( $option, $uid ) {
global $database;
$row = new mosHello_world( $database );
$row->load( $uid );
HTML_hello_world::edit( $option, $row );
}
function delete( $option, $cid ) {
global $database;
if (!is_array( $cid ) || count( $cid ) < 1) {
echo "<script> alert('Select an item to delete'); window.history.go(-1);</script>n";
exit;
}
if (count( $cid )) {
$cids = implode( ',', $cid );
$database->setQuery( "DELETE FROM mos_hello_world WHERE id IN ($cids)" );
if (!$database->query()) {
echo "<script> alert('".$database->getErrorMsg()."'); window.history.go(-1); </script>n";
}
}
mosRedirect( "index2.php?option=$option" );
}
function showText($option) {
global $database;
# Do the main database query
$database->setQuery( "SELECT * FROM mos_hello_world ORDER BY id" );
$rows = $database->loadObjectList();
if ($database->getErrorNum()) {
echo $database->stderr();
return false;
}
HTML_hello_world::showText( $option, $rows );
}
让我们来看看这个文件
:
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
这个将验证是否由MAMBO来调用此文件,防止非法直接运行本文件,对于安全性非常重要。

require_once($mosConfig_absolute_path."/administrator/components/com_hello_world/class.hello_world.php");
require_once( $mainframe->getPath( 'admin_html' ) );
调用以下两文件 class.hello_world.php and admin.hello_world.html.php

switch ($act) {
default:
$task = "showText";
break;
}
建立一个选择开关语句这样假如有一个变量$act 我们将重定义一个新变量$task. 这样$act 将用来实现显示文字的函数中,而$task将被用在保存,删除等。.

switch ($task) {
case "save":
save( $option );
break;
case "delete":
delete( $option, $id );
break;
case "new":
$id = '';
edit( $option, $id );
break;
case "edit":
save( $option, $id[0] );
break;
case "showText":
showText( $option );
break;
}
这个开关语句将根据$task来运行所需的函数。

function save( $option ) {
我们的第一个函数,将保存我们创建或正在编辑的内容。

global $database;
声明$database为全局变量。

$row = new mosHello_world( $database );
这将定义$row新变量来存储插入到数据库中的信息,$row是class class.hello_world.php文件定义的mosHello_world类的一个实例。

if (!$row->bind( $_POST )) {
echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n";
exit();
}
假如 $row 返回空值,显示错误信息并返回上一个窗口。

if (!$row->store()) {
echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n";
exit();
}
假如不能完成对数据库的写操作,将显示错误信息并返回上一个窗口,这仅仅会在数据库出现异常时会出现。

mosRedirect( "index2.php?option=$option", "Saved" );
假如一切正常将重定向你的浏览器到主选项窗口,并显示"Saved".

function edit( $option, $uid ) {
很多代码可参照前面的解释,这里不再赘述。

$row->load( $uid );
定义了$row后并声明它为mosHello_world类,装载$uid相关的数据. $uid是
我们想编辑的内容的$id的值。

HTML_hello_world::edit( $option, $row );
将$row 传递到admin.hello_world.html.php 显示。
.
function delete( $option, $cid ) {
同前,这里不再赘述。

if (!is_array( $cid ) || count( $cid ) < 1) {
echo "<script> alert('Select an item to delete'); window.history.go(-1);</script>n";
exit;
}
这将检验是否有删除对象,如为空将显示提示信息并返回上一个窗口。

if (count( $cid )) {
$cids = implode( ',', $cid );
$database->setQuery( "DELETE FROM mos_hello_world WHERE id IN ($cids)" );
if (!$database->query()) {
echo "<script> alert('".$database->getErrorMsg()."'); window.history.go(-1); </script>n";
}
这将检验$cid (存储所有欲删除的对象的$id值的数列)是否为空,如果不为空它将创建一个以逗号为分隔符的所有id的列表并存储在字符串$cids然后根据相应的id进行删除操作,如果操作出错将返回上一个窗口。

function showText($option) {
这是我们的主输出函数,将创建我们要输出的文字的列表,解释参照前面所述。

admin.hello_world.html.php –控制所有的输出.
<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
// ensure this file is being included by a parent file
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
require_once($mosConfig_absolute_path."/administrator/components/com_hello_world/class.hello_world.php");
class HTML_hello_world {
function edit( $option, &$row ) {
?>
<script language="javascript" type="text/javascript">
function submitbutton(pressbutton) {
var form = document.adminForm;
if (pressbutton == "cancel") {
submitform( pressbutton );
return;
}
submitform( pressbutton );
}
</script>
<form action="index2.php" method="post" name="adminForm" id="adminForm" class="adminForm">
<table border="0" cellpadding="3" cellspacing="0">
<tr>
<td>Text Output: </td>
<td><input type="text" size="50" maxsize="100" name="text" value="<?php echo $row->text; ?>" /></td>
</tr>
</table>
<input type="hidden" name="id" value="<?php echo $row->id; ?>" />
<input type="hidden" name="option" value="<?php echo $option; ?>" />
<input type="hidden" name="task" value="" />
</form>
<?php } ?>
function showText( $option, &$rows ) {
?>
<script language="javascript" type="text/javascript">
function submitbutton(pressbutton) {
var form = document.adminForm;
if (pressbutton == "cancel") {
submitform( pressbutton );
return;
}
submitform( pressbutton );
}
</script>
<form action="index2.php" method="post" name="adminForm">
<table cellpadding="4" cellspacing="0" border="0" width="100%" class="adminlist">
<tr>
<th width="20"><input type="checkbox" name="toggle" value="" onclick="checkAll(<?php echo count($rows); ?>);"
/></th>
<th class="title" width="25%">Text Output</th>
<th width="25%">Published</th>
</tr>
<?php
$k = 0;
for($i=0; $i < count( $rows ); $i++) {
$row = $rows[$i];
?>
<tr class="<?php echo "row$k"; ?>">
<td><input type="checkbox" id="cb<?php echo $i;?>" name="id[]" value="<?php echo $row->id; ?>"
onclick="isChecked(this.checked);" /></td>
<td><a href="http://www.mambochina.net/content/view/48_38.html#edit" onclick="return listItemTask('cb<?php echo $i;?>','edit')"><?php echo $row->text; ?></a></td>
<td align="center">
<?php
if ($row->published == "1") {
echo "<img src="images/tick.png" border="0" />";
} else {
echo "<img src="images/publish_x.png" border="0" />";
}
?>
</td>
<?php $k = 1 - $k; ?>
</tr>
<?php } ?>
<input type="hidden" name="option" value="<?php echo $option; ?>" />
<input type="hidden" name="task" value="" />
<input type="hidden" name="boxchecked" value="0" />
</form>
<?php }
} ?>

我们来看一下这个文件
class HTML_hello_world {
声明一个新类:HTML_hello_world

function edit( $option, &$row ) {
声明edit函数, 将显示用来创建新内容并编辑已有的内容的表单。

<script language="javascript" type="text/javascript">
function submitbutton(pressbutton) {
var form = document.adminForm;
if (pressbutton == "cancel") {
submitform( pressbutton );
return;
}
submitform( pressbutton );
}
</script>
这将检验你是否按下了任何工具栏的按钮,你可以加入任何表单验证代码在这里。

<form action="index2.php" method="post" name="adminForm" id="adminForm" class="adminForm">
你可以将这段代码拷贝到任何组件中,它必须包括这些标签。

<input type="hidden" name="id" value="<?php echo $row->id; ?>" />
<input type="hidden" name="option" value="<?php echo $option; ?>" />
<input type="hidden" name="task" value="" />
保存或取消操作所必须的option和task字段。

function showText( $option, &$rows ) {
将显示所有的文字部分。.

<th width="20"><input type="checkbox" name="toggle" value="" onclick="checkAll(<?php echo count($rows); ?>);"
/></th>
这将快速全选所有的选择框。

<?php
$k = 0;
for($i=0; $i < count( $rows ); $i++) {
$row = $rows[$i];
$k用来产生行的替换图效果,for 语句将保证遍列所有的结果。

<td><input type="checkbox" id="cb<?php echo $i;?>" name="id[]" value="<?php echo $row->id; ?>"
onclick="isChecked(this.checked);" /></td>
这将选上本行的选择框。

<td><a href="http://www.mambochina.net/content/view/48_38.html#edit" onclick="return listItemTask('cb<?php echo $i;?>','edit)"><?php echo $row->text; ?></a></td>
将产生编辑此项的链接。

<?php
if ($row->published == "1") {
echo "<img src="images/tick.png" border="0" />";
} else {
echo "<img src="images/publish_x.png" border="0" />";
}
?>
假如此行被设置为发行,你将看到一个绿的叉,否则将看到一个小红叉。

<?php $k = 1 - $k; ?>
将 $k设为 1和它自身的差值,假如$k是 0,它就等于1,假如它等于1它就被设为0.

<input type="hidden" name="boxchecked" value="0" />
这行代码很重要不然所有的选择框将不能正常工作。


class.hello_world.php -数据库类文件.
<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
class mosHello_world extends mosDBTable {
// INT(11) AUTO_INCREMENT
var $id=null;
// TEXT
var $text=null;
// TINYINT(1)
var $published=null;
function mosHello_world( &$db ) {
$this->mosDBTable( 'mos_hello_world', 'id', $db );
}
}

我们来看一下这个文件

class mosHello_world extends mosDBTable {
声明类mosHello_world为mosDBTable的派生类,你可以将mosHello_world改成你自己的类名称。

// INT(11) AUTO_INCREMENT
var $id=null;
注释行只是给出了变量的一些信息,变量名必须和你数据库的相应字段相符合并将它们设为空值。

function mosHello_world( &$db ) {
$this->mosDBTable( 'mos_hello_world', 'id', $db );
}
调用父类的构造函数,你可以调用$row=new mosHello_world($database)来得到想要的结果。
install.hello_world.php – 安装文件.
<?php
function com_install() {
echo "Thank you for using this component. Please contact me at support@mambo-hosting.com

with any questions";
}
?>
在文件中调用函数com_install(),不然会导致异常。

uninstall.hello_world.php – 卸载文件.
<?
function com_uninstall() {
echo "Thank you for using this component. Please contact me at support@mambo-hosting.com

with any questions";
}
?>
在文件中调用函数com_uninstall(),不然会导致异常。

toolbar.hello_world.php -设置工具栏
<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
require_once( $mainframe->getPath( 'toolbar_html' ) );
if($task) {
switch($task) {
case 'new':
case 'edit':
$act = "edit";
break;
}
}
if ($act) {
switch ( $act ) {
case 'edit':
menuHello_world::EDIT_MENU();
break;
case 'text':
menuHello_world::TEXT_MENU();
break;
}
}
?>
我们来看一下这个文件

require_once( $mainframe->getPath( 'toolbar_html' ) );
和在admin.hello_world.php中包括admin.hello_world.html.php一样

if($task) {
switch($task) {
case 'new':
case 'edit':
$act = "edit";
break;
}
}
"new" 和"edit" 将应用相同的工具栏。

case 'edit':
menuHello_world::EDIT_MENU();
break;
告诉toolbar.hello_world.html.php 该调用哪个函数。


toolbar.hello_world.html.php -控制工具栏的输出
<?php
//hello_world Component//
/**
* Content code
* @package hello_world
* @Copyright (C) 2004 Doyle Lewis
* @ All rights reserved
* @ hello_world is Free Software
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html
* @version 1.0
**/
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
class menuHello_world {
function TEXT_MENU() {
mosMenuBar::startTable();
mosMenuBar::publish('publish');
mosMenuBar::unpublish('unpublish');
mosMenuBar::divider();
mosMenuBar::addNew('new');
mosMenuBar::editList('edit', 'Edit');
mosMenuBar::deleteList( ' ', 'delete', 'Remove' );
mosMenuBar::endTable();
}
function EDIT_MENU() {
mosMenuBar::startTable();
mosMenuBar::back();
mosMenuBar::save('save');
mosMenuBar::spacer();
mosMenuBar::endTable();
}
}
?>
class menuHello_world {
Sets the toolbar class
function TEXT_MENU() {
mosMenuBar::startTable();
mosMenuBar::publish('publish');
mosMenuBar::unpublish('unpublish');
mosMenuBar::divider();
mosMenuBar::addNew('new');
mosMenuBar::editList('edit', 'Edit');
mosMenuBar::deleteList( ' ', 'delete', 'Remove' );
mosMenuBar::endTable();
}
告诉mosMenuBar 在工具栏中输出什么内容,括号中小写的内容将告诉admin.hello_world.php
执行哪个任务。

希望诸位看官眼睛还没有花:-) 这只是对组件的一个很简单的介绍,但是如果你打印本教程的话还是有16页之长:-)* 希望本教程能帮助你设计出更强大的MAMBO组件(没准会收入MAMBO5.0版中哦)


*这里其实有17页,因为我重新排了一下版。


原文代码在我的机器中安装有许多问题, 大家可下载我修改后的代码对比源码, 仅供新手学习使用(共同学习.... )

posted on 2006-03-07 10:55 蛮哥♂枫 阅读(453) 评论(2)  编辑  收藏 所属分类: mambo

FeedBack:
# re: 轻松开发自己的组件
2009-05-05 20:08 | wholesale
very good <a href="http://www.13sz.com">Wholesale Electronics</a>  回复  更多评论
  
# re: 轻松开发自己的组件
2012-02-29 13:39 | 智能卡
太长的代码  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航: