分类： 入门

bbp_loaded

bbp_loaded

bbp_loaded
Codex Home → bbp_loaded
The 『bbp_loaded』 action is hooked onto WordPress』s 『plugins_loaded』 action with default priority 10 in:
/includes/core/actions.php
It』s one of several 『piggy-back』 actions intended to help load code only when bbPress is active. It』s used to execute code early in the WordPress load order.
How it's hooked
add_action( 'plugins_loaded', 'bbp_loaded', 10 );
Where it's used
add_action( 'bbp_loaded', 'bbp_constants', 2 );
add_action( 'bbp_loaded', 'bbp_boot_strap_globals', 4 );
add_action( 'bbp_loaded', 'bbp_includes', 6 );
add_action( 'bbp_loaded', 'bbp_setup_globals', 8 );
add_action( 'bbp_loaded', 'bbp_setup_option_filters', 10 );
add_action( 'bbp_loaded', 'bbp_setup_user_option_filters', 12 );
add_action( 'bbp_loaded', 'bbp_register_theme_packages', 14 );
add_action( 'bbp_loaded', 'bbp_filter_user_roles_option', 16 );

常见问题

常见问题

如何

如何让用户注册到网站的论坛？

bbpress 与 WordPress 集成，参与论坛的用户注册对您 WordPress 站点上的所有用户都是相同的。他们可以使用 WordPress 提供的默认注册页面进行注册，或者您可以使用提供的注册表简码 作为前端表单。一旦用户注册到您的网站，他们将能够参与论坛。

如何阻止用户进入 WordPress 后端？

所有用户都可以转到 WordPress 后端，如果某些用户能够管理您网站的其他选项，他们将在仪表盘中看到新的菜单项，默认情况下，参与者/订阅者角色等低级角色只能编辑他们的个人资料。版主可以通过后台的区域管理话题和回复。有些人不喜欢除具有管理员权限的用户进入 WordPress 后端之外的任何人，如果您是其中之一，您可以使用此代码片段控制谁可以进入 WordPress 后端，或者安装 WP Admin No Show 之类的插件 。

如何启用注册？

默认情况下，WordPress 注册是禁用的，但是您可以通过登录您网站的 WordPress 后端来更改此设置，然后转到设置 > 常规，然后启用允许任何人注册。

如何安装 bbPress 主题？

阅读代码中的安装主题。

登录后如何重定向用户？

要在登录到您的站点后重定向用户的自定义 url，您可以使用此自定义代码片段，或安装一个插件，该插件可以添加与 Peter 的登录重定向相同的功能。

如何创建子主题？

遵循法典指南 子主题。

如何在 bbPress 中更改我的用户头像？

按照代码指南，如何更改我的用户头像？.

如何从其他论坛软件导入？

有关从其他论坛软件导入的任何信息，请阅读此 bbPress codex 部分导入论坛。

如何找到帖子 ID？

要查找 bbPress 自定义文章类型的帖子 ID，让我们说简码，在话题或回复帖子附近，您将看到每个帖子的类似 #12 的数字，即帖子 ID 号。安装像 Reveal IDs 这样的插件， 您将在 WordPress 后端的各自区域中看到每个帖子和用户 ID 。通过阅读 WordPress Codex Guide 中的这篇文章，还有其他方法可以在不需要插件的情况下找到帖子的帖子 ID 。

如何设置我的论坛？

设置论坛有两个主要程序，配置论坛设置和创建一些内容。如果您需要设置 bbPress 的其他进程，请参阅 bbPress codex 的入门部分。

如何删除 bbPress 并删除其所有内容？

如果您需要删除 bbPress 及其所有内容，请按照指南删除 bbPress 中列出的说明进行操作。

如何创造内容？

要了解如何在 bbPress 中创建论坛、话题和回复，请阅读以下指南创建内容。

如何翻译 bbPress？

要了解如何翻译您的 bbPress 论坛，请阅读您的语言 （本地化）中的以下 bbPress 指南。

如何自定义 bbPress？

要了解自定义和扩展 bbPress 的方法，请阅读代码指南自定义。

故障排除

我的论坛帖子返回 404 消息。我怎样才能解决这个问题？

这可能是您的重写规则的问题。要解决此问题，请尝试重置您的永久链接。在您的 WordPress 管理屏幕中，导航到设置 > 永久链接，选择不同的永久链接结构并保存。然后选择您喜欢的永久链接结构并再次保存。

bbPress.org 上的插件似乎都不起作用。这是怎么回事？

