Changeset 13184 for trunk/src/bp-blogs/bp-blogs-template.php

Timestamp:

12/12/2021 02:09:02 PM (4 years ago)

Author:

imath

Message:

Support date queries for Members, Groups and Sites

According to components, date queries can be restricted to a limited list of loop types:

• For Members, the $type parameter in bp_has_members() needs to be either active, newest, random or online.
• For Groups, the $type parameter in bp_has_groups() needs to be either active or newest.
• For sites, the $type parameter in bp_has_blogs() needs to be either active or newest.

Props r-a-y

Fixes #8488

File:

• trunk/src/bp-blogs/bp-blogs-template.php (modified) (5 diffs)

trunk/src/bp-blogs/bp-blogs-template.php

@@ -112 +112 @@
  * Based on the $args passed, bp_has_blogs() populates the $blogs_template
  * global, enabling the use of BuddyPress templates and template functions to
- * display a list of activity items.
+ * display a list of blogs.
+ *
+ * @since 1.0.0
+ * @since 1.2.0 Added $type, $page, $search_terms parameters
+ * @since 1.6.0 Added $page_arg parameter
+ * @since 2.0.0 Added $include_blog_ids, $update_meta_cache parameters
+ * @since 10.0.0 Added $date_query parameter
  *
  * @global BP_Blogs_Template $blogs_template {@link BP_Blogs_Template}
@@ -122 +128 @@
  *     and because bp_has_blogs() determines some default arguments in a
  *     dynamic fashion, we list all accepted arguments here as well.
- *
- *     Arguments can be passed as an associative array, or as a URL query
- *     string (eg, 'user_id=4&per_page=3').
  *
  *     @type int      $page             Which page of results to fetch. Using page=1 without
@@ -141 +144 @@
  *                                      When viewing a user profile page, 'user_id' defaults to the
  *                                      ID of the displayed user. Otherwise the default is false.
+ *     @type array    $date_query       Filter results by site last activity date. See first parameter of
+ *                                      {@link WP_Date_Query::__construct()} for syntax. Only applicable if
+ *                                      $type is either 'newest' or 'active'.
  * }
  * @return bool Returns true when blogs are found, otherwise false.
@@ -168 +174 @@
             'include_blog_ids'  => false,
             'search_terms'      => $search_terms_default,
+            'date_query'        => false,
             'update_meta_cache' => true,
         ),
@@ -179 +186 @@
 
     // Get the blogs.
-    $blogs_template = new BP_Blogs_Template( $r['type'], $r['page'], $r['per_page'], $r['max'], $r['user_id'], $r['search_terms'], $r['page_arg'], $r['update_meta_cache'], $r['include_blog_ids'] );
+    $blogs_template = new BP_Blogs_Template( $r );
 
     /**