phpcms二次开发学习

1、新建模块就是phpcms modules 目录下面新建文件夹,文件夹名即为模块名。 2、模块内 一般新建三个文件夹:classes(模块要使用的类放置在这

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);
    }