Changeset 9622

Timestamp:

03/17/2015 06:05:20 PM (10 years ago)

Author:

imath

Message:

Introduces the BuddyPress Attachments API

BP_Attachment is a new class custom and core components can extend to manage file uploads.

• It is taking care of setting the uploads data (path, url..)
• It is creating the specific base uploads directory for the component if requested
• It is taking care of uploading the files into the uploads directory
• Custom validation rules can be set in order to for instance: restrict mime types or file size
• If, like avatars, cropping an image file is needed, the class includes a crop method to help you.

bp_upload_dir() is also a new function to make sure the uploads data will always be the one of the site BuddyPress is activated on (the root site).

Props johnjamesjacoby, boonebgorges

See #6278

Location:

trunk/src/bp-core

Files:

• bp-core-classes.php (modified) (1 diff)
• bp-core-functions.php (modified) (1 diff)
• classes/class-bp-attachment.php (added)

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

@@ -22 +22 @@
 require dirname( __FILE__ ) . '/classes/class-bp-recursive-query.php';
 require dirname( __FILE__ ) . '/classes/class-bp-media-extractor.php';
+require dirname( __FILE__ ) . '/classes/class-bp-attachment.php';

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

@@ -2148 +2148 @@
     return apply_filters( 'bp_core_get_suggestions', $retval, $args );
 }
+
+/**
+ * Set data from the BP root blog's upload directory.
+ *
+ * Handy for multisite instances because all uploads are made on the BP root
+ * blog and we need to query the BP root blog for the upload directory data.
+ *
+ * This function ensures that we only need to use {@link switch_to_blog()}
+ * once to get what we need.
+ *
+ * @since BuddyPress (2.3.0)
+ *
+ * @uses  is_multisite()
+ * @uses  bp_is_root_blog()
+ * @uses  switch_to_blog()
+ * @uses  wp_upload_dir()
+ * @uses  restore_current_blog()
+ */
+function bp_upload_dir() {
+    $bp = buddypress();
+
+    if ( empty( $bp->upload_dir ) ) {
+        $need_switch = (bool) ( is_multisite() && ! bp_is_root_blog() );
+
+        // Maybe juggle to root blog
+        if ( true === $need_switch ) {
+            switch_to_blog( bp_get_root_blog_id() );
+        }
+
+        // Get the upload directory (maybe for root blog)
+        $wp_upload_dir = wp_upload_dir();
+
+        // Maybe juggle back to current blog
+        if ( true === $need_switch ) {
+            restore_current_blog();
+        }
+
+        // Bail if an error occurred
+        if ( ! empty( $wp_upload_dir['error'] ) ) {
+            return false;
+        }
+
+        $bp->upload_dir = $wp_upload_dir;
+    }
+
+    return $bp->upload_dir;
+}