File: //home/dfwparty/dfwchat.net/wp-content/plugins/buddyboss-platform/bp-forums/topics/template.php
<?php
/**
* Forums Topic Template Tags
*
* @package BuddyBoss\Template\Tags
*/
// Exit if accessed directly
defined( 'ABSPATH' ) || exit;
/** Post Type *****************************************************************/
/**
* Output the unique id of the custom post type for topics
*
* @since bbPress (r2857)
*
* @uses bbp_get_topic_post_type() To get the topic post type
*/
function bbp_topic_post_type() {
echo bbp_get_topic_post_type();
}
/**
* Return the unique id of the custom post type for topics
*
* @since bbPress (r2857)
*
* @return string The unique topic post type id
* @uses apply_filters() Calls 'bbp_get_topic_post_type' with the topic
* post type id
*/
function bbp_get_topic_post_type() {
return apply_filters( 'bbp_get_topic_post_type', bbpress()->topic_post_type );
}
/**
* Return array of labels used by the topic post type
*
* @since bbPress (r5129)
*
* @return array
*/
function bbp_get_topic_post_type_labels() {
return apply_filters(
'bbp_get_topic_post_type_labels',
array(
'name' => __( 'Discussions', 'buddyboss' ),
'menu_name' => __( 'Discussions', 'buddyboss' ),
'singular_name' => __( 'Discussion', 'buddyboss' ),
'all_items' => __( 'All Discussions', 'buddyboss' ),
'add_new' => __( 'New Discussion', 'buddyboss' ),
'add_new_item' => __( 'Start New Discussion', 'buddyboss' ),
'edit' => __( 'Edit', 'buddyboss' ),
'edit_item' => __( 'Edit Discussion', 'buddyboss' ),
'new_item' => __( 'New Discussion', 'buddyboss' ),
'view' => __( 'View Discussion', 'buddyboss' ),
'view_item' => __( 'View Discussion', 'buddyboss' ),
'search_items' => __( 'Search Discussions', 'buddyboss' ),
'not_found' => __( 'No discussions found', 'buddyboss' ),
'not_found_in_trash' => __( 'No discussions found in trash', 'buddyboss' ),
'parent_item_colon' => __( 'Forum:', 'buddyboss' ),
)
);
}
/**
* Return array of topic post type rewrite settings
*
* @since bbPress (r5129)
*
* @return array
*/
function bbp_get_topic_post_type_rewrite() {
return apply_filters(
'bbp_get_topic_post_type_rewrite',
array(
'slug' => bbp_get_topic_slug(),
'with_front' => false,
)
);
}
/**
* Return array of features the topic post type supports
*
* @since bbPress (r5129)
*
* @return array
*/
function bbp_get_topic_post_type_supports() {
return apply_filters(
'bbp_get_topic_post_type_supports',
array(
'title',
'editor',
'revisions',
)
);
}
/**
* Return the base URL used inside of pagination links
*
* @since 2.6.0 bbPress (r6402)
*
* @param int $forum_id Forum ID.
* @return string
*/
function bbp_get_topics_pagination_base( $forum_id = 0 ) {
// If pretty permalinks are enabled, make our pagination pretty.
if ( bbp_use_pretty_urls() ) {
// User's topics.
if ( bbp_is_single_user_topics() ) {
$base = bbp_get_user_topics_created_url( bbp_get_displayed_user_id() );
// User's engagements.
} elseif ( bbp_is_single_user_engagements() ) {
$base = bbp_get_user_engagements_url( bbp_get_displayed_user_id() );
// User's favorites.
} elseif ( bbp_is_favorites() ) {
$base = bbp_get_favorites_permalink( bbp_get_displayed_user_id() );
// Root profile page.
} elseif ( bbp_is_single_user() ) {
$base = bbp_get_user_profile_url( bbp_get_displayed_user_id() );
// Any single post (for shortcodes, ahead of shortcodeables below)
} elseif ( is_singular() ) {
if ( has_shortcode( get_the_content(), 'bbp-forum-index' ) ) {
$base = bbp_get_topics_url();
} else {
// If archive page set as homepage.
if ( bbp_is_forum_archive() ) {
if ( 'forums' === bbp_show_on_root() ) {
$base = bbp_get_topics_url();
} elseif ( 'topics' === bbp_show_on_root() ) {
$base = bbp_get_forums_url();
}
} elseif ( bbp_is_topic_archive() ) {
$base = bbp_get_topics_url();
// Page or single post.
} else {
$base = get_permalink();
}
}
// View.
} elseif ( bbp_is_single_view() ) {
$base = bbp_get_view_url();
// Topic tag.
} elseif ( bbp_is_topic_tag() ) {
$base = bbp_get_topic_tag_link();
// Forum archive.
} elseif ( bbp_is_forum_archive() ) {
if ( 'forums' === bbp_show_on_root() ) {
$base = bbp_get_topics_url();
} elseif ( 'topics' === bbp_show_on_root() ) {
$base = bbp_get_forums_url();
}
// Topic archive.
} elseif ( bbp_is_topic_archive() ) {
$base = bbp_get_topics_url();
// Page or single post.
} else {
$base = get_permalink( $forum_id );
}
// Use pagination base.
$base = trailingslashit( $base ) . user_trailingslashit( bbp_get_paged_slug() . '/%#%/' );
// Unpretty pagination.
} else {
$base = add_query_arg( 'paged', '%#%' );
}
// Filter & return.
return apply_filters( 'bbp_get_topics_pagination_base', $base, $forum_id );
}
/**
* The plugin version of Forums comes with two topic display options:
* - Traditional: Topics are included in the reply loop (default)
* - New Style: Topics appear as "lead" posts, ahead of replies
*
* @since bbPress (r2954)
*
* @param bool $show_lead Optional. Default false.
*
* @return bool Yes if the topic appears as a lead, otherwise false
*/
function bbp_show_lead_topic( $show_lead = true ) {
// Never separate the lead topic in feeds.
if ( is_feed() ) {
return false;
}
return (bool) apply_filters( 'bbp_show_lead_topic', (bool) $show_lead );
}
/** Topic Loop ****************************************************************/
/**
* The main topic loop. WordPress makes this easy for us
*
* @since bbPress (r2485)
*
* @param mixed $args All the arguments supported by {@link WP_Query}
*
* @return object Multidimensional array of topic information
* @uses current_user_can() To check if the current user can edit other's topics
* @uses bbp_get_topic_post_type() To get the topic post type
* @uses WP_Query To make query and get the topics
* @uses is_page() To check if it's a page
* @uses bbp_is_single_forum() To check if it's a forum
* @uses bbp_get_forum_id() To get the forum id
* @uses bbp_get_paged() To get the current page value
* @uses bbp_get_super_stickies() To get the super stickies
* @uses bbp_get_stickies() To get the forum stickies
* @uses wpdb::get_results() To execute our query and get the results
* @uses bbp_use_pretty_urls() To check if the site is using pretty URLs
* @uses get_permalink() To get the permalink
* @uses add_query_arg() To add custom args to the url
* @uses apply_filters() Calls 'bbp_topics_pagination' with the pagination args
* @uses paginate_links() To paginate the links
* @uses apply_filters() Calls 'bbp_has_topics' with
* bbPres::topic_query::have_posts()
* and bbPres::topic_query
*/
function bbp_has_topics( $args = '' ) {
/** Defaults */
// Other defaults.
$default_topic_search = bbp_sanitize_search_request( 'ts' );
$default_show_stickies = (bool) ( bbp_is_single_forum() || bbp_is_topic_archive() ) && ( false === $default_topic_search );
$default_post_parent = bbp_is_single_forum() ? bbp_get_forum_id() : 'any';
// Default argument array.
$default = array(
'post_type' => bbp_get_topic_post_type(), // Narrow query down to Forums topics.
'post_parent' => $default_post_parent, // Forum ID.
'meta_key' => '_bbp_last_active_time', // Make sure topic has some last activity time.
'meta_type' => 'DATETIME',
'orderby' => 'meta_value', // 'meta_value', 'author', 'date', 'title', 'modified', 'parent', rand',
'order' => 'DESC', // 'ASC', 'DESC'.
'posts_per_page' => bbp_get_topics_per_page(), // Topics per page.
'paged' => bbp_get_paged(), // Page Number.
's' => $default_topic_search, // Topic Search.
'show_stickies' => $default_show_stickies, // Ignore sticky topics?
'max_num_pages' => false, // Maximum number of pages to show.
'update_post_family_cache' => true,
);
// What are the default allowed statuses (based on user caps).
if ( bbp_get_view_all( 'edit_others_topics' ) ) {
// Default view=all statuses.
$post_statuses = array_keys( bbp_get_topic_statuses() );
// Add support for private status.
if ( current_user_can( 'read_private_topics' ) ) {
$post_statuses[] = bbp_get_private_status_id();
}
// Join post statuses together.
$default['post_status'] = implode( ',', $post_statuses );
// Lean on the 'perm' query var value of 'readable' to provide statuses.
} else {
$default['perm'] = 'readable';
}
// Maybe query for topic tags.
if ( bbp_is_topic_tag() ) {
$default['term'] = bbp_get_topic_tag_slug();
$default['taxonomy'] = bbp_get_topic_tag_tax_id();
}
/** Setup */
// Parse arguments against default values.
$r = bbp_parse_args( $args, $default, 'has_topics' );
// Get Forums.
$bbp = bbpress();
// Call the query.
$bbp->topic_query = new WP_Query( $r );
// Maybe prime last active posts.
if ( ! empty( $r['update_post_family_cache'] ) ) {
bbp_update_post_family_caches( $bbp->topic_query->posts );
}
// Set post_parent back to 0 if originally set to 'any'.
if ( 'any' === $r['post_parent'] ) {
$r['post_parent'] = 0;
}
// Limited the number of pages shown.
if ( ! empty( $r['max_num_pages'] ) ) {
$bbp->topic_query->max_num_pages = $r['max_num_pages'];
}
// If no limit to posts per page, set it to the current post_count.
if ( -1 === $r['posts_per_page'] ) {
$r['posts_per_page'] = $bbp->topic_query->post_count;
}
// Add pagination values to query object.
$bbp->topic_query->posts_per_page = $r['posts_per_page'];
$bbp->topic_query->paged = $r['paged'];
// Only add pagination if query returned results.
if ( ( (int) $bbp->topic_query->post_count || (int) $bbp->topic_query->found_posts ) && (int) $bbp->topic_query->posts_per_page ) {
// Limit the number of topics shown based on maximum allowed pages.
if ( ( ! empty( $r['max_num_pages'] ) ) && $bbp->topic_query->found_posts > $bbp->topic_query->max_num_pages * $bbp->topic_query->post_count ) {
$bbp->topic_query->found_posts = $bbp->topic_query->max_num_pages * $bbp->topic_query->post_count;
}
// Maybe add view-all args.
$add_args = bbp_get_view_all() ? array( 'view' => 'all' ) : false;
// Total topics for pagination boundaries.
$total_pages = ( $bbp->topic_query->posts_per_page === $bbp->topic_query->found_posts ) ? 1 : ceil( $bbp->topic_query->found_posts / $bbp->topic_query->posts_per_page );
// Pagination settings with filter.
$bbp_topic_pagination = apply_filters(
'bbp_topic_pagination',
array(
'base' => bbp_get_topics_pagination_base( $r['post_parent'] ),
'format' => '',
'total' => $total_pages,
'current' => $bbp->topic_query->paged,
'prev_text' => is_rtl() ? '→' : '←',
'next_text' => is_rtl() ? '←' : '→',
'mid_size' => 1,
'add_args' => $add_args,
)
);
// Add pagination to query object.
$bbp->topic_query->pagination_links = bbp_paginate_links( $bbp_topic_pagination );
}
// Return object.
return apply_filters( 'bbp_has_topics', $bbp->topic_query->have_posts(), $bbp->topic_query );
}
/**
* Whether there are more topics available in the loop
*
* @since bbPress (r2485)
*
* @return object Topic information
* @uses WP_Query bbPress::topic_query::have_posts()
*/
function bbp_topics() {
// Put into variable to check against next.
$have_posts = bbpress()->topic_query->have_posts();
// Reset the post data when finished.
if ( empty( $have_posts ) ) {
wp_reset_postdata();
}
return $have_posts;
}
/**
* Loads up the current topic in the loop
*
* @since bbPress (r2485)
*
* @return object Topic information
* @uses WP_Query bbPress::topic_query::the_post()
*/
function bbp_the_topic() {
return bbpress()->topic_query->the_post();
}
/**
* Add sticky topics to a topics query object
*
* @since 2.6.0 bbPress (r6402)
*
* @param WP_Query $query Array of query.
* @param array $args Array of arguments.
*/
function bbp_add_sticky_topics( &$query, $args = array() ) {
// Bail if intercepted.
$intercept = bbp_maybe_intercept( __FUNCTION__, func_get_args() );
if ( bbp_is_intercepted( $intercept ) ) {
return $intercept;
}
// Parse arguments against what gets used locally.
$r = bbp_parse_args( $args, array(
'post_parent' => 0,
'post_parent__not_in' => array(),
'post__not_in' => array(),
'post_status' => '',
'perm' => ''
), 'add_sticky_topics' );
// Get super stickies and stickies in this forum.
$super_stickies = bbp_get_super_stickies();
$forum_stickies = ! empty( $r['post_parent'] ) ? bbp_get_stickies( $r['post_parent'] ) : array();
// Merge stickies (supers first) and remove duplicates.
$stickies = array_filter( array_unique( array_merge( $super_stickies, $forum_stickies ) ) );
// Bail if no stickies.
if ( empty( $stickies ) ) {
return;
}
// If any posts have been excluded specifically, Ignore those that are sticky.
if ( ! empty( $r['post__not_in'] ) ) {
$stickies = array_diff( $stickies, $r['post__not_in'] );
}
// Default sticky posts array.
$sticky_topics = array();
// Loop through posts.
foreach ( $query->posts as $key => $post ) {
// Looking for stickies in this query loop, and stash & unset them.
if ( in_array( $post->ID, $stickies, true ) ) {
$sticky_topics[] = $post;
unset( $query->posts[ $key ] );
}
}
// Remove queried stickies from stickies array.
if ( ! empty( $sticky_topics ) ) {
$stickies = array_diff( $stickies, wp_list_pluck( $sticky_topics, 'ID' ) );
}
// Fetch all stickies that were not in the query.
if ( ! empty( $stickies ) ) {
// Query to use in get_posts to get sticky posts.
$sticky_query = array(
'post_type' => bbp_get_topic_post_type(),
'post_parent' => 'any',
'meta_key' => '_bbp_last_active_time',
'meta_type' => 'DATETIME',
'orderby' => 'meta_value',
'order' => 'DESC',
'include' => $stickies,
);
// Conditionally exclude private/hidden forum ID's.
$exclude_forum_ids = bbp_exclude_forum_ids( 'array' );
// Maybe remove the current forum from excluded forum IDs.
if ( ! empty( $r['post_parent'] ) ) {
unset( $exclude_forum_ids[ $r['post_parent'] ] );
}
// Maybe exclude specific forums.
if ( ! empty( $exclude_forum_ids ) ) {
$sticky_query['post_parent__not_in'] = $exclude_forum_ids;
}
// Allowed statuses, or lean on the 'perm' argument (probably 'readable').
$sticky_query['post_status'] = bbp_get_view_all( 'edit_others_topics' )
? $r['post_status']
: $r['perm'];
// Get unqueried stickies.
$_posts = get_posts( $sticky_query );
if ( ! empty( $_posts ) ) {
// Merge the stickies topics with the query topics .
$sticky_topics = array_merge( $sticky_topics, $_posts );
// Get a count of the visible stickies.
$sticky_count = count( $_posts );
// Adjust loop and counts for new sticky positions.
$query->found_posts = (int) $query->found_posts + (int) $sticky_count;
$query->post_count = (int) $query->post_count + (int) $sticky_count;
}
}
// Bail if no sticky topics empty or not an array.
if ( empty( $sticky_topics ) || ! is_array( $sticky_topics ) ) {
return;
}
// Default ordered stickies array.
$ordered_stickies = array(
'supers' => array(),
'forums' => array(),
);
// Separate supers from forums.
foreach ( $sticky_topics as $post ) {
if ( in_array( $post->ID, $super_stickies, true ) ) {
$ordered_stickies['supers'][] = $post;
} elseif ( in_array( $post->ID, $forum_stickies, true ) ) {
$ordered_stickies['forums'][] = $post;
}
}
// Merge supers and forums, supers first.
$sticky_topics = array_merge( $ordered_stickies['supers'], $ordered_stickies['forums'] );
// Update queried posts.
$query->posts = array_merge( $sticky_topics, array_values( $query->posts ) );
}
/**
* Output the topic id
*
* @since bbPress (r2485)
*
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_topic_id( $topic_id = 0 ) {
echo bbp_get_topic_id( $topic_id );
}
/**
* Return the topic id
*
* @since bbPress (r2485)
*
* @param $topic_id Optional. Used to check emptiness
*
* @return int The topic id
* @uses bbPress::topic_query::post::ID To get the topic id
* @uses bbp_is_topic() To check if the search result is a topic
* @uses bbp_is_single_topic() To check if it's a topic page
* @uses bbp_is_topic_edit() To check if it's a topic edit page
* @uses bbp_is_single_reply() To check if it it's a reply page
* @uses bbp_is_reply_edit() To check if it's a reply edit page
* @uses bbp_get_reply_topic_edit() To get the reply topic id
* @uses get_post_field() To get the post's post type
* @uses WP_Query::post::ID To get the topic id
* @uses bbp_get_topic_post_type() To get the topic post type
* @uses apply_filters() Calls 'bbp_get_topic_id' with the topic id and
* supplied topic id
*/
function bbp_get_topic_id( $topic_id = 0 ) {
global $wp_query;
$bbp = bbpress();
// Easy empty checking
if ( ! empty( $topic_id ) && is_numeric( $topic_id ) ) {
$bbp_topic_id = $topic_id;
// Currently inside a topic loop
} elseif ( ! empty( $bbp->topic_query->in_the_loop ) && isset( $bbp->topic_query->post->ID ) ) {
$bbp_topic_id = $bbp->topic_query->post->ID;
// Currently inside a search loop
} elseif ( ! empty( $bbp->search_query->in_the_loop ) && isset( $bbp->search_query->post->ID ) && bbp_is_topic( $bbp->search_query->post->ID ) ) {
$bbp_topic_id = $bbp->search_query->post->ID;
// Currently viewing/editing a topic, likely alone
} elseif ( ( bbp_is_single_topic() || bbp_is_topic_edit() ) && ! empty( $bbp->current_topic_id ) ) {
$bbp_topic_id = $bbp->current_topic_id;
// Currently viewing/editing a topic, likely in a loop
} elseif ( ( bbp_is_single_topic() || bbp_is_topic_edit() ) && isset( $wp_query->post->ID ) ) {
$bbp_topic_id = $wp_query->post->ID;
// Currently viewing/editing a reply
} elseif ( bbp_is_single_reply() || bbp_is_reply_edit() ) {
$bbp_topic_id = bbp_get_reply_topic_id();
// Fallback
} else {
$bbp_topic_id = 0;
}
return (int) apply_filters( 'bbp_get_topic_id', (int) $bbp_topic_id, $topic_id );
}
/**
* Gets a topic
*
* @since bbPress (r2787)
*
* @param int|object $topic Topic id or topic object
* @param string $output Optional. OBJECT, ARRAY_A, or ARRAY_N. Default = OBJECT
* @param string $filter Optional Sanitation filter. See {@link sanitize_post()}
*
* @return mixed Null if error or topic (in specified form) if success
* @uses apply_filters() Calls 'bbp_get_topic' with the topic, output type and
* sanitation filter
* @uses get_post() To get the topic
*/
function bbp_get_topic( $topic, $output = OBJECT, $filter = 'raw' ) {
// Use topic ID.
if ( empty( $topic ) || is_numeric( $topic ) ) {
$topic = bbp_get_topic_id( $topic );
}
// Attempt to load the topic.
$topic = get_post( $topic, OBJECT, $filter );
if ( empty( $topic ) ) {
return $topic;
}
// Bail if post_type is not a topic.
if ( bbp_get_topic_post_type() !== $topic->post_type ) {
return null;
}
// Tweak the data type to return.
if ( ARRAY_A === $output ) {
$topic = get_object_vars( $topic );
} elseif ( ARRAY_N === $output ) {
$topic = array_values( get_object_vars( $topic ) );
}
return apply_filters( 'bbp_get_topic', $topic, $output, $filter );
}
/**
* Output the link to the topic in the topic loop
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
* @param $string $redirect_to Optional. Pass a redirect value for use with
* shortcodes and other fun things.
*
* @uses bbp_get_topic_permalink() To get the topic permalink
*/
function bbp_topic_permalink( $topic_id = 0, $redirect_to = '' ) {
echo esc_url( bbp_get_topic_permalink( $topic_id, $redirect_to ) );
}
/**
* Return the link to the topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
* @param $string $redirect_to Optional. Pass a redirect value for use with
* shortcodes and other fun things.
*
* @return string Permanent link to topic
* @uses get_permalink() To get the topic permalink
* @uses esc_url_raw() To clean the redirect_to url
* @uses apply_filters() Calls 'bbp_get_topic_permalink' with the link
* and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_permalink( $topic_id = 0, $redirect_to = '' ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Use the redirect address
if ( ! empty( $redirect_to ) ) {
$topic_permalink = esc_url_raw( $redirect_to );
// Use the topic permalink
} else {
$topic_permalink = get_permalink( $topic_id );
}
return apply_filters( 'bbp_get_topic_permalink', $topic_permalink, $topic_id );
}
/**
* Output the title of the topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_title() To get the topic title
*/
function bbp_topic_title( $topic_id = 0 ) {
echo bbp_get_topic_title( $topic_id );
}
/**
* Return the title of the topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
*
* @return string Title of topic
* @uses get_the_title() To get the title
* @uses apply_filters() Calls 'bbp_get_topic_title' with the title and
* topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_title( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$title = ( ! empty( $topic_id ) ) ? esc_html( get_the_title( $topic_id ) ) : '';
return apply_filters( 'bbp_get_topic_title', $title, $topic_id );
}
/**
* Output the topic archive title
*
* @since bbPress (r3249)
*
* @param string $title Default text to use as title
*/
function bbp_topic_archive_title( $title = '' ) {
echo bbp_get_topic_archive_title( $title );
}
/**
* Return the topic archive title
*
* @since bbPress (r3249)
*
* @param string $title Default text to use as title
*
* @return string The topic archive title
* @uses get_the_title() Use the page title at the root path
* @uses get_post_type_object() Load the post type object
* @uses bbp_get_topic_post_type() Get the topic post type ID
* @uses get_post_type_labels() Get labels for topic post type
* @uses apply_filters() Allow output to be manipulated
*
* @uses bbp_get_page_by_path() Check if page exists at root path
*/
function bbp_get_topic_archive_title( $title = '' ) {
// If no title was passed
if ( empty( $title ) ) {
// Set root text to page title
$page = bbp_get_page_by_path( bbp_get_topic_archive_slug() );
if ( ! empty( $page ) ) {
$title = get_the_title( $page->ID );
// Default to topic post type name label
} else {
$tto = get_post_type_object( bbp_get_topic_post_type() );
$title = $tto->labels->name;
}
}
return apply_filters( 'bbp_get_topic_archive_title', $title );
}
/**
* Output the content of the topic
*
* @since bbPress (r2780)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_content() To get the topic content
*/
function bbp_topic_content( $topic_id = 0 ) {
echo bbp_get_topic_content( $topic_id );
}
/**
* Return the content of the topic
*
* @since bbPress (r2780)
*
* @param int $topic_id Optional. Topic id
*
* @return string Content of the topic
* @uses post_password_required() To check if the topic requires pass
* @uses get_the_password_form() To get the password form
* @uses get_post_field() To get the content post field
* @uses apply_filters() Calls 'bbp_get_topic_content' with the content
* and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_content( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Check if password is required
if ( post_password_required( $topic_id ) ) {
return get_the_password_form();
}
$content = get_post_field( 'post_content', $topic_id );
return apply_filters( 'bbp_get_topic_content', $content, $topic_id );
}
/**
* Output the excerpt of the topic
*
* @since bbPress (r2780)
*
* @param int $topic_id Optional. Topic id
* @param int $length Optional. Length of the excerpt. Defaults to 100 letters
*
* @uses bbp_get_topic_excerpt() To get the topic excerpt
*/
function bbp_topic_excerpt( $topic_id = 0, $length = 100 ) {
echo bbp_get_topic_excerpt( $topic_id, $length );
}
/**
* Return the excerpt of the topic
*
* @since bbPress (r2780)
*
* @param int $topic_id Optional. topic id
* @param int $length Optional. Length of the excerpt. Defaults to 100
* letters
*
* @return string topic Excerpt
* @uses get_post_field() To get the excerpt
* @uses bbp_get_topic_content() To get the topic content
* @uses apply_filters() Calls 'bbp_get_topic_excerpt' with the excerpt,
* topic id and length
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_excerpt( $topic_id = 0, $length = 100 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$length = (int) $length;
$excerpt = get_post_field( 'post_excerpt', $topic_id );
if ( empty( $excerpt ) ) {
$excerpt = bbp_get_topic_content( $topic_id );
}
$excerpt = trim( strip_tags( $excerpt ) );
// Multibyte support
if ( function_exists( 'mb_strlen' ) ) {
$excerpt_length = mb_strlen( $excerpt );
} else {
$excerpt_length = strlen( $excerpt );
}
if ( ! empty( $length ) && ( $excerpt_length > $length ) ) {
$excerpt = substr( $excerpt, 0, $length - 1 );
$excerpt .= '…';
}
return apply_filters( 'bbp_get_topic_excerpt', $excerpt, $topic_id, $length );
}
/**
* Output the post date and time of a topic
*
* @since bbPress (r4155)
*
* @param int $topic_id Optional. Topic id.
* @param bool $humanize Optional. Humanize output using time_since
* @param bool $gmt Optional. Use GMT
*
* @uses bbp_get_topic_post_date() to get the output
*/
function bbp_topic_post_date( $topic_id = 0, $humanize = false, $gmt = false ) {
echo bbp_get_topic_post_date( $topic_id, $humanize, $gmt );
}
/**
* Return the post date and time of a topic
*
* @since bbPress (r4155)
*
* @param int $topic_id Optional. Topic id.
* @param bool $humanize Optional. Humanize output using time_since
* @param bool $gmt Optional. Use GMT
*
* @return string
* @uses get_post_time() to get the topic post time
* @uses bbp_get_time_since() to maybe humanize the topic post time
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_post_date( $topic_id = 0, $humanize = false, $gmt = false ) {
$topic_id = bbp_get_topic_id( $topic_id );
// 4 days, 4 hours ago
if ( ! empty( $humanize ) ) {
$gmt_s = ! empty( $gmt ) ? 'U' : 'G';
$date = get_post_time( $gmt_s, $gmt, $topic_id );
$time = false; // For filter below
$result = bbp_get_time_since( $date );
// August 4, 2012 at 2:37 pm
} else {
$date = get_post_time( get_option( 'date_format' ), $gmt, $topic_id, true );
$time = get_post_time( get_option( 'time_format' ), $gmt, $topic_id, true );
$result = sprintf( _x( '%1$s at %2$s', 'date at time', 'buddyboss' ), $date, $time );
}
return apply_filters( 'bbp_get_topic_post_date', $result, $topic_id, $humanize, $gmt, $date, $time );
}
/**
* Output pagination links of a topic within the topic loop
*
* @since bbPress (r2966)
*
* @param mixed $args See {@link bbp_get_topic_pagination()}
*
* @uses bbp_get_topic_pagination() To get the topic pagination links
*/
function bbp_topic_pagination( $args = '' ) {
echo bbp_get_topic_pagination( $args );
}
/**
* Returns pagination links of a topic within the topic loop
*
* @since bbPress (r2966)
*
* @param mixed $args This function supports these arguments:
* - topic_id: Topic id
* - before: Before the links
* - after: After the links
*
* @return string Pagination links
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_use_pretty_urls() To check if the blog is using permalinks
* @uses user_trailingslashit() To add a trailing slash
* @uses trailingslashit() To add a trailing slash
* @uses get_permalink() To get the permalink of the topic
* @uses add_query_arg() To add query args
* @uses bbp_get_topic_reply_count() To get topic reply count
* @uses bbp_show_topic_lead() Are we showing the topic as a lead?
* @uses get_option() To get replies per page option
* @uses paginate_links() To paginate the links
* @uses apply_filters() Calls 'bbp_get_topic_pagination' with the links and arguments
*/
function bbp_get_topic_pagination( $args = '' ) {
// Bail if threading replies
if ( bbp_thread_replies() ) {
return;
}
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'topic_id' => bbp_get_topic_id(),
'before' => '<span class="bbp-topic-pagination">',
'after' => '</span>',
),
'get_topic_pagination'
);
// If pretty permalinks are enabled, make our pagination pretty
if ( bbp_use_pretty_urls() ) {
$base = trailingslashit( get_permalink( $r['topic_id'] ) ) . user_trailingslashit( bbp_get_paged_slug() . '/%#%/' );
} else {
$base = add_query_arg( 'paged', '%#%', get_permalink( $r['topic_id'] ) );
}
// Get total and add 1 if topic is included in the reply loop
$total = bbp_get_topic_reply_count( $r['topic_id'], true );
// Bump if topic is in loop
if ( ! bbp_show_lead_topic() ) {
$total ++;
}
// Pagination settings
$pagination = array(
'base' => $base,
'format' => '',
'total' => ceil( (int) $total / (int) bbp_get_replies_per_page() ),
'current' => 0,
'prev_next' => false,
'mid_size' => 2,
'end_size' => 3,
'add_args' => ( bbp_get_view_all() ) ? array( 'view' => 'all' ) : false,
);
// Add pagination to query object
$pagination_links = paginate_links( $pagination );
if ( ! empty( $pagination_links ) ) {
// Remove first page from pagination
if ( bbp_use_pretty_urls() ) {
$pagination_links = str_replace( bbp_get_paged_slug() . '/1/', '', $pagination_links );
} else {
$pagination_links = str_replace( '&paged=1', '', $pagination_links );
}
// Add before and after to pagination links
$pagination_links = $r['before'] . $pagination_links . $r['after'];
}
return apply_filters( 'bbp_get_topic_pagination', $pagination_links, $args );
}
/**
* Append revisions to the topic content
*
* @since bbPress (r2782)
*
* @param string $content Optional. Content to which we need to append the revisions to
* @param int $topic_id Optional. Topic id
*
* @return string Content with the revisions appended
* @uses apply_filters() Calls 'bbp_topic_append_revisions' with the processed
* content, original content and topic id
* @uses bbp_get_topic_revision_log() To get the topic revision log
*/
function bbp_topic_content_append_revisions( $content = '', $topic_id = 0 ) {
// Bail if in admin or feed
if ( is_admin() || is_feed() ) {
return;
}
// Validate the ID
$topic_id = bbp_get_topic_id( $topic_id );
return apply_filters( 'bbp_topic_append_revisions', $content . bbp_get_topic_revision_log( $topic_id ), $content, $topic_id );
}
/**
* Output the revision log of the topic
*
* @since bbPress (r2782)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_revision_log() To get the topic revision log
*/
function bbp_topic_revision_log( $topic_id = 0 ) {
echo bbp_get_topic_revision_log( $topic_id );
}
/**
* Return the formatted revision log of the topic
*
* @since bbPress (r2782)
*
* @param int $topic_id Optional. Topic id
*
* @return string Revision log of the topic
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic_revisions() To get the topic revisions
* @uses bbp_get_topic_raw_revision_log() To get the raw revision log
* @uses bbp_get_topic_author_display_name() To get the topic author
* @uses bbp_get_author_link() To get the topic author link
* @uses bbp_convert_date() To convert the date
* @uses bbp_get_time_since() To get the time in since format
* @uses apply_filters() Calls 'bbp_get_topic_revision_log' with the
* log and topic id
*/
function bbp_get_topic_revision_log( $topic_id = 0 ) {
// Create necessary variables
$topic_id = bbp_get_topic_id( $topic_id );
$revision_log = bbp_get_topic_raw_revision_log( $topic_id );
if ( empty( $topic_id ) || empty( $revision_log ) || ! is_array( $revision_log ) ) {
return false;
}
$revisions = bbp_get_topic_revisions( $topic_id );
if ( empty( $revisions ) ) {
return false;
}
$r = "\n\n" . '<ul id="bbp-topic-revision-log-' . esc_attr( $topic_id ) . '" class="bbp-topic-revision-log">' . "\n\n";
// Loop through revisions
foreach ( (array) $revisions as $revision ) {
if ( empty( $revision_log[ $revision->ID ] ) ) {
$author_id = $revision->post_author;
$reason = '';
} else {
$author_id = $revision_log[ $revision->ID ]['author'];
$reason = $revision_log[ $revision->ID ]['reason'];
}
$author = bbp_get_author_link(
array(
'size' => 14,
'link_text' => bbp_get_topic_author_display_name( $revision->ID ),
'post_id' => $revision->ID,
)
);
$since = bbp_get_time_since( bbp_convert_date( $revision->post_modified ) );
$r .= "\t" . '<li id="bbp-topic-revision-log-' . esc_attr( $topic_id ) . '-item-' . esc_attr( $revision->ID ) . '" class="bbp-topic-revision-log-item">' . "\n";
if ( ! empty( $reason ) ) {
$r .= "\t\t" . sprintf( __( 'This discussion was modified %1$s by %2$s. Reason: %3$s', 'buddyboss' ), esc_html( $since ), $author, esc_html( $reason ) ) . "\n";
} else {
$r .= "\t\t" . sprintf( __( 'This discussion was modified %1$s by %2$s.', 'buddyboss' ), esc_html( $since ), $author ) . "\n";
}
$r .= "\t" . '</li>' . "\n";
}
$r .= "\n" . '</ul>' . "\n\n";
return apply_filters( 'bbp_get_topic_revision_log', $r, $topic_id );
}
/**
* Return the raw revision log of the topic
*
* @since bbPress (r2782)
*
* @param int $topic_id Optional. Topic id
*
* @return string Raw revision log of the topic
* @uses get_post_meta() To get the revision log meta
* @uses apply_filters() Calls 'bbp_get_topic_raw_revision_log'
* with the log and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_raw_revision_log( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$revision_log = get_post_meta( $topic_id, '_bbp_revision_log', true );
$revision_log = empty( $revision_log ) ? array() : $revision_log;
return apply_filters( 'bbp_get_topic_raw_revision_log', $revision_log, $topic_id );
}
/**
* Return the revisions of the topic
*
* @since bbPress (r2782)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic revisions
* @uses wp_get_post_revisions() To get the topic revisions
* @uses apply_filters() Calls 'bbp_get_topic_revisions'
* with the revisions and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_revisions( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$revisions = wp_get_post_revisions( $topic_id, array( 'order' => 'ASC' ) );
return apply_filters( 'bbp_get_topic_revisions', $revisions, $topic_id );
}
/**
* Return the revision count of the topic
*
* @since bbPress (r2782)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic revision count
* @uses apply_filters() Calls 'bbp_get_topic_revision_count'
* with the revision count and topic id
* @uses bbp_get_topic_revisions() To get the topic revisions
*/
function bbp_get_topic_revision_count( $topic_id = 0, $integer = false ) {
$count = (int) count( bbp_get_topic_revisions( $topic_id ) );
$filter = ( true === $integer ) ? 'bbp_get_topic_revision_count_int' : 'bbp_get_topic_revision_count';
return apply_filters( $filter, $count, $topic_id );
}
/**
* Output the status of the topic
*
* @since bbPress (r2667)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_status() To get the topic status
*/
function bbp_topic_status( $topic_id = 0 ) {
echo bbp_get_topic_status( $topic_id );
}
/**
* Return the status of the topic
*
* @since bbPress (r2667)
*
* @param int $topic_id Optional. Topic id
*
* @return string Status of topic
* @uses get_post_status() To get the topic status
* @uses apply_filters() Calls 'bbp_get_topic_status' with the status
* and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_status( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
return apply_filters( 'bbp_get_topic_status', get_post_status( $topic_id ), $topic_id );
}
/**
* Is the topic open to new replies?
*
* @since bbPress (r2727)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if open, false if closed.
* @uses bbp_is_topic_closed() To check if the topic is closed
* @uses bbp_get_topic_status()
*
*/
function bbp_is_topic_open( $topic_id = 0 ) {
return ! bbp_is_topic_closed( $topic_id );
}
/**
* Is the topic closed to new replies?
*
* @since bbPress (r2746)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if closed, false if not.
* @uses apply_filters() Calls 'bbp_is_topic_closed' with the topic id
*
* @uses bbp_get_topic_status() To get the topic status
*/
function bbp_is_topic_closed( $topic_id = 0 ) {
$closed = bbp_get_topic_status( $topic_id ) === bbp_get_closed_status_id();
return (bool) apply_filters( 'bbp_is_topic_closed', (bool) $closed, $topic_id );
}
/**
* Is the topic a sticky or super sticky?
*
* @since bbPress (r2754)
*
* @param int $topic_id Optional. Topic id
* @param int $check_super Optional. If set to true and if the topic is not a
* normal sticky, it is checked if it is a super
* sticky or not. Defaults to true.
*
* @return bool True if sticky or super sticky, false if not.
* @uses bbp_get_topic_forum_id() To get the topic forum id
* @uses bbp_get_stickies() To get the stickies
* @uses bbp_is_topic_super_sticky() To check if the topic is a super sticky
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_sticky( $topic_id = 0, $check_super = true ) {
$topic_id = bbp_get_topic_id( $topic_id );
$forum_id = bbp_get_topic_forum_id( $topic_id );
$stickies = bbp_get_stickies( $forum_id );
if ( in_array( $topic_id, $stickies ) || ( ! empty( $check_super ) && bbp_is_topic_super_sticky( $topic_id ) ) ) {
return true;
}
return false;
}
/**
* Is the topic a super sticky?
*
* @since bbPress (r2754)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if super sticky, false if not.
* @uses bbp_get_super_stickies() To get the super stickies
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_super_sticky( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$stickies = bbp_get_super_stickies( $topic_id );
return in_array( $topic_id, $stickies );
}
/**
* Is the topic not spam or deleted?
*
* @since bbPress (r3496)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if published, false if not.
* @uses bbp_get_topic_status() To get the topic status
* @uses apply_filters() Calls 'bbp_is_topic_published' with the topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_published( $topic_id = 0 ) {
$topic_status = bbp_get_topic_status( bbp_get_topic_id( $topic_id ) ) === bbp_get_public_status_id();
return (bool) apply_filters( 'bbp_is_topic_published', (bool) $topic_status, $topic_id );
}
/**
* Is the topic marked as spam?
*
* @since bbPress (r2727)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if spam, false if not.
* @uses bbp_get_topic_status() To get the topic status
* @uses apply_filters() Calls 'bbp_is_topic_spam' with the topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_spam( $topic_id = 0 ) {
$topic_status = bbp_get_topic_status( bbp_get_topic_id( $topic_id ) ) === bbp_get_spam_status_id();
return (bool) apply_filters( 'bbp_is_topic_spam', (bool) $topic_status, $topic_id );
}
/**
* Is the topic trashed?
*
* @since bbPress (r2888)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if trashed, false if not.
* @uses bbp_get_topic_status() To get the topic status
* @uses apply_filters() Calls 'bbp_is_topic_trash' with the topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_trash( $topic_id = 0 ) {
$topic_status = bbp_get_topic_status( bbp_get_topic_id( $topic_id ) ) === bbp_get_trash_status_id();
return (bool) apply_filters( 'bbp_is_topic_trash', (bool) $topic_status, $topic_id );
}
/**
* Is the posted by an anonymous user?
*
* @since bbPress (r2753)
*
* @param int $topic_id Optional. Topic id
*
* @return bool True if the post is by an anonymous user, false if not.
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses get_post_meta() To get the anonymous user name and email meta
* @uses apply_filters() Calls 'bbp_is_topic_anonymous' with the topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_is_topic_anonymous( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$retval = false;
if ( ! bbp_get_topic_author_id( $topic_id ) ) {
$retval = true;
} elseif ( get_post_meta( $topic_id, '_bbp_anonymous_name', true ) ) {
$retval = true;
} elseif ( get_post_meta( $topic_id, '_bbp_anonymous_email', true ) ) {
$retval = true;
}
// The topic is by an anonymous user
return (bool) apply_filters( 'bbp_is_topic_anonymous', $retval, $topic_id );
}
/**
* Deprecated. Use bbp_topic_author_display_name() instead.
*
* Output the author of the topic.
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @deprecated bbPress (r5119)
*
* @uses bbp_get_topic_author() To get the topic author
*/
function bbp_topic_author( $topic_id = 0 ) {
echo bbp_get_topic_author( $topic_id );
}
/**
* Deprecated. Use bbp_get_topic_author_display_name() instead.
*
* Return the author of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @return string Author of topic
* @deprecated bbPress (r5119)
*
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_is_topic_anonymous() To check if the topic is by an
* anonymous user
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses get_the_author_meta() To get the display name of the author
* @uses get_post_meta() To get the name of the anonymous poster
* @uses apply_filters() Calls 'bbp_get_topic_author' with the author
* and topic id
*/
function bbp_get_topic_author( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
if ( ! bbp_is_topic_anonymous( $topic_id ) ) {
$author = get_the_author_meta( 'display_name', bbp_get_topic_author_id( $topic_id ) );
} else {
$author = get_post_meta( $topic_id, '_bbp_anonymous_name', true );
}
return apply_filters( 'bbp_get_topic_author', $author, $topic_id );
}
/**
* Output the author ID of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_author_id() To get the topic author id
*/
function bbp_topic_author_id( $topic_id = 0 ) {
echo bbp_get_topic_author_id( $topic_id );
}
/**
* Return the author ID of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @return string Author of topic
* @uses get_post_field() To get the topic author id
* @uses apply_filters() Calls 'bbp_get_topic_author_id' with the author
* id and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_author_id( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$author_id = get_post_field( 'post_author', $topic_id );
return (int) apply_filters( 'bbp_get_topic_author_id', (int) $author_id, $topic_id );
}
/**
* Output the author display_name of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_author_display_name() To get the topic author's display
* name
*/
function bbp_topic_author_display_name( $topic_id = 0 ) {
echo bbp_get_topic_author_display_name( $topic_id );
}
/**
* Return the author display_name of the topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic's author's display name
* @uses bbp_is_topic_anonymous() To check if the topic is by an
* anonymous user
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses get_the_author_meta() To get the author meta
* @uses get_post_meta() To get the anonymous user name
* @uses apply_filters() Calls 'bbp_get_topic_author_id' with the
* display name and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_author_display_name( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Check for anonymous user
if ( ! bbp_is_topic_anonymous( $topic_id ) ) {
// Get the author ID
$author_id = bbp_get_topic_author_id( $topic_id );
$author_name = ( function_exists( 'bp_core_get_user_displayname' ) ) ? bp_core_get_user_displayname( $author_id ) : '';
if ( empty( $author_name ) ) {
// Try to get a display name
$author_name = get_the_author_meta( 'display_name', $author_id );
// Fall back to user login
if ( empty( $author_name ) ) {
$author_name = get_the_author_meta( 'user_login', $author_id );
}
}
// User does not have an account
} else {
$author_name = get_post_meta( $topic_id, '_bbp_anonymous_name', true );
}
// If nothing could be found anywhere, use Anonymous
if ( empty( $author_name ) ) {
$author_name = __( 'Anonymous', 'buddyboss' );
}
// Encode possible UTF8 display names
if ( seems_utf8( $author_name ) === false ) {
$author_name = utf8_encode( $author_name );
}
return apply_filters( 'bbp_get_topic_author_display_name', $author_name, $topic_id );
}
/**
* Output the author avatar of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
* @param int $size Optional. Avatar size. Defaults to 40
*
* @uses bbp_get_topic_author_avatar() To get the topic author avatar
*/
function bbp_topic_author_avatar( $topic_id = 0, $size = 40 ) {
echo bbp_get_topic_author_avatar( $topic_id, $size );
}
/**
* Return the author avatar of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
* @param int $size Optional. Avatar size. Defaults to 40
*
* @return string Avatar of the author of the topic
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_is_topic_anonymous() To check if the topic is by an
* anonymous user
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses get_post_meta() To get the anonymous user's email
* @uses get_avatar() To get the avatar
* @uses apply_filters() Calls 'bbp_get_topic_author_avatar' with the
* avatar, topic id and size
*/
function bbp_get_topic_author_avatar( $topic_id = 0, $size = 40 ) {
$author_avatar = '';
$topic_id = bbp_get_topic_id( $topic_id );
if ( ! empty( $topic_id ) ) {
if ( ! bbp_is_topic_anonymous( $topic_id ) ) {
$author_avatar = get_avatar( bbp_get_topic_author_id( $topic_id ), $size );
} else {
$author_avatar = get_avatar( get_post_meta( $topic_id, '_bbp_anonymous_email', true ), $size );
}
}
return apply_filters( 'bbp_get_topic_author_avatar', $author_avatar, $topic_id, $size );
}
/**
* Output the author link of the topic
*
* @since bbPress (r2717)
*
* @param mixed|int $args If it is an integer, it is used as topic_id. Optional.
*
* @uses bbp_get_topic_author_link() To get the topic author link
*/
function bbp_topic_author_link( $args = '' ) {
echo bbp_get_topic_author_link( $args );
}
/**
* Return the author link of the topic
*
* @since bbPress (r2717)
*
* @param mixed|int $args If it is an integer, it is used as topic id.
* Optional.
*
* @return string Author link of topic
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic_author_display_name() To get the topic author
* @uses bbp_is_topic_anonymous() To check if the topic is by an
* anonymous user
* @uses bbp_get_topic_author_url() To get the topic author url
* @uses bbp_get_topic_author_avatar() To get the topic author avatar
* @uses bbp_get_topic_author_display_name() To get the topic author display
* name
* @uses bbp_get_user_display_role() To get the topic author display role
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses apply_filters() Calls 'bbp_get_topic_author_link' with the link
* and args
*/
function bbp_get_topic_author_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'post_id' => 0,
'link_title' => '',
'type' => 'both',
'size' => 80,
'sep' => ' ',
'show_role' => false,
),
'get_topic_author_link'
);
// Default return value
$author_link = '';
// Used as topic_id
if ( is_numeric( $args ) ) {
$topic_id = bbp_get_topic_id( $args );
} else {
$topic_id = bbp_get_topic_id( $r['post_id'] );
}
// Topic ID is good
if ( ! empty( $topic_id ) ) {
// Get some useful topic information
$author_url = bbp_get_topic_author_url( $topic_id );
$anonymous = bbp_is_topic_anonymous( $topic_id );
// Tweak link title if empty
if ( empty( $r['link_title'] ) ) {
$link_title = sprintf( empty( $anonymous ) ? __( 'View %s\'s profile', 'buddyboss' ) : __( 'Visit %s\'s website', 'buddyboss' ), bbp_get_topic_author_display_name( $topic_id ) );
// Use what was passed if not
} else {
$link_title = $r['link_title'];
}
// Setup title and author_links array
$link_title = ! empty( $link_title ) ? ' title="' . esc_attr( $link_title ) . '"' : '';
$author_links = array();
// Get avatar
if ( 'avatar' === $r['type'] || 'both' === $r['type'] ) {
if ( bp_is_active( 'moderation' ) ) {
add_filter( 'bb_get_blocked_avatar_url', 'bb_moderation_fetch_avatar_url_filter', 10, 3 );
}
$author_links['avatar'] = bbp_get_topic_author_avatar( $topic_id, $r['size'] );
if ( bp_is_active( 'moderation' ) ) {
remove_filter( 'bb_get_blocked_avatar_url', 'bb_moderation_fetch_avatar_url_filter', 10, 3 );
}
}
// Get display name
if ( 'name' === $r['type'] || 'both' === $r['type'] ) {
$author_links['name'] = bbp_get_topic_author_display_name( $topic_id );
}
// Empty array
$links = array();
$sprint = '<span %1$s>%2$s</span>';
// Wrap each link
foreach ( $author_links as $link => $link_text ) {
$link_class = ' class="bbp-author-' . esc_attr( $link ) . '"';
$links[] = sprintf( $sprint, $link_class, $link_text );
}
// Juggle
$author_links = $links;
unset( $links );
// Filter sections if avatar size is 1 or type is name else assign the author links array itself. Added condition not to show verified badges on avatar.
if ( 1 == $r['size'] || 'name' === $r['type'] ) {
$sections = apply_filters( 'bbp_get_topic_author_links', $author_links, $r, $args );
} else {
$sections = $author_links;
}
// Assemble sections into author link
$author_link = implode( $r['sep'], $sections );
// Only wrap in link if profile exists
if ( empty( $anonymous ) && bbp_user_has_profile( bbp_get_topic_author_id( $topic_id ) ) ) {
$author_link = sprintf( '<a href="%1$s"%2$s%3$s%5$s>%4$s</a>', esc_url( $author_url ), $link_title, ' class="bbp-author-link"', $author_link, ' data-bb-hp-profile="' . bbp_get_topic_author_id( $topic_id ) . '"' );
}
// Role is not linked
if ( true === $r['show_role'] ) {
$author_link .= bbp_get_topic_author_role( array( 'topic_id' => $topic_id ) );
}
}
// Filter & return
return apply_filters( 'bbp_get_topic_author_link', $author_link, $args );
}
/**
* Output the author url of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_author_url() To get the topic author url
*/
function bbp_topic_author_url( $topic_id = 0 ) {
echo esc_url( bbp_get_topic_author_url( $topic_id ) );
}
/**
* Return the author url of the topic
*
* @since bbPress (r2590)
*
* @param int $topic_id Optional. Topic id
*
* @return string Author URL of topic
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_is_topic_anonymous() To check if the topic is by an anonymous
* user or not
* @uses bbp_user_has_profile() To check if the user has a profile
* @uses bbp_get_topic_author_id() To get topic author id
* @uses bbp_get_user_profile_url() To get profile url
* @uses get_post_meta() To get anonmous user's website
* @uses apply_filters() Calls 'bbp_get_topic_author_url' with the link &
* topic id
*/
function bbp_get_topic_author_url( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Check for anonymous user or non-existant user
if ( ! bbp_is_topic_anonymous( $topic_id ) && bbp_user_has_profile( bbp_get_topic_author_id( $topic_id ) ) ) {
$author_url = bbp_get_user_profile_url( bbp_get_topic_author_id( $topic_id ) );
} else {
$author_url = get_post_meta( $topic_id, '_bbp_anonymous_website', true );
// Set empty author_url as empty string
if ( empty( $author_url ) ) {
$author_url = '';
}
}
return apply_filters( 'bbp_get_topic_author_url', $author_url, $topic_id );
}
/**
* Output the topic author email address
*
* @since bbPress (r3445)
*
* @param int $topic_id Optional. Reply id
*
* @uses bbp_get_topic_author_email() To get the topic author email
*/
function bbp_topic_author_email( $topic_id = 0 ) {
echo bbp_get_topic_author_email( $topic_id );
}
/**
* Return the topic author email address
*
* @since bbPress (r3445)
*
* @param int $topic_id Optional. Reply id
*
* @return string Topic author email address
* @uses bbp_is_topic_anonymous() To check if the topic is by an anonymous
* user
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses get_userdata() To get the user data
* @uses get_post_meta() To get the anonymous poster's email
* @uses apply_filters() Calls bbp_get_topic_author_email with the author
* email & topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_author_email( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Not anonymous user
if ( ! bbp_is_topic_anonymous( $topic_id ) ) {
// Use topic author email address
$user_id = bbp_get_topic_author_id( $topic_id );
$user = get_userdata( $user_id );
$author_email = ! empty( $user->user_email ) ? $user->user_email : '';
// Anonymous
} else {
// Get email from post meta
$author_email = get_post_meta( $topic_id, '_bbp_anonymous_email', true );
// Sanity check for missing email address
if ( empty( $author_email ) ) {
$author_email = '';
}
}
return apply_filters( 'bbp_get_topic_author_email', $author_email, $topic_id );
}
/**
* Output the topic author role
*
* @since bbPress (r3860)
*
* @param array $args Optional.
*
* @uses bbp_get_topic_author_role() To get the topic author role
*/
function bbp_topic_author_role( $args = array() ) {
echo bbp_get_topic_author_role( $args );
}
/**
* Return the topic author role
*
* @since bbPress (r3860)
*
* @param array $args Optional.
*
* @return string topic author role
* @uses bbp_get_user_display_role() To get the user display role
* @uses bbp_get_topic_author_id() To get the topic author id
* @uses apply_filters() Calls bbp_get_topic_author_role with the author
* role & args
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_author_role( $args = array() ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'topic_id' => 0,
'class' => 'bbp-author-role',
'before' => '',
'after' => '',
),
'get_topic_author_role'
);
$topic_id = bbp_get_topic_id( $r['topic_id'] );
$role = bbp_get_user_display_role( bbp_get_topic_author_id( $topic_id ) );
$author_role = sprintf( '%1$s<div class="%2$s">%3$s</div>%4$s', $r['before'], $r['class'], $role, $r['after'] );
return apply_filters( 'bbp_get_topic_author_role', $author_role, $r );
}
/**
* Output the title of the forum a topic belongs to
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_forum_title() To get the topic's forum title
*/
function bbp_topic_forum_title( $topic_id = 0 ) {
echo bbp_get_topic_forum_title( $topic_id );
}
/**
* Return the title of the forum a topic belongs to
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic forum title
* @uses bbp_get_topic_forum_id() To get topic's forum id
* @uses apply_filters() Calls 'bbp_get_topic_forum' with the forum
* title and topic id
* @uses bbp_get_topic_id() To get topic id
*/
function bbp_get_topic_forum_title( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$forum_id = bbp_get_topic_forum_id( $topic_id );
return apply_filters( 'bbp_get_topic_forum', bbp_get_forum_title( $forum_id ), $topic_id, $forum_id );
}
/**
* Output the forum id a topic belongs to
*
* @since bbPress (r2491)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_forum_id()
*/
function bbp_topic_forum_id( $topic_id = 0 ) {
echo bbp_get_topic_forum_id( $topic_id );
}
/**
* Return the forum id a topic belongs to
*
* @since bbPress (r2491)
*
* @param int $topic_id Optional. Topic id
*
* @return int Topic forum id
* @uses get_post_meta() To retrieve get topic's forum id meta
* @uses apply_filters() Calls 'bbp_get_topic_forum_id' with the forum
* id and topic id
* @uses bbp_get_topic_id() To get topic id
*/
function bbp_get_topic_forum_id( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$forum_id = get_post_meta( $topic_id, '_bbp_forum_id', true );
return (int) apply_filters( 'bbp_get_topic_forum_id', (int) $forum_id, $topic_id );
}
/**
* Output the topics last active ID
*
* @since bbPress (r2860)
*
* @param int $topic_id Optional. Forum id
*
* @uses bbp_get_topic_last_active_id() To get the topic's last active id
*/
function bbp_topic_last_active_id( $topic_id = 0 ) {
echo bbp_get_topic_last_active_id( $topic_id );
}
/**
* Return the topics last active ID
*
* @since bbPress (r2860)
*
* @param int $topic_id Optional. Forum id
*
* @return int Forum's last active id
* @uses get_post_meta() To get the topic's last active id
* @uses apply_filters() Calls 'bbp_get_topic_last_active_id' with
* the last active id and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_last_active_id( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$active_id = get_post_meta( $topic_id, '_bbp_last_active_id', true );
return (int) apply_filters( 'bbp_get_topic_last_active_id', (int) $active_id, $topic_id );
}
/**
* Output the topics last update date/time (aka freshness)
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_last_active_time() To get topic freshness
*/
function bbp_topic_last_active_time( $topic_id = 0 ) {
echo bbp_get_topic_last_active_time( $topic_id );
}
/**
* Return the topics last update date/time (aka freshness)
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic freshness
* @uses bbp_get_topic_id() To get topic id
* @uses get_post_meta() To get the topic lst active meta
* @uses bbp_get_topic_last_reply_id() To get topic last reply id
* @uses get_post_field() To get the post date of topic/reply
* @uses bbp_convert_date() To convert date
* @uses bbp_get_time_since() To get time in since format
* @uses apply_filters() Calls 'bbp_get_topic_last_active' with topic
* freshness and topic id
*/
function bbp_get_topic_last_active_time( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
// Try to get the most accurate freshness time possible
$last_active = get_post_meta( $topic_id, '_bbp_last_active_time', true );
if ( empty( $last_active ) ) {
$reply_id = bbp_get_topic_last_reply_id( $topic_id );
if ( ! empty( $reply_id ) ) {
$last_active = get_post_field( 'post_date', $reply_id );
} else {
$last_active = get_post_field( 'post_date', $topic_id );
}
}
$last_active = ! empty( $last_active ) ? bbp_get_time_since( bbp_convert_date( $last_active ) ) : '';
// Return the time since
return apply_filters( 'bbp_get_topic_last_active', $last_active, $topic_id );
}
/** Topic Subscriptions *******************************************************/
/**
* Output the topic subscription link
*
* @since bbPress (r5156)
*
* @uses bbp_get_topic_subscription_link()
*/
function bbp_topic_subscription_link( $args = array() ) {
echo bbp_get_topic_subscription_link( $args );
}
/**
* Get the forum subscription link
*
* A custom wrapper for bbp_get_user_subscribe_link()
*
* @since bbPress (r5156)
*
* @uses bbp_parse_args()
* @uses bbp_get_user_subscribe_link()
* @uses apply_filters() Calls 'bbp_get_topic_subscribe_link'
*/
function bbp_get_topic_subscription_link( $args = array() ) {
// No link
$retval = false;
// Parse the arguments
$r = bbp_parse_args(
$args,
array(
'user_id' => 0,
'topic_id' => 0,
'before' => ' | ',
'after' => '',
'subscribe' => __( 'Subscribe', 'buddyboss' ),
'unsubscribe' => __( 'Unsubscribe', 'buddyboss' ),
),
'get_forum_subscribe_link'
);
// Get the link
$retval = bbp_get_user_subscribe_link( $r );
return apply_filters( 'bbp_get_topic_subscribe_link', $retval, $r );
}
/** Topic Favorites ***********************************************************/
/**
* Output the topic favorite link
*
* @since bbPress (r5156)
*
* @uses bbp_get_topic_favorite_link()
*/
function bbp_topic_favorite_link( $args = array() ) {
echo bbp_get_topic_favorite_link( $args );
}
/**
* Get the forum favorite link
*
* A custom wrapper for bbp_get_user_favorite_link()
*
* @since bbPress (r5156)
*
* @uses bbp_parse_args()
* @uses bbp_get_user_favorites_link()
* @uses apply_filters() Calls 'bbp_get_topic_favorite_link'
*/
function bbp_get_topic_favorite_link( $args = array() ) {
// No link
$retval = false;
// Parse the arguments
$r = bbp_parse_args(
$args,
array(
'user_id' => 0,
'topic_id' => 0,
'before' => '',
'after' => '',
'favorite' => __( 'Favorite', 'buddyboss' ),
'favorited' => __( 'Unfavorite', 'buddyboss' ),
),
'get_forum_favorite_link'
);
// Get the link
$retval = bbp_get_user_favorites_link( $r );
return apply_filters( 'bbp_get_topic_favorite_link', $retval, $r );
}
/** Topic Last Reply **********************************************************/
/**
* Output the id of the topics last reply
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_last_reply_id() To get the topic last reply id
*/
function bbp_topic_last_reply_id( $topic_id = 0 ) {
echo bbp_get_topic_last_reply_id( $topic_id );
}
/**
* Return the topics last update date/time (aka freshness)
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @return int Topic last reply id
* @uses get_post_meta() To get the last reply id meta
* @uses apply_filters() Calls 'bbp_get_topic_last_reply_id' with the
* last reply id and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_last_reply_id( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$reply_id = get_post_meta( $topic_id, '_bbp_last_reply_id', true );
if ( empty( $reply_id ) ) {
$reply_id = $topic_id;
}
return (int) apply_filters( 'bbp_get_topic_last_reply_id', (int) $reply_id, $topic_id );
}
/**
* Output the title of the last reply inside a topic
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_last_reply_title() To get the topic last reply title
*/
function bbp_topic_last_reply_title( $topic_id = 0 ) {
echo bbp_get_topic_last_reply_title( $topic_id );
}
/**
* Return the title of the last reply inside a topic
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic last reply title
* @uses bbp_get_topic_last_reply_id() To get the topic last reply id
* @uses bbp_get_reply_title() To get the reply title
* @uses apply_filters() Calls 'bbp_get_topic_last_topic_title' with
* the reply title and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_last_reply_title( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
return apply_filters( 'bbp_get_topic_last_topic_title', bbp_get_reply_title( bbp_get_topic_last_reply_id( $topic_id ) ), $topic_id );
}
/**
* Output the link to the last reply in a topic
*
* @since bbPress (r2464)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_last_reply_permalink() To get the topic's last reply link
*/
function bbp_topic_last_reply_permalink( $topic_id = 0 ) {
echo esc_url( bbp_get_topic_last_reply_permalink( $topic_id ) );
}
/**
* Return the link to the last reply in a topic
*
* @since bbPress (r2464)
*
* @param int $topic_id Optional. Topic id
*
* @return string Permanent link to the reply
* @uses bbp_get_topic_last_reply_id() To get the topic last reply id
* @uses bbp_get_reply_permalink() To get the reply permalink
* @uses apply_filters() Calls 'bbp_get_topic_last_topic_permalink' with
* the reply permalink and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_last_reply_permalink( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
return apply_filters( 'bbp_get_topic_last_reply_permalink', bbp_get_reply_permalink( bbp_get_topic_last_reply_id( $topic_id ) ) );
}
/**
* Output the link to the last reply in a topic
*
* @since bbPress (r2683)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_last_reply_url() To get the topic last reply url
*/
function bbp_topic_last_reply_url( $topic_id = 0 ) {
echo esc_url( bbp_get_topic_last_reply_url( $topic_id ) );
}
/**
* Return the link to the last reply in a topic
*
* @since bbPress (r2683)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic last reply url
* @uses bbp_get_topic_last_reply_id() To get the topic last reply id
* @uses bbp_get_reply_url() To get the reply url
* @uses bbp_get_reply_permalink() To get the reply permalink
* @uses apply_filters() Calls 'bbp_get_topic_last_topic_url' with
* the reply url and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_last_reply_url( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$reply_id = bbp_get_topic_last_reply_id( $topic_id );
if ( ! empty( $reply_id ) && ( $reply_id !== $topic_id ) ) {
$reply_url = bbp_get_reply_url( $reply_id );
} else {
$reply_url = bbp_get_topic_permalink( $topic_id );
}
return apply_filters( 'bbp_get_topic_last_reply_url', $reply_url );
}
/**
* Output link to the most recent activity inside a topic, complete with link
* attributes and content.
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_freshness_link() To get the topic freshness link
*/
function bbp_topic_freshness_link( $topic_id = 0 ) {
echo bbp_get_topic_freshness_link( $topic_id );
}
/**
* Returns link to the most recent activity inside a topic, complete
* with link attributes and content.
*
* @since bbPress (r2625)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic freshness link
* @uses bbp_get_topic_last_reply_url() To get the topic last reply url
* @uses bbp_get_topic_last_reply_title() To get the reply title
* @uses bbp_get_topic_last_active_time() To get the topic freshness
* @uses apply_filters() Calls 'bbp_get_topic_freshness_link' with the
* link and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_freshness_link( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$link_url = bbp_get_topic_last_reply_url( $topic_id );
$title = bbp_get_topic_last_reply_title( $topic_id );
$time_since = bbp_get_topic_last_active_time( $topic_id );
if ( ! empty( $time_since ) ) {
$anchor = '<a href="' . esc_url( $link_url ) . '" title="' . esc_attr( $title ) . '">' . esc_html( $time_since ) . '</a>';
} else {
$anchor = __( 'No Replies', 'buddyboss' );
}
return apply_filters( 'bbp_get_topic_freshness_link', $anchor, $topic_id, $time_since, $link_url, $title );
}
/**
* Output the replies link of the topic
*
* @since bbPress (r2740)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_replies_link() To get the topic replies link
*/
function bbp_topic_replies_link( $topic_id = 0 ) {
echo bbp_get_topic_replies_link( $topic_id );
}
/**
* Return the replies link of the topic
*
* @since bbPress (r2740)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses bbp_get_topic_reply_count() To get the topic reply count
* @uses bbp_get_topic_permalink() To get the topic permalink
* @uses bbp_get_topic_reply_count_hidden() To get the topic hidden
* reply count
* @uses current_user_can() To check if the current user can edit others
* replies
* @uses apply_filters() Calls 'bbp_get_topic_replies_link' with the
* replies link and topic id
*/
function bbp_get_topic_replies_link( $topic_id = 0 ) {
$topic = bbp_get_topic( bbp_get_topic_id( (int) $topic_id ) );
$topic_id = $topic->ID;
$replies = sprintf( _n( '%s reply', '%s replies', bbp_get_topic_reply_count( $topic_id, true ), 'buddyboss' ), bbp_get_topic_reply_count( $topic_id ) );
$retval = '';
$link = bbp_get_topic_permalink( $topic_id );
// First link never has view=all
if ( bbp_get_view_all( 'edit_others_replies' ) ) {
$retval .= "<a href='" . esc_url( bbp_remove_view_all( $link ) ) . "'>" . esc_html( $replies ) . "</a>";
} else {
$retval .= $replies;
}
// Any deleted replies?
$deleted_int = bbp_get_topic_reply_count_hidden( $topic_id, true );
// This topic has hidden replies.
if ( ! empty( $deleted_int ) && current_user_can( 'edit_others_replies' ) ) {
// Hidden replies.
$deleted_num = bbp_get_topic_reply_count_hidden( $topic_id, false );
$extra = ' ' . sprintf( _n( '(+%s hidden)', '(+%s hidden)', $deleted_int, 'buddyboss' ), $deleted_num );
// Hidden link.
$retval .= ! bbp_get_view_all( 'edit_others_replies' )
? " <a href='" . esc_url( bbp_add_view_all( $link, true ) ) . "'>" . esc_html( $extra ) . "</a>"
: " {$extra}";
}
return apply_filters( 'bbp_get_topic_replies_link', $retval, $topic_id );
}
/**
* Output total reply count of a topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @uses bbp_get_topic_reply_count() To get the topic reply count
*/
function bbp_topic_reply_count( $topic_id = 0, $integer = false ) {
echo bbp_get_topic_reply_count( $topic_id, $integer );
}
/**
* Return total reply count of a topic
*
* @since bbPress (r2485)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @return int Reply count
* @uses get_post_meta() To get the topic reply count meta
* @uses apply_filters() Calls 'bbp_get_topic_reply_count' with the
* reply count and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_reply_count( $topic_id = 0, $integer = false ) {
$topic_id = bbp_get_topic_id( $topic_id );
$replies = (int) get_post_meta( $topic_id, '_bbp_reply_count', true );
$filter = ( true === $integer ) ? 'bbp_get_topic_reply_count_int' : 'bbp_get_topic_reply_count';
return apply_filters( $filter, $replies, $topic_id );
}
/**
* Output total post count of a topic
*
* @since bbPress (r2954)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @uses bbp_get_topic_post_count() To get the topic post count
*/
function bbp_topic_post_count( $topic_id = 0, $integer = false ) {
echo bbp_get_topic_post_count( $topic_id, $integer );
}
/**
* Return total post count of a topic
*
* @since bbPress (r2954)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @return int Post count
* @uses get_post_meta() To get the topic post count meta
* @uses apply_filters() Calls 'bbp_get_topic_post_count' with the
* post count and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_post_count( $topic_id = 0, $integer = false ) {
$topic_id = bbp_get_topic_id( $topic_id );
$replies = (int) get_post_meta( $topic_id, '_bbp_reply_count', true ) + 1;
$filter = ( true === $integer ) ? 'bbp_get_topic_post_count_int' : 'bbp_get_topic_post_count';
return apply_filters( $filter, $replies, $topic_id );
}
/**
* Output total hidden reply count of a topic (hidden includes trashed and
* spammed replies)
*
* @since bbPress (r2740)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @uses bbp_get_topic_reply_count_hidden() To get the topic hidden reply count
*/
function bbp_topic_reply_count_hidden( $topic_id = 0, $integer = false ) {
echo bbp_get_topic_reply_count_hidden( $topic_id, $integer );
}
/**
* Return total hidden reply count of a topic (hidden includes trashed
* and spammed replies)
*
* @since bbPress (r2740)
*
* @param int $topic_id Optional. Topic id
* @param boolean $integer Optional. Whether or not to format the result
*
* @return int Topic hidden reply count
* @uses get_post_meta() To get the hidden reply count
* @uses apply_filters() Calls 'bbp_get_topic_reply_count_hidden' with
* the hidden reply count and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_reply_count_hidden( $topic_id = 0, $integer = false ) {
$topic_id = bbp_get_topic_id( $topic_id );
$replies = (int) get_post_meta( $topic_id, '_bbp_reply_count_hidden', true );
$filter = ( true === $integer ) ? 'bbp_get_topic_reply_count_hidden_int' : 'bbp_get_topic_reply_count_hidden';
return apply_filters( $filter, $replies, $topic_id );
}
/**
* Output total voice count of a topic
*
* @since bbPress (r2567)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_voice_count() To get the topic voice count
*/
function bbp_topic_voice_count( $topic_id = 0, $integer = false ) {
echo bbp_get_topic_voice_count( $topic_id, $integer );
}
/**
* Return total voice count of a topic
*
* @since bbPress (r2567)
*
* @param int $topic_id Optional. Topic id
*
* @return int Members count of the topic
* @uses get_post_meta() To get the voice count meta
* @uses apply_filters() Calls 'bbp_get_topic_voice_count' with the
* voice count and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_voice_count( $topic_id = 0, $integer = false ) {
$topic_id = bbp_get_topic_id( $topic_id );
$voices = (int) get_post_meta( $topic_id, '_bbp_voice_count', true );
$filter = ( true === $integer ) ? 'bbp_get_topic_voice_count_int' : 'bbp_get_topic_voice_count';
return apply_filters( $filter, $voices, $topic_id );
}
/**
* Output a the tags of a topic
*
* @param int $topic_id Optional. Topic id
* @param mixed $args See {@link bbp_get_topic_tag_list()}
*
* @uses bbp_get_topic_tag_list() To get the topic tag list
*/
function bbp_topic_tag_list( $topic_id = 0, $args = '' ) {
echo bbp_get_topic_tag_list( $topic_id, $args );
}
/**
* Return the tags of a topic
*
* @param int $topic_id Optional. Topic id
* @param array $args This function supports these arguments:
* - before: Before the tag list
* - sep: Tag separator
* - after: After the tag list
*
* @return string Tag list of the topic
* @uses get_the_term_list() To get the tags list
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_tag_list( $topic_id = 0, $args = '' ) {
// Bail if topic-tags are off
if ( ! bbp_allow_topic_tags() ) {
return;
}
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'before' => '<div class="bbp-topic-tags"><p>' . esc_html__( 'Tagged:', 'buddyboss' ) . ' ',
'sep' => ', ',
'after' => '</p></div>',
),
'get_topic_tag_list'
);
$topic_id = bbp_get_topic_id( $topic_id );
// Topic is spammed, so display pre-spam terms
if ( bbp_is_topic_spam( $topic_id ) ) {
// Get pre-spam terms
$terms = get_post_meta( $topic_id, '_bbp_spam_topic_tags', true );
// If terms exist, explode them and compile the return value
if ( ! empty( $terms ) ) {
$terms = implode( $r['sep'], $terms );
$retval = $r['before'] . $terms . $r['after'];
// No terms so return emty string
} else {
$retval = '';
}
// Topic is not spam so display a clickable term list
} else {
$retval = get_the_term_list( $topic_id, bbp_get_topic_tag_tax_id(), $r['before'], $r['sep'], $r['after'] );
}
return $retval;
}
/**
* Output the row class of a topic
*
* @since bbPress (r2667)
*
* @param int $topic_id Optional. Topic id
* @param array Extra classes you can pass when calling this function
*
* @uses bbp_get_topic_class() To get the topic class
*/
function bbp_topic_class( $topic_id = 0, $classes = array() ) {
echo bbp_get_topic_class( $topic_id, $classes );
}
/**
* Return the row class of a topic
*
* @since bbPress (r2667)
*
* @param int $topic_id Optional. Topic id
* @param array Extra classes you can pass when calling this function
*
* @return string Row class of a topic
* @uses bbp_is_topic_super_sticky() To check if the topic is a super sticky
* @uses bbp_get_topic_forum_id() To get the topic forum id
* @uses get_post_class() To get the topic classes
* @uses apply_filters() Calls 'bbp_get_topic_class' with the classes
* and topic id
* @uses bbp_is_topic_sticky() To check if the topic is a sticky
*/
function bbp_get_topic_class( $topic_id = 0, $classes = array() ) {
$bbp = bbpress();
$topic_id = bbp_get_topic_id( $topic_id );
$count = isset( $bbp->topic_query->current_post ) ? $bbp->topic_query->current_post : 1;
$classes = (array) $classes;
$classes[] = ( (int) $count % 2 ) ? 'even' : 'odd';
$classes[] = bbp_is_topic_sticky( $topic_id, false ) ? 'sticky' : '';
$classes[] = bbp_is_topic_super_sticky( $topic_id ) ? 'super-sticky' : '';
$classes[] = 'bbp-parent-forum-' . bbp_get_topic_forum_id( $topic_id );
$classes[] = 'user-id-' . bbp_get_topic_author_id( $topic_id );
$classes = array_filter( $classes );
$classes = get_post_class( $classes, $topic_id );
$classes = apply_filters( 'bbp_get_topic_class', $classes, $topic_id );
$retval = 'class="' . implode( ' ', $classes ) . '"';
return $retval;
}
/** Topic Admin Links *********************************************************/
/**
* Output admin links for topic
*
* @param array $args See {@link bbp_get_topic_admin_links()}
*
* @uses bbp_get_topic_admin_links() To get the topic admin links
*/
function bbp_topic_admin_links( $args = array() ) {
echo bbp_get_topic_admin_links( $args );
}
/**
* Return admin links for topic.
*
* Move topic functionality is handled by the edit topic page.
*
* @param array $args This function supports these arguments:
* - id: Optional. Topic id
* - before: Before the links
* - after: After the links
* - sep: Links separator
* - links: Topic admin links array
*
* @return string Topic admin links
* @uses current_user_can() To check if the current user can edit/delete
* the topic
* @uses bbp_get_topic_edit_link() To get the topic edit link
* @uses bbp_get_topic_trash_link() To get the topic trash link
* @uses bbp_get_topic_close_link() To get the topic close link
* @uses bbp_get_topic_spam_link() To get the topic spam link
* @uses bbp_get_topic_stick_link() To get the topic stick link
* @uses bbp_get_topic_merge_link() To get the topic merge link
* @uses bbp_get_topic_status() To get the topic status
* @uses apply_filters() Calls 'bbp_get_topic_admin_links' with the
* topic admin links and args
*/
function bbp_get_topic_admin_links( $args = array() ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => bbp_get_topic_id(),
'before' => '<span class="bbp-admin-links">',
'after' => '</span>',
'sep' => ' | ',
'links' => array(),
),
'get_topic_admin_links'
);
if ( empty( $r['links'] ) ) {
$r['links'] = apply_filters(
'bbp_topic_admin_links',
array(
'edit' => bbp_get_topic_edit_link( $r ),
'close' => bbp_get_topic_close_link( $r ),
'stick' => bbp_get_topic_stick_link( $r ),
'merge' => bbp_get_topic_merge_link( $r ),
'trash' => bbp_get_topic_trash_link( $r ),
'spam' => bbp_get_topic_spam_link( $r ),
'reply' => bbp_get_topic_reply_link( $r ),
),
$r['id']
);
if ( bp_is_active( 'moderation' ) ) {
$r['links']['report'] = bbp_get_topic_report_link( $r );
}
}
// See if links need to be unset
$topic_status = bbp_get_topic_status( $r['id'] );
if ( in_array( $topic_status, array( bbp_get_spam_status_id(), bbp_get_trash_status_id() ) ) ) {
// Close link shouldn't be visible on trashed/spammed topics
unset( $r['links']['close'] );
// Spam link shouldn't be visible on trashed topics
if ( bbp_get_trash_status_id() === $topic_status ) {
unset( $r['links']['spam'] );
// Trash link shouldn't be visible on spam topics
} elseif ( bbp_get_spam_status_id() === $topic_status ) {
unset( $r['links']['trash'] );
}
}
// Process the admin links
$links = implode( $r['sep'], array_filter( $r['links'] ) );
$retval = $r['before'] . $links . $r['after'];
return apply_filters( 'bbp_get_topic_admin_links', $retval, $r, $args );
}
/**
* Output the edit link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args See {@link bbp_get_topic_edit_link()}
*
* @uses bbp_get_topic_edit_link() To get the topic edit link
*/
function bbp_topic_edit_link( $args = '' ) {
echo bbp_get_topic_edit_link( $args );
}
/**
* Return the edit link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - edit_text: Edit text
*
* @return string Topic edit link
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can edit the
* topic
* @uses bbp_get_topic_edit_url() To get the topic edit url
* @uses apply_filters() Calls 'bbp_get_topic_edit_link' with the link
* and args
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_edit_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'edit_text' => esc_html__( 'Edit', 'buddyboss' ),
),
'get_topic_edit_link'
);
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
// Bypass check if user has caps
if ( ! current_user_can( 'edit_others_topics' ) ) {
// User cannot edit or it is past the lock time
if ( empty( $topic ) || ! current_user_can( 'edit_topic', $topic->ID ) || bbp_past_edit_lock( $topic->post_date_gmt ) ) {
return;
}
}
// Get uri
$uri = bbp_get_topic_edit_url( $r['id'] );
// Bail if no uri
if ( empty( $uri ) ) {
return;
}
$retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-edit-link">' . $r['edit_text'] . '</a>' . $r['link_after'];
return apply_filters( 'bbp_get_topic_edit_link', $retval, $r );
}
/**
* Output URL to the topic edit page
*
* @since bbPress (r2753)
*
* @param int $topic_id Optional. Topic id
*
* @uses bbp_get_topic_edit_url() To get the topic edit url
*/
function bbp_topic_edit_url( $topic_id = 0 ) {
echo esc_url( bbp_get_topic_edit_url( $topic_id ) );
}
/**
* Return URL to the topic edit page
*
* @since bbPress (r2753)
*
* @param int $topic_id Optional. Topic id
*
* @return string Topic edit url
* @uses bbp_get_topic() To get the topic
* @uses add_query_arg() To add custom args to the url
* @uses apply_filters() Calls 'bbp_get_topic_edit_url' with the edit
* url and topic id
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_edit_url( $topic_id = 0 ) {
$bbp = bbpress();
$topic = bbp_get_topic( bbp_get_topic_id( $topic_id ) );
if ( empty( $topic ) ) {
return;
}
// Remove view=all link from edit
$topic_link = bbp_remove_view_all( bbp_get_topic_permalink( $topic_id ) );
// Pretty permalinks, previously used `bbp_use_pretty_urls()`
// https://bbpress.trac.wordpress.org/ticket/3054
if ( false === strpos( $topic_link, '?' ) ) {
$url = trailingslashit( $topic_link ) . bbp_get_edit_slug();
$url = user_trailingslashit( $url );
// Unpretty permalinks
} else {
$url = add_query_arg(
array(
bbp_get_topic_post_type() => $topic->post_name,
$bbp->edit_id => '1',
),
$topic_link
);
}
// Maybe add view=all
$url = bbp_add_view_all( $url );
return apply_filters( 'bbp_get_topic_edit_url', $url, $topic_id );
}
/**
* Output the trash link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args See {@link bbp_get_topic_trash_link()}
*
* @uses bbp_get_topic_trash_link() To get the topic trash link
*/
function bbp_topic_trash_link( $args = '' ) {
echo bbp_get_topic_trash_link( $args );
}
/**
* Return the trash link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - sep: Links separator
* - trash_text: Trash text
* - restore_text: Restore text
* - delete_text: Delete text
*
* @return string Topic trash link
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can delete the
* topic
* @uses bbp_is_topic_trash() To check if the topic is trashed
* @uses bbp_get_topic_status() To get the topic status
* @uses add_query_arg() To add custom args to the url
* @uses wp_nonce_url() To nonce the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_trash_link' with the link
* and args
*/
function bbp_get_topic_trash_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'sep' => ' | ',
'trash_text' => esc_html__( 'Trash', 'buddyboss' ),
'restore_text' => esc_html__( 'Restore', 'buddyboss' ),
'delete_text' => esc_html__( 'Delete', 'buddyboss' ),
),
'get_topic_trash_link'
);
$actions = array();
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
if ( empty( $topic ) ) {
return;
} elseif ( ! current_user_can( 'delete_topic', $topic->ID ) ) {
// Is groups component active.
if ( bp_is_active( 'groups' ) ) {
$author_id = bbp_get_topic_author_id( $topic->ID );
$forum_id = bbp_get_topic_forum_id( $topic->ID );
$args = array( 'author_id' => $author_id, 'forum_id' => $forum_id );
$allow_delete = bb_moderator_can_delete_topic_reply( $topic, $args );
if ( ! $allow_delete ) {
return;
}
} else {
return;
}
}
if ( bbp_is_topic_trash( $topic->ID ) ) {
$actions['untrash'] = '<a title="' . esc_attr__( 'Restore this item from the Trash', 'buddyboss' ) . '" href="' . esc_url(
wp_nonce_url(
add_query_arg(
array(
'action' => 'bbp_toggle_topic_trash',
'sub_action' => 'untrash',
'topic_id' => $topic->ID,
)
),
'untrash-' . $topic->post_type . '_' . $topic->ID
)
) . '" class="bbp-topic-restore-link">' . $r['restore_text'] . '</a>';
} elseif ( EMPTY_TRASH_DAYS ) {
$actions['trash'] = '<a title="' . esc_attr__( 'Move this item to the Trash', 'buddyboss' ) . '" href="' . esc_url(
wp_nonce_url(
add_query_arg(
array(
'action' => 'bbp_toggle_topic_trash',
'sub_action' => 'trash',
'topic_id' => $topic->ID,
)
),
'trash-' . $topic->post_type . '_' . $topic->ID
)
) . '" class="bbp-topic-trash-link">' . $r['trash_text'] . '</a>';
}
if ( bbp_is_topic_trash( $topic->ID ) || ! EMPTY_TRASH_DAYS ) {
$actions['delete'] = '<a title="' . esc_attr__( 'Delete this item permanently', 'buddyboss' ) . '" href="' . esc_url(
wp_nonce_url(
add_query_arg(
array(
'action' => 'bbp_toggle_topic_trash',
'sub_action' => 'delete',
'topic_id' => $topic->ID,
)
),
'delete-' . $topic->post_type . '_' . $topic->ID
)
) . '" onclick="return confirm(\'' . esc_js( __( 'Are you sure you want to delete that permanently?', 'buddyboss' ) ) . '\' );" class="bbp-topic-delete-link">' . $r['delete_text'] . '</a>';
}
// Process the admin links
$retval = $r['link_before'] . implode( $r['sep'], $actions ) . $r['link_after'];
return apply_filters( 'bbp_get_topic_trash_link', $retval, $r );
}
/**
* Output the close link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args See {@link bbp_get_topic_close_link()}
*
* @uses bbp_get_topic_close_link() To get the topic close link
*/
function bbp_topic_close_link( $args = '' ) {
echo bbp_get_topic_close_link( $args );
}
/**
* Return the close link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - close_text: Close text
* - open_text: Open text
*
* @return string Topic close link
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can edit the topic
* @uses bbp_is_topic_open() To check if the topic is open
* @uses add_query_arg() To add custom args to the url
* @uses wp_nonce_url() To nonce the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_close_link' with the link
* and args
*/
function bbp_get_topic_close_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'sep' => ' | ',
'close_text' => __( 'Close', 'buddyboss' ),
'open_text' => __( 'Open', 'buddyboss' ),
),
'get_topic_close_link'
);
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
if ( empty( $topic ) || ! current_user_can( 'moderate', $topic->ID ) ) {
return;
}
$display = bbp_is_topic_open( $topic->ID ) ? $r['close_text'] : $r['open_text'];
$uri = add_query_arg(
array(
'action' => 'bbp_toggle_topic_close',
'topic_id' => $topic->ID,
)
);
$uri = wp_nonce_url( $uri, 'close-topic_' . $topic->ID );
$retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-close-link">' . $display . '</a>' . $r['link_after'];
return apply_filters( 'bbp_get_topic_close_link', $retval, $r );
}
/**
* Output the stick link of the topic
*
* @since bbPress (r2754)
*
* @param mixed $args See {@link bbp_get_topic_stick_link()}
*
* @uses bbp_get_topic_stick_link() To get the topic stick link
*/
function bbp_topic_stick_link( $args = '' ) {
echo bbp_get_topic_stick_link( $args );
}
/**
* Return the stick link of the topic
*
* @since bbPress (r2754)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - stick_text: Stick text
* - unstick_text: Unstick text
* - super_text: Stick to front text
*
* @return string Topic stick link
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can edit the
* topic
* @uses bbp_is_topic_sticky() To check if the topic is a sticky
* @uses add_query_arg() To add custom args to the url
* @uses wp_nonce_url() To nonce the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_stick_link' with the link
* and args
*/
function bbp_get_topic_stick_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'stick_text' => esc_html__( 'Stick', 'buddyboss' ),
'unstick_text' => esc_html__( 'Unstick', 'buddyboss' ),
'super_text' => esc_html__( '(to front)', 'buddyboss' ),
),
'get_topic_stick_link'
);
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
if ( empty( $topic ) || ! current_user_can( 'moderate', $topic->ID ) ) {
return;
}
$is_sticky = bbp_is_topic_sticky( $topic->ID );
$stick_uri = add_query_arg(
array(
'action' => 'bbp_toggle_topic_stick',
'topic_id' => $topic->ID,
)
);
$stick_uri = wp_nonce_url( $stick_uri, 'stick-topic_' . $topic->ID );
$stick_display = ( true === $is_sticky ) ? $r['unstick_text'] : $r['stick_text'];
$stick_display = '<a href="' . esc_url( $stick_uri ) . '" class="bbp-topic-sticky-link">' . $stick_display . '</a>';
if ( empty( $is_sticky ) ) {
$super_uri = add_query_arg(
array(
'action' => 'bbp_toggle_topic_stick',
'topic_id' => $topic->ID,
'super' => 1,
)
);
$super_uri = wp_nonce_url( $super_uri, 'stick-topic_' . $topic->ID );
$super_display = ' <a href="' . esc_url( $super_uri ) . '" class="bbp-topic-super-sticky-link">' . $r['super_text'] . '</a>';
} else {
$super_display = '';
}
// Combine the HTML into 1 string
$retval = $r['link_before'] . $stick_display . $super_display . $r['link_after'];
return apply_filters( 'bbp_get_topic_stick_link', $retval, $r );
}
/**
* Output the merge link of the topic
*
* @since bbPress (r2756)
*
* @param mixed $args
*
* @uses bbp_get_topic_merge_link() To get the topic merge link
*/
function bbp_topic_merge_link( $args = '' ) {
echo bbp_get_topic_merge_link( $args );
}
/**
* Return the merge link of the topic
*
* @since bbPress (r2756)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - merge_text: Merge text
*
* @return string Topic merge link
* @uses bbp_get_topic() To get the topic
* @uses bbp_get_topic_edit_url() To get the topic edit url
* @uses add_query_arg() To add custom args to the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_merge_link' with the link
* and args
* @uses bbp_get_topic_id() To get the topic id
*/
function bbp_get_topic_merge_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'merge_text' => esc_html__( 'Merge', 'buddyboss' ),
),
'get_topic_merge_link'
);
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
if ( empty( $topic ) || ! current_user_can( 'moderate', $topic->ID ) ) {
return;
}
$uri = add_query_arg( array( 'action' => 'merge' ), bbp_get_topic_edit_url( $topic->ID ) );
$retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-merge-link">' . $r['merge_text'] . '</a>' . $r['link_after'];
return apply_filters( 'bbp_get_topic_merge_link', $retval, $args );
}
/**
* Output the spam link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args See {@link bbp_get_topic_spam_link()}
*
* @uses bbp_get_topic_spam_link() Topic spam link
*/
function bbp_topic_spam_link( $args = '' ) {
echo bbp_get_topic_spam_link( $args );
}
/**
* Return the spam link of the topic
*
* @since bbPress (r2727)
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - spam_text: Spam text
* - unspam_text: Unspam text
*
* @return string Topic spam link
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can edit the topic
* @uses bbp_is_topic_spam() To check if the topic is marked as spam
* @uses add_query_arg() To add custom args to the url
* @uses wp_nonce_url() To nonce the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_spam_link' with the link
* and args
*/
function bbp_get_topic_spam_link( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'sep' => ' | ',
'spam_text' => esc_html__( 'Spam', 'buddyboss' ),
'unspam_text' => esc_html__( 'Unspam', 'buddyboss' ),
),
'get_topic_spam_link'
);
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
if ( empty( $topic ) || ! current_user_can( 'moderate', $topic->ID ) ) {
return;
}
$display = bbp_is_topic_spam( $topic->ID ) ? $r['unspam_text'] : $r['spam_text'];
$uri = add_query_arg(
array(
'action' => 'bbp_toggle_topic_spam',
'topic_id' => $topic->ID,
)
);
$uri = wp_nonce_url( $uri, 'spam-topic_' . $topic->ID );
$retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-spam-link">' . $display . '</a>' . $r['link_after'];
return apply_filters( 'bbp_get_topic_spam_link', $retval, $r );
}
/**
* Return the spam link of the topic
*
* @since BuddyBoss 1.5.6
*
* @param mixed $args This function supports these args:
* - id: Optional. Topic id
* - link_before: Before the link
* - link_after: After the link
* - spam_text: Spam text
* - unspam_text: Unspam text
*
* @return string Topic spam link
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_get_topic() To get the topic
* @uses current_user_can() To check if the current user can edit the topic
* @uses bbp_is_topic_spam() To check if the topic is marked as spam
* @uses add_query_arg() To add custom args to the url
* @uses wp_nonce_url() To nonce the url
* @uses esc_url() To escape the url
* @uses apply_filters() Calls 'bbp_get_topic_spam_link' with the link
* and args
*/
function bbp_get_topic_report_link( $args = '' ) {
if ( ! bp_is_active( 'moderation' ) || ! is_user_logged_in() ) {
return false;
}
$report_btn_arr = bp_moderation_get_report_button( array(
'id' => 'topic_report',
'component' => 'moderation',
'must_be_logged_in' => true,
'button_attr' => array(
'data-bp-content-id' => ! empty( $args['id'] ) ? $args['id'] : 0,
'data-bp-content-type' => BP_Moderation_Forum_Topics::$moderation_type,
),
),
true
);
if ( empty( $report_btn_arr ) ) {
$report_btn_arr = false;
}
return apply_filters( 'bbp_get_topic_report_link', $report_btn_arr, $args );
}
/**
* Output the link to go directly to the reply form
*
* @since bbPress (r4966)
*
* @param array $args
*
* @uses bbp_get_reply_to_link() To get the reply to link
*/
function bbp_topic_reply_link( $args = array() ) {
echo bbp_get_topic_reply_link( $args );
}
/**
* Return the link to go directly to the reply form
*
* @since bbPress (r4966)
*
* @param array $args Arguments
*
* @return string Link for a reply to a topic
* @uses bbp_get_topic_id() To validate the topic id
* @uses bbp_get_topic() To get the topic
* @uses apply_filters() Calls 'bbp_get_topic_reply_link' with the formatted link,
* the arguments array, and the topic
* @uses bbp_current_user_can_access_create_reply_form() To check permissions
*/
function bbp_get_topic_reply_link( $args = array() ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'id' => 0,
'link_before' => '',
'link_after' => '',
'reply_text' => esc_html__( 'Reply', 'buddyboss' ),
),
'get_topic_reply_link'
);
// Get the reply to use it's ID and post_parent
$topic = bbp_get_topic( bbp_get_topic_id( (int) $r['id'] ) );
// Bail if no reply or user cannot reply
if ( empty( $topic ) || ! bbp_current_user_can_access_create_reply_form() ) {
return;
}
$uri = '#new-post';
// Add $uri to the array, to be passed through the filter
$r['uri'] = $uri;
$retval = $r['link_before'] . '<a href="' . esc_url( $r['uri'] ) . '" data-modal-id="bbp-reply-form" class="bbp-topic-reply-link">' . $r['reply_text'] . '</a>' . $r['link_after'];
return apply_filters( 'bbp_get_topic_reply_link', $retval, $r, $args );
}
/**
* Return the link to report reply
*
* @since BuddyBoss 1.5.6
*
* @param array $args Arguments
*
* @return string Link for a report a reply
*/
function bbp_get_reply_report_link( $args = array() ) {
if ( ! bp_is_active( 'moderation' ) || ! is_user_logged_in() ) {
return false;
}
$report_btn_arr = bp_moderation_get_report_button(
array(
'id' => 'reply_report',
'component' => 'moderation',
'must_be_logged_in' => true,
'button_attr' => array(
'data-bp-content-id' => ! empty( $args['id'] ) ? $args['id'] : 0,
'data-bp-content-type' => BP_Moderation_Forum_Replies::$moderation_type,
),
),
true
);
if ( empty( $report_btn_arr ) ) {
$report_btn_arr = false;
}
return apply_filters( 'bbp_get_reply_report_link', $report_btn_arr, $args );
}
/** Topic Pagination **********************************************************/
/**
* Output the pagination count
*
* @since bbPress (r2519)
*
* @uses bbp_get_forum_pagination_count() To get the forum pagination count
*/
function bbp_forum_pagination_count() {
echo bbp_get_forum_pagination_count();
}
/**
* Return the pagination count
*
* @since bbPress (r2519)
*
* @return string Forum Pagintion count
* @uses apply_filters() Calls 'bbp_get_forum_pagination_count' with the
* pagination count
* @uses bbp_number_format() To format the number value
*/
function bbp_get_forum_pagination_count() {
$bbp = bbpress();
if ( empty( $bbp->topic_query ) ) {
return false;
}
// Set pagination values
$start_num = intval( ( $bbp->topic_query->paged - 1 ) * $bbp->topic_query->posts_per_page ) + 1;
$from_num = bbp_number_format( $start_num );
$to_num = bbp_number_format( ( $start_num + ( $bbp->topic_query->posts_per_page - 1 ) > $bbp->topic_query->found_posts ) ? $bbp->topic_query->found_posts : $start_num + ( $bbp->topic_query->posts_per_page - 1 ) );
$total_int = (int) ! empty( $bbp->topic_query->found_posts ) ? $bbp->topic_query->found_posts : $bbp->topic_query->post_count;
$total = bbp_number_format( $total_int );
// Several topics in a forum with a single page
if ( empty( $to_num ) ) {
$retstr = sprintf( _n( 'Viewing %1$s discussion', 'Viewing %1$s discussions', $total_int, 'buddyboss' ), $total );
// Several topics in a forum with several pages
} else {
$retstr = sprintf( _n( 'Viewing %2$s of %4$s discussions', 'Viewing %2$s - %3$s of %4$s discussions', $total_int, 'buddyboss' ), $bbp->topic_query->post_count, $from_num, $to_num, $total );
}
// Filter and return
return apply_filters( 'bbp_get_forum_pagination_count', esc_html( $retstr ) );
}
/**
* Output pagination links
*
* @since bbPress (r2519)
*
* @uses bbp_get_forum_pagination_links() To get the pagination links
*/
function bbp_forum_pagination_links() {
echo bbp_get_forum_pagination_links();
}
/**
* Return pagination links
*
* @since bbPress (r2519)
*
* @return string Pagination links
* @uses bbPress::topic_query::pagination_links To get the links
*/
function bbp_get_forum_pagination_links() {
$bbp = bbpress();
if ( empty( $bbp->topic_query ) ) {
return false;
}
return apply_filters( 'bbp_get_forum_pagination_links', $bbp->topic_query->pagination_links );
}
/**
* Displays topic notices
*
* @since bbPress (r2744)
*
* @uses bbp_is_single_topic() To check if it's a topic page
* @uses bbp_get_topic_status() To get the topic status
* @uses bbp_get_topic_id() To get the topic id
* @uses apply_filters() Calls 'bbp_topic_notices' with the notice text, topic
* status and topic id
* @uses bbp_add_error() To add an error message
*/
function bbp_topic_notices() {
// Bail if not viewing a topic
if ( ! bbp_is_single_topic() ) {
return;
}
// Get the topic_status
$topic_status = bbp_get_topic_status();
// Get the topic status
switch ( $topic_status ) {
// Spam notice
case bbp_get_spam_status_id():
$notice_text = __( 'This topic is marked as spam.', 'buddyboss' );
break;
// Trashed notice
case bbp_get_trash_status_id():
$notice_text = __( 'This topic is in the trash.', 'buddyboss' );
break;
// Standard status
default:
$notice_text = '';
break;
}
// Filter notice text and bail if empty
$notice_text = apply_filters( 'bbp_topic_notices', $notice_text, $topic_status, bbp_get_topic_id() );
if ( empty( $notice_text ) ) {
return;
}
bbp_add_error( 'topic_notice', $notice_text, 'message' );
}
/**
* Displays topic type select box (normal/sticky/super sticky)
*
* @since bbPress (r5059)
*
* @param $args This function supports these arguments:
* - select_id: Select id. Defaults to bbp_stick_topic
* - tab: Tabindex
* - topic_id: Topic id
* - selected: Override the selected option
*
* @deprecated since Forums (r5059)
*
*/
function bbp_topic_type_select( $args = '' ) {
echo bbp_get_form_topic_type_dropdown( $args );
}
/**
* Displays topic type select box (normal/sticky/super sticky)
*
* @since bbPress (r5059)
*
* @param $args This function supports these arguments:
* - select_id: Select id. Defaults to bbp_stick_topic
* - tab: Tabindex
* - topic_id: Topic id
* - selected: Override the selected option
*/
function bbp_form_topic_type_dropdown( $args = '' ) {
echo bbp_get_form_topic_type_dropdown( $args );
}
/**
* Returns topic type select box (normal/sticky/super sticky)
*
* @since bbPress (r5059)
*
* @param $args This function supports these arguments:
* - select_id: Select id. Defaults to bbp_stick_topic
* - tab: Tabindex
* - topic_id: Topic id
* - selected: Override the selected option
*
* @uses bbp_get_topic_id() To get the topic id
* @uses bbp_is_single_topic() To check if we're viewing a single topic
* @uses bbp_is_topic_edit() To check if it is the topic edit page
* @uses bbp_is_topic_super_sticky() To check if the topic is a super sticky
* @uses bbp_is_topic_sticky() To check if the topic is a sticky
*/
function bbp_get_form_topic_type_dropdown( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'select_id' => 'bbp_stick_topic',
'tab' => bbp_get_tab_index(),
'topic_id' => 0,
'selected' => false,
),
'topic_type_select'
);
// No specific selected value passed
if ( empty( $r['selected'] ) ) {
// Post value is passed
if ( bbp_is_post_request() && isset( $_POST[ $r['select_id'] ] ) ) {
$r['selected'] = $_POST[ $r['select_id'] ];
// No Post value passed
} else {
// Edit topic
if ( bbp_is_single_topic() || bbp_is_topic_edit() ) {
// Get current topic id
$topic_id = bbp_get_topic_id( $r['topic_id'] );
// Topic is super sticky
if ( bbp_is_topic_super_sticky( $topic_id ) ) {
$r['selected'] = 'super';
// Topic is sticky or normal
} else {
$r['selected'] = bbp_is_topic_sticky( $topic_id, false ) ? 'stick' : 'unstick';
}
}
}
}
// Used variables
$tab = ! empty( $r['tab'] ) ? ' tabindex="' . esc_attr( (int) $r['tab'] ) . '"' : '';
// Start an output buffer, we'll finish it after the select loop
ob_start();
// Get topic sticky types.
$topic_sticky_types = bbp_get_topic_types();
// Get current topic id
$topic_id = bbp_get_topic_id( $r['topic_id'] );
if ( ! empty( $topic_id ) && bb_is_group_forum_topic( $topic_id ) ) {
unset( $topic_sticky_types['super'] );
}
?>
<select name="<?php echo esc_attr( $r['select_id'] ); ?>" id="<?php echo esc_attr( $r['select_id'] ); ?>_select"<?php echo $tab; ?>>
<?php foreach ( $topic_sticky_types as $key => $label ) : ?>
<option value="<?php echo esc_attr( $key ); ?>"<?php selected( $key, $r['selected'] ); ?>>
<span><?php _e( 'Type: ', 'buddyboss' ); ?></span>
<?php echo esc_html( $label ); ?>
</option>
<?php endforeach; ?>
</select>
<?php
// Return the results
return apply_filters( 'bbp_get_form_topic_type_dropdown', ob_get_clean(), $r );
}
/**
* Output value topic status dropdown
*
* @since bbPress (r5059)
*
* @param int $topic_id The topic id to use
*/
function bbp_form_topic_status_dropdown( $args = '' ) {
echo bbp_get_form_topic_status_dropdown( $args );
}
/**
* Returns topic status downdown
*
* This dropdown is only intended to be seen by users with the 'moderate'
* capability. Because of this, no additional capablitiy checks are performed
* within this function to check available topic statuses.
*
* @since bbPress (r5059)
*
* @param $args This function supports these arguments:
* - select_id: Select id. Defaults to bbp_open_close_topic
* - tab: Tabindex
* - topic_id: Topic id
* - selected: Override the selected option
*/
function bbp_get_form_topic_status_dropdown( $args = '' ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'select_id' => 'bbp_topic_status',
'tab' => bbp_get_tab_index(),
'topic_id' => 0,
'selected' => false,
),
'topic_open_close_select'
);
// No specific selected value passed
if ( empty( $r['selected'] ) ) {
// Post value is passed
if ( bbp_is_post_request() && isset( $_POST[ $r['select_id'] ] ) ) {
$r['selected'] = $_POST[ $r['select_id'] ];
// No Post value was passed
} else {
// Edit topic
if ( bbp_is_topic_edit() ) {
$r['topic_id'] = bbp_get_topic_id( $r['topic_id'] );
$r['selected'] = bbp_get_topic_status( $r['topic_id'] );
// New topic
} else {
$r['selected'] = bbp_get_public_status_id();
}
}
}
// Used variables
$tab = ! empty( $r['tab'] ) ? ' tabindex="' . (int) $r['tab'] . '"' : '';
// Start an output buffer, we'll finish it after the select loop
ob_start();
?>
<select name="<?php echo esc_attr( $r['select_id'] ); ?>"
id="<?php echo esc_attr( $r['select_id'] ); ?>_select"<?php echo $tab; ?>>
<?php foreach ( bbp_get_topic_statuses( $r['topic_id'] ) as $key => $label ) : ?>
<option value="<?php echo esc_attr( $key ); ?>"<?php selected( $key, $r['selected'] ); ?>><?php echo esc_html( $label ); ?></option>
<?php endforeach; ?>
</select>
<?php
// Return the results
return apply_filters( 'bbp_get_form_topic_status_dropdown', ob_get_clean(), $r );
}
/** Topic Tags ****************************************************************/
/**
* Output the unique id of the topic tag taxonomy
*
* @since bbPress (r3348)
*
* @uses bbp_get_topic_post_type() To get the topic post type
*/
function bbp_topic_tag_tax_id() {
echo bbp_get_topic_tag_tax_id();
}
/**
* Return the unique id of the topic tag taxonomy
*
* @since bbPress (r3348)
*
* @return string The unique topic tag taxonomy
* @uses apply_filters() Calls 'bbp_get_topic_tag_tax_id' with the topic tax id
*/
function bbp_get_topic_tag_tax_id() {
return apply_filters( 'bbp_get_topic_tag_tax_id', bbpress()->topic_tag_tax_id );
}
/**
* Return array of labels used by the topic-tag taxonomy
*
* @since bbPress (r5129)
*
* @return array
*/
function bbp_get_topic_tag_tax_labels() {
return apply_filters(
'bbp_get_topic_tag_tax_labels',
array(
'name' => __( 'Discussion Tags', 'buddyboss' ),
'singular_name' => __( 'Discussion Tag', 'buddyboss' ),
'search_items' => __( 'Search Tags', 'buddyboss' ),
'popular_items' => __( 'Popular Tags', 'buddyboss' ),
'all_items' => __( 'All Tags', 'buddyboss' ),
'edit_item' => __( 'Edit Tag', 'buddyboss' ),
'update_item' => __( 'Update Tag', 'buddyboss' ),
'add_new_item' => __( 'Add New Tag', 'buddyboss' ),
'new_item_name' => __( 'New Tag Name', 'buddyboss' ),
'view_item' => __( 'View Discussion Tag', 'buddyboss' ),
)
);
}
/**
* Return an array of topic-tag taxonomy rewrite settings
*
* @since bbPress (r5129)
*
* @return array
*/
function bbp_get_topic_tag_tax_rewrite() {
return apply_filters(
'bbp_get_topic_tag_tax_rewrite',
array(
'slug' => bbp_get_topic_tag_tax_slug(),
'with_front' => false,
)
);
}
/**
* Output the id of the current tag
*
* @since bbPress (r3109)
*
* @uses bbp_get_topic_tag_id()
*/
function bbp_topic_tag_id( $tag = '' ) {
echo bbp_get_topic_tag_id( $tag );
}
/**
* Return the id of the current tag
*
* @since bbPress (r3109)
*
* @return string Term Name
* @uses get_queried_object()
* @uses get_query_var()
* @uses apply_filters()
*
* @uses get_term_by()
*/
function bbp_get_topic_tag_id( $tag = '' ) {
// Get the term
if ( ! empty( $tag ) ) {
$term = get_term_by( 'slug', $tag, bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->term_id ) ) {
$retval = $term->term_id;
// No id
} else {
$retval = '';
}
return (int) apply_filters( 'bbp_get_topic_tag_id', (int) $retval, $tag );
}
/**
* Output the name of the current tag
*
* @since bbPress (r3109)
*
* @uses bbp_get_topic_tag_name()
*/
function bbp_topic_tag_name( $tag = '' ) {
echo bbp_get_topic_tag_name( $tag );
}
/**
* Return the name of the current tag
*
* @since bbPress (r3109)
*
* @return string Term Name
* @uses get_queried_object()
* @uses get_query_var()
* @uses apply_filters()
*
* @uses get_term_by()
*/
function bbp_get_topic_tag_name( $tag = '' ) {
// Get the term
if ( ! empty( $tag ) ) {
$term = get_term_by( 'slug', $tag, bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->name ) ) {
$retval = $term->name;
// No name
} else {
$retval = '';
}
return apply_filters( 'bbp_get_topic_tag_name', $retval );
}
/**
* Output the slug of the current tag
*
* @since bbPress (r3109)
*
* @uses bbp_get_topic_tag_slug()
*/
function bbp_topic_tag_slug( $tag = '' ) {
echo bbp_get_topic_tag_slug( $tag );
}
/**
* Return the slug of the current tag
*
* @since bbPress (r3109)
*
* @return string Term Name
* @uses get_queried_object()
* @uses get_query_var()
* @uses apply_filters()
*
* @uses get_term_by()
*/
function bbp_get_topic_tag_slug( $tag = '' ) {
// Get the term
if ( ! empty( $tag ) ) {
$term = get_term_by( 'slug', $tag, bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->slug ) ) {
$retval = $term->slug;
// No slug
} else {
$retval = '';
}
return apply_filters( 'bbp_get_topic_tag_slug', $retval );
}
/**
* Output the link of the current tag
*
* @since bbPress (r3348)
*
* @uses bbp_get_topic_tag_link()
*/
function bbp_topic_tag_link( $tag = '' ) {
echo esc_url( bbp_get_topic_tag_link( $tag ) );
}
/**
* Return the link of the current tag
*
* @since bbPress (r3348)
*
* @return string Term Name
* @uses get_queried_object()
* @uses get_query_var()
* @uses apply_filters()
*
* @uses get_term_by()
*/
function bbp_get_topic_tag_link( $tag = '' ) {
// Get the term
if ( ! empty( $tag ) ) {
$term = get_term_by( 'slug', $tag, bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->term_id ) ) {
$retval = get_term_link( $term, bbp_get_topic_tag_tax_id() );
// No link
} else {
$retval = '';
}
return apply_filters( 'bbp_get_topic_tag_link', $retval, $tag );
}
/**
* Output the link of the current tag
*
* @since bbPress (r3348)
*
* @uses bbp_get_topic_tag_edit_link()
*/
function bbp_topic_tag_edit_link( $tag = '' ) {
echo esc_url( bbp_get_topic_tag_edit_link( $tag ) );
}
/**
* Return the link of the current tag
*
* @since bbPress (r3348)
*
* @return string Term Name
* @uses get_queried_object()
* @uses get_query_var()
* @uses apply_filters()
*
* @uses get_term_by()
*/
function bbp_get_topic_tag_edit_link( $tag = '' ) {
// Get the term
if ( ! empty( $tag ) ) {
$term = get_term_by( 'slug', $tag, bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->term_id ) ) {
// Pretty or ugly URL.
$retval = bbp_use_pretty_urls()
? user_trailingslashit( trailingslashit( bbp_get_topic_tag_link() ) . bbp_get_edit_slug() )
: add_query_arg( array( bbp_get_edit_rewrite_id() => '1' ), bbp_get_topic_tag_link() );
// No link
} else {
$retval = '';
}
return apply_filters( 'bbp_get_topic_tag_edit_link', $retval, $tag );
}
/**
* Output the description of the current tag
*
* @since bbPress (r3109)
*
* @uses bbp_get_topic_tag_description()
*/
function bbp_topic_tag_description( $args = array() ) {
echo bbp_get_topic_tag_description( $args );
}
/**
* Return the description of the current tag
*
* @since bbPress (r3109)
*
* @param array $args before|after|tag
*
* @return string Term Name
* @uses get_query_var()
* @uses apply_filters()
* @uses get_term_by()
* @uses get_queried_object()
*/
function bbp_get_topic_tag_description( $args = array() ) {
// Parse arguments against default values
$r = bbp_parse_args(
$args,
array(
'before' => '<div class="bbp-topic-tag-description"><p>',
'after' => '</p></div>',
'tag' => '',
),
'get_topic_tag_description'
);
// Get the term
if ( ! empty( $r['tag'] ) ) {
$term = get_term_by( 'slug', $r['tag'], bbp_get_topic_tag_tax_id() );
} else {
$tag = get_query_var( 'term' );
$r['tag'] = $tag;
$term = get_queried_object();
}
// Add before and after if description exists
if ( ! empty( $term->description ) ) {
$retval = $r['before'] . $term->description . $r['after'];
// No description, no HTML
} else {
$retval = '';
}
return apply_filters( 'bbp_get_topic_tag_description', $retval, $r );
}
/** Forms *********************************************************************/
/**
* Output the value of topic title field
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_title() To get the value of topic title field
*/
function bbp_form_topic_title() {
echo bbp_get_form_topic_title();
}
/**
* Return the value of topic title field
*
* @since bbPress (r2976)
*
* @return string Value of topic title field
* @uses apply_filters() Calls 'bbp_get_form_topic_title' with the title
* @uses bbp_is_topic_edit() To check if it's topic edit page
*/
function bbp_get_form_topic_title() {
// Get _POST data.
if ( bbp_is_post_request() && isset( $_POST['bbp_topic_title'] ) ) {
$topic_title = sanitize_text_field( wp_unslash( $_POST['bbp_topic_title'] ) );
// Get edit data.
} elseif ( bbp_is_topic_edit() ) {
$topic_title = bbp_get_global_post_field( 'post_title', 'raw' );
// No data.
} else {
$topic_title = '';
}
return apply_filters( 'bbp_get_form_topic_title', esc_html( $topic_title ) );
}
/**
* Output the value of topic content field
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_content() To get value of topic content field
*/
function bbp_form_topic_content() {
echo bbp_get_form_topic_content();
}
/**
* Return the value of topic content field
*
* @since bbPress (r2976)
*
* @return string Value of topic content field
* @uses apply_filters() Calls 'bbp_get_form_topic_content' with the content
* @uses bbp_is_topic_edit() To check if it's the topic edit page
*/
function bbp_get_form_topic_content() {
// Get _POST data
if ( bbp_is_post_request() && isset( $_POST['bbp_topic_content'] ) ) {
$topic_content = stripslashes( $_POST['bbp_topic_content'] );
// Remove unintentional empty paragraph coming from the medium editor when only link preview.
if ( preg_match('/^(<p><br><\/p>|<p><br \/><\/p>|<p><\/p>|<p><br\/><\/p>)$/i', $topic_content ) ) {
$topic_content = '';
}
// Get edit data
} elseif ( bbp_is_topic_edit() ) {
$topic_content = bbp_get_global_post_field( 'post_content', 'raw' );
// No data
} else {
$topic_content = '';
}
return apply_filters( 'bbp_get_form_topic_content', $topic_content );
}
/**
* Allow topic rows to have adminstrative actions
*
* @since bbPress (r3653)
* @uses do_action()
* @todo Links and filter
*/
function bbp_topic_row_actions() {
do_action( 'bbp_topic_row_actions' );
}
/**
* Output value of topic tags field
*
* @since bbPress (r2976)
* @uses bbp_get_form_topic_tags() To get the value of topic tags field
*/
function bbp_form_topic_tags() {
echo bbp_get_form_topic_tags();
}
/**
* Return value of topic tags field
*
* @since bbPress (r2976)
*
* @return string Value of topic tags field
* @uses apply_filters() Calls 'bbp_get_form_topic_tags' with the tags
* @uses bbp_is_topic_edit() To check if it's the topic edit page
*/
function bbp_get_form_topic_tags() {
// Get _POST data
if ( bbp_is_post_request() && isset( $_POST['bbp_topic_tags'] ) ) {
$topic_tags = $_POST['bbp_topic_tags'];
// Get edit data
} elseif ( bbp_is_single_topic() || bbp_is_single_reply() || bbp_is_topic_edit() || bbp_is_reply_edit() ) {
// Determine the topic id based on the post type
switch ( get_post_type() ) {
// Post is a topic
case bbp_get_topic_post_type():
$topic_id = get_the_ID();
break;
// Post is a reply
case bbp_get_reply_post_type():
$topic_id = bbp_get_reply_topic_id( get_the_ID() );
break;
default:
// If post type doesn't match and topic id is set via shortcode.
$topic_id = bbp_get_topic_id();
break;
}
$new_terms = array();
// Topic exists
if ( ! empty( $topic_id ) ) {
// Topic is spammed so display pre-spam terms
if ( bbp_is_topic_spam( $topic_id ) ) {
$new_terms = get_post_meta( $topic_id, '_bbp_spam_topic_tags', true );
// Topic is not spam so get real terms
} else {
$terms = array_filter( (array) get_the_terms( $topic_id, bbp_get_topic_tag_tax_id() ) );
$new_terms = wp_list_pluck( $terms, 'name' );
}
}
// Set the return value
$topic_tags = ( ! empty( $new_terms ) ) ? implode( ', ', $new_terms ) : '';
// No data
} else {
$topic_tags = '';
}
return apply_filters( 'bbp_get_form_topic_tags', esc_attr( $topic_tags ) );
}
/**
* Output value of topic forum
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_forum() To get the topic's forum id
*/
function bbp_form_topic_forum() {
echo bbp_get_form_topic_forum();
}
/**
* Return value of topic forum
*
* @since bbPress (r2976)
*
* @return string Value of topic content field
* @uses bbp_get_topic_forum_id() To get the topic forum id
* @uses apply_filters() Calls 'bbp_get_form_topic_forum' with the forum
* @uses bbp_is_topic_edit() To check if it's the topic edit page
*/
function bbp_get_form_topic_forum() {
// Get _POST data
if ( bbp_is_post_request() && isset( $_POST['bbp_forum_id'] ) ) {
$topic_forum = (int) $_POST['bbp_forum_id'];
// Get edit data
} elseif ( bbp_is_topic_edit() ) {
$topic_forum = bbp_get_topic_forum_id();
// No data
} else {
$topic_forum = 0;
}
return apply_filters( 'bbp_get_form_topic_forum', $topic_forum );
}
/**
* Output checked value of topic subscription
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_subscribed() To get the subscribed checkbox value
*/
function bbp_form_topic_subscribed() {
echo bbp_get_form_topic_subscribed();
}
/**
* Return checked value of topic subscription
*
* @since bbPress (r2976)
*
* @return string Checked value of topic subscription
* @uses bbp_is_user_subscribed_to_topic() To check if the user is
* subscribed to the topic
* @uses apply_filters() Calls 'bbp_get_form_topic_subscribed' with the
* option
* @uses bbp_is_topic_edit() To check if it's the topic edit page
*/
function bbp_get_form_topic_subscribed() {
// Default value.
$topic_subscribed = false;
// Get _POST data.
if ( bbp_is_post_request() && isset( $_POST['bbp_topic_subscription'] ) ) {
$topic_subscribed = (bool) $_POST['bbp_topic_subscription'];
// Get edit data.
} elseif ( bbp_is_topic_edit() || bbp_is_reply_edit() ) {
// Get current posts author.
$post_author = (int) bbp_get_global_post_field( 'post_author', 'raw' );
$topic_subscribed = bbp_is_user_subscribed( $post_author, bbp_get_topic_id() );
// Get current status.
} elseif ( bbp_is_single_topic() ) {
$topic_subscribed = bbp_is_user_subscribed( bbp_get_current_user_id(), bbp_get_topic_id() );
}
// Get checked output.
$checked = checked( $topic_subscribed, true, false );
return apply_filters( 'bbp_get_form_topic_subscribed', $checked, $topic_subscribed );
}
/**
* Output checked value of topic log edit field
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_log_edit() To get the topic log edit value
*/
function bbp_form_topic_log_edit() {
echo bbp_get_form_topic_log_edit();
}
/**
* Return checked value of topic log edit field
*
* @since bbPress (r2976)
*
* @return string Topic log edit checked value
* @uses apply_filters() Calls 'bbp_get_form_topic_log_edit' with the
* log edit value
*/
function bbp_get_form_topic_log_edit() {
// Get _POST data
if ( bbp_is_post_request() && isset( $_POST['bbp_log_topic_edit'] ) ) {
$topic_revision = (int) $_POST['bbp_log_topic_edit'];
// No data
} else {
$topic_revision = 1;
}
// Get checked output
$checked = checked( $topic_revision, true, false );
return apply_filters( 'bbp_get_form_topic_log_edit', $checked, $topic_revision );
}
/**
* Output the value of the topic edit reason
*
* @since bbPress (r2976)
*
* @uses bbp_get_form_topic_edit_reason() To get the topic edit reason value
*/
function bbp_form_topic_edit_reason() {
echo bbp_get_form_topic_edit_reason();
}
/**
* Return the value of the topic edit reason
*
* @since bbPress (r2976)
*
* @return string Topic edit reason value
* @uses apply_filters() Calls 'bbp_get_form_topic_edit_reason' with the
* topic edit reason value
*/
function bbp_get_form_topic_edit_reason() {
// Get _POST data
if ( bbp_is_post_request() && isset( $_POST['bbp_topic_edit_reason'] ) ) {
$topic_edit_reason = $_POST['bbp_topic_edit_reason'];
// No data
} else {
$topic_edit_reason = '';
}
return apply_filters( 'bbp_get_form_topic_edit_reason', esc_attr( $topic_edit_reason ) );
}
/**
* Return the topics created date/time.
*
* @since BuddyBoss 2.0.0
*
* @param int $topic_id Optional. Topic id.
*
* @uses bbp_get_topic_id() To get topic id.
* @uses get_post_meta() To get the topic lst active meta.
* @uses bbp_get_topic_last_reply_id() To get topic last reply id.
* @uses get_post_field() To get the post date of topic/reply.
* @uses bbp_convert_date() To convert date.
* @uses bbp_get_time_since() To get time in since format.
* @uses apply_filters() Calls 'bbp_get_topic_last_active' with topic
* freshness and topic id.
*
* @return string Topic freshness.
*/
function bbp_get_topic_created_time( $topic_id = 0 ) {
$topic_id = bbp_get_topic_id( $topic_id );
$last_active = get_post_field( 'post_date', $topic_id );
$last_active = ! empty( $last_active ) ? bbp_get_time_since( bbp_convert_date( $last_active ) ) : '';
// Return the time since.
return apply_filters( 'bbp_get_topic_created_time', $last_active, $topic_id );
}