phpcms插件
phpcms插件
最近在研究PHP,学了一段时间后感觉想自己写点东西,但是又不知道写什么,最后把目标对准了PHPCMS的插件,从网上找了一下,大部分教程都只是教怎么写插件的具体代码,而没有教怎么把插件打成安装包,特别是官方,只字未提!这里鄙视一下~好了下面把我知道的一些东西写下来,希望能帮到新手~
下面我们先来看一下插件包的具体结构
mytest
–class //这个是mytest模块会用到的类
–function//mytest模块用到的函数
–install//安装此模块需要的一些配置文件和建立数据表myslq语句什么的在这里
–language//多语言的时候会用到
–config.ini.php//这个配置文件是用来描述整个模块的一些信息
–extention.inc.php//这个是创建目录结构 .这个文件也用来控制权限
–model.php//模块使用了哪些数据模型.(可以理解为使用了哪些表.)
–model.sql//这个向数据库里面插入模型的记录
–my_test.sql//这个文件在安装的时候会被执行,把建立数据库表的sql放进来
–templates //,mytest模块用到的模板文件
–uninstall //卸载模块时候用到的配置和文件
这个里面的文件我没研究 回头研究了补上.
my_test.php //这个是mytest模块的后台控制器文件`
index.php//这个是前台的控制器,这个我没写东西.
好了,插件包基本上就是这个样子了~那么接下来分步解释:
建立完一个这样的结构后 我们还需要在/phpcms/model/下面建立我们的数据模型
例如 my_test_model.class.php (这个使用了很典型的工厂模式)
具体每个文件里面写了些什么.我们一个一个来看 .首先来看我们在model文件夹下面写的那个文件.
<?php
defined(\’IN_PHPCMS\’) or exit(\’No permission resources.\’);
pc_base::load_sys_class(\’model\’, \’\’, 0);
class my_test_model extends model {
public function __construct() {
$this->db_config = pc_base::load_config(\’database\’);
$this->db_setting = \’default\’;//默认的数据库配置.//多个库的话可以在这里选库
$this->table_name = \’my_test\’;//这个就是表名称,不用加表前缀
parent::__construct();
}
}
?>
第一行的作用是确定是不是在phpcms的运行框架内.
第二行加载系统的model类,后面的参数0 的意思是并不实例化.
最后一行调用了父类的构造方法.可以在phpcms/libs/classes/model.class.php中找到
而这个model类里面定义了很多对数据的操作方法 最基本的增删改查。以后我再详细说说model基本的一些方法。
接着来看看modules 里面的东东
我们一个个往下面看 第一个language 是用来支持多语言菜单的。
然后是config.ini.php,这个里面写的是一些关于模块安装时候的信息。
文件里面是这个结构的
$module = \’mytest\’;//使用的model
$modulename = \’这里是模块的名称\’;
$introduce = \’模块的描述信息\’;
$author = \’作者\’;
$authorsite = \’作者网站\’;
$authoremail = \’作者email\’;
里面标注的很清楚了
接着是extention.inc.php 这个文件是用来创建后台管理菜单的目录结构的,也是用来控制权限的
$id= $menu_db->insert(array(\’name\’=>\’这里写着操作名称\’, \’parentid\’=>父ID, \’m\’=>\’模块\’, \’c\’=>\’控制器\’, \’a\’=>\’动作\’, \’data\’=>\’\’, \’listorder\’=>排序, \’display\’=>\’是否显示\’),true);//最后的true是用来返回ID的
文件最后应该有一个数组,这个数组是用来插入系统的languagezh-cnsystem_menu.lang.php里面的 格式如下
$language = array(
\’这里是你起的操作名称\’=>\’这里是操作的中文翻译\’,
类似:\’mytest_init\’=>\’显示列表\’
);
这里我分别解释一下:
$id:这个是你这个插件的菜单ID号,主要是用与下级菜单(如果有的话)挂载用的,就是从属于它下面的菜单会通过这个id变量挂到它的下面;
$menu_db->insert():这个是PHPCMS提供的一个方法,具体在集成的系统modul里可以自己去查,这句就是向数据库插入数据用的,里面的参数分别为:数组(要插入的内容),布尔变量(是否返回ID号),布尔变量(是否采用 replace into的方式添加数据);
数组的变量也分别解释一下:
name:这里写着操作名称
parentid:这个变量是父级的ID,就是说你想要让这个菜单显示在什么位置,
m:模块,就是你想调用的模块下面的控制器c和动作a都一样不一一解释了,
data:这个应该是附加数据,具体怎么用暂时不知道,
listorder:排序,主要是用在菜单比较多的时候用来决定排放位置先后顺序的,
display:就是说是不是让这个菜单显示出来,用1和0表示,1代表显示,0代表不显示千万别用例子中的方法啊!
最后只得一说的是parentid这个变量,它不是决定菜单放到什么位置吗?那该如何确定呢?看图:
1位置的”parentid”=>0
2位置的”parentid”=>29
这样就可以把菜单放到需要的位置了~
然后是model.php 这个就是你使用了哪些数据模型 可以理解为使用了哪些表
INSERT INTO `phpcms_module` (`module`, `name`, `url`, `iscore`, `version`, `description`, `setting`, `listorder`, `disabled`, `installdate`, `updatedate`) VALUES ();
然后是mytest.sql 建立你数据库表的语句应该写在这个文件里面
接着就是你所使用的模板 应该放在templates里面 命名的规则应该是 mytest_add.tpl.php
最后是你的控制器 这个有的研究了.控制器里面是针对你每个url传递过来的action也就是a=?的动作.默认动作是init
<?php
defined(\’IN_PHPCMS\’) or exit(\’No permission resources.\’);
pc_base::load_app_class(\’admin\’,\’admin\’,0);
class mytest extends admin(){
public function __construct(){
parent::__construct;//调用父类的构造函数
}
public function init(){
echo “这里是默认的操作方法”;
}
public function add(){
include $this->admin_tpl(\’mytest_add\’);//使用模板的方法
}
}