/**
* Returns the reply ID.
*
* @since 1.0.0
* @access public
* @param int $reply_id
* @return int
*/
function mb_get_reply_id($reply_id = 0)
{
$mb = message_board();
if (is_numeric($reply_id) && 0 < $reply_id) {
$_reply_id = $reply_id;
} elseif ($mb->reply_query->in_the_loop && isset($mb->reply_query->post->ID)) {
$_reply_id = $mb->reply_query->post->ID;
} elseif ($mb->search_query->in_the_loop && isset($mb->search_query->post->ID) && mb_is_reply($mb->search_query->post->ID)) {
$_reply_id = $mb->search_query->post->ID;
} elseif (mb_is_single_reply()) {
$_reply_id = get_queried_object_id();
} elseif (get_query_var('reply_id')) {
$_reply_id = get_query_var('reply_id');
} else {
$_reply_id = 0;
}
return apply_filters('mb_get_reply_id', absint($_reply_id), $reply_id);
}
/**
* Overwrites the `do_trail_items()` method and creates custom trail items.
*
* @since 1.0.0
* @access public
* @return void
*/
public function do_trail_items()
{
/* Add the network and site home links. */
$this->do_network_home_link();
$this->do_site_home_link();
$this->mb_do_board_home_link();
/* Single forum, topic, or reply. */
if (mb_is_single_forum() || mb_is_single_topic() || mb_is_single_reply()) {
$this->do_singular_items();
} elseif (mb_is_forum_archive() || mb_is_topic_archive() || mb_is_reply_archive()) {
$this->do_post_type_archive_items();
} elseif (mb_is_role_archive()) {
$this->mb_do_user_archive_link();
if (is_paged()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_role_archive_url(), mb_get_role_archive_title());
} elseif ($this->args['show_title']) {
$this->items[] = mb_get_role_archive_title();
}
} elseif (mb_is_single_role()) {
$this->mb_do_user_archive_link();
$this->mb_do_role_archive_link();
if (is_paged()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_role_url(), mb_get_single_role_title());
} elseif ($this->args['show_title']) {
$this->items[] = mb_get_single_role_title();
}
} elseif (mb_is_user_archive()) {
if (is_paged()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_archive_url(), mb_get_user_archive_title());
} elseif ($this->args['show_title']) {
$this->items[] = mb_get_user_archive_title();
}
} elseif (mb_is_single_user()) {
$this->mb_do_user_archive_link();
/* If single user subpage. */
if (mb_is_user_page()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_url(), get_the_author_meta('display_name', mb_get_user_id()));
if (is_paged()) {
if (mb_is_user_forums()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_forums_url(), mb_get_user_forums_title());
} elseif (mb_is_user_topics()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_topics_url(), mb_get_user_topics_title());
} elseif (mb_is_user_replies()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_replies_url(), mb_get_user_replies_title());
} elseif (mb_is_user_bookmarks()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_bookmarks_url(), mb_get_user_bookmarks_title());
} elseif (mb_is_user_forum_subscriptions()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_forum_subscriptions_url(), mb_get_user_forum_subscriptions_title());
} elseif (mb_is_user_topic_subscriptions()) {
$this->items[] = sprintf('<a href="%s">%s</a>', mb_get_user_topic_subscriptions_url(), mb_get_user_topic_subscriptions_title());
}
} elseif ($this->args['show_title']) {
$this->items[] = mb_get_user_page_title();
}
/* If viewing the single user page but not a subpage. */
} elseif ($this->args['show_title']) {
$this->items[] = mb_get_single_user_title();
}
/* Login page. */
} elseif (mb_is_forum_login()) {
$this->items[] = mb_get_login_page_title();
}
/* Add paged items. */
$this->do_paged_items();
/* Return the board breadcrumb trail items. */
$this->items = apply_filters('mb_get_breadcrumb_trail_items', $this->items, $this->args);
}
/**
* Builds the template hierarchy for the plugin. This function figures out what the current page
* is and returns an array of possible templates to use. Note that this function only returns
* the templates name and not a full paths. It is meant to be used within other functions that actually
* locate/load the templates.
*
* @since 1.0.0
* @access public
* @return array
*/
function mb_get_template_hierarchy()
{
$hierarchy = array();
/* If viewing a single forum page. */
if (mb_is_single_forum()) {
$hierarchy[] = 'single-forum.php';
/* If viewing the forum archive (default forum front). */
} elseif (mb_is_forum_archive()) {
$hierarchy[] = 'archive-forum.php';
/* If viewing a single topic. */
} elseif (mb_is_single_topic()) {
$hierarchy[] = "single-topic.php";
/* If viewing the topic archive (possible forum front page). */
} elseif (mb_is_topic_archive()) {
$hierarchy[] = 'archive-topic.php';
/* If viewing a single reply. */
} elseif (mb_is_single_reply()) {
$hierarchy[] = "single-reply.php";
/* If viewing the reply archive. */
} elseif (mb_is_reply_archive()) {
$hierarchy[] = 'archive-reply.php';
} elseif (mb_is_role_archive()) {
$hierarchy[] = 'archive-role.php';
} elseif (mb_is_single_role()) {
$hierarchy[] = 'single-role.php';
/* If viewing a user sub-page. */
} elseif (mb_is_user_page()) {
$page = sanitize_key(get_query_var('mb_user_page'));
$hierarchy[] = "single-user-{$page}.php";
$hierarchy[] = 'single-user.php';
/* If viewing a user profile page. */
} elseif (mb_is_single_user()) {
$hierarchy[] = 'single-user.php';
/* If viewing the user archive. */
} elseif (mb_is_user_archive()) {
$hierarchy[] = 'archive-user.php';
/* If viewing a search results page. */
} elseif (mb_is_search_results()) {
$hierarchy[] = 'search-results.php';
/* If viewing the advanced search page. */
} elseif (mb_is_search()) {
$hierarchy[] = 'search.php';
/* If viewing the forum login page. */
} elseif (mb_is_forum_login()) {
$hierarchy[] = 'login.php';
/* If viewing an edit page. */
} elseif (mb_is_edit()) {
if (mb_is_forum_edit()) {
$hierarchy[] = 'edit-forum.php';
} elseif (mb_is_topic_edit()) {
$hierarchy[] = 'edit-topic.php';
} elseif (mb_is_reply_edit()) {
$hierarchy[] = 'edit-reply.php';
} elseif (mb_is_user_edit()) {
$hierarchy[] = 'edit-user.php';
}
$hierarchy[] = 'edit.php';
}
/* Add the fallback template. */
$hierarchy[] = 'board.php';
return apply_filters('mb_get_template_hierarchy', $hierarchy);
}
/**
* Checks if viewing one of the Message Board plugin pages.
*
* @since 1.0.0
* @access public
* @return bool
*/
function mb_is_message_board()
{
$is_message_board = false;
if (mb_is_search() || mb_is_search_results() || mb_is_forum_login() || mb_is_edit() || mb_is_forum_archive() || mb_is_topic_archive() || mb_is_reply_archive() || mb_is_user_archive() || mb_is_single_forum() || mb_is_single_topic() || mb_is_single_reply() || mb_is_single_user() || mb_is_role_archive() || mb_is_single_role()) {
$is_message_board = true;
}
return apply_filters('mb_is_message_board', $is_message_board);
}
/**
* Filter on `body_class` to add custom classes for the plugin's pages on the front end.
*
* @todo Remove `bbpress` class.
* @todo Decide on class naming system.
*
* @since 1.0.0
* @access public
* @param array $classes
* @return array
*/
function mb_body_class($classes)
{
global $wp;
if (mb_is_message_board()) {
$classes[] = 'mb';
$classes[] = 'bbpress';
// temporary class for compat
$forum_type = mb_get_forum_post_type();
$topic_type = mb_get_topic_post_type();
$reply_type = mb_get_reply_post_type();
$_classes = $classes;
$remove = array("single-{$forum_type}", "single-{$topic_type}", "single-{$reply_type}", "singular-{$forum_type}", "singular-{$topic_type}", "singular-{$reply_type}", "archive-{$forum_type}", "archive-{$topic_type}", "archive-{$reply_type}");
foreach ($_classes as $class_key => $class_value) {
if (in_array($class_value, $remove)) {
unset($classes[$class_key]);
}
}
if (mb_is_forum_front()) {
$classes[] = 'forum-front';
} elseif (mb_is_single_forum()) {
$classes[] = 'single-forum';
} elseif (mb_is_single_topic()) {
$classes[] = 'single-topic';
} elseif (mb_is_single_reply()) {
$classes[] = 'single-reply';
} elseif (mb_is_single_role()) {
$classes[] = 'single-role';
} elseif (mb_is_forum_archive()) {
$classes[] = 'archive-forum';
} elseif (mb_is_topic_archive()) {
$classes[] = 'archive-topic';
} elseif (mb_is_reply_archive()) {
$classes[] = 'archive-reply';
} elseif (mb_is_role_archive()) {
$classes[] = 'archive-role';
} elseif (mb_is_user_archive()) {
$classes[] = 'archive-user';
}
}
return $classes;
}