Changeset 13436 for trunk/src/bp-core/deprecated/12.0.php

Timestamp:

03/15/2023 08:16:46 AM (2 years ago)

Author:

imath

Message:

Make more BuddyPress generated links ready for BP Rewrites

• Improve the Members component adding permastructs and custom rewrite

rules for registration and activation pages.

• Improve the Blogs component adding custom rewrite rule to handle the

Blogs create page.

• Make a huge progress about replacing all occurrences of

bp_get_root_domain() (45 replacements were performed).

• Deprecate bp_groups_directory_permalink(),

bp_get_groups_directory_permalink(), bp_blogs_directory_permalink() &
bp_get_blogs_directory_permalink() and replace them with these new
functions: bp_groups_directory_url(), bp_get_groups_directory_url(),
bp_blogs_directory_url() & bp_get_blogs_directory_url().

• Although bp_loggedin_user_domain() & bp_displayed_user_domain()

should also be deprecated, we're leaving them as aliases of the right
functions to use. Plugin authors shouldn't use them to build other links
than member's profile home url.

NB: these deprecations are required because these functions were used
to build BuddyPress URLs concatenating URL chunks. Once the BP Classic
plugin will be built we will adapt the code to remove these deprecation
notices.

Props r-a-y, johnjamesjacoby, boonebgorges

Closes ​https://github.com/buddypress/buddypress/pull/73
See #4954

File:

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

trunk/src/bp-core/deprecated/12.0.php

@@ -242 +242 @@
     return apply_filters_deprecated( 'bp_core_get_user_domain', array( $domain, $user_id, $user_nicename, $user_login), '12.0.0', 'bp_members_get_user_url' );
 }
+
+/**
+ * Get the link for the logged-in user's profile.
+ *
+ * @since 1.0.0
+ * @deprecated 12.0.0
+ *
+ * @return string
+ */
+function bp_get_loggedin_user_link() {
+    _deprecated_function( __FUNCTION__, '12.0.0', 'bp_loggedin_user_url()' );
+    $url = bp_loggedin_user_url();
+
+    /**
+     * Filters the link for the logged-in user's profile.
+     *
+     * @since 1.2.4
+     * @deprecated 12.0.0
+     *
+     * @param string $url Link for the logged-in user's profile.
+     */
+    return apply_filters_deprecated( 'bp_get_loggedin_user_link', array( $url ), '12.0.0', 'bp_loggedin_user_url' );
+}
+
+/**
+ * Get the link for the displayed user's profile.
+ *
+ * @since 1.0.0
+ * @deprecated 12.0.0
+ *
+ * @return string
+ */
+function bp_get_displayed_user_link() {
+    _deprecated_function( __FUNCTION__, '12.0.0', 'bp_displayed_user_url()' );
+    $url = bp_displayed_user_url();
+
+    /**
+     * Filters the link for the displayed user's profile.
+     *
+     * @since 1.2.4
+     * @deprecated 12.0.0
+     *
+     * @param string $url Link for the displayed user's profile.
+     */
+    return apply_filters_deprecated( 'bp_get_displayed_user_link', array( $url ), '12.0.0', 'bp_displayed_user_url' );
+}
+
+/**
+ * Alias of {@link bp_displayed_user_domain()}.
+ *
+ * @deprecated 12.0.0
+ */
+function bp_user_link() {
+    _deprecated_function( __FUNCTION__, '12.0.0', 'bp_displayed_user_url()' );
+    bp_displayed_user_url();
+}
+
+/**
+ * Output blog directory permalink.
+ *
+ * @since 1.5.0
+ * @deprecated 12.0.0
+ */
+function bp_blogs_directory_permalink() {
+    _deprecated_function( __FUNCTION__, '12.0.0', 'bp_blogs_directory_url()' );
+    bp_blogs_directory_url();
+}
+
+/**
+ * Return blog directory permalink.
+ *
+ * @since 1.5.0
+ * @deprecated 12.0.0
+ *
+ * @return string The URL of the Blogs directory.
+ */
+function bp_get_blogs_directory_permalink() {
+    _deprecated_function( __FUNCTION__, '12.0.0', 'bp_get_blogs_directory_url()' );
+    $url = bp_get_blogs_directory_url();
+
+    /**
+     * Filters the blog directory permalink.
+     *
+     * @since 1.5.0
+     * @deprecated 12.0.0
+     *
+     * @param string $url Permalink URL for the blog directory.
+     */
+    return apply_filters_deprecated( 'bp_get_blogs_directory_permalink', array( $url ), '12.0.0', 'bp_get_blogs_directory_url' );
+}