phpcms-v9 前台模板文件中{pc}标签的执行流程

前台pc标签的使用：{pc:content 参数名="参数值" 参数名="参数值" 参数名="参数值"}
如： {pc:content action="lists" catid="9" cache="3600" num="20" page="$page"}{/pc}
执行流程如下：
     ①模块名：content
     ②模块类文件：modules/content/classes/content_tag.class.php，便于二次开发或标签的扩展
     ③文件中的方法：lists
     ④action后面的参数以数组的形式传递给lists方法，如：function lists($data=array())
此标签实际获取的是：content_tag.class.php文件中lists方法返回的数据
注意：此标签会根据catid的值去寻找对应的模型id，然后再根据对应的模型id寻找到对应的模型表，如：news
注意：几乎所有的模块都有一个标签类,格式如下:模块名_tag.class.php
注意：前台模板文件中出现{pc}标签的位置，都可在"碎片管理"中进行编辑修改，非常方便

content_tag.class.php文件分析-pc标签调用的方法

 <?php
 class content_tag {
     private $db;                                                            //主要针对v9_news表
     public function __construct() {
         $this->db = pc_base::load_model('content_model');                    //数据模型，对应数据表news 和 news_data
         $this->position = pc_base::load_model('position_data_model');        //position_data表
     }
     /**
      * 初始化模型,其实就是为了根据栏目id设置对应对应的模型表及数据表：news-模型表、v9_news-数据表
      * @param $catid
      */
     public function set_modelid($catid) {
         $siteids = getcache('category_content','commons');    //获取所有栏目所属的站点id
         if(!$siteids[$catid]) return false;                    //不存在此栏目，返回false
         $siteid = $siteids[$catid];                            //当前栏目所属站点id
         $this->category = getcache('category_content_'.$siteid,'commons');//获取当前站点id下所有栏目的配置信息
         if($this->category[$catid]['type']!=0) return false;//如果不为内部栏目，返回false  0-内部栏目 1-单网页 2-外部链接
         $this->modelid = $this->category[$catid]['modelid'];//获取当前栏目所属模型id
         $this->db->set_model($this->modelid);                //根据模型id获取当前模型所对应的模型表和数据表 1：文档模型-news  3：图片模型-picture   2：下载模型-download
         $this->tablename = $this->db->table_name;            //数据表:v9_news
         if(empty($this->category)) {                        //如果当前站点下不存在栏目配置信息，则返回false
             return false;
         } else {                                            //如果当前站点下存在栏目配置信息，则返回true
             return true;
         }
     }
     /**
      * 分页统计
      * @param $data
      */
     public function count($data) {
         if($data['action'] == 'lists') {
             $catid = intval($data['catid']);
             if(!$this->set_modelid($catid)) return false;
             if(isset($data['where'])) {
                 $sql = $data['where'];
             } else {
                 if($this->category[$catid]['child']) {
                     $catids_str = $this->category[$catid]['arrchildid'];
                     $pos = strpos($catids_str,',')+1;
                     $catids_str = substr($catids_str, $pos);
                     $sql = "status=99 AND catid IN ($catids_str)";
                 } else {
                     $sql = "status=99 AND catid='$catid'";
                 }
             }
             return $this->db->count($sql);
         }
     }

     /**
      * 列表页标签：主要返回的是主表中数据与附表中数据， {pc:content action="lists"} {/pc}标签调用的都是lists方法
      * @param $data
      */
     public function lists($data) {
         $catid = intval($data['catid']);                                    //pc标签中catid属性
         if(!$this->set_modelid($catid)) return false;                        //会根据栏目id->对应的模型id->对应的模型表
         if(isset($data['where'])) {                                            //如果pc标签中设置了where属性，一般情况下不存在
             $sql = $data['where'];
         } else {                                                            //如果pc标签中没有设置where属性
             $thumb = intval($data['thumb']) ? " AND thumb != ''" : '';        //如果有thumb属性
             if($this->category[$catid]['child']) {                            //当前栏目下是否存在子栏目
                 $catids_str = $this->category[$catid]['arrchildid'];        //所有子栏目id，包括当前栏目自身id
                 $pos = strpos($catids_str,',')+1;
                 $catids_str = substr($catids_str, $pos);                    //所有子栏目id,不包括当前栏目自身id
                 $sql = "status=99 AND catid IN ($catids_str)".$thumb;        //拼接成一个sql语句
             } else {
                 $sql = "status=99 AND catid='$catid'".$thumb;                //如果当前栏目下不存在子栏目
             }
         }
         $order = $data['order'];                                            //pc标签中order属性
         //$sql作为一个条件出现，调用的是model.calss.php文件中的select方法，返回结果集数组，并按照键名'id'排序
         $return = $this->db->select($sql, '*', $data['limit'], $order, '', 'id');//从数据库中获取主表数据，使用的也是sql语句查询

         //调用副表的数据
         if (isset($data['moreinfo']) && intval($data['moreinfo']) == 1) {    //如果pc标签中设置了moreinfo属性：是否调用附表数据
             $ids = array();
             //$return为返回的主表数据
             foreach ($return as $v) {                                        //循环主表中的记录信息:$v-主表中的每条记录
                 if (isset($v['id']) && !empty($v['id'])) {
                     $ids[] = $v['id'];                                        //ids[]是主表中排序完成的文章id数组
                 } else {
                     continue;
                 }
             }
             if (!empty($ids)) {
                 $this->db->table_name = $this->db->table_name.'_data';        //副表名
                 $ids = implode('\',\'', $ids);                                //以逗号拼接成一个字符串
                 $r = $this->db->select("`id` IN ('$ids')", '*', '', '', '', 'id');//查询与主表中数据有关的副表中的数据
                 if (!empty($r)) {
                     foreach ($r as $k=>$v) {                                //副表中的数据
                         //$return:返回的主表中的数据，主表中的id字段值与附表中的id字段值是对应的，也就是说一篇文章在主表中存储的id跟在附表中存储的id的值是相等的
                         if (isset($return[$k])) $return[$k] = array_merge($v, $return[$k]);//主表中数据与副表中数据合并
                     }
                 }
             }
         }
         return $return;
     }

     /**
      * 相关文章标签，{pc:content action="relation"} {/pc}标签调用的都是relation方法
      * @param $data
      */
     public function relation($data) {
         $catid = intval($data['catid']);                                    //pc标签的catid属性：栏目id
         if(!$this->set_modelid($catid)) return false;
         $order = $data['order'];                                            //pc标签的order属性
         $sql = "`status`=99";                                                //拼接sql
         $limit = $data['id'] ? $data['limit']+1 : $data['limit'];
         if($data['relation']) {                                                //pc标签的relation属性：相关文章id   格式如下：2|7|5
             $relations = explode('|',trim($data['relation'],'|'));            //以 | 分割成一个数组
             $relations = array_diff($relations, array(null));
             $relations = implode(',',$relations);
             $sql = " `id` IN ($relations)";                                    //拼接sql
             $key_array = $this->db->select($sql, '*', $limit, $order,'','id');//关联的文章
         } elseif($data['keywords']) {                                        //相关关键词
             $keywords = str_replace('%', '',$data['keywords']);
             $keywords_arr = explode(' ',$keywords);                            //以空格将关键词分割为一个数组
             $key_array = array();
             $number = 0;                                                    //相关热词文章数量
             $i =1;                                                            //控制返回文章数量的标识
             foreach ($keywords_arr as $_k) {
                 $sql2 = $sql." AND `keywords` LIKE '%$_k%'".(isset($data['id']) && intval($data['id']) ? " AND `id` != '".abs(intval($data['id']))."'" : '');
                 $r = $this->db->select($sql2, '*', $limit, '','','id');
                 $number += count($r);                                        //所有热词文章的总量
                 foreach ($r as $id=>$v) {
                     if($i<= $data['limit'] && !in_array($id, $key_array)) $key_array[$id] = $v;//$key_array[文章id]=文章记录
                     $i++;
                 }
                 if($data['limit']<$number) break;
             }
         }
         if($data['id']) unset($key_array[$data['id']]);//针对性的屏蔽某篇文章
         return $key_array;
     }

     /**
      * 排行榜标签{pc:content action="hits"} {/pc}标签调用的都是hits方法
      * @param $data
      */
     public function hits($data) {
         $catid = intval($data['catid']);                                    //栏目id，pc标签的catid属性
         if(!$this->set_modelid($catid)) return false;                        //根据栏目id->对应的模型id->模型表，如：news

         $this->hits_db = pc_base::load_model('hits_model');                    //hits：点击量表
         $sql = $desc = $ids = '';
         $array = $ids_array = array();
         $order = $data['order'];                                            //pc标签中order属性
         $hitsid = 'c-'.$this->modelid.'-%';                                    //hits点击量表中hitsid字段的组成：c-模型id-文章id
         $sql = "hitsid LIKE '$hitsid'";                                        //拼接sql
         if(isset($data['day'])) {                                            //pc标签中day属性：表示调用多少天内的排行
             $updatetime = SYS_TIME-intval($data['day'])*86400;                //表示调用多少天内的排行
             $sql .= " AND updatetime>'$updatetime'";                        //拼接sql
         }
         if($this->category[$catid]['child']) {                                //当前栏目是否有子栏目
             $catids_str = $this->category[$catid]['arrchildid'];            //当前栏目下所有子栏目id，包括当前栏目自身的id
             $pos = strpos($catids_str,',')+1;
             $catids_str = substr($catids_str, $pos);                        //当前栏目下所有子栏目id，不包括当前栏目自身id
             $sql .= " AND catid IN ($catids_str)";                            //拼接sql
         } else {
             $sql .= " AND catid='$catid'";                                    //如果当前栏目不存在子栏目
         }
         $hits = array();
         $result = $this->hits_db->select($sql, '*', $data['limit'], $order);//查询v9_hits点击量表
         foreach ($result as $r) {                                            //$result:v9_hits表中返回的数据
             $pos = strpos($r['hitsid'],'-',2) + 1;                            //格式：c-模型id-文章id，如，c-1-1 ,查找第二个 "-"的位置
             $ids_array[] = $id = substr($r['hitsid'],$pos);                    //文章的id
             $hits[$id] = $r;                                                //每篇文章的点击量信息 ，格式：$hits[文章id]= 文章点击记录信息
         }
         $ids = implode(',', $ids_array);                                    //以逗号拼接成一个字符串
         if($ids) {
             $sql = "status=99 AND id IN ($ids)";                            //拼接sql
         } else {
             $sql = '';
         }
         $this->db->table_name = $this->tablename;                            //内容主表：v9_news
         $result = $this->db->select($sql, '*', $data['limit'],'','','id');  //查询内容主表：v9_news
         foreach ($ids_array as $id) {
             if($result[$id]['title']!='') {
                 $array[$id] = $result[$id];
                 $array[$id] = array_merge($array[$id], $hits[$id]);            //将内容主表v9_news中数据与点击量表v9_hits中数据合并，合并桥梁为id
             }
         }
         return $array;
     }
     /**
      * 栏目标签：主要用来返回当前栏目下的所有子栏目及子栏目的url链接地址等信息：{pc:content action="category"} {/pc}标签调用的都是category方法
      * @param $data
      */
     public function category($data) {
         $data['catid'] = intval($data['catid']);                            //pc标签的catid属性：栏目id
         $array = array();
         $siteid = $data['siteid'] && intval($data['siteid']) ? intval($data['siteid']) : get_siteid();//pc标签的siteid属性：默认调用系统站点
         $categorys = getcache('category_content_'.$siteid,'commons');        //获取当前站点下所有栏目的详细配置信息
         $site = siteinfo($siteid);                                            //获取当前站点的信息
         $i = 1;
         foreach ($categorys as $catid=>$cat) {
             if($i>$data['limit']) break;
             if((!$cat['ismenu']) || $siteid && $cat['siteid']!=$siteid) continue;//ismenu:是否显示栏目，1-显示栏目   0-不显示栏目
             if (strpos($cat['url'], '://') === false) {                        //当前栏目的url链接地址中是否存在 "://"
                 $cat['url'] = substr($site['domain'],0,-1).$cat['url'];        //当前栏目的url链接地址
             }
             if($cat['parentid']==$data['catid']) {                            //默认为0，调用一级栏目，$cat['parentid']只有一个值
                 $array[$catid] = $cat;                                        //所有子栏目信息
                 $i++;
             }
         }
         return $array;
     }

     /**
      * 推荐位，主要用来返回当前推荐位置所有文章的标题和url链接地址等信息：{pc:content action="position"} {/pc}标签调用的都是position方法
      * @param $data
      */
     public function position($data) {
         $sql = '';
         $array = array();
         $posid = intval($data['posid']);                                    //pc标签中posid属性：推荐位id
         $order = $data['order'];                                            //pc标签中order属性
         $thumb = (empty($data['thumb']) || intval($data['thumb']) == 0) ? 0 : 1;//pc标签中thumb属性
         $siteid = $GLOBALS['siteid'] ? $GLOBALS['siteid'] : 1;                //当前站点id
         $catid = (empty($data['catid']) || $data['catid'] == 0) ? '' : intval($data['catid']);//pc标签中的catid属性
         if($catid) {                                                        //如果栏目id存在
             $siteids = getcache('category_content','commons');                //获取所有栏目所对应的站点id
             if(!$siteids[$catid]) return false;                                //当前站点下不存在当前栏目，则返回false
             $siteid = $siteids[$catid];                                        //当前站点id
             $this->category = getcache('category_content_'.$siteid,'commons');//当前站点id下所有栏目的详细配置信息
         }
         if($catid && $this->category[$catid]['child']) {                    //当前栏目是否存在子栏目
             $catids_str = $this->category[$catid]['arrchildid'];            //当前栏目下所有子栏目id，包括当前栏目自身id
             $pos = strpos($catids_str,',')+1;
             $catids_str = substr($catids_str, $pos);                        //当前栏目下所有子栏目id，不包括当前栏目自身id
             $sql = "`catid` IN ($catids_str) AND ";                            //拼接sql
         }  elseif($catid && !$this->category[$catid]['child']) {            //如果当前栏目不存在子栏目
                 $sql = "`catid` = '$catid' AND ";
         }
         if($thumb) $sql .= "`thumb` = '1' AND ";                            //有缩略图的情况
         if(isset($data['where'])) $sql .= $data['where'].' AND ';            //pc标签的where属性：一般情况下没有此属性
         if(isset($data['expiration']) && $data['expiration']==1) $sql .= '(`expiration` >= \''.SYS_TIME.'\' OR `expiration` = \'0\' ) AND ';
         $sql .= "`posid` = '$posid' AND `siteid` = '".$siteid."'";            //拼接sql
         $pos_arr = $this->position->select($sql, '*', $data['limit'],$order);//查询v9_position_data表
         if(!empty($pos_arr)) {
             foreach ($pos_arr as $info) {                                    //循环查询到的v9_position_data表中的记录
                 $key = $info['catid'].'-'.$info['id'];                        //格式:栏目id-文章id
                 $array[$key] = string2array($info['data']);                    //将v9_position_data表中data字段的值转换为数组
                 $array[$key]['url'] = go($info['catid'],$info['id']);        //url链接地址
                 $array[$key]['id'] = $info['id'];                            //文章id
                 $array[$key]['catid'] = $info['catid'];                        //栏目id
                 $array[$key]['listorder'] = $info['listorder'];                //排序
             }
         }
         return $array;
     }
     /**
      * 可视化标签，主要用于在后台可视化的对pc标签进行编辑
      */
     public function pc_tag() {
         $positionlist = getcache('position','commons');
         $sites = pc_base::load_app_class('sites','admin');
         $sitelist = $sites->pc_tag_list();

         foreach ($positionlist as $_v) if($_v['siteid'] == get_siteid() || $_v['siteid'] == 0) $poslist[$_v['posid']] = $_v['name'];
         return array(
             'action'=>array('lists'=>L('list','', 'content'),'position'=>L('position','', 'content'), 'category'=>L('subcat', '', 'content'), 'relation'=>L('related_articles', '', 'content'), 'hits'=>L('top', '', 'content')),
             'lists'=>array(
                 'catid'=>array('name'=>L('catid', '', 'content'),'htmltype'=>'input_select_category','data'=>array('type'=>0),'validator'=>array('min'=>1)),
                 'order'=>array('name'=>L('sort', '', 'content'), 'htmltype'=>'select','data'=>array('id DESC'=>L('id_desc', '', 'content'), 'updatetime DESC'=>L('updatetime_desc', '', 'content'), 'listorder ASC'=>L('listorder_asc', '', 'content'))),
                 'thumb'=>array('name'=>L('thumb', '', 'content'), 'htmltype'=>'radio','data'=>array('0'=>L('all_list', '', 'content'), '1'=>L('thumb_list', '', 'content'))),
                 'moreinfo'=>array('name'=>L('moreinfo', '', 'content'), 'htmltype'=>'radio', 'data'=>array('1'=>L('yes'), '0'=>L('no')))
             ),
             'position'=>array(
                 'posid'=>array('name'=>L('posid', '', 'content'),'htmltype'=>'input_select','data'=>$poslist,'validator'=>array('min'=>1)),
                 'catid'=>array('name'=>L('catid', '', 'content'),'htmltype'=>'input_select_category','data'=>array('type'=>0),'validator'=>array('min'=>0)),
                 'thumb'=>array('name'=>L('thumb', '', 'content'), 'htmltype'=>'radio','data'=>array('0'=>L('all_list', '', 'content'), '1'=>L('thumb_list', '', 'content'))),
                 'order'=>array('name'=>L('sort', '', 'content'), 'htmltype'=>'select','data'=>array('listorder DESC'=>L('listorder_desc', '', 'content'),'listorder ASC'=>L('listorder_asc', '', 'content'),'id DESC'=>L('id_desc', '', 'content'))),
             ),
             'category'=>array(
                 'siteid'=>array('name'=>L('siteid'), 'htmltype'=>'input_select', 'data'=>$sitelist),
                 'catid'=>array('name'=>L('catid', '', 'content'), 'htmltype'=>'input_select_category', 'data'=>array('type'=>0))
             ),
             'relation'=>array(
                 'catid'=>array('name'=>L('catid', '', 'content'), 'htmltype'=>'input_select_category', 'data'=>array('type'=>0), 'validator'=>array('min'=>1)),
                 'order'=>array('name'=>L('sort', '', 'content'), 'htmltype'=>'select','data'=>array('id DESC'=>L('id_desc', '', 'content'), 'updatetime DESC'=>L('updatetime_desc', '', 'content'), 'listorder ASC'=>L('listorder_asc', '', 'content'))),
                 'relation'=>array('name'=>L('relevant_articles_id', '', 'content'), 'htmltype'=>'input'),
                 'keywords'=>array('name'=>L('key_word', '', 'content'), 'htmltype'=>'input')
             ),
             'hits'=>array(
                 'catid'=>array('name'=>L('catid', '', 'content'), 'htmltype'=>'input_select_category', 'data'=>array('type'=>0), 'validator'=>array('min'=>1)),
                 'day'=>array('name'=>L('day_select', '', 'content'), 'htmltype'=>'input', 'data'=>array('type'=>0)),
             ),

         );
     }
 }