前台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)),
- ),
- );
- }
- }