1、新建模块就是phpcms/modules/目录下面新建文件夹,文件夹名即为模块名。
2、模块内 一般新建三个文件夹:classes(模块要使用的类放置在这个文件夹,通过pc_base::load_app_classes()函数加载使用 )///
functions(模块要使用的函数放置在这个文件夹,通过pc_base::load_app_func()函数加载使用)////
template(模块后台管理的模板文件,通过$this->admin_tpl()方法调用)///
除此之外,经常还有install文件夹和uninstall文件夹。具体参照安装源码包。
3、模块的实现机制。
控制器:即模块内的一个php文件,这是个类文件,文件名和文件内定义的类名必须一致。
当我们在浏览器输入index.php?m=模块名&c=控制器名&c=控制器内方法名 时候,首先找到模块文件夹,再找到控制器,然后调用控制器内的方法。
控制器内方法一般有两类:(1)显示一些内容;(2)处理提交的内容;
对于“显示一些内容”的方法,首先准备一些模板中需要使用的变量,然后使用include template('','')调用模板。最重要的是模板的调用,模板中需要的变量必须在控制器内的方法中定义。
一般如下:
public function list_type() { $siteid = SITEID; $type_id = trim(urldecode($_GET['type_id'])); $type_id = intval($type_id); if($type_id==""){ $type_id ='0'; } $setting = getcache('link', 'commons'); $SEO = seo(SITEID, '', L('link'), '', ''); include template('link', 'list_type');//这一句是模板调用,这一句上面的语句基本都是为这一句做准备 }
对于“处理提交的内容”,一般结构是这样的:
public function register() { $siteid = SITEID;//定义下面所需变量 if(isset($_POST['dosubmit'])){//如果提交按钮按下去了,执行下面的操作,一般就是插入数据库并显示插入成功 if($_POST['name']==""){ showmessage(L('sitename_noempty'),"?m=link&c=index&a=register&siteid=$siteid"); } if($_POST['url']==""){ showmessage(L('siteurl_not_empty'),"?m=link&c=index&a=register&siteid=$siteid"); } if(!in_array($_POST['linktype'],array('0','1'))){ $_POST['linktype'] = '0'; } $link_db = pc_base::load_model(link_model);//加载数据模型 $_POST['logo'] =new_html_special_chars($_POST['logo']); $logo = safe_replace(strip_tags($_POST['logo'])); $name = safe_replace(strip_tags($_POST['name'])); $url = safe_replace(strip_tags($_POST['url'])); if($_POST['linktype']=='0'){ $sql = array('siteid'=>$siteid,'typeid'=>intval($_POST['typeid']),'linktype'=>intval($_POST['linktype']),'name'=>$name,'url'=>$url); }else{ $sql = array('siteid'=>$siteid,'typeid'=>intval($_POST['typeid']),'linktype'=>intval($_POST['linktype']),'name'=>$name,'url'=>$url,'logo'=>$logo); } $link_db->insert($sql);//执行数据插入操作 showmessage(L('add_success'), "?m=link&c=index&siteid=$siteid");//显示插入成功 } else { //否则就显示页面,等待输入并提交 $setting = getcache('link', 'commons'); $setting = $setting[$siteid]; if($setting['is_post']=='0'){ showmessage(L('suspend_application'), HTTP_REFERER); } $this->type = pc_base::load_model('type_model'); $types = $this->type->get_types($siteid);//获取站点下所有友情链接分类 pc_base::load_sys_class('form', '', 0); $SEO = seo(SITEID, '', L('application_links'), '', ''); include template('link', 'register'); } }
4、关于模板
模板中使用的是标签技术,比如内容模块中,用来显示分类的标签如下:
{pc:content action="lists" catid="15" num="8" order="id DESC" page=""}
那么,如果是我们自己定义的模块呢?应该是这个样子:
{pc:模块名 action="动作函数" catid="15" num="8" order="id DESC" page=""}
模块名不用多说,就是刚才我们定义的文件夹名。那么动作函数是哪来的呢?它定义在模块名/classes目录下的“模块名_tag.class.php”中,同样,这个类文件内主类名也应该是“模块名_tag”,此中定义一个名为“动作函数”的方法。这个方法接收一个参数data,这是一个数组参数,数组的键名就是上面的action,catid,num,order,page等等(这些变量名是可以自己定义的),值就是“动作函数”,15,8,等。
一个典型的格式如下:
public function type_lists($data) { if (!in_array($data['listorder'], array('desc', 'asc'))) { $data ['listorder'] = 'desc'; } $sql = array('module'=>ROUTE_M,'siteid'=>$data['siteid']); $r = $this->type_db->select($sql, '*', $data['limit'], 'listorder '.$data['listorder']); return new_html_special_chars($r); }