BP_Media_Theme_Compat
The main theme compat class for BuddyBoss Media.
Description
This class sets up the necessary theme compatibility actions to safely output media template parts to the_title and the_content areas of a theme.
Source
File: bp-media/classes/class-bp-media-theme-compat.php
class BP_Media_Theme_Compat { /** * Set up the media component theme compatibility. * * @since BuddyBoss 1.0.0 */ public function __construct() { add_action( 'bp_setup_theme_compat', array( $this, 'is_media' ) ); } /** * Set up the theme compatibility hooks, if we're looking at an media page. * * @since BuddyBoss 1.0.0 */ public function is_media() { // Bail if not looking at a group. if ( ! bp_is_media_component() ) return; // Media Directory. if ( ! bp_displayed_user_id() && ! bp_current_action() ) { bp_update_is_directory( true, 'media' ); /** This action is documented in bp-media/bp-media-screens.php */ do_action( 'bp_media_screen_index' ); add_filter( 'bp_get_buddypress_template', array( $this, 'directory_template_hierarchy' ) ); add_action( 'bp_template_include_reset_dummy_post_data', array( $this, 'directory_dummy_post' ) ); add_filter( 'bp_replace_the_content', array( $this, 'directory_content' ) ); } } /** Directory *************************************************************/ /** * Add template hierarchy to theme compat for the media directory page. * * This is to mirror how WordPress has {@link https://codex.wordpress.org/Template_Hierarchy template hierarchy}. * * @since BuddyBoss 1.0.0 * * @param string $templates The templates from bp_get_theme_compat_templates(). * @return array $templates Array of custom templates to look for. */ public function directory_template_hierarchy( $templates ) { /** * Filters the template hierarchy for the media directory page. * * @since BuddyBoss 1.0.0 * * @param array $index-directory Array holding template names to be merged into template list. */ $new_templates = apply_filters( 'bp_template_hierarchy_media_directory', array( 'media/index-directory.php' ) ); // Merge new templates with existing stack // @see bp_get_theme_compat_templates(). $templates = array_merge( (array) $new_templates, $templates ); return $templates; } /** * Update the global $post with directory data. * * @since BuddyBoss 1.0.0 */ public function directory_dummy_post() { bp_theme_compat_reset_post( array( 'ID' => 0, 'post_title' => bp_get_directory_title( 'media' ), 'post_author' => 0, 'post_date' => 0, 'post_content' => '', 'post_type' => 'page', 'post_status' => 'publish', 'is_page' => true, 'comment_status' => 'closed' ) ); } /** * Filter the_content with the groups index template part. * * @since BuddyBoss 1.0.0 */ public function directory_content() { return bp_buffer_template_part( 'media/index', null, false ); } /** Single ****************************************************************/ /** * Add custom template hierarchy to theme compat for media permalink pages. * * This is to mirror how WordPress has {@link https://codex.wordpress.org/Template_Hierarchy template hierarchy}. * * @since BuddyBoss 1.0.0 * * @param string $templates The templates from bp_get_theme_compat_templates(). * @return array $templates Array of custom templates to look for. */ public function single_template_hierarchy( $templates ) { /** * Filters the template hierarchy for the media permalink pages. * * @since BuddyBoss 1.0.0 * * @param array $index Array holding template names to be merged into template list. */ $new_templates = apply_filters( 'bp_template_hierarchy_media_single_item', array( 'media/single/index.php' ) ); // Merge new templates with existing stack // @see bp_get_theme_compat_templates(). $templates = array_merge( (array) $new_templates, $templates ); return $templates; } /** * Update the global $post with the displayed user's data. * * @since BuddyBoss 1.0.0 */ public function single_dummy_post() { bp_theme_compat_reset_post( array( 'ID' => 0, 'post_title' => __( 'Photos', 'buddyboss' ), 'post_author' => 0, 'post_date' => 0, 'post_content' => '', 'post_type' => 'page', 'post_status' => 'publish', 'is_page' => true, 'comment_status' => 'closed' ) ); } /** * Filter the_content with the members' media permalink template part. * * @since BuddyBoss 1.0.0 */ public function single_dummy_content() { return bp_buffer_template_part( 'media/single/home', null, false ); } }
Changelog
Version | Description |
---|---|
BuddyBoss 1.0.0 | Introduced. |
Methods
- __construct — Set up the media component theme compatibility.
- directory_content — Filter the_content with the groups index template part.
- directory_dummy_post — Update the global $post with directory data.
- directory_template_hierarchy — Add template hierarchy to theme compat for the media directory page.
- is_media — Set up the theme compatibility hooks, if we're looking at an media page.
- single_dummy_content — Filter the_content with the members' media permalink template part.
- single_dummy_post — Update the global $post with the displayed user's data.
- single_template_hierarchy — Add custom template hierarchy to theme compat for media permalink pages.
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.