Changeset 10834

Timestamp:

05/31/2016 06:58:43 AM (9 years ago)

Author:

r-a-y

Message:

Core: Introduce bp_core_extract_media_from_content().

This is a convenience function to access the BP_Media_Extractor class,
which was made available in BuddyPress 2.3.0.

See #6177.

File:

• trunk/src/bp-core/bp-core-functions.php (modified) (1 diff)

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

@@ -1667 +1667 @@
      */
     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.6.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;
 }