bp_legacy_theme_ajax_querystring( string $query_string, string $object )
This function looks scarier than it actually is. 🙂 Each object loop (activity/members/groups/blogs/forums) contains default parameters to show specific information based on the page we are currently looking at.
Description Description
The following function will take into account any cookies set in the JS and allow us to override the parameters sent. That way we can change the results returned without reloading the page.
By using cookies we can also make sure that user settings are retained across page loads.
Parameters Parameters
- $query_string
-
(Required) Query string for the current request.
- $object
-
(Required) Object for cookie.
Return Return
(string) Query string for the component loops.
Source Source
File: bp-templates/bp-legacy/buddypress-functions.php
function bp_legacy_theme_ajax_querystring( $query_string, $object ) { if ( empty( $object ) ) return ''; // Set up the cookies passed on this AJAX request. Store a local var to avoid conflicts. if ( ! empty( $_POST['cookie'] ) ) { $_BP_COOKIE = wp_parse_args( str_replace( '; ', '&', urldecode( $_POST['cookie'] ) ) ); } else { $_BP_COOKIE = &$_COOKIE; } $qs = array(); /** * Check if any cookie values are set. If there are then override the * default params passed to the template loop. */ // Activity stream filtering on action. if ( ! empty( $_BP_COOKIE['bp-' . $object . '-filter'] ) && '-1' != $_BP_COOKIE['bp-' . $object . '-filter'] ) { $qs[] = 'type=' . urlencode( $_BP_COOKIE['bp-' . $object . '-filter'] ); if ( bp_is_active( 'activity' ) ) { $actions = bp_activity_get_actions_for_context(); // Handle multiple actions (eg. 'friendship_accepted,friendship_created') $action_filter = explode( ',', $_BP_COOKIE['bp-' . $object . '-filter'] ); // See if action filter matches registered actions. If so, add it to qs. if ( ! array_diff( $action_filter, wp_list_pluck( $actions, 'key' ) ) ) { $qs[] = 'action=' . join( ',', $action_filter ); } } } if ( ! empty( $_BP_COOKIE['bp-' . $object . '-scope'] ) ) { if ( 'personal' == $_BP_COOKIE['bp-' . $object . '-scope'] ) { $user_id = ( bp_displayed_user_id() ) ? bp_displayed_user_id() : bp_loggedin_user_id(); $qs[] = 'user_id=' . $user_id; } // Activity stream scope only on activity directory. if ( 'all' != $_BP_COOKIE['bp-' . $object . '-scope'] && ! bp_displayed_user_id() && ! bp_is_single_item() ) $qs[] = 'scope=' . urlencode( $_BP_COOKIE['bp-' . $object . '-scope'] ); } // If page and search_terms have been passed via the AJAX post request, use those. if ( ! empty( $_POST['page'] ) && '-1' != $_POST['page'] ) $qs[] = 'page=' . absint( $_POST['page'] ); // Excludes activity just posted and avoids duplicate ids. if ( ! empty( $_POST['exclude_just_posted'] ) ) { $just_posted = wp_parse_id_list( $_POST['exclude_just_posted'] ); $qs[] = 'exclude=' . implode( ',', $just_posted ); } // To get newest activities. if ( ! empty( $_POST['offset'] ) ) { $qs[] = 'offset=' . intval( $_POST['offset'] ); } $object_search_text = bp_get_search_default_text( $object ); if ( ! empty( $_POST['search_terms'] ) && is_string( $_POST['search_terms'] ) && $object_search_text != $_POST['search_terms'] && 'false' != $_POST['search_terms'] && 'undefined' != $_POST['search_terms'] ) $qs[] = 'search_terms=' . urlencode( $_POST['search_terms'] ); // Now pass the querystring to override default values. $query_string = empty( $qs ) ? '' : join( '&', (array) $qs ); $object_filter = ''; if ( isset( $_BP_COOKIE['bp-' . $object . '-filter'] ) ) $object_filter = $_BP_COOKIE['bp-' . $object . '-filter']; $object_scope = ''; if ( isset( $_BP_COOKIE['bp-' . $object . '-scope'] ) ) $object_scope = $_BP_COOKIE['bp-' . $object . '-scope']; $object_page = ''; if ( isset( $_BP_COOKIE['bp-' . $object . '-page'] ) ) $object_page = $_BP_COOKIE['bp-' . $object . '-page']; $object_search_terms = ''; if ( isset( $_BP_COOKIE['bp-' . $object . '-search-terms'] ) ) $object_search_terms = $_BP_COOKIE['bp-' . $object . '-search-terms']; $object_extras = ''; if ( isset( $_BP_COOKIE['bp-' . $object . '-extras'] ) ) $object_extras = $_BP_COOKIE['bp-' . $object . '-extras']; /** * Filters the AJAX query string for the component loops. * * @since 1.7.0 * * @param string $query_string The query string we are working with. * @param string $object The type of page we are on. * @param string $object_filter The current object filter. * @param string $object_scope The current object scope. * @param string $object_page The current object page. * @param string $object_search_terms The current object search terms. * @param string $object_extras The current object extras. */ return apply_filters( 'bp_legacy_theme_ajax_querystring', $query_string, $object, $object_filter, $object_scope, $object_page, $object_search_terms, $object_extras ); }
Changelog Changelog
Version | Description |
---|---|
1.2.0 | Introduced. |