README

克隆到您的生产网站？请检查2.1分支！这是我们经过验证的稳定版本。

你好，陌生人！

Vanilla的诞生源于创建灵活、可定制且极具娱乐性的社区解决方案的愿望。Vanilla已被用于全球数以万计的社区论坛，如果您决定使用Vanilla来扩展您的社区，我们将非常高兴。

每个社区都是独特的。Vanilla是一个精心打造的平台，设计师和开发者可以在其上构建定制的环境，以满足您社区的特殊需求。

Vanilla是最好论坛的5个理由

我们重新构想了传统论坛，使其更具吸引力。
我们的主题灵活性无与伦比。
与单点登录和嵌入的不可思议的集成选项。
最佳的社区管理工具。
精心挑选的功能和丰富的插件选项，而不是杂乱无章。

开源

Vanilla是免费的开源软件，在GNU GPL2许可下分发。我们接受并鼓励社区贡献，有时甚至给予拥抱。您可以在Vanilla社区论坛加入我们，成为讨论的一部分。

最新稳定版本始终在此列出。目前，它是2.1分支。

新插件和主题可以在官方插件目录中列出。我们鼓励插件开发者将代码发布在GPL下，但这不是强制性的。

云解决方案

Vanilla Forums在vanillaforums.com提供官方云托管解决方案，一键安装，自动升级，惊人的专业支持，惊人的可扩展性，集成协助，主题和迁移服务，以及独家功能。为了获得最佳的Vanilla论坛体验，您可以跳过其余的技术内容，并直接前往。

如果您专业运营大型社区或企业论坛，我们的云解决方案将带来最佳的技术和经济效益。

自托管要求

PHP版本5.3或更高版本，并启用--enable-mbstring。
必须启用pdo_mysql模块。
MySQL 5或更高版本。

Vanilla 2.2需要PHP 5.3。运行master分支需要PHP 5.4，未来的官方版本也将如此。

Vanilla与PHP 5.6（当前版本）兼容，我们始终建议尽可能使用最新的稳定PHP版本。

Vanilla附带一个用于Apache支持的.htaccess文件。Nginx和IIS需要额外的配置。

在客户端，Vanilla应该在几乎所有现代浏览器中运行并看起来很好。使用IE？多么异国情调。您需要IE8或更高版本。如果您眯着眼睛轻轻点击，IE7可能会工作，但我们不保证。

我们在时尚之前就已经是原生移动的了。Vanilla默认启用了适用于所有智能手机和平板电脑的移动优化主题。嘿，它甚至可以在PlayStation Vita上运行。

安装

Vanilla旨在简单，其安装也不例外。

将整个文件结构上传到您的Web服务器。
确认缓存、conf和上传文件夹可由PHP写入。
在您的浏览器中导航到该文件夹。
按照屏幕上的说明操作。

升级

当宣布新的稳定版本发布时，按照以下步骤升级Vanilla。

备份您的数据库、.htaccess和conf/config.php文件到安全位置。
上传新发布版本的文件，以覆盖旧文件。
转到yourforum.com/utility/update以强制执行任何需要的更新。
如果失败，尝试刷新页面后再试一次。

要从2.0.18或更早版本升级，请添加以下步骤

删除文件/themes/mobile/views/discussions/helper_functions.php
删除文件/applications/dashboard/views/default.master.php

要从Vanilla 1.0升级，您必须使用Vanilla Porter将其作为迁移来导出您的数据。您的主机和任何自定义都需要重新创建。备份您的Vanilla 1数据和文件，然后尝试安装Vanilla 2之前，从您的服务器上删除它们。

迁移到Vanilla

获取Vanilla Porter并确认它支持您的平台。
阅读该页面的高级使用说明。
将其上传到您的当前服务器。
在您的浏览器中导航到该文件并运行它。
将生成的文件导入到Vanilla中。

获取帮助

贡献

在社区论坛中解决您遇到的问题，以便大家都可以帮助并稍后参考。
有想法或建议？使用论坛讨论。
在GitHub上详细报告问题（版本号、您所做之事以及实际与预期结果）。
签署贡献者协议以发送代码。
针对正确的发布（目前大多数更改的stage）使用拉取请求。
通过审查已解决或重复的开放问题来保持我们的待办事项列表最新。

版本控制策略

我们在项目中采用了git flow分支模型。git flow的创建者发布了一个简短介绍视频来解释该模型。

master分支适用于我们的云产品，但尚未经过开源发布（替代平台和配置）的审核。经审查的稳定更改通过拉取请求进入master。

我们的开源发布分支以版本号命名，例如release/2.2。我们以beta（b1）标识开始发布分支，并通过发布候选到稳定逐步推进。所有开源发布（包括预发布版）都已标记。

报告安全问题

请通过发送包含完整描述的电子邮件到support@vanillaforums.com负责任地披露安全问题。我们将尽快发布更新版本。请勿通过电子邮件发送非安全问题；而是使用问题跟踪器。

法律事项

Vanilla Forums 是免费软件：您可以按照自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它，许可证版本为2或（根据您的选择）任何更新的版本。Vanilla Forums 的分发是希望它将是有用的，但没有任何保证；甚至没有关于其商誉或特定用途适用性的暗示保证。有关详细信息，请参阅GNU通用公共许可证。您应已收到与Vanilla Forums一起的GNU通用公共许可证副本。如果没有，请参阅https://gnu.ac.cn/licenses/。请联系Vanilla Forums Inc.，邮箱：support [at] vanillaforums [dot] com

砰！

开个玩笑，一切都很棒。

dimassrio / vanilla

维护者

详细信息