bbPress.org 上列出的插件用于 2.x 之前的安装，很快它们将被移动和存档。最新版本的 bbPress (2.x) 的所有插件都可以在 WordPress.org 上找到，带有 bbPress 标签 ——看看吧！

布局和 CSS 问题？

如果您遇到布局或 CSS 问题，请使用 Firebug 或任何内置 「开发人员工具」 的主要浏览器 Google Chrome 、 Safari 、 Firefox 、 Internet Explorer 和 Opera 。

插件冲突

要尝试解决与其他插件的冲突，请禁用除 bbPress 之外的所有插件，以查看错误是否仍然存在。一次重新启用每个插件，如果再次出现问题，您现在应该能够知道是哪个其他插件导致了冲突。

管理

如何让用户成为版主？

访问用户 > 所有用户并选择您希望成为主持人的用户。从将角色更改为... 下拉菜单中选择论坛版主，然后单击保存。

如何制作置顶话题？

坚持话题是坚持论坛顶部的话题。要创建粘性话题，请在创建话题时从话题类型下拉菜单中选择粘性。您可以通过将话题设为 「超级粘性」，使其在您的所有论坛上粘贴。

如何在主页中显示来自特定论坛的最近话题？

您可以通过在页面中插入简码来显示最近的话题。 bbPress 简码列表可以在这里找到。

简码

简码

由于版本 2.0 bbPress 支持所谓的 Shortcodes 。引入它们是为了创建宏，用于在 WordPress 页面上的论坛内容布局中使用。要使用任何简码，只需将所需的简码插入任何 WordPress 页面即可。

要获取 $forum_id 、 $topic_id 、 $reply_id 和 $tag_id 所需的数字 ID，您需要访问您的 /wp-admin/ 部分并通过编辑帖子或将鼠标悬停在适用的论坛/话题/回复/标记文章类型，您将看到该帖子的数字 ID，例如。/wp-admin/post.php?post=47

论坛

[bbp-forum-index] – 这将显示您的整个论坛索引。

[bbp-forum-form] – 显示 「新论坛」 表单。

[bbp-single-forum id=$forum_id] – 显示单个论坛话题。例如。 [bbp-single-forum id=32]

话题

[bbp-topic-index] – 使用分页显示所有论坛中最近的 15 个话题。

[bbp-topic-form] – 显示 「新话题」 表单，您可以从下拉菜单中选择与该话题相关联的论坛。

[bbp-topic-form forum_id=$forum_id] – 显示特定论坛 ID 的 「新话题表单」 。

[bbp-single-topic id=$topic_id] – 显示单个话题。例如。 [bbp-single-topic id=4096]

回复

[bbp-reply-form] – 显示 「新回复」 表单。

[bbp-single-reply id=$reply_id] – 显示单个回复，例如。 [bbp-单回复 id=32768]

话题标签

[bbp-topic-tags] – 显示所有话题标签的标签云。

[bbp-single-tag id=$tag_id] – 显示与特定标签关联的所有话题的列表。例如。 [bbp-single-tag id=64]

查看次数

[bbp-single-view] – 单一视图 – 显示与特定视图关联的话题。当前包含 bbPress 的 「视图」 是 「流行的」[bbp-single-view id='popular'] 和 「无回复」[bbp-single-view id='no-replies']

[bbp-search] – 显示搜索输入表单。

[bbp-search-form] – 显示搜索表单模板。

帐户

[bbp-login] – 显示登录屏幕。

[bbp-register] – 显示注册屏幕。

[bbp-lost-pass] – 显示丢失的密码屏幕。

统计数据

[bbp-stats] – 显示论坛统计信息。

** 尚未实施，计划在未来发布。

小工具

小工具

bbPress 带有五个小工具，可用于添加到您的任何 WordPress 话题侧边栏，要启用它们，只需打开您的 WordPress 管理仪表盘并转到 「外观」->「小工具」

(bbPress) 论坛列表– 带有设置父级选项的论坛列表。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。
  • 父论坛 ID：「0」 仅显示 root -「any」 显示所有

(bbPress) 最近回复-最近回复的列表。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。
  • 显示的最大回复数：
  • 显示发布日期：

(bbPress) 最近的话题-最近的话题列表，按流行度或新鲜度排序。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。
  • 要显示的最大话题数：
  • 显示发布日期：
  • 流行度检查：返回的话题数检查回复计数以确定流行度。小于要显示的最大话题数的数字将禁用检查。

(bbPress) 话题视图列表- 已注册的可选话题视图列表。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。

(bbPress) Search – 一个简单的论坛搜索表单。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。

