README

关于

CakePHP 3 插件，使用 FullCalendar JS（作为 AdminLTE 的一部分）来管理日历事件和参与者。

我们将很快添加的一些功能

• 通过自动完成（使用 Select2 复选框）搜索日历参与者。
• 重复日历事件。
• 原型日历参与者。
• 将 jQuery 完全重写为 VueJS 组件。
• 实现 FreeBusy 日历。

此插件由 Qobo 为 Qobrix 开发。它可以作为独立的 CakePHP 插件使用，也可以作为 project-template-cakephp 安装的一部分。

注意：该插件处于开发中，因此任何 错误报告 和 拉取请求 都非常欢迎。

插件安装

使用 composer 安装

composer require qobo/cakephp-calendar

在 config/bootstrap.php 中加载插件及其依赖项。

# Optionally adding AdminLTE and Qobo Utils that are partially used inside.
Plugin::load('AdminLTE', ['bootstrap' => true, 'routes' => true]);
Plugin::load('Qobo/Utils');
Plugin::load('Qobo/Calendar', ['bootstrap' => true, 'routes' => true]);

运行数据库架构迁移以创建将包含日历、事件、参与者等的表。

./bin/cake migrations migrate --plugin Qobo/Calendar

自定义

JavaScript 和样式。

该插件严重依赖 AdminLTE Bootstrap 主题进行样式设置，因此您需要在 src/Template/Calendars/index.ctp 中进行一些调整，以便使其运行。

<?php

echo $this->Html->css(
    [
        'Qobo/Calendar.fullcalendar.min.css',
        'AdminLTE./plugins/select2/select2.min',
        'AdminLTE./plugins/daterangepicker/daterangepicker',
        'Qobo/Utils.select2-bootstrap.min',
        'Qobo/Calendar.calendar',
    ]
);


echo $this->Html->script([
    'Qobo/Calendar./dist/vendor',
    'Qobo/Calendar./dist/app',
], [
    'block' => 'scriptBottom'
]);

?>

为了初始化 Calendar VueJS 应用程序，您应该定义 #qobo-calendar-app 元素

<section class="content" id="qobo-calendar-app" token="YourApiToken">
    <calendar :timezone="timezone" :editable="editable" :show-print-button="true"></calendar>
</section>

VueJS 贡献

日历插件具有包含所有必需模块的 package.json，以便修改 dist 编译后的 JS 文件。运行 yarn 命令以安装所需的 node_module 以继续开发。

如果需要热重载功能，请运行

yarn watch

准备生产就绪构建

yarn build:prod

有关更多脚本和 linters 等，请参阅 package.json 文件。