Changeset 13507 for trunk/src/bp-core/classes/class-bp-core-bp-nav-backcompat.php

Timestamp:

06/25/2023 05:18:41 PM (2 years ago)

Author:

imath

Message:

Fully deprecate bp_nav & bp_options_nav BP globals

These back compatibility mechanism, which was in BP since version 2.6, has moved to the BP Classic plugin.

Fixes #8927
Closes ​https://github.com/buddypress/buddypress/pull/121

File:

• trunk/src/bp-core/classes/class-bp-core-bp-nav-backcompat.php (modified) (19 diffs)

trunk/src/bp-core/classes/class-bp-core-bp-nav-backcompat.php

@@ -4 +4 @@
  *
  * @since 2.6.0
+ * @deprecated 12.0.0
  */
 
@@ -16 +17 @@
  *
  * @since 2.6.0
+ * @deprecated 12.0.0
  */
 class BP_Core_BP_Nav_BackCompat implements ArrayAccess {
@@ -57 +59 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -68 +71 @@
             '2.6.0'
         );
-
-        $bp = buddypress();
-
-        if ( is_array( $value ) ) {
-            $value = new self( $value );
-        }
-
-        if ( $offset !== null ) {
-            // Temporarily set the backcompat_nav.
-            $this->backcompat_nav[ $offset ] = $value;
-
-            $args = $this->to_array();
-            if ( isset( $args['parent_slug'] ) ) {
-                $this->get_component_nav( $args['parent_slug'] )->edit_nav( $args, $args['slug'], $args['parent_slug'] );
-            } elseif ( isset( $args['slug'] ) ) {
-                $bp->members->nav->edit_nav( $args, $args['slug'] );
-            }
-        }
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -92 +78 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -103 +90 @@
             '2.6.0'
         );
-
-        $nav = $this->get_nav( $offset );
-        if ( $nav && isset( $nav[ $offset ] ) ) {
-            $this->backcompat_nav[ $offset ] = new self( $nav[ $offset ] );
-        }
-
-        return $this->backcompat_nav[ $offset ];
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -116 +97 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -127 +109 @@
             '2.6.0'
         );
-
-        if ( isset( $this->backcompat_nav[ $offset ] ) ) {
-            return true;
-        }
-
-        $nav = $this->get_nav( $offset );
-        if ( $nav && isset( $nav[ $offset ] ) ) {
-            return true;
-        }
-
-        return false;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -144 +116 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -154 +127 @@
             '2.6.0'
         );
-
-        // For top-level nav items, the backcompat nav hasn't yet been initialized.
-        if ( ! isset( $this->backcompat_nav[ $offset ] ) ) {
-            buddypress()->members->nav->delete_nav( $offset );
-            unset( $this->backcompat_nav[ $offset ] );
-        }
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -166 +134 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param string $component
      */
     public function set_component( $component ) {
-        $this->component = $component;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -181 +150 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -186 +156 @@
      */
     public function get_component( $offset = '' ) {
-        if ( ! isset( $this->component ) ) {
-            if ( bp_is_active( 'groups' ) && $offset === bp_get_current_group_slug() ) {
-                $this->component = 'groups';
-            } else {
-                $this->component = 'members';
-            }
-        }
-
-        return $this->component;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -203 +165 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      */
     public function reset() {
-        $this->backcompat_nav = array();
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -212 +175 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param mixed $offset Array offset.
@@ -217 +181 @@
      */
     protected function get_nav( $offset ) {
-        $component_nav = $this->get_component_nav( $offset );
-        $primary_nav   = $component_nav->get_primary( array( 'slug' => $offset ), false );
-
-        $nav = array();
-
-        if ( empty( $primary_nav ) ) {
-            return $nav;
-        }
-
-        foreach ( $primary_nav as $item ) {
-            $nav[ $item->slug ] = (array) $item;
-        }
-
-        return $nav;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -243 +194 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @param string $offset Nav item name.
@@ -248 +200 @@
      */
     protected function get_component_nav( $offset = '' ) {
-        $component = $this->get_component( $offset );
-
-        $bp = buddypress();
-        if ( ! isset( $bp->{$component}->nav ) ) {
-            return false;
-        }
-
-        return $bp->{$component}->nav;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 
@@ -262 +207 @@
      *
      * @since 2.6.0
+     * @deprecated 12.0.0
      *
      * @return array
      */
     protected function to_array() {
-        return $this->backcompat_nav;
+        _deprecated_function( __METHOD__, '12.0.0' );
     }
 }