(bbPress) 登录小工具– 一个简单的登录表单，带有可选的注册和丢失密码页面链接。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。
  • 注册 URI：链接到您的自定义注册页面，例如。使用 [bbp-register] 简码的 WordPress 页面。
  • 丢失密码 URI：链接到您丢失密码的页面，例如。使用 [bbp-lost-pass] 简码的 WordPress 页面。

(bbPress) 统计– 您的论坛统计列表。

选项：

  • 标题：您可以在此处设置小工具的标题，因为它将显示在侧边栏中。

创建内容

创建内容

bbPress 在 WordPress 后端创建了三个新菜单项来管理您的三种自定义文章类型。它们是：

  • 论坛- 包含在论坛中创建的所有话题和回复。
  • 话题- 话题是在论坛中创建的，它们是正在讨论的话题。
  • 回复- 回复是实际发生的讨论。它们是在话题内创建的，如果启用了线程回复，则可以回复其他用户的回复。

本指南将帮助您创建每个文章类型、为您的论坛构建类别，并解释任何其他属性以自定义每个文章类型。

创建论坛

要创建论坛，请按照下列步骤操作：

  1. 导航到论坛 > 新论坛。
  2. 为您的论坛命名。
  3. 可选：您可以在描述区域添加文本来描述您的特定论坛。出现在论坛管理屏幕上的正文
  4. 调整任何其他论坛属性。

类型：选择是创建论坛还是类别。

论坛– 可以包含话题并成为其他论坛的父论坛。

类别– 只能包含论坛 （无话题） 。用于组织您的论坛。

例如，您可能有一个 「开源软件」 类别，其中包含论坛 「bbPress」 和 「WordPress」 。

状态：选择论坛是打开还是关闭。

开放- 论坛用户可以在论坛中创建新话题。

关闭- 关闭论坛不允许创建任何新话题，也不允许对论坛中任何现有话题的任何新回复。如果是分类或其他论坛的父论坛，关闭该分类或父论坛将关闭其所有子论坛。

可见性：决定您的论坛是公开的、私密的还是隐藏的。

公开– 任何人都可以看到这些论坛

私人- 只有登录的注册用户才能看到这些论坛

隐藏- 只有版主/管理员可以看到这些论坛

父：论坛可以具有层次结构。如果您的论坛是另一个论坛的子论坛或某个类别的子论坛，请在此处添加父论坛。

顺序：这决定了论坛出现的顺序。用序号调整每个论坛以重新排列您的论坛。

当您满意时，点击发布。

默认情况下，您的论坛将位于 http://yourdomain.com/forums/forum/yourforumname

要调整默认 slug，请访问论坛 > 设置

创建话题

创建论坛后，您可以开始添加话题。您可以从前端或 WordPress 后端添加话题。

从前端添加话题

在前端导航到您的论坛。如果您刚刚设置了您的论坛，它将没有话题。

没有任何话题的论坛图片

为您的话题命名并为其添加一些内容。

添加了内容的前端 bbPress 话题字段。 话题标题、文章类型和订阅按钮高亮显示

您可以添加用于组织话题的标签，并且可以使帖子具有粘性或超级粘性。

粘性- 帖子将粘在其所在论坛的顶部。

超级粘性- 帖子将粘在所有论坛的顶部。

您还可以选择通过电子邮件订阅回复。

发布话题后，它将出现在您的论坛上。

添加到前端的话题

从 WordPress 后端添加话题

要从 WordPress 后端添加话题，

WordPress 管理屏幕上的话题编辑屏幕

  1. 导航到话题 > 新话题。
  2. 给您的话题一个标题和一些内容。
  3. 调整任何其他话题属性。

类型： 指示话题类型为粘性或正常。

正常- 这将是话题的默认类型，这不会将话题粘贴到任何地方。

粘性– 将话题粘贴到他们所在的单个论坛的顶部。

超级粘性– 将话题粘贴到您网站上所有论坛的顶部。

状态： 表示话题状态。

开放- 没有任何限制的正常话题。您网站上的所有论坛用户都可以回复此话题。

已关闭– 参与者无法进行任何进一步回复。不过，版主和键盘管理员仍然可以回复这些封闭的话题。

垃圾邮件– 将话题标记为垃圾邮件。该话题现在将显示在您的垃圾邮件队列中。

捣毁-在垃圾桶里，从中可以永久删除它就把话题。

待定- 等待批准发布的话题。

论坛： 选择您要添加话题的论坛。

您还可以看到输入话题标签、密码保护话题、将话题设置为仅供管理员/密钥管理员专用的区域。

完成创建话题后，单击发布。

创建回复

