Ticket #6772: 6772.05.patch

new file src/bp-activity/bp-activity-embeds.php

@@ +1 @@
+<?php
+/**
+ * Functions related to embedding single activity items externally.
+ *
+ * Relies on WordPress 4.4.
+ *
+ * @since 2.5.0
+ *
+ * @package BuddyPress
+ * @subpackage ActivityEmbeds
+ */
+
+// Exit if accessed directly.
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Loads our activity oEmbed component.
+ *
+ * @since 2.5.0
+ */
+function bp_activity_setup_oembed() {
+        if ( bp_get_major_wp_version() >= 4.4 && bp_is_active( 'activity', 'embeds' ) ) {
+                buddypress()->activity->oembed = new BP_Activity_oEmbed_Component;
+        }
+}
+
+/**
+ * Outputs a text excerpt for an activity item (and remove any oEmbeds URLs).
+ *
+ * @since 2.5.0
+ */
+function bp_activity_embed_excerpt( $content = '' ) {
+        echo bp_activity_get_embed_excerpt( $content = '' );
+}
+
+        /**
+         * Generate a text excerpt for an activity item (and remove any oEmbeds URLs).
+         *
+         * @since 2.5.0
+         *
+         * @param  string $content The content to generate an excerpt for.
+         * @return string
+         */
+        function bp_activity_get_embed_excerpt( $content = '' ) {
+                if ( empty( $content ) && ! empty( $GLOBALS['activities_template']->in_the_loop ) ) {
+                        $content = $GLOBALS['activities_template']->activity->content;
+                }
+
+                /**
+                 * bp_activity_truncate_entry() includes the 'Read More' link, which is why
+                 * we're using this instead of bp_create_excerpt().
+                 */
+                $content = html_entity_decode( $content );
+                $content = bp_activity_truncate_entry( $content, array(
+                        'html' => false,
+                        'filter_shortcodes' => true,
+                        'strip_tags'        => true,
+                        'force_truncate'    => true
+                ) );
+
+                // Remove links from content.
+                $content = preg_replace( '#^\s*(https?://[^\s"]+)\s*$#im', '', $content );
+
+                return $content;
+        }
+
+/**
+ * Outputs the first embedded item in the activity oEmbed template.
+ *
+ * @since 2.5.0
+ */
+function bp_activity_embed_response_display_media() {
+        // Bail if oEmbed request explicitly hides media.
+        if ( isset( $_REQUEST['hide_media'] ) && true == wp_validate_boolean( $_REQUEST['hide_media'] ) ) {
+                return;
+        }
+
+        // Find all embeds for the activity item.
+        $embeds = bp_core_extract_media_from_content( $GLOBALS['activities_template']->activity->content, 'embeds' );
+
+        /**
+         * Should we display media in the oEmbed template?
+         *
+         * @since 2.5.0
+         *
+         * @param bool $retval Defaults to true.
+         */
+        $allow_embeds = apply_filters( 'bp_activity_embed_display_media', true );
+
+        // Only embed the first embedded item.
+        if ( $embeds && $allow_embeds ) {
+                $content = apply_filters( 'bp_get_activity_content_body', $embeds['embeds'][0]['url'] );
+                echo $content;
+
+                if ( false !== strpos( $content, '<iframe' ) ) {
+        ?>
+
+<script>
+/*! fluidvids.js v1.2.0 | (c) 2013 @toddmotto | https://github.com/toddmotto/fluidvids */
+window.fluidvids=function(a,b){"use strict";var c=function(a){this.elem=a};c.prototype={init:function(){var a=100*(this.elem.height/this.elem.width);this.elem.style.position="absolute",this.elem.style.top="0",this.elem.style.left="0",this.elem.width="100%",this.elem.height="100%";var c=b.createElement("div");c.className="fluidvids",c.style.width="100%",c.style.position="relative",c.style.paddingTop=a+"%";var d=this.elem.parentNode;d.insertBefore(c,this.elem),c.appendChild(this.elem)}};for(var d=b.getElementsByTagName("iframe"),e=0;e<d.length;e++){d[e].src&&new c(d[e]).init()}}(window,document);
+</script>
+
+        <?php
+                }
+        }
+}
+add_action( 'bp_activity_embed_after_content', 'bp_activity_embed_response_display_media' );

src/bp-activity/bp-activity-filters.php

@@ -387 +387 @@
  * This method can only be used inside the Activity loop.
  *
  * @since 1.5.0
- *
- * @uses bp_is_single_activity()
- * @uses apply_filters() To call the 'bp_activity_excerpt_append_text' hook.
- * @uses apply_filters() To call the 'bp_activity_excerpt_length' hook.
- * @uses bp_create_excerpt()
- * @uses bp_get_activity_id()
- * @uses bp_get_activity_thread_permalink()
- * @uses apply_filters() To call the 'bp_activity_truncate_entry' hook.
+ * @since 2.5.0 Added $args parameter.
  *
  * @param string $text The original activity entry text.
  * @return string $excerpt The truncated text.
  */
