README

警告

此包已被替换，不再维护。

CMS Contact 是什么？

CMS Contact 是一个 CMS Core 插件，它添加了一个联系表单的后端。

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

系统要求

• 需要 PHP 5.4.7+ 或 PHP 5.5+。
• 您需要一个类似 Bootstrap CMS 的 CMS Core 应用程序，因为此包是为它设计的。
• 您需要安装 Composer 以加载 CMS-Contact 的依赖项。

安装

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

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

在尝试加载 CMS Contact 服务提供者之前，您需要注册许多服务提供者。打开 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’
• ‘GrahamCampbell\CMSCore\CMSCoreServiceProvider’

一旦安装了CMS Contact，您需要注册服务提供者。打开app/config/app.php，并在providers键中添加以下内容。

• ‘GrahamCampbell\CMSContact\CMSContactServiceProvider’

配置

CMS Contact支持可选配置。

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

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

有两种配置选项

表单路径

此选项（'path'）定义了联系表单的路径。这是您联系表单应显示的页面。此设置的默认值是'pages/contact'。

联系表单邮箱

此选项（'email'）定义了发送联系表单消息的电子邮件地址。将其设置为null会将联系表单数据通过电子邮件发送到ID为1的用户。如果将其从null更改为其他值，请在此处输入电子邮件地址。此设置的默认值是null。

使用方法

除了CMS Contact的API文档外，目前还没有使用文档。

您需要使用此插件编写自己的联系表单。CMS Comment仅提供后端功能来创建评论表单。CMS Comment表单将注册contact.post路由，该路由将接受到contact路径的POST请求。请注意，已包含一个基本表单，如果您想使用它，可以将其拉入您自己的视图之一。

更新您的分支

最新的和最好的源代码可以在GitHub上找到。

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

您可以分支CMS Contact

git remote add upstream git://github.com/GrahamCampbell/CMS-Contact.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通用公共许可证

CMS Contact是CMS Core插件，用于添加联系表单后端。版权所有（C）2013-2014 Graham Campbell

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

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

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