与话题一样，可以从您网站的前端或 WordPress 后端添加回复。

从前端添加回复

要从前端回复，请导航到您的论坛并单击您要回复的话题。

添加您的回复。您还可以选择通过电子邮件接收后续回复的通知。

前端的回复框

添加回复后，您会在回复 > 所有回复中看到它已添加到 WordPress 后端

添加来自 WordPress 后端的回复

要添加来自 WordPress 后端的回复，

  1. 导航到回复 > 新回复。
  2. 给您的话题一个标题和一些内容。
  3. 调整任何其他回复属性。

WordPress 管理屏幕中的回复属性

论坛：选择要回复的论坛。

话题：输入您希望回复的话题的 ID 。

回复：如果您启用了线程回复，这很有用。您输入要在其下发送的回复的 ID 。

您的回复现在将显示在您网站的前端。

您现在已经拥有开始使用 bbPress 创建论坛所需的一切！

论坛设置

论坛设置

论坛用户设置

该区域定义了 bbPress 论坛的权限和限制。

禁止编辑帖子

将此设置为时间 （以分钟为单位） 以限制后期编辑。一旦达到时间限制，论坛帖子将不再可供论坛参与者编辑。管理员和 bbPress 版主可以随时覆盖此设置。

限制发布

时间 将此设置为在 bbPress 论坛中发布新回复之间的最短时间 （以秒为单位） 。这有助于阻止垃圾邮件或其他干扰论坛正常流程的尝试。

匿名发布

任何站点访问者都可以发布新话题或回复，而无需登录您的站点。他们仍然需要输入姓名和电子邮件才能发布，但不需要创建用户名或密码，也不会显示在 WordPress 用户列表中。

自动角色

选择 bbPress 论坛成员默认分配的角色，角色有 Keymaster 、 Moderator 、 Participant（默认） 、 Spectator 和 Blocked 。有关这些角色分配的权限的完整详细信息，请参阅用户角色和功能。

论坛特色

修订版

的 WordPress 存储每个草稿保存时间或岗位后的新版本被编辑和重新发布。在此处为 bbPress 话题和回复启用或禁用此功能。要了解有关修订的更多信息，请查看有关修订管理的 WordPress 法典文章。

收藏夹

论坛参与者可以 「收藏」 任何话题。这些话题稍后可从参与者的论坛资料中查看。此外，还提供自定义 RSS 提要，使参与者能够及时了解对他们来说很重要的话题。

订阅

论坛参与者可以选择订阅论坛或话题。当在订阅的论坛中创建新话题或向订阅的话题发布新回复时，他们将收到通知。订阅的论坛和话题将出现在他们的论坛用户资料中。

话题标签

这将在站点范围内禁用话题标签，并且不再显示与每个话题或话题标签输入表单相关联的话题标签。

搜索

这将启用论坛范围的搜索，允许用户在您的论坛中搜索论坛、话题和回复。

帖子格式化

这会将工具栏和按钮添加到 textarea 以帮助进行 HTML 格式设置，默认值为 「b」（粗体） 、 「i」（斜体/强调） 、 「link」（URL 超链接） 、 「del」（删除线）) 、'img'（通过 URL 链接图像） 、'ul'（无序列表） 、'ol'（有序列表） 、'li'（列表项） 、'code'（用于预格式化文本的 HTML/PHP/SQL 代码) & 'close tags'（关闭任何未关闭的标签） 。

自动嵌入链接

使论坛参与者能够通过简单地将链接粘贴到他们的话题或回复中来嵌入来自 YouTube 、 Twitter 和其他人的链接。这是使用 WordPress oEmbed API 完成的。更多信息和支持站点的完整列表可以在嵌入 Codex 页面上找到。

回复线程

这将允许您的用户回复特定回复，在 「线程」 视图中为讨论提供上下文。这也将删除话题分页，因此话题和所有回复只会是一个页面。

允许全局访问

在 WordPress 多站点安装中，bbPress 在单个站点上被启用。允许全局访问将允许网络中的所有用户在此特定站点的论坛上发布话题和回复。

每页话题和回复

话题– 每页显示多少话题。
回复- 每页显示多少回复。

每个 RSS 页面的话题和回复

话题– 每个 RSS 页面显示多少个话题
回复– 每个 RSS 页面显示多少个回复

论坛根别名

论坛根 (Root) – 用于在论坛
上添加自定义 root slug 前缀 Forum Prefix – 用于在 Archive Slugs 中使用 Forums base slug 启用论坛前缀
论坛 root 应显示– 设置您的论坛以显示您的论坛索引或最新话题列表.

