🔸新人必看注意事项及FAQ，此文章内容不定期更新。
🔹在发言前，请仔细阅读并遵守中文社区准则
🔸CatBBS 已发布正式版，大量测试年代的魔改教程很可能已失效，请在魔改前注意备份。

在提问前，请务必要阅读《提问的智慧》精读注解版。不仅仅是在魔法世界社区，以后在任何社区提问，都要遵守提问的智慧。

🚦 你不应该

如果你随意提问，而没有做功课，只能得到大家的鄙视，就像这样。

“哪位大神帮我远程看看到底哪儿出错了吗？”
“如何创建社区”
“请问这是什么原因啊？[结果/报错截图]”
“为什么我安装完后和官网不一样啊？”
“git 怎么用啊？”
“怎么进入后台啊？”
“谁可以帮忙解决一下”
“为啥我的报这个错啊：Class XXXX not found…”
“Fatal error: Maximum execution time of 30 seconds exceeded in”
…

👾 开启自检错误

使用调试模式自行检查报错详情，无法解决时发帖。
如果，您必须要贴出部分代码提问，请善用代码块格式，例如这样：

我是一串代码块格式，而不是一段普通文本格式

📚️ FAQ

Flarum 中文安装指南
Markdown 语法说明
宝塔面板？
常用插件？
哪些插件有冲突？
这些插件的作用是什么？
请问如何删除隐藏文件？
如何在<head></head>间添加 HTML 代码
中文用户名？
中文搜索？
时间格式？
内存不足，总是 Killed？
邮件配置
如何发图片
如何让URL只显示纯数字
数据库删除了UID-1怎么办？
如何更改邮箱通知默认开启/关闭
如何给编辑器添加功能
帖子如何排版？如何发布图片？—— markdown 语法
能不能帮我开发一个xxx插件？跪谢。—— 多少钱
如何评价xxxx功能？—— 亲，你去知乎吧。

🔅 Flarum 客制化路线

中文用户名支持
中文搜索
本地化时间格式
阻止 Pusher 移除刷新按钮
添加/修改文本编辑器按钮

📌 Flarum 安装中部分大概率遇到的问题

正在遇见问题并尽可能的汇总，需要用户反馈，这里才可以进行编辑和更新，请耐心等待补充…

0.安装 Flarum 遇到「require(../site.php): failed to open stream」

Warning: require(../site.php): failed to open stream: No such file or directory in /www/wwwroot/helpbooks.org/index.php on line 10

Fatal error: require(): Failed opening required '../site.php' (include_path='.:/www/server/php/72/lib/php') in /www/wwwroot/helpbooks.org/index.php on line 10

1.安装 Flarum 遇到 “vendor/autoload.php” 缺失等相关 autoload 问题

确保 Composer 安装正确，建议全局安装。在你想要的目录下重新运行 Composer 命令
composer create-project flarum/flarum . –stability=beta
来获取 Flarum，之后会看到 Flarum 相关文件。
如果 Composer 无法正常获取文件或超时，请切换到 Composer 国内源后重试。

2.注册时出现 Oops! 不能注册或者注册不正常，显示
Oops! Something went wrong. Please reload the page and try again.

确保你的STMP或者邮箱账户或密码设置正确！！！

为什么根据重写规则，还是404或者无法打开网页？

一般情况下，请确保运行目录是 /public 即可正常运行 Flarum，Flarum 自带.htaccess或.nginx.conf文件，将 Flarum 自带的定向文件包含在服务器总rewrite配置内即可。
重定向不正确，特别是 Nginx 的 Beta 11+ 重定向项设置，需要删除一段关于 admin 的重定向

当您的重定向不正确，才需要使用上文的 “URL 重写规则” 进行参考补全，而非全局/全部替换覆盖！！
同时，请确保您修改的重写规则文件的位置正确且主次不冲突，视具体情况而不同。

4.遇到PHP函数被禁用/不可用的问题
The Process class relies on ... ,which is not available on your PHP in stallation

请将禁用的PHP函数打开，如下所示的proc_open函数报错，若后面如果出现类似提示，
则以此类推逐一打开被禁函数，或者安装需要的php相关功能。安装指南中也有提到，请仔细阅读需要的函数功能。

Installing flarum/flarum (v0.1.0-beta.11): Downloading (100%)
The Process class relies on proc_open, which is not available on your PHP in stallation.
The archive may contain identical file names with different capitalization (which fails on case insensitive filesystems)
Unzip with unzip command failed, falling back to ZipArchive class
左下角显示"请求的资源不存在" The requested resource was not found

请检查伪静态是否设置正确，以及目录结构与目录权限有无调整。
确认根地址配置正确，特别是 http 转为 https ，需要重新配置文件 config 中的站点根地址

6.实际上消息已经发送成功了，但需要刷新才能显示。

Filter插件的过滤词格式设置有问题，请重新配置。

如果你加入了 QQ 群，请不要直接通过 QQ 找我，并贴上一堆的代码。谢谢。

请务必要阅读《提问的智慧》
请务必要阅读《提问的智慧》
请务必要阅读《提问的智慧》

重要的话说三遍。