phpcmsv9】前台模板文件中{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)),
            ),
                
        );
    }
}