ztbcms / docs

ZTBCMS文档

ZTBCMS 文档

官网 | 文档 | 源代码

V3官网 | V3文档 | V3源代码

环境需求

Node.js 8.x以上

开始构建

npm install
# 本地预览
npm run dev
# 构建生产环境
npm run build
# 推送到部署分支 dist
npm run deploy
# 建构生产环境并推送到部署分支
npm run buildAndDeploy

docs's Issues

如何让定时任务立即运行？

栏目列表页： 如何自定义搜索条件

根据后台管理员的权限显示不同的视图？

前端检测权限显示按钮 例子：

Libs\System\RBAC.php 新增

    /**
     * 检测登陆用户对某个接口的访问权限
     * @param $moduelName
     * @param $controllerName
     * @param $actionName
     * @return bool
     */
	static function ableAccess($moduelName, $controllerName, $actionName){
        $accessList = session("_ACCESS_LIST");

        if(!empty($accessList[$moduelName]) && !empty($accessList[$moduelName][$controllerName]) && !empty($accessList[$moduelName][$controllerName][$actionName])){
            return true;
        }
        return false;
    }

  <if condition="\Libs\System\RBAC::ableAccess('Content', 'Content', 'edit')">
    <a href="javascript:;;" onClick="javascript:openwinx('{:U("Content/edit", ["catid" =>$vo['catid'] , "id" => $vo["id"]])}')">修改</a>
    |
</if>

<if condition="\Libs\System\RBAC::ableAccess('Content', 'Content', 'delete')">
    <a href="{:U('Content/delete',array('catid'=>$vo['catid'],'id'=>$vo['id']))}" class="J_ajax_del" >删除</a>
</if>

如何使用数据导入导出模块

如何写一个模块？

模块的目录结构等等

cms中的模型详情页 列表页的选择顺序

模型的信息处理函数使用

如何写后台模板

任务队列 Queue vs 计划任务 Cron

同

均可以在php中的非用户http请求流程中执行一些耗时的任务

异

执行时效：

Queue 支持『秒级』别的调度执行
Cron 支持『分钟』级别的调度执行

调度触发

Queue 自带调度器，由自身实现
Cron 需要依赖其他软件来调度，如crontab

并发控制：

Queue 可以预先设定开启多个队列，实现并行操作
Cron 无法预先设置并发数，并发由时间调度(crontab)进行控制

可靠性

• Queue 可以启动多个进程，可以平滑启动 重启
• Cron 一旦停了，部分时间点的计划任务无法执行，如果部分必须按时执行的任务，一旦停止，正确性得不到保证

分布式支持

• Queue 无额外需要
• Cron 服务器时间需要统一

需求

• 确保必须且有且只能执行一次

如何写后台模型的列表页模板？

自带缺省的模块：Migrate & Testing & System模块

• Migrate: 用于写迁移数据脚本
• Testing：写测试先相关的处理
• System: 把该系统的自定义的Model,Service 都集中在这个模块

行为管理的最佳实践

如何明确hook的参数

前端：如何上传图片

模型：万能字段

如何测试Behavior？

Behavior 遵循TP的自动加载方式，所以直接创建对应的Behavior 并填写模拟参数调用run()方法即可

样例：

行为PaidChongzhiOrderBehavior.class.php

/**
 * 支付充值订单后
 *
 * @package Payment\Behavior
 */
class PaidChongzhiOrderBehavior extends BaseBehavior  {

    //充值余额 快照栏目
    const CAT_CHONGZHIYUE = 96;

    public function run(PaidOrderBehaviorParam &$param) {
        parent::run($param);

        $order = DgorderService::getOrder($param->orderid)['data'];


        //充值余额订单+已支付
        if($order['dg_catid'] == DgorderModel::CAT_CHONGZHI_YUE && $order['pay_status'] == DgorderModel::PAY_STATUS_PAYID ){
            $chongzhiInfo = ContentService::getContent(self::CAT_CHONGZHIYUE, $order['dg_id'])['data'];

            //添加余额明细
            $currency = $order['country'] == '**' ? BalanceService::CURRENCY_RMB : BalanceService::CURRENCY_USD;
            BalanceService::addBalanceMingxi($order['userid'], $chongzhiInfo['money'], $currency, 'ORDER'.$order['trade_no'], BalanceService::TYPE_ADD, '余额充值 ' . $chongzhiInfo['money'] . $currency);

            //标志订单已完成
            DgorderService::updateOrder($order['orderid'], ['order_status' => DgorderModel::ORDER_STATUS_FINISH]);
        }
    }
}

参数类PaidOrderBehaviorParam.class.php

class PaidOrderBehaviorParam extends BaseBehaviorParam {

    /**
     * @var 订单号
     */
    public $orderid;

}

调用样例：

<?php

namespace Payment\Controller;

use Common\Controller\Base;
use Payment\Behavior\PaidChongzhiOrderBehavior;
use Payment\BehaviorParam\PaidOrderBehaviorParam;

class TestController extends Base {

    function testPaidChongzhiOrderBehavior(){
        $b = new PaidChongzhiOrderBehavior();
        $bp = PaidOrderBehaviorParam::create(['orderid' => '2016111011144970299']);
        $b->run($bp);
    }
}

视图：表单生成

form.inc.php:

    switch ($setting['boxtype']) {
        case 'radio':
            $string = \Form::radio($option, $value, "name='info[$field]' {$fieldinfo['formattribute']}", $setting['width'], $field);
            break;

        case 'checkbox':
            $string = \Form::checkbox($option, $value, "name='info[$field][]' {$fieldinfo['formattribute']}", 1, $setting['width'], $field);
            break;

        case 'select':
            $string = \Form::select($option, $value, "name='info[$field]' id='$field' {$fieldinfo['formattribute']}");
            break;

        case 'multiple':
            $string = \Form::select($option, $value, "name='info[$field][]' id='$field ' size=2 multiple='multiple' style='height:60px;' {$fieldinfo['formattribute']}");
            break;
    }

如何实现多语言切换？

常见错误-安装完成后显示模板不存在

安装完成后显示模板不存在

原因：数据库连接有错

解决办法：
删除app/Common/dataconfig.php 重新安装 或者 在配置文件里填写正确数据库连接信息

模块开发Tips

开发时，模块内的资源文件不需要每次改动完后重新修改install/目录下的资源文件，可以直接给一个软连接即可

 ln -s /Users/jayin/Desktop/project/fenxiangbei/ztbcms/app/Application/Shop/Install/Extres /Users/jayin/Desktop/project/fenxiangbei/ztbcms/statics/extres/shop

 ln -s /ztbcms/app/Application/Shop/Install/Extres /ztbcms/statics/extres/shop