-function bp_activity_truncate_entry( $text ) {
+function bp_activity_truncate_entry( $text, $args = array() ) {
         global $activities_template;
 
         /**
@@ -415 +408 @@
         );
 
         // The full text of the activity update should always show on the single activity screen.
-        if ( ! $maybe_truncate_text || bp_is_single_activity() ) {
+        if ( empty( $args['force_truncate'] ) && ( ! $maybe_truncate_text || bp_is_single_activity() ) ) {
                 return $text;
         }
 
@@ -437 +430 @@
          */
         $excerpt_length = apply_filters( 'bp_activity_excerpt_length', 358 );
 
+        $args = wp_parse_args( $args, array( 'ending' => __( '…', 'buddypress' ) ) );
+
         // Run the text through the excerpt function. If it's too short, the original text will be returned.
-        $excerpt        = bp_create_excerpt( $text, $excerpt_length, array( 'ending' => __( '…', 'buddypress' ) ) );
+        $excerpt        = bp_create_excerpt( $text, $excerpt_length, $args );
 
         /*
          * If the text returned by bp_create_excerpt() is different from the original text (ie it's

src/bp-activity/bp-activity-functions.php

@@ -2789 +2789 @@
         }
 
         // Generate a text excerpt for this activity item (and remove any oEmbeds URLs).
-        $summary = strip_shortcodes( html_entity_decode( strip_tags( $content ) ) );
-        $summary = bp_create_excerpt( preg_replace( '#^\s*(https?://[^\s"]+)\s*$#im', '', $summary ) );
+        $summary = bp_create_excerpt( html_entity_decode( $content ), 225, array(
+                'html' => false,
+                'filter_shortcodes' => true,
+                'strip_tags'        => true,
+                'remove_links'      => true
+        ) );
 
         if ( $use_media_type === 'embeds' ) {
                 $summary .= PHP_EOL . PHP_EOL . $extracted_media['url'];

src/bp-activity/bp-activity-loader.php

@@ -31 +31 @@
                         array(
                                 'adminbar_myaccount_order' => 10,
                                 'search_query_arg' => 'activity_search',
+                                'features' => array( 'embeds' )
                         )
                 );
         }
@@ -67 +68 @@
                         $includes[] = 'akismet';
                 }
 
+                // Embeds - only applicable for WP 4.4+
+                if ( bp_get_major_wp_version() >= 4.4 && bp_is_active( $this->id, 'embeds' ) ) {
+                        $includes[] = 'classes/class-bp-activity-oembed-component';
+                        $includes[] = 'embeds';
+                }
+
                 if ( is_admin() ) {
                         $includes[] = 'admin';
                 }
@@ -365 +372 @@
                 // Spam prevention.
                 add_action( 'bp_include', 'bp_activity_setup_akismet' );
 
+                // oEmbed handler.
+                add_action( 'bp_loaded', 'bp_activity_setup_oembed' );
+
                 parent::setup_actions();
         }
 

new file src/bp-activity/classes/class-bp-activity-oembed-component.php

@@ +1 @@
+<?php
+/**
+ * BuddyPress Activity Classes.
+ *
+ * @package BuddyPress
+ * @subpackage Embeds
+ */
+
+// Exit if accessed directly.
+defined( 'ABSPATH' ) || exit;
+
+require_once( buddypress()->plugin_dir . '/bp-core/classes/class-bp-oembed-component.php' );
+
+/**
+ * oEmbed handler to respond and render single activity items.
+ *
+ * @since 2.5.0
+ */
+class BP_Activity_oEmbed_Component extends BP_oEmbed_Component {
+        /**
+         * Custom oEmbed slug endpoint.
+         *
+         * @since 2.5.0
+         *
+         * @var string
+         */
+        public $slug_endpoint = 'activity';
+
+        /**
+         * Custom hooks.
+         *
+         * @since 2.5.0
+         */
+        protected function custom_hooks() {
+                add_action( 'embed_content_meta', array( $this, 'embed_comments_button' ), 5 );
+        }
+
+        /**
+         * Add custom endpoint arguments.
+         *
+         * Currently, includes 'hide_media'.
+         *
+         * @since 2.5.0
+         *
+         * @return array
+         */
+        protected function set_route_args() {
+                return array(
+                        'hide_media' => array(
+                                'default' => false,
+                                'sanitize_callback' => 'wp_validate_boolean'
+                        )
+                );
+        }
+
+        /**
+         * Output our custom embed template part.
+         *
+         * @since 2.5.0
+         */
+        protected function content() {
+                bp_get_asset_template_part( 'embeds/activity' );
+        }
+
+        /**
+         * Check if we're on our single activity page.
+         *
+         * @since 2.5.0
+         *
+         * @return bool
+         */
+        protected function is_page() {
+                return bp_is_single_activity();
+        }
+
+        /**
+         * Validates the URL to determine if the activity item is valid.
+         *
+         * @since 2.5.0
+         *
+         * @param  string   $url The URL to check.
+         * @return int|bool Activity ID on success; boolean false on failure.
+         */
+        protected function validate_url_to_item_id( $url ) {
+                if ( bp_core_enable_root_profiles() ) {
+                        $domain = bp_get_root_domain();
+                } else {
+                        $domain = bp_get_members_directory_permalink();
+                }
+
+                // Check the URL to see if this is a single activity URL.
+                if ( 0 !== strpos( $url, $domain ) ) {
+                        return false;
+                }
+
+                // Check for activity slug.
+                if ( false === strpos( $url, '/' . bp_get_activity_slug() . '/' ) ) {
+                        return false;
+                }
+
+                // Do more checks.
+                $url = trim( untrailingslashit( $url ) );
+
+                // Grab the activity ID.
+                $activity_id = (int) substr(
+                        $url,
+                        strrpos( $url, '/' ) + 1
+                );
+
+                if ( ! empty( $activity_id ) ) {
+                        // Check if activity item still exists.
+                        $activity = new BP_Activity_Activity( $activity_id );
+
+                        // Okay, we're good to go!
+                        if ( ! empty( $activity->component ) && 0 === (int) $activity->is_spam ) {
+                                return $activity_id;
+                        }
+                }
+
+                return false;
+        }
+
+        /**
+         * Sets the oEmbed response data for our activity item.
+         *
+         * @since 2.5.0
+         *
+         * @param  int $item_id The activity ID.
+         * @return array
+         */
+        protected function set_oembed_response_data( $item_id ) {
+                $activity = new BP_Activity_Activity( $item_id );
+
+                return array(
+                        'user_id'    => $activity->user_id,
+                        'content'    => $activity->content,
+                        'title'      => __( 'Activity', 'buddypress' ),
+                        'author_url' => bp_core_get_user_domain( $activity->user_id )
+                );
+        }
+
+        /**
+         * Sets a custom <blockquote> for our oEmbed fallback HTML.
+         *
+         * @since 2.5.0
+         *
+         * @param  int $item_id The activity ID.
+         * @return string
+         */
+        protected function set_fallback_html( $item_id ) {
+                $activity    = new BP_Activity_Activity( $item_id );
+                $mentionname = bp_activity_do_mentions() ? ' (@' . bp_activity_get_user_mentionname( $activity->user_id ) . ')' : '';
+                $date        = date_i18n( get_option( 'date_format' ), strtotime( $activity->date_recorded ) );
+
+                // Make sure we can use some activity functions that depend on the loop.
+                $GLOBALS['activities_template'] = new stdClass;
+                $GLOBALS['activities_template']->activity = $activity;
+
+                // 'wp-embedded-content' CSS class is necessary due to how the embed JS works.
+                $blockquote = sprintf( '<blockquote class="wp-embedded-content bp-activity-item">%1$s%2$s %3$s</blockquote>',
+                        '<p>' . bp_activity_get_embed_excerpt( $activity->content ) . '</p>',
+                        '- ' . bp_core_get_user_displayname( $activity->user_id ) . $mentionname,
+                        '<a href="' . esc_url( bp_activity_get_permalink( $item_id ) ) . '">' . $date . '</a>'
+                );
+
+                // Clean up.
+                unset( $GLOBALS['activities_template'] );
+
+                /**
+                 * Filters the fallback HTML used when embedding a BP activity item.
+                 *
+                 * @since 2.5.0
+                 *
+                 * @param string               $blockquote Current fallback HTML
+                 * @param BP_Activity_Activity $activity   Activity object
+                 */
+                return apply_filters( 'bp_activity_embed_fallback_html', $blockquote, $activity );
+        }
+
+        /**
+         * Sets a custom <iframe> title for our oEmbed item.
+         *
+         * @since 2.5.0
+         *
+         * @param  int $item_id The activity ID
+         * @return string
+         */
+        protected function set_iframe_title( $item_id ) {
+                return __( 'Embedded Activity Item', 'buddypress' );
+        }
+
+        /**
+         * Prints the markup for the activity embed comments button.
+         *
+         * @since 2.5.0
+         */
+        public function embed_comments_button() {
+                if ( ! bp_is_single_activity() ) {
+                        return;
+                }
+
+                // Make sure our custom permalink shows up in the 'WordPress Embed' block.
+                add_filter( 'the_permalink', array( $this, 'filter_embed_url' ) );
+
+                // Only show comment bubble if we have some activity comments.
+                $count = bp_activity_get_comment_count();
+                if ( empty( $count ) ) {
+                        return;
+                }
+        ?>
+
+                <div class="wp-embed-comments">
+                        <a href="<?php bp_activity_thread_permalink(); ?>">
+                                <span class="dashicons dashicons-admin-comments"></span>
+                                <?php
+                                printf(
+                                        _n(
+                                                '%s <span class="screen-reader-text">Comment</span>',
+                                                '%s <span class="screen-reader-text">Comments</span>',
+                                                $count
+                                        ),
+                                        number_format_i18n( $count )
+                                );
+                                ?>
+                        </a>
+                </div>
+
+        <?php
+        }
+}

src/bp-core/bp-core-functions.php

@@ -1666 +1666 @@
         return apply_filters( 'bp_use_embed_in_private_messages', !defined( 'BP_EMBED_DISABLE_PRIVATE_MESSAGES' ) || !BP_EMBED_DISABLE_PRIVATE_MESSAGES );
 }
 
+/**
+ * Extracts media metadata from a given content.
+ *
+ * @since 2.5.0
+ *
+ * @param  string     $content The content to check.
+ * @param  string|int $type    The type to check. Can also use a bitmask. See the class constants in the
+ *                             BP_Media_Extractor class for more info.
+ * @return array|bool          If media exists, will return array of media metadata. Else, boolean false.
+ */
+function bp_core_extract_media_from_content( $content = '', $type = 'all' ) {
+        if ( is_string( $type ) ) {
+                $class = new ReflectionClass( 'BP_Media_Extractor' );
+                $bitmask = $class->getConstant( strtoupper( $type ) );
+        } else {
+                $bitmask = (int) $type;
+        }
+
+        // Type isn't valid, so bail.
+        if ( empty( $bitmask ) ) {
+                return false;
+        }
+
+        $x = new BP_Media_Extractor;
+        $media = $x->extract( $content, $bitmask );
+
+        unset( $media['has'] );
+        $retval = array_filter( $media );
+
+        return ! empty( $retval ) ? $retval : false;
+}
+
 /** Admin *********************************************************************/
 
 /**

src/bp-core/bp-core-template-loader.php

@@ -65 +65 @@
 }
 
 /**
+ * Get an asset template part.
+ *
+ * Basically the same as {@link bp_get_template_part()}, but with 'assets/'
+ * prepended to the slug.
+ *
+ * @since 2.5.0
+ *
+ * @see bp_get_template_part() for full documentation.
+ */
+function bp_get_asset_template_part( $slug, $name = null ) {
+        return bp_get_template_part( "assets/{$slug}", $name );
+}
+
+/**
  * Retrieve the name of the highest priority template file that exists.
  *
  * Searches in the STYLESHEETPATH before TEMPLATEPATH so that themes which

src/bp-core/bp-core-template.php

@@ -742 +742 @@
  * This function is borrowed from CakePHP v2.0, under the MIT license. See
  * http://book.cakephp.org/view/1469/Text#truncate-1625
  *
+ * @since 2.5.0 Added 'strip_tags' and 'remove_links' as $options args.
+ *
  * ### Options:
  *
  * - `ending` Will be used as Ending and appended to the trimmed string.
@@ -762 +764 @@
  *                                     excerpt length. Default: true.
  *     @type bool   $filter_shortcodes If true, shortcodes will be stripped.
  *                                     Default: true.
+ *     @type bool   $strip_tags        If true, HTML tags will be stripped. Default: false.
+ *                                     Only applicable if $html is set to false.
+ *     @type bool   $remove_links      If true, URLs will be stripped. Default: false.
+ *                                     Only applicable if $html is set to false.
  * }
  * @return string Trimmed string.
  */
@@ -774 +780 @@
                 'ending'            => __( ' […]', 'buddypress' ),
                 'exact'             => false,
                 'html'              => true,
-                'filter_shortcodes' => $filter_shortcodes_default
+                'filter_shortcodes' => $filter_shortcodes_default,
+                'strip_tags'        => false,
+                'remove_links'      => false,
         ), 'create_excerpt' );
 
         // Save the original text, to be passed along to the filter.
