README

BackBee CMS 核心组件 是基于 Symfony & Doctrine 2 组件构建的开源 PHP CMS BackBee 的核心部分。

概述

BackBee CMS 是一个开源内容管理系统。由于其将 HTML5 编程集成到了前所未有的程度，其可用性和设计灵活性超过了我们所知的所有其他内容管理系统。

所有内容更改——添加、删除或更改文本、图像或新页面元素——都可以直接在页面上进行。只需点击和输入，或拖放。没有后台办公室。无需在前后端之间来回切换，以及经常无法匹配最终页面显示的“预览”页面。

BackBee CMS 提供了我们喜欢称之为 WYSIWYRG（所见即所得）。因为它自动保存不同的页面版本，所以不必担心在过程中丢失更改。如果生活中的每一件事都这么简单和安全就好了。

这是 BackBee CMS 的核心库仓库，如果您在寻找打包的 CMS，请查看 BackBee CMS

💬 如果您想了解更多关于项目进展的信息，您可以查看实际的 路线图。

特性

• 强大且易于使用的内容系统
• 多个网站
• 自定义主题
• 自定义页面
• 高级区块系统
• 用户/组管理

文档

📖 可用 API 文档，您还可以关注 BlogBee，这是一个使用 BackBee CMS 创建完整网站的教程。

• 开发者 PHP API 文档
• 开发者文档

寻求帮助

💬 如果您需要关于此项目的帮助，您可以

• 在我们的 gitter 房间发帖：
• 在 Twitter 社交网络上联系 @BackBeeCMS
• 在 Stackoverflow 上寻求帮助，使用官方标签 backbee-cms

贡献

欢迎拉取请求 和项目仓库上的星标。

请查看我们的 CONTRIBUTING.md 文件

首先，感谢您的贡献，您很棒！

以下是您在维护者接受和合并您的工作之前应遵循的一些规则，以便于代码审查和讨论。

您必须遵循 PSR-1 和 PSR-2。如果您不了解其中任何一项，您应该真的读一下推荐。迫不及待？使用 PHP-CS-Fixer 工具。

• 您必须运行测试套件。
• 您必须编写（或更新）单元测试。
• 您应该编写文档。

请编写有意义的提交信息，并在提交拉取请求之前rebase您的分支。

有人可能要求您压缩提交。这用于在合并之前“清理”您的拉取请求（我们不希望有像fix tests、fix 2、fix 3等这样的提交）。

此外，在GitHub上创建您的拉取请求时，您必须编写一个描述，提供上下文或解释您为什么要创建它。

工作流程

当您创建一个拉取请求（"PR"）时，如果它与组件相关，您可以在组件名称前加上前缀。您还可以使用加号或减号来描述是否全局添加或删除某些内容，并将其引用到问题中。

例如，这是一个有效的PR标签：[Rest] #42 + Updated & completed PageController tests。

当您想接收一个问题，创建带有[WIP]（"Work in progress"）前缀的PR，并添加一个"进行中"标签。这样，我们知道您正在处理它，如果需要，我们可以给您一些建议。

当您的PR完成时，您可以更新PR标签，用[RFR]（"Ready for review"）前缀替换[WIP]。

以下条件满足时，您的PR可以视为完成：

• 您为新的功能编写了一个测试用例；
• 所有测试都通过；
• 构建全部为绿色；
• 您（可能）增加了一些文档；
• 您的PR遵守项目格式规范（见上文）；

同步分支

Github开发团队已经描述了正确的同步方法。

$ git fetch upstream
$ git checkout master
$ git merge upstream/master

格式规范

我们使用php-formatter来管理您的文件头和如何将use语句添加到类中。

在提交您的拉取请求之前，请务必应用以下命令

    ~$ php-formatter formatter:header:fix .
    ~$ php-formatter formatter:use:sort .

您需要先安装php-formatter。

决策者 & 合并者

BackBee CMS有一个核心团队，他们有权访问仓库。

• 只有合并者才能合并您的代码到master分支；
• 如果决策者之一对您的建议给出:-1:，则拉取请求将不会合并，直到他改变主意；

当前的合并者是@eric-chau和@crouillon，当前的决策者是@ndufreche、@fkroockmann、@hbaptiste和@mickaelandrieu。

所有核心团队成员都在这里帮助您改进BackBee CMS，我们热爱贡献：）

谢谢！

注意：此CONTRIBUTING文件自豪地借鉴了Hateoas的版本

感谢已经做出贡献的每个人。

要求

BackBee核心仅支持PHP 5.4及以上版本。BackBee还需要mbstring、mcrypt、pdo PHP扩展。

安装

推荐安装BackBee CMS的方式是通过Composer

{
    "require": {
        "backbee/backbee-php": "@stable"
    }
}

小贴士：你应该浏览backbee/backbee-php页面来选择一个稳定的版本使用，避免使用@stable元约束。

本项目由Lp digital支持

主要开发者： @crouillon

发布于GPL3许可证下