Changeset 14026 for trunk/src/class-buddypress.php

Timestamp:

09/27/2024 09:11:27 PM (15 months ago)

Author:

espellcaste

Message:

Include the V2 of the BP REST API in BuddyPress core.

We are officially deprecating the V1 of the BP REST API. And bundling the new, default, V2 of the BP REST API inside BuddyPress core. Previously, the V1 was developed as a plugin in a separate repo (​https://github.com/buddypress/BP-REST).

• One of the main differences between the V1 and V2 is how objects are returned. Single items are no longer returned as an array;
• We have a new BP_Test_REST_Controller_Testcase for testing the new API endpoints;
• We changed the names of our controllers to follow our autoloader rules;
• Removed the BP-REST plugin from wp-env and from our release script;
• And we added notices for the deprecated V1 API (endpoints and files).

Props imath & I. ;)

Fixes #8200
See #9145
Closes ​https://github.com/buddypress/buddypress/pull/337

File:

• trunk/src/class-buddypress.php (modified) (6 diffs)

trunk/src/class-buddypress.php

@@ -657 +657 @@
                 require $this->plugin_dir . sprintf( 'bp-core/deprecated/%s.php', number_format( $deprecated_functions_version, 1 ) );
             }
-        }
+        }
 
         // Load wp-cli module if PHP 5.6+.
@@ -674 +674 @@
      * @since 2.5.0
      *
