[PC] PHPCMS二次开发指南（上）
-------------------------------------------------------------------------------------
PHPCMS本身功能已经很完善，自带的模块可用可不用，松耦合特性使其非常适合企业的二次开发。
PC的默认路由在 phpcms/caches/configs/route.php 中定义，为content模块下index控制器的init方法
一. PC所有模块都在module目录下，与数据表名字相同；
module目录中文件就是控制器，控制器名与文件名相同；
前台控制器如index.php无须继承任何类，用于前台操作；
后台控制器一般需要继承admin模块的admin类，一旦继承admin就需要权限验证（也可以不继承）。
二. 总结开发后台模块的步骤：
1. 后台访问扩展的模块：
扩展 - 菜单管理 - 添加菜单 - 上级：作为一级菜单（模块名，文件名，方法名）
添加子菜单 - 上级：某个一级菜单（填不存在的模块名，填不存在的文件名，填不存在的方法名）
扩展模块后，需要在v9_module中注册模块，插入此数据！（也即安装）
2. 创建数据表：
create table v9_link( ......... )engine=myisam default charset='utf8';
3. 建立后台的数据模型
<?php
defined('IN_PHPCMS') or exit('No permiss resources.'); pc_base::load_sys_class('model', '', 0); class link_model extends model { function __construct() { $this->db_config = pc_base::load_config('database'); $htis->db_setting = 'default'; $this->table_name = 'link'; parent::__construct(); } } /** * 几点注意： * 1. PC的数据模型基本是鸡肋，只是指定了数据库设置和对应的表名，非彻底的MVC，直接复制一份修改即可。 * 2. 此模型一般在控制器构造方法调用。
* 3. load_sys_class第三个参数为是否初始化，0表示只引入系统类，返回真假；1表示返回指定系统类的实例对象
* <Farwish.com>
*/
4. 建立后台控制器：
<?php /** * 后台友情链接，完整CURD */ defined('IN_PHPCMS') or exit('No permission resources.'); pc_base::load_app_class('admin', 'admin', 0); class link extends admin { private $db, $admin_db; public $siteid; function __construct() { parent::__construct(); $this->M = new_html_special_chars(getcache('link', 'commons')); $this->db = pc_base::load_model('link_model'); $this->db2 = pc_base::load_model('type_model'); } /** * 友情链接列表 */ public function init() { if($_GET['typeid'] != '') { $where = array('typeid'=>intval($_GET['typeid']), 'siteid'=>$this->get_siteid()); } else { $where = array('siteid'=>$this->get_siteid()); } $page = (isset($_GET['page']) && intval($_GET['page'])) ? intval($_GET['page']) : 1; $infos = $this->db->listinfo($where, $order = 'listorder DESC, linkid DESC', $page, $page = '9'); $pages = $this->db->pages; $types = $this->db2->listinfo(array('module'=>ROUTE_M, 'siteid'=>$this->get_siteid()), $order = 'typeid DESC'); $types = new_html_special_chars($types); $type_arr = array(); foreach($types as $typeid=>$type) { $type_arr[$type['typeid']] = $type['name']; } $big_menu = array('javascript:window.top.art.dialog({id:\'add\',iframe:\'?m=link&c=link&a=add\', title:\''.L('link_add').'\', width:\'700\', height:\'450\'}, function(){var d = window.top.art.dialog({id:\'add\'}).data.iframe;var form = d.document.getElementById(\'dosubmit\');form.click();return false;}, function(){window.top.art.dialog({id:\'add\'}).close()});void(0);', L('link_add')); include $this->admin_tpl('link_list'); } /* 判断标题重复和验证 */ /* 添加分类时，验证分类名是否已存在 */ /** * 添加友情链接 */ public function add() { if(isset($_POST['dosubmit'])) { $_POST['link']['addtime'] = SYS_TIME; $_POST['link']['siteid'] = $this->get_siteid(); if(empty($_POST['link']['name'])) { showmessage(L('sitename_noempey'), HTTP_REFERER); } else { $_POST['link']['name'] = safe_replace($_POST['link']['name']); } if($_POST['link']['logo']) { $_POST['link']['logo'] = safe_replace($_POST['link']['logo']); } $data = new_addslashes($_POST['link']); $linkid = $this->db->insert($data, true); if( ! $linked) { return false; } $siteid = $this->get_siteid(); //更新附件状态 if(pc_base::load_config('system', 'attachment_stat') & $_POST['link']['logo']) { $this->attachment_db = pc_base::load_model('attachment_model'); $this->attachment_db->api_update($_POST['link']['logo'], 'link-' . $linkid, 1); } showmessage(L('operation_success'), HTTP_REFERER, '', 'add'); } else { $show_validator = $show_scroll = $show_header = true; pc_base::load_sys_class('form', '', 0); $siteid = $this->get_siteid(); $types = $this->db2->get_types($siteid); include $this->admin_tpl('link_add'); } } /* 异步更新排序 */ /* 手动更新排序 */ /* 添加友情链接分类 */ /* 删除分类 */ /* 分类管理 */ /** * 修改友情链接分类 */ public function edit_type() { if(isset($_POST['dosubmit'])) { $typeid = intval($_GET['typeid']); if($typeid < 1) return false; if( ! is_array($_POST['type']) || empty($_POST['type'])) return false; if((!$_POST['type']['name']) || empty($_POST['type']['name'])) return false; $this->db2->update($_POST['type'], array('typeid'=>$typeid)); showmessage(L('operation_success'),'?m=link&c=link&a=list_type','', 'edit'); } else { $show_validator = $show_scroll = $show_header = true; //查询分类内容 $info = $this->db2->get_one(array('typeid'=>$_GET['typeid'])); if( ! $info) { showmessage(L('linktype_exit')); extract($info); include $this->admin_tpl('link_type_edit'); } } } /** * 删除友情链接 */ public function delete() { if( ! isset($_GET['linkid']) || (empty($_GET['linkid']) && ! isset($_POST['linkid'])) || empty($_POST['linkid'])) { showmessage(L('illegal_parameters'), HTTP_REFERER); } else { if(is_array($_POST['linkid'])) { foreach($_POST['linkid'] as $linkid_arr) { //批量删除友情链接 $this->db->delete(array('linkid'=>$linkid_arr)); //更新附件状态 if(pc_base::load_config('system', 'attachment_stat')) { $this->attachment_db = pc_base::load_model('attachment_model'); $this->attachment_db->api_delete('link - '. $linkid_arr); } } showmessage(L('operation_success', '?m=link&c=link')); } else { $linkid = intval($_GET['linkid']); if($linkid < 1) { return false; } //删除友情链接 $result = $this->db->delete(array('linkid'=>$linkid)); //更新附件状态if(pc_base::load_config('system','attachment_stat')) { $this->attachment_db = pc_base::load_model('attachment_model'); $this->attachment_db->api_delete('link-'.$linkid); } if($result){ showmessage(L('operation_success'),'?m=link&c=link'); }else { showmessage(L("operation_failure"),'?m=link&c=link'); } } showmessage(L('operation_success'), HTTP_REFERER); } } } /** * 几点注意： * 1. 作为一款产品，你可以感受到它程序的严谨性，照着做。 * 2. 操作数据类和其它系统类均在 libs/classes/ 中，数据模型基类model.class.php通过数据库工厂类作为抽象层调用操作数据库的方法。 * 3. 查询所有为listinfo, 单条信息为get_one, 增加为insert， 修改为update。 * 4. 提示消息为系统公共函数showmessage()，在 libs/functions/global.func.php 中。 * 5. L()方法为语言处理函数，将读入语言包，根据后台配置显示英文/中文, 同样是系统公共函数，
* 6. 加载后台模板 include $this->admin_tpl(""); 这是admin模块下admin.class.php类的方法
* <Farwish.com> */
5. 建立后台模板文件
后台模板文件都在 modules/link/templates 下，文件名统一以“ .tpl.php”结尾
/** * 后台模板局部 */ <?php defined('IN_ADMIN') or exit('No Permission resources.'); $show_dialog = 1; include $this->admin_tpl('header', 'admin'); ?> <table width="100%" cellspacing="0" class="search-form"> <tbody> <tr> <td><div class="explain-col"> <?php echo L('all_linktype')?>: <a href="?m=link&c=link"><?php echo L('all')?></a> <a href="?m=link&c=link&typeid=0">默认分类</a> <?php if(is_array($type_arr)){ foreach($type_arr as $typeid => $type){ ?><a href="?m=link&c=link&typeid=<?php echo $typeid;?>"><?php echo $type;?></a> <?php }}?> </div> </td> </tr> </tbody> </table> /** * 几点注意： * 1. 后台模板是混编风格，由于在后台控制器中总是最后调用模板，所以系统库和函数以及变量总是可用的。 * 2. 模板底部可以写一些自己的JS操作函数。
* 3. pc的安全性体现url参数中的pc_hash值验证，我们在做一些修改显示页面时也必须在链接上带上这个加密的session值。
* <Farwish.com> */
PHPCMS的模块化设计非常人性化，更多有趣的地方等待大伙儿去发现，等待：[PC]PHPCMS二次开发指南（下）
Refer：PHPCMS与二次开发