@@ -860 +868 @@
                         }
                 }
         } else {
+                // Strip HTML tags if necessary.
+                if ( ! empty( $r['strip_tags'] ) ) {
+                        $text = strip_tags( $text );
+                }
+
+                // Remove links if necessary.
+                if ( ! empty( $r['remove_links'] ) ) {
+                        $text = preg_replace( '#^\s*(https?://[^\s"]+)\s*$#im', '', $text );
+                }
+
                 if ( mb_strlen( $text ) <= $length ) {
                         return $text;
                 } else {

src/bp-core/bp-core-theme-compatibility.php

@@ -650 +650 @@
 }
 
 /**
+ * Create a dummy WP_Post object.
+ *
+ * @since 2.5.0
+ *
+ * @param  array $args Array of optional arguments. Arguments parallel the properties
+ *                    of {@link WP_Post}; see that class for more details.
+ * @return WP_Post
+ */
+function bp_theme_compat_create_dummy_post( $args = array() ) {
+        $args = wp_parse_args( $args, array(
+                'ID'                    => -9999,
+                'post_status'           => 'public',
+                'post_author'           => 0,
+                'post_parent'           => 0,
+                'post_type'             => 'page',
+                'post_date'             => 0,
+                'post_date_gmt'         => 0,
+                'post_modified'         => 0,
+                'post_modified_gmt'     => 0,
+                'post_content'          => '',
+                'post_title'            => '',
+                'post_excerpt'          => '',
+                'post_content_filtered' => '',
+                'post_mime_type'        => '',
+                'post_password'         => '',
+                'post_name'             => '',
+                'guid'                  => '',
+                'menu_order'            => 0,
+                'pinged'                => '',
+                'to_ping'               => '',
+                'ping_status'           => '',
+                'comment_status'        => 'closed',
+                'comment_count'         => 0,
+                'filter'                => 'raw',
+
+                'is_404'                => false,
+                'is_page'               => false,
+                'is_single'             => false,
+                'is_archive'            => false,
+                'is_tax'                => false,
+        ) );
+
+        // Create the dummy post.
+        $post = new WP_Post( (object) $args );
+
+        return $post;
+}
+
+/**
  * Populate various WordPress globals with dummy data to prevent errors.
  *
  * This dummy data is necessary because theme compatibility essentially fakes
@@ -670 +719 @@
 
         // Switch defaults if post is set.
         if ( isset( $wp_query->post ) ) {
-                $dummy = wp_parse_args( $args, array(
+                $args = wp_parse_args( $args, array(
                         'ID'                    => $wp_query->post->ID,
                         'post_status'           => $wp_query->post->post_status,
                         'post_author'           => $wp_query->post->post_author,
@@ -695 +744 @@
                         'comment_status'        => $wp_query->post->comment_status,
                         'comment_count'         => $wp_query->post->comment_count,
                         'filter'                => $wp_query->post->filter,
-
-                        'is_404'                => false,
-                        'is_page'               => false,
-                        'is_single'             => false,
-                        'is_archive'            => false,
-                        'is_tax'                => false,
-                ) );
-        } else {
-                $dummy = wp_parse_args( $args, array(
-                        'ID'                    => -9999,
-                        'post_status'           => 'public',
-                        'post_author'           => 0,
-                        'post_parent'           => 0,
-                        'post_type'             => 'page',
-                        'post_date'             => 0,
-                        'post_date_gmt'         => 0,
-                        'post_modified'         => 0,
-                        'post_modified_gmt'     => 0,
-                        'post_content'          => '',
-                        'post_title'            => '',
-                        'post_excerpt'          => '',
-                        'post_content_filtered' => '',
-                        'post_mime_type'        => '',
-                        'post_password'         => '',
-                        'post_name'             => '',
-                        'guid'                  => '',
-                        'menu_order'            => 0,
-                        'pinged'                => '',
-                        'to_ping'               => '',
-                        'ping_status'           => '',
-                        'comment_status'        => 'closed',
-                        'comment_count'         => 0,
-                        'filter'                => 'raw',
-
-                        'is_404'                => false,
-                        'is_page'               => false,
-                        'is_single'             => false,
-                        'is_archive'            => false,
-                        'is_tax'                => false,
                 ) );
         }
 
         // Bail if dummy post is empty.
-        if ( empty( $dummy ) ) {
+        if ( empty( $args ) ) {
                 return;
         }
 
         // Set the $post global.
-        $post = new WP_Post( (object) $dummy );
+        $post = bp_theme_compat_create_dummy_post( $args );
 
         // Copy the new post global into the main $wp_query.
         $wp_query->post       = $post;
@@ -751 +761 @@
 
         // Prevent comments form from appearing.
         $wp_query->post_count = 1;
-        $wp_query->is_404     = $dummy['is_404'];
-        $wp_query->is_page    = $dummy['is_page'];
-        $wp_query->is_single  = $dummy['is_single'];
-        $wp_query->is_archive = $dummy['is_archive'];
-        $wp_query->is_tax     = $dummy['is_tax'];
-
-        // Clean up the dummy post.
-        unset( $dummy );
+        $wp_query->is_404     = $post->is_404;
+        $wp_query->is_page    = $post->is_page;
+        $wp_query->is_single  = $post->is_single;
+        $wp_query->is_archive = $post->is_archive;
+        $wp_query->is_tax     = $post->is_tax;
 
         /**
          * Force the header back to 200 status if not a deliberate 404

new file src/bp-core/classes/class-bp-oembed-component.php

@@ +1 @@
+<?php
+/**
+ * Core component classes.
+ *
+ * @package BuddyPress
+ * @subpackage Core
+ */
+
+// Exit if accessed directly.
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * API for responding and returning a custom oEmbed request.
+ *
+ * @since 2.5.0
+ */
+abstract class BP_oEmbed_Component {
+
+        /** START PROPERTIES ****************************************************/
+
+        /**
+         * (required) The slug endpoint.
+         *
+         * Should be your component id.
+         *
+         * @var string
+         */
+        public $slug_endpoint = '';
+
+        /**
+         * (optional) Embed template hierarchy.
+         *
+         * Define the template hierarchy for your oEmbed rendering.
+         *
+         * @var array
+         */
+        protected $template_hierarchy = array();
+
+        /** END PROPERTIES ******************************************************/
+
+        /**
+         * Constructor.
+         */
+        final public function __construct() {
+                $this->setup_properties();
+
+                // Some rudimentary logic checking.
+                if ( empty( $this->slug_endpoint ) ) {
+                        $class = get_class( $this );
+                        throw new \LogicException( $class . ' class must define $slug_endpoint property' );
+                }
+
+                $this->setup_hooks();
+                $this->custom_hooks();
+        }
+
+        /** REQUIRED METHODS ****************************************************/
+
+        /**
+         * Add content for your oEmbed response here.
+         *
+         * @since 2.5.0
+         */
+        abstract protected function content();
+
+        /**
+         * Add a check for when you are on the page you want to oEmbed.
+         *
+         * You'll want to return a boolean here. eg. bp_is_single_activity().
+         *
+         * @since 2.5.0
+         *
+         * @return bool
+         */
+        abstract protected function is_page();
+
+        /**
+         * Validate the URL to see if it matches your item ID.
+         *
+         * @since 2.5.0
+         *
+         * @return int Your item ID
+         */
+        abstract protected function validate_url_to_item_id( $url );
+
+        /**
+         * Set the oEmbed response data.
+         *
+         * @since 2.5.0
+         *
+         * @param  int   $item_id Your item ID to do checks against.
+         * @return array Should contain 'user_id', 'content', 'title', 'author_url' as array keys.
+         *               'author_url' is optional; the rest are required.
+         */
+        abstract protected function set_oembed_response_data( $item_id );
+
+        /**
+         * Sets the fallback HTML for the oEmbed response.
+         *
+         * In a WordPress oEmbed item, the fallback HTML is a <blockquote>.  This is
+         * usually hidden after the <iframe> is loaded.
+         *
+         * @since 2.5.0
+         *
+         * @param  int    $item_id Your item ID to do checks against.
+         * @return string Fallback HTML you want to output.
+         */
+        abstract protected function set_fallback_html( $item_id );
+
+        /** OPTIONAL METHODS ****************************************************/
+
+        /**
+         * If your oEmbed endpoint requires additional arguments, set them here.
+         *
+         * @see register_rest_route() View the $args parameter for more info.
+         *
+         * @since 2.5.0
+         *
+         * @return array
+         */
+        protected function set_route_args() {
+                return array();
+        }
+
+        /**
+         * Set the iframe title.
+         *
+         * If not set, this will fallback to WP's 'Embedded WordPress Post'.
+         *
+         * @param int $item_id The item ID to do checks for.
+         * @return string
+         */
+        protected function set_iframe_title( $item_id ) {}
+
+        /**
+         * Do what you need to do here to initialize any custom hooks.
+         *
+         * @since 2.5.0
+         */
+        protected function custom_hooks() {}
+
+        /**
+         * Set permalink for oEmbed link discovery.
+         *
+         * This method will be called on the page we want to oEmbed.  In most cases,
+         * you will not need to override this method.  However, if you need to, do
+         * override in your extended class.
+         *
+         * @since 2.5.0
+         */
+        protected function set_permalink() {
+                $url = bp_get_requested_url();
+
+                // Remove querystring from bp_get_requested_url()
+                if ( false !== strpos( bp_get_requested_url(), '?' ) ) {
+                        $url = substr( bp_get_requested_url(), 0, strpos( bp_get_requested_url(), '?' ) );
+                }
+
+                return $url;
+        }
+
+        /** SET UP **************************************************************/
+
+        /**
+         * Set up properties.
+         *
+         * @since 2.5.0
+         */
+        protected function setup_properties() {
+                $this->slug_endpoint = sanitize_title( $this->slug_endpoint );
+        }
+
+        /**
+         * Hooks! We do the dirty work here, so you don't have to! :)
+         *
+         * @since 2.5.0
+         */
+        protected function setup_hooks() {
+                add_action( 'rest_api_init',  array( $this, 'register_route' ) );
+                add_action( 'embed_content',  array( $this, 'inject_content' ) );
+
+                add_filter( 'embed_template', array( $this, 'filter_template' ) );
+                add_filter( 'post_embed_url', array( $this, 'filter_embed_url' ) );
+                add_filter( 'embed_html',     array( $this, 'filter_embed_html' ) );
+                add_filter( 'oembed_discovery_links', array( $this, 'add_oembed_discovery_links' ) );
+        }
+
+        /** HOOKS ***************************************************************/
+
+        /**
+         * Register the oEmbed REST API route.
+         *
+         * @since 2.5.0
+         */
+        public function register_route() {
+                /** This filter is documented in wp-includes/class-wp-oembed-controller.php */
+                $maxwidth = apply_filters( 'oembed_default_width', 600 );
+
+                // Required arguments.
+                $args = array(
+                        'url'      => array(
+                                'required'          => true,
+                                'sanitize_callback' => 'esc_url_raw',
+                        ),
+                        'format'   => array(
+                                'default'           => 'json',
+                                'sanitize_callback' => 'wp_oembed_ensure_format',
+                        ),
+                        'maxwidth' => array(
+                                'default'           => $maxwidth,
+                                'sanitize_callback' => 'absint',
+                        )
+                );
+
+                // Merge custom arguments here.
+                $args = $args + (array) $this->set_route_args();
+
+                register_rest_route( 'oembed/1.0', "/embed/{$this->slug_endpoint}", array(
+                        array(
+                                'methods'  => WP_REST_Server::READABLE,
+                                'callback' => array( $this, 'get_item' ),
+                                'args'     => $args
+                        ),
+                ) );
+        }
+
+        /**
+         * Filters the embed template.
+         *
+         * Override if needed.
+         *
+         * @since 2.5.0
+         *
+         * @param  string $template File path to current embed template.
+         * @return string
+         */
+        public function filter_template( $template ) {
+                if ( ! $this->is_page() || is_404() ) {
+                        return $template;
+                }
+
+                // Embed template hierarchy!
+                return bp_locate_template( array(
+                        'assets/embeds/template.php'
+                ) );
+        }
+
+        /**
+         * Adds oEmbed discovery links on single activity pages.
+         *
+         * @since 2.5.0
+         *
+         * @param  string $retval Current discovery links.
+         * @return string
+         */
+        public function add_oembed_discovery_links( $retval ) {
+                if ( ! $this->is_page() ) {
+                        return $retval;
+                }
+
+                $permalink = $this->set_permalink();
+                if ( empty( $permalink ) ) {
+                        return $retval;
+                }
+
+                add_filter( 'rest_url' , array( $this, 'filter_rest_url' ) );
+
+                $retval = '<link rel="alternate" type="application/json+oembed" href="' . esc_url( get_oembed_endpoint_url( $permalink ) ) . '" />' . "\n";
+
+                if ( class_exists( 'SimpleXMLElement' ) ) {
+                        $retval .= '<link rel="alternate" type="text/xml+oembed" href="' . esc_url( get_oembed_endpoint_url( $permalink, 'xml' ) ) . '" />' . "\n";
+                }
+
+                remove_filter( 'rest_url' , array( $this, 'filter_rest_url' ) );
+
+                return $retval;
+        }
+
+        /**
+         * Callback for the API endpoint.
+         *
+         * Returns the JSON object for the item.
+         *
+         * @since 2.5.0
+         *
+         * @param  WP_REST_Request $request Full data about the request.
+         * @return WP_Error|array oEmbed response data or WP_Error on failure.
+         */
+        public function get_item( $request ) {
+                $url = $request['url'];
+
+                $data = false;
+
+                $item_id = (int) $this->validate_url_to_item_id( $url );
+
+                if ( ! empty( $item_id ) ) {
+                        $item = $this->set_oembed_response_data( $item_id );
+
+                        // Create dummy post to piggyback off of get_oembed_response_data()
+                        $post = bp_theme_compat_create_dummy_post( array(
+                                'post_author'  => $item['user_id'],
+                                'post_title'   => $item['title'],
+                                'post_content' => $item['content'],
+
+                                // This passes the get_oembed_response_data() check.
+                                'post_status'  => 'publish'
+                        ) );
+
+                        // Add markers to tell that we're embedding a single activity.
+                        // This is needed for various oEmbed response data filtering.
+                        if ( empty( buddypress()->{$this->slug_endpoint} ) ) {
+                                buddypress()->{$this->slug_endpoint} = new stdClass;
+                        }
+                        buddypress()->{$this->slug_endpoint}->embedurl_in_progress = $url;
+                        buddypress()->{$this->slug_endpoint}->embedid_in_progress  = $item_id;
+
+                        // Save custom route args as well.
+                        $custom_args = array_keys( (array) $this->set_route_args() );
+                        if ( ! empty( $custom_args ) ) {
+                                buddypress()->{$this->slug_endpoint}->embedargs_in_progress = array();
+
+                                foreach( $custom_args as $arg ) {
+                                        if ( isset( $request[ $arg ] ) ) {
+                                                buddypress()->{$this->slug_endpoint}->embedargs_in_progress[ $arg ] = $request[ $arg ];
+                                        }
+                                }
+                        }
+
+                        // Use WP's oEmbed response data function.
+                        $data = get_oembed_response_data( $post, $request['maxwidth'] );
+
+                        // Set custom 'author_url' if we have one.
+                        if ( ! empty( $item['author_url'] ) ) {
+                                $data['author_url'] = $item['author_url'];
+                        }
+                }
+
+                if ( ! $data ) {
+                        return new WP_Error( 'oembed_invalid_url', get_status_header_desc( 404 ), array( 'status' => 404 ) );
+                }
+
+                return $data;
+        }
+
+        /**
+         * Pass our BuddyPress activity permalink for embedding.
+         *
+         * @since 2.5.0
+         *
+         * @see bp_activity_embed_rest_route_callback()
+         *
+         * @param  string $retval Current embed URL
+         * @return string
+         */
+        public function filter_embed_url( $retval ) {
+                if ( false === isset( buddypress()->{$this->slug_endpoint}->embedurl_in_progress ) && ! $this->is_page() ) {
+                        return $retval;
+                }
+
+                $url = $this->is_page() ? $this->set_permalink() : buddypress()->{$this->slug_endpoint}->embedurl_in_progress;
+                $url = trailingslashit( $url );
+
+                // This is for the 'WordPress Embed' block
+                // @see bp_activity_embed_comments_button()
+                if ( 'the_permalink' !== current_filter() ) {
+                        $url = add_query_arg( 'embed', 'true', trailingslashit( $url ) );
+
+                        // Add custom route args to iframe.
+                        if ( ! empty( buddypress()->{$this->slug_endpoint}->embedargs_in_progress ) ) {
+                                foreach( buddypress()->{$this->slug_endpoint}->embedargs_in_progress as $key => $value ) {
+                                        $url = add_query_arg( $key, $value, $url );
+                                }
+                        }
+                }
+
+                return $url;
+        }
+
+        /**
+         * Filters the embed HTML for the default oEmbed fallback HTML.
+         *
+         * @since 2.5.0
+         *
+         * @param  string $retval Current embed HTML
+         * @return string
+         */
+        public function filter_embed_html( $retval ) {
+                if ( false === isset( buddypress()->{$this->slug_endpoint}->embedurl_in_progress ) && ! $this->is_page() ) {
+                        return $retval;
+                }
+
+                $url = $this->set_permalink();
+
+                $item_id = $this->is_page() ? $this->validate_url_to_item_id( $url ) : buddypress()->{$this->slug_endpoint}->embedid_in_progress;
+
+                // Change 'Embedded WordPress Post' to custom title.
+                $custom_title = $this->set_iframe_title( $item_id );
+                if ( ! empty( $custom_title ) ) {
+                        $retval = str_replace( __( 'Embedded WordPress Post' ), esc_attr( $custom_title ), $retval );
+                }
+
+                // Remove default <blockquote>
+                $retval = substr( $retval, strpos( $retval, '</blockquote>' ) + 13 );
+
+                // Set up new fallback HTML
+                // @todo Maybe use KSES?
+                $fallback_html = $this->set_fallback_html( $item_id );
+
+                // Add our custom <blockquote>
+                return $fallback_html . $retval;
+        }
+
+        /**
+         * Append our custom slug endpoint to oEmbed endpoint URL.
+         *
+         * Meant to be used as a filter on 'rest_url' before any call to
+         * {@link get_oembed_endpoint_url()} is used.
+         *
+         * @since 2.5.0
+         *
+         * @see add_oembed_discovery_links()
+         *
+         * @param  string $retval Current oEmbed endpoint URL
+         * @return string
+         */
+        function filter_rest_url( $retval = '' ) {
+                return $retval . "/{$this->slug_endpoint}";
+        }
+
+        /**
+         * Inject activity content into the embed template.
+         *
+         * @since 2.5.0
+         */
+        public function inject_content() {
+                if ( ! $this->is_page() ) {
+                        return;
+                }
+
+                $this->content();
+        }
+}
+ No newline at end of file

new file src/bp-templates/bp-legacy/buddypress/assets/embeds/activity.php

@@ +1 @@
+
+                <?php if ( bp_has_activities( 'display_comments=threaded&show_hidden=true&include=' . bp_current_action() ) ) : ?>
+
+                        <?php while ( bp_activities() ) : bp_the_activity(); ?>
+                                <div class="wp-embed-excerpt"><p><?php bp_activity_embed_excerpt(); ?></p></div>
+
+                                <p class="wp-embed-timestamp"><a href="<?php bp_activity_thread_permalink(); ?>"><?php echo date_i18n( get_option( 'time_format' ) . ' - ' . get_option( 'date_format' ), strtotime( bp_get_activity_date_recorded() ) ); ?></a></p>
+
+                                <?php do_action( 'bp_activity_embed_after_content' ); ?>
+
+                        <?php endwhile; ?>
+
+                <?php endif; ?>
+

new file src/bp-templates/bp-legacy/buddypress/assets/embeds/css.php

@@ +1 @@
+<style type="text/css">
+#wp-embed-header:after {
+        clear: both;
+        content: "";
+        display: table;
+        margin-bottom: 1em;
+}
+
+.wp-embed-avatar {
+        float: left;
+        margin: 0 .75em 0 0;
+}
+
+p.wp-embed-heading {
+        font-size: 16px;
+        margin-bottom: 0;
+}
+
+.wp-embed-excerpt, p.wp-embed-timestamp {
+        margin-bottom: .5em;
+}
+
+.activity-read-more {
+        margin-left: .5em;
+}
+
+.activity-read-more a {
+        color: #b4b9be;
+}
+
+.wp-embed-footer {
+        margin-top: 20px;
+}
+</style>
+ No newline at end of file