-     * @param string $class Classes to be autoloaded.
-     * @return string Path of a class.
-     */
-    public function autoload( $class ) {
-        $class_parts = explode( '_', strtolower( $class ) );
+     * @param string $class_name Classes to be autoloaded.
+     */
+    public function autoload( $class_name ) {
+        $class_parts = explode( '_', strtolower( $class_name ) );
 
         if ( 'bp' !== $class_parts[0] ) {
@@ -699 +698 @@
         // These classes don't have a name that matches their component.
         $irregular_map = array(
-            'BP_Akismet'                                 => 'activity',
-            'BP_REST_Activity_Endpoint'                  => 'activity',
-
-            'BP_REST_Blogs_Endpoint'                     => 'blogs',
-            'BP_REST_Attachments_Blog_Avatar_Endpoint'   => 'blogs',
-
-            'BP_Admin'                                   => 'core',
-            'BP_Attachment_Avatar'                       => 'core',
-            'BP_Attachment_Cover_Image'                  => 'core',
-            'BP_Attachment'                              => 'core',
-            'BP_Button'                                  => 'core',
-            'BP_Block'                                   => 'core',
-            'BP_Component'                               => 'core',
-            'BP_Customizer_Control_Range'                => 'core',
-            'BP_Date_Query'                              => 'core',
-            'BP_Email_Delivery'                          => 'core',
-            'BP_Email_Address'                           => 'core',
-            'BP_Email_Recipient'                         => 'core',
-            'BP_Email_Sender'                            => 'core',
-            'BP_Email_Participant'                       => 'core',
-            'BP_Email'                                   => 'core',
-            'BP_Embed'                                   => 'core',
-            'BP_Media_Extractor'                         => 'core',
-            'BP_Members_Suggestions'                     => 'core',
-            'BP_PHPMailer'                               => 'core',
-            'BP_Recursive_Query'                         => 'core',
-            'BP_Suggestions'                             => 'core',
-            'BP_Theme_Compat'                            => 'core',
-            'BP_User_Query'                              => 'core',
-            'BP_Walker_Category_Checklist'               => 'core',
-            'BP_Walker_Nav_Menu'                         => 'core',
-            'BP_Invitation_Manager'                      => 'core',
-            'BP_Invitation'                              => 'core',
-            'BP_REST_Components_Endpoint'                => 'core',
-            'BP_REST_Attachments'                        => 'core',
-            'BP_Admin_Types'                             => 'core',
-            'BP_Optout'                                  => 'core',
-            'BP_Optouts_List_Table'                      => 'core',
-
-            'BP_REST_Friends_Endpoint'                   => 'friends',
-
-            'BP_Group_Extension'                         => 'groups',
-            'BP_Group_Member_Query'                      => 'groups',
-            'BP_REST_Groups_Endpoint'                    => 'groups',
-            'BP_REST_Group_Membership_Endpoint'          => 'groups',
-            'BP_REST_Group_Invites_Endpoint'             => 'groups',
-            'BP_REST_Group_Membership_Request_Endpoint'  => 'groups',
-            'BP_REST_Attachments_Group_Avatar_Endpoint'  => 'groups',
-            'BP_REST_Attachments_Group_Cover_Endpoint'   => 'groups',
-
-            'BP_Core_Members_Template'                   => 'members',
-            'BP_Registration_Theme_Compat'               => 'members',
-            'BP_Signup'                                  => 'members',
-            'BP_REST_Members_Endpoint'                   => 'members',
-            'BP_REST_Attachments_Member_Avatar_Endpoint' => 'members',
-            'BP_REST_Attachments_Member_Cover_Endpoint'  => 'members',
-            'BP_REST_Signup_Endpoint'                    => 'members',
-            'BP_Members_Invitation_Manager'              => 'members',
-            'BP_Members_Invitations_Template'            => 'members',
-            'BP_Members_Invitations_Component'           => 'members',
-
-            'BP_REST_Messages_Endpoint'                  => 'messages',
-            'BP_REST_Sitewide_Notices_Endpoint'          => 'messages',
-
-            'BP_REST_Notifications_Endpoint'             => 'notifications',
-
-            'BP_REST_XProfile_Fields_Endpoint'           => 'xprofile',
-            'BP_REST_XProfile_Field_Groups_Endpoint'     => 'xprofile',
-            'BP_REST_XProfile_Data_Endpoint'             => 'xprofile',
+            'BP_Akismet'                       => 'activity',
+            'BP_Admin'                         => 'core',
+            'BP_Attachment_Avatar'             => 'core',
+            'BP_Attachment_Cover_Image'        => 'core',
+            'BP_Attachment'                    => 'core',
+            'BP_Button'                        => 'core',
+            'BP_Block'                         => 'core',
+            'BP_Component'                     => 'core',
+            'BP_Customizer_Control_Range'      => 'core',
+            'BP_Date_Query'                    => 'core',
+            'BP_Email_Delivery'                => 'core',
+            'BP_Email_Address'                 => 'core',
+            'BP_Email_Recipient'               => 'core',
+            'BP_Email_Sender'                  => 'core',
+            'BP_Email_Participant'             => 'core',
+            'BP_Email'                         => 'core',
+            'BP_Embed'                         => 'core',
+            'BP_Media_Extractor'               => 'core',
+            'BP_Members_Suggestions'           => 'core',
+            'BP_PHPMailer'                     => 'core',
+            'BP_Recursive_Query'               => 'core',
+            'BP_Suggestions'                   => 'core',
+            'BP_Theme_Compat'                  => 'core',
+            'BP_User_Query'                    => 'core',
+            'BP_Walker_Category_Checklist'     => 'core',
+            'BP_Walker_Nav_Menu'               => 'core',
+            'BP_Invitation_Manager'            => 'core',
+            'BP_Invitation'                    => 'core',
+            'BP_REST_Attachments'              => 'core',
+            'BP_Admin_Types'                   => 'core',
+            'BP_Optout'                        => 'core',
+            'BP_Optouts_List_Table'            => 'core',
+            'BP_Group_Extension'               => 'groups',
+            'BP_Group_Member_Query'            => 'groups',
+            'BP_Core_Members_Template'         => 'members',
+            'BP_Registration_Theme_Compat'     => 'members',
+            'BP_Signup'                        => 'members',
+            'BP_Members_Invitation_Manager'    => 'members',
+            'BP_Members_Invitations_Template'  => 'members',
+            'BP_Members_Invitations_Component' => 'members',
         );
 
@@ -773 +743 @@
 
         // First check to see if the class is one without a properly namespaced name.
-        if ( isset( $irregular_map[ $class ] ) ) {
-            $component = $irregular_map[ $class ];
-
-        // Next chunk is usually the component name.
+        if ( isset( $irregular_map[ $class_name ] ) ) {
+            $component = $irregular_map[ $class_name ];
+
+            // Next chunk is usually the component name.
         } elseif ( in_array( $class_parts[1], $components, true ) ) {
             $component = $class_parts[1];
@@ -786 +756 @@
 
         // Sanitize class name.
-        $class = strtolower( str_replace( '_', '-', $class ) );
+        $class = strtolower( str_replace( '_', '-', $class_name ) );
 
         if ( 'bp-rest-attachments' === $class ) {
-            $path = dirname( __FILE__ ) . "/bp-{$component}/classes/trait-attachments.php";
+            $path = __DIR__ . "/bp-{$component}/classes/trait-attachments.php";
         } else {
-            $path = dirname( __FILE__ ) . "/bp-{$component}/classes/class-{$class}.php";
+            $path = __DIR__ . "/bp-{$component}/classes/class-{$class}.php";
         }
 
@@ -878 +848 @@
             $this->db_version_raw = (int) $versions['1.6-single'];
 
-        // If no 1.6-single exists, use the max of the others.
+            // If no 1.6-single exists, use the max of the others.
         } else {
             $versions['1.2']        = get_site_option( 'bp-core-db-version' );