README

警告

此包已与Bootstrap CMS重新合并，并且不再维护。

CMS Core是什么？

CMS Core为Bootstrap CMS等应用提供一些核心功能。

• CMS Core由Graham Campbell创建并维护。
• CMS Core依赖于我的一些包，包括Laravel Core和Laravel Queuing。
• CMS Core使用Travis CI与Coveralls来检查一切是否正常工作。
• CMS Core使用Scrutinizer CI和SensioLabsInsight进行额外的检查。
• CMS Core使用Composer来加载和管理依赖。
• CMS Core提供变更日志、版本发布和API文档。
• CMS Core采用GNU AGPLv3许可，可在此处找到。

系统要求

• 需要PHP 5.4.7+或PHP 5.5+。
• 您需要Laravel 4.1，因为此包是为它设计的。
• 您需要安装Composer以加载CMS Core的依赖。

安装

在安装CMS Core之前，请检查系统要求。

要获取CMS Core的最新版本，只需在您的composer.json文件中要求"graham-campbell/cms-core": "0.2.*@alpha"。然后您需要运行composer install或composer update来下载它并更新自动加载器。

在尝试加载CMS Core服务提供者之前，您需要注册许多服务提供者。打开app/config/app.php并在providers键中添加以下内容。

• 'Lightgear\Asset\AssetServiceProvider'
• 'Cartalyst\Sentry\SentryServiceProvider'
• ‘GrahamCampbell\Core\CoreServiceProvider’
• ‘GrahamCampbell\Viewer\ViewerServiceProvider’
• ‘GrahamCampbell\Queuing\QueuingServiceProvider’
• ‘GrahamCampbell\HTMLMin\HTMLMinServiceProvider’
• ‘GrahamCampbell\Markdown\MarkdownServiceProvider’
• ‘GrahamCampbell\Security\SecurityServiceProvider’
• ‘GrahamCampbell\Binput\BinputServiceProvider’
• ‘GrahamCampbell\Passwd\PasswdServiceProvider’
• ‘GrahamCampbell\Throttle\ThrottleServiceProvider’
• ‘GrahamCampbell\Credentials\CredentialsServiceProvider’
• ‘GrahamCampbell\Navigation\NavigationServiceProvider’

CMS 核心安装完成后，您需要注册服务提供者。打开 app/config/app.php 并将以下内容添加到 providers 键。

• ‘GrahamCampbell\CMSCore\CMSCoreServiceProvider’

配置

CMS 核心支持可选配置。

要开始使用，首先发布包配置文件

php artisan config:publish graham-campbell/cms-core

有几个配置选项

评论模型

此选项（‘comment’）定义了要使用的评论模型。此设置的默认值是 ‘GrahamCampbell\CMSCore\Models\Comment’。

事件模型

此选项（‘event’）定义了要使用的事件模型。此设置的默认值是 ‘GrahamCampbell\CMSCore\Models\Event’。

页面模型

此选项（‘page’）定义了要使用的页面模型。此设置的默认值是 ‘GrahamCampbell\CMSCore\Models\Page’。

文章模型

此选项（‘post’）定义了要使用的文章模型。此设置的默认值是 ‘GrahamCampbell\CMSCore\Models\Post’。

使用

除了 CMS 核心的 API 文档 之外，目前没有使用文档。

您可以在 Bootstrap CMS 中看到实现的示例。 CMS CloudFlare、CMS Contact 和 CMS LogViewer 都是 CMS 的插件示例。

更新您的分支

在提交拉取请求之前，您应确保您的分支是最新的。

您可以fork CMS 核心库

git remote add upstream git://github.com/GrahamCampbell/CMS-Core.git

第一个命令只适用于第一次。如果合并时出现问题，您将需要获取合并工具，如 P4Merge。

然后您可以更新分支

git pull --rebase upstream master
git push --force origin <branch_name>

设置完成后，运行 git mergetool。一旦所有冲突都解决，运行 git rebase --continue，然后运行 git push --force origin <branch_name>。

拉取请求

在提交任何拉取请求之前，请仔细阅读以下指南。

• 在提交错误修复之前，请检查是否存在针对旧版本的维护分支，如果错误存在于该分支中，请对该旧分支进行拉取。
• 在提交新功能的拉取请求之前，您应该首先创建一个标题包含 [提案] 的问题。
• 请遵循 PSR-2 编码风格 和 PHP-FIG 命名约定。

许可证

GNU AFFERO 通用公共许可证

CMS 核心为类似 Bootstrap CMS 这样的应用程序提供一些核心功能（C）2013-2014 Graham Campbell

本程序是自由软件：您可以在自由软件基金会发布的GNU Affero通用公共许可证的条款下重新分发和/或修改它，许可证版本可以是第3版，也可以是（根据您的选择）任何后续版本。

本程序的分发是希望它将是有用的，但没有任何保证；甚至没有关于其商业性或特定用途适用性的暗示性保证。有关详细信息，请参阅GNU Affero通用公共许可证。

您应该已经随本程序收到一份GNU Affero通用公共许可证的副本。如果没有，请参阅https://gnu.ac.cn/licenses/。