new file src/bp-templates/bp-legacy/buddypress/assets/embeds/footer.php

@@ +1 @@
+                        <div class="wp-embed-footer">
+                                <div class="wp-embed-site-title">
+                                        <?php
+                                        $site_title = sprintf(
+                                                '<a href="%s"><img src="%s" srcset="%s 2x" width="32" height="32" alt="" class="wp-embed-site-icon"/><span>%s</span></a>',
+                                                esc_url( home_url() ),
+                                                esc_url( get_site_icon_url( 32, admin_url( 'images/w-logo-blue.png' ) ) ),
+                                                esc_url( get_site_icon_url( 64, admin_url( 'images/w-logo-blue.png' ) ) ),
+                                                esc_html( get_bloginfo( 'name' ) )
+                                        );
+
+                                        /**
+                                         * Filter the site title HTML in the embed footer.
+                                         *
+                                         * @since 4.4.0
+                                         *
+                                         * @param string $site_title The site title HTML.
+                                         */
+                                        echo apply_filters( 'embed_site_title_html', $site_title );
+                                        ?>
+                                </div>
+
+                                <div class="wp-embed-meta">
+                                        <?php
+                                        /**
+                                         * Print additional meta content in the embed template.
+                                         *
+                                         * @since 4.4.0
+                                         */
+                                        do_action( 'embed_content_meta');
+                                        ?>
+                                </div>
+                        </div>
+ No newline at end of file

