[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')?>: &nbsp;&nbsp; <a href="?m=link&c=link"><?php echo L('all')?></a> &nbsp;&nbsp;
<a href="?m=link&c=link&typeid=0">默认分类</a>&nbsp;
<?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>&nbsp;
<?php }}?>
</div>
</td>
</tr>
</tbody>
</table> /**
* 几点注意:
* 1. 后台模板是混编风格,由于在后台控制器中总是最后调用模板,所以系统库和函数以及变量总是可用的。
* 2. 模板底部可以写一些自己的JS操作函数。
* 3. pc的安全性体现url参数中的pc_hash值验证,我们在做一些修改显示页面时也必须在链接上带上这个加密的session值。
* <Farwish.com>
*/

PHPCMS的模块化设计非常人性化,更多有趣的地方等待大伙儿去发现,等待:[PC]PHPCMS二次开发指南(下)

Link:http://www.cnblogs.com/farwish/p/4249318.html

上一篇:AJAX 状态值(readyState)与状态码(status)详解


下一篇:phpcms二次开发中无法获取SESSION的值