单论坛别名

Forum – 用于论坛 root slugs 的前缀
Topic – 用于话题 root slugs 的前缀
Topic Tag – 用于单个话题标签 root slugs 的前缀
Topic View – 用于话题视图根 slugs 的前缀
Reply – 用于回复 root slugs 的前缀
Search – 用于前缀搜索根段

论坛用户别名

用户基础– 用于添加用户 root slug 的前缀
Topics Started – 用于添加用户创建的话题 slugs
Replies Created – 用于添加用户创建的回复 slugs
最喜欢的话题– 用于添加用户最喜欢的话题 slugs
Topic Subscriptions – 用于添加用户订阅 slugs 的前缀

bbp_list_forums

bbp_list_forums

bbp_list_forums
Codex Home → bbp_list_forums
The bbp_list_forums function is commonly used to display a list of sub forums. You can customise the returned data by passing the function some arguments.
The bbp_list_forums is a function located in includesforumstemplate.php.
To filter this array use:
add_filter( 'bbp_before_list_forums_parse_args', 'your_filter_name' );
An example list of arguments
array (
'before' => '

    ',
    'after' => '

',
'link_before' => '

  • ',
    'link_after' => '

    • ',
    'count_before' => ' (',
    'count_after' => ')',
    'count_sep' => ', ',
    'separator' => ', ',
    'forum_id' => '',
    'show_topic_count' => true,
    'show_reply_count' => true,
    )
    before
    The value you specify for 『before』 will be put at the start of the returned data.
    after
    The value you specify for 『after』 will be put at the end of the returned data.
    link_before
    The value you specify for 『link_before』 will appear before each row returned in the data.
    link_after
    The value you specify for 『link_after』 will appear after each row returned in the data.
    count_before
    If you have show_topic_count or show_reply_count set to true, then this will attach itself to the start of each count.
    count_after
    If you have show_topic_count or show_reply_count set to true, then this will attach itself to the end of each count.
    count_sep
    The value specified inside count_sep is what separates each count, for example if you specified a comma the returned count would be: 0,0
    separator
    The value specified inside separator is what separates each subforum, for example if you specified
    the returned subforums would be displayed one per line.
    forum_id
    If you specify a forum_id then only child forums of the forum_id will be returned.
    show_topic_count
    This is a boolean flag, set it to true or false depending on if you want topic counts to be returned.
    show_reply_count
    This is a boolean flag, set it to true or false depending on if you want reply counts to be returned.
    Common Code Examples
    bbp_list_forums(array (
    'before' => '

    ',
    'after' => '

    ',
    'link_before' => '

    ',
    'link_after' => '

    ',
    'separator' => '',
    ));
    Returns a list of forums without the comma between reply and topic counts.
    bbp_list_forums(array (
    'before' => '

    ',
    'after' => '

    ',
    'link_before' => '

    ',
    'link_after' => '

    ',
    'separator' => '',
    'count_before' => '',
    'count_after' => '',
    ));
    Returns a list of forums without the comma between and the brackets around the reply and topic counts.

    bbp_theme_before_forum_title

    bbp_theme_before_forum_title

    bbp_theme_before_forum_title
    Codex Home → bbp_theme_before_forum_title
    Description
    The 『bbp_theme_before_forum_title』 action is used to display content before each forum title on the forum index pages.
    Where it can be found
    On line 16 of
    /bbp-theme-compat/bbpress/loop-single-forum.php
    /bbp-themes/bbp-twentyten/bbpress/loop-single-forum.php
    How to use it
    Since this is an action, we can use add_action to hook into it.
    Sample code example
    1234add_action( 'bbp_theme_before_forum_title', 'jc_before_forum_title' );function jc_before_forum_title() {     echo 'Hello world!';}
    Note: Always remember to prefix your functions to avoid conflicts!

    bbp_theme_after_forum_title

    bbp_theme_after_forum_title

    bbp_theme_after_forum_title
    Codex Home → bbp_theme_after_forum_title
    Description
    The 『bbp_theme_after_forum_title』 action is used to display content after each forum title on the forum index pages.
    Where it can be found
    On line 20 of
    /bbp-theme-compat/bbpress/loop-single-forum.php
    /bbp-themes/bbp-twentyten/bbpress/loop-single-forum.php

    How to use it
    Since this is an action, we can use add_action to hook into it.
    Sample code example
    add_action( 'bbp_theme_after_forum_title', 'jc_after_forum_title' );
    function jc_after_forum_title() {
    echo 'Hello world!';
    }
    Note: Always remember to prefix your functions to avoid conflicts!