new file src/bp-templates/bp-legacy/buddypress/assets/embeds/header.php

@@ +1 @@
+
+                <div id="wp-embed-header">
+                        <div class="wp-embed-avatar">
+                                <a href="<?php bp_displayed_user_link(); ?>">
+                                        <?php bp_displayed_user_avatar( 'type=thumb&width=36&height=36' ); ?>
+                                </a>
+                        </div>
+
+                        <p class="wp-embed-heading">
+                                <a href="<?php bp_displayed_user_link(); ?>">
+                                        <?php bp_displayed_user_fullname(); ?>
+                                </a>
+                        </p>
+
+                        <?php if ( bp_is_active( 'activity' ) && bp_activity_do_mentions() ) : ?>
+                                <p class="wp-embed-mentionname">@<?php bp_displayed_user_mentionname(); ?></p>
+                        <?php endif; ?>
+                </div>

new file src/bp-templates/bp-legacy/buddypress/assets/embeds/template.php

@@ +1 @@
+<?php
+/**
+ * Generic embed template used by BuddyPress.
+ *
+ * When a BuddyPress item is embedded in an iframe, this file is used to
+ * create the output.
+ *
+ * This is a modified version of the bundled WordPress embed template
+ * included in WordPress 4.4+.
+ *
+ * @since 2.5.0
+ *
+ * @package BuddyPress
+ * @subpackage Embeds
+ */
+
+if ( ! headers_sent() ) {
+        header( 'X-WP-embed: true' );
+}
+
+?>
+<!DOCTYPE html>
+<html <?php language_attributes(); ?> class="no-js">
+<head>
+        <title><?php echo wp_get_document_title(); ?></title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge">
+        <base target="_top" />
+        <?php
+        /** This action is documented in wp-includes/embed-template.php */
+        do_action( 'embed_head' );
+
+        // This is used by r-a-y for testing purposes at the moment.
+        bp_get_asset_template_part( 'embeds/css' );
+        ?>
+</head>
+<body <?php body_class(); ?>>
+<div <?php post_class( 'wp-embed' ); ?>>
+<?php
+bp_get_asset_template_part( 'embeds/header', bp_current_component() );
+
+/** This action is documented in wp-includes/embed-template.php */
+do_action( 'embed_content' );
+
+bp_get_asset_template_part( 'embeds/footer', bp_current_component() );
+?>
+
+</div>
+
+<?php
+/** This action is documented in wp-includes/embed-template.php */
+do_action( 'embed_footer' );
+?>
+</body>
+</html>
+ No newline at end of file