| [ Index ] |
PHP Cross Reference of BuddyPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * BuddyPress Groups Template loop class. 4 * 5 * @package BuddyPress 6 * @since 1.2.0 7 */ 8 9 // Exit if accessed directly. 10 defined( 'ABSPATH' ) || exit; 11 12 /** 13 * The main Groups template loop class. 14 * 15 * Responsible for loading a group of groups into a loop for display. 16 * 17 * @since 1.2.0 18 */ 19 class BP_Groups_Template { 20 21 /** 22 * The loop iterator. 23 * 24 * @var int 25 * @since 1.2.0 26 */ 27 public $current_group = -1; 28 29 /** 30 * The number of groups returned by the paged query. 31 * 32 * @var int 33 * @since 1.2.0 34 */ 35 public $group_count; 36 37 /** 38 * Array of groups located by the query. 39 * 40 * @var array 41 * @since 1.2.0 42 */ 43 public $groups; 44 45 /** 46 * The group object currently being iterated on. 47 * 48 * @var object 49 * @since 1.2.0 50 */ 51 public $group; 52 53 /** 54 * A flag for whether the loop is currently being iterated. 55 * 56 * @var bool 57 * @since 1.2.0 58 */ 59 public $in_the_loop; 60 61 /** 62 * The page number being requested. 63 * 64 * @var string 65 * @since 1.2.0 66 */ 67 public $pag_page; 68 69 /** 70 * The number of items being requested per page. 71 * 72 * @var string 73 * @since 1.2.0 74 */ 75 public $pag_num; 76 77 /** 78 * An HTML string containing pagination links. 79 * 80 * @var string 81 * @since 1.2.0 82 */ 83 public $pag_links; 84 85 /** 86 * The total number of groups matching the query parameters. 87 * 88 * @var int 89 * @since 1.2.0 90 */ 91 public $total_group_count; 92 93 /** 94 * Whether the template loop is for a single group page. 95 * 96 * @var bool 97 * @since 1.2.0 98 */ 99 public $single_group = false; 100 101 /** 102 * Field to sort by. 103 * 104 * @var string 105 * @since 1.2.0 106 */ 107 public $sort_by; 108 109 /** 110 * Sort order. 111 * 112 * @var string 113 * @since 1.2.0 114 */ 115 public $order; 116 117 /** 118 * Constructor method. 119 * 120 * @see BP_Groups_Group::get() for an in-depth description of arguments. 121 * 122 * @param array $args { 123 * Array of arguments. Accepts all arguments accepted by 124 * {@link BP_Groups_Group::get()}. In cases where the default 125 * values of the params differ, they have been discussed below. 126 * @type int $per_page Default: 20. 127 * @type int $page Default: 1. 128 * } 129 */ 130 function __construct( $args = array() ){ 131 $function_args = func_get_args(); 132 133 // Backward compatibility with old method of passing arguments. 134 if ( ! is_array( $args ) || count( $function_args ) > 1 ) { 135 _deprecated_argument( __METHOD__, '1.7', sprintf( __( 'Arguments passed to %1$s should be in an associative array. See the inline documentation at %2$s for more details.', 'buddypress' ), __METHOD__, __FILE__ ) ); 136 137 $old_args_keys = array( 138 0 => 'user_id', 139 1 => 'type', 140 2 => 'page', 141 3 => 'per_page', 142 4 => 'max', 143 5 => 'slug', 144 6 => 'search_terms', 145 7 => 'populate_extras', 146 8 => 'include', 147 9 => 'exclude', 148 10 => 'show_hidden', 149 11 => 'page_arg', 150 ); 151 152 $args = bp_core_parse_args_array( $old_args_keys, $function_args ); 153 } 154 155 $defaults = array( 156 'page' => 1, 157 'per_page' => 20, 158 'page_arg' => 'grpage', 159 'max' => false, 160 'type' => 'active', 161 'order' => 'DESC', 162 'orderby' => 'date_created', 163 'show_hidden' => false, 164 'user_id' => 0, 165 'slug' => false, 166 'include' => false, 167 'exclude' => false, 168 'parent_id' => null, 169 'search_terms' => '', 170 'search_columns' => array(), 171 'group_type' => '', 172 'group_type__in' => '', 173 'group_type__not_in' => '', 174 'status' => array(), 175 'meta_query' => false, 176 'update_meta_cache' => true, 177 'update_admin_cache' => false, 178 ); 179 180 $r = bp_parse_args( 181 $args, 182 $defaults, 183 'groups_template' 184 ); 185 186 extract( $r ); 187 188 $this->pag_arg = sanitize_key( $r['page_arg'] ); 189 $this->pag_page = bp_sanitize_pagination_arg( $this->pag_arg, $r['page'] ); 190 $this->pag_num = bp_sanitize_pagination_arg( 'num', $r['per_page'] ); 191 192 if ( bp_current_user_can( 'bp_moderate' ) || ( is_user_logged_in() && $user_id == bp_loggedin_user_id() ) ) { 193 $show_hidden = true; 194 } 195 196 if ( 'invites' == $type ) { 197 $this->groups = groups_get_invites_for_user( $user_id, $this->pag_num, $this->pag_page, $exclude ); 198 } elseif ( 'single-group' == $type ) { 199 $this->single_group = true; 200 201 if ( groups_get_current_group() ) { 202 $group = groups_get_current_group(); 203 204 } else { 205 $group = groups_get_group( BP_Groups_Group::get_id_from_slug( $r['slug'] ) ); 206 } 207 208 // Backwards compatibility - the 'group_id' variable is not part of the 209 // BP_Groups_Group object, but we add it here for devs doing checks against it 210 // 211 // @see https://buddypress.trac.wordpress.org/changeset/3540 212 // 213 // this is subject to removal in a future release; devs should check against 214 // $group->id instead. 215 $group->group_id = $group->id; 216 217 $this->groups = array( $group ); 218 219 } else { 220 $this->groups = groups_get_groups( array( 221 'type' => $type, 222 'order' => $order, 223 'orderby' => $orderby, 224 'per_page' => $this->pag_num, 225 'page' => $this->pag_page, 226 'user_id' => $user_id, 227 'search_terms' => $search_terms, 228 'search_columns' => $search_columns, 229 'meta_query' => $meta_query, 230 'group_type' => $group_type, 231 'group_type__in' => $group_type__in, 232 'group_type__not_in' => $group_type__not_in, 233 'status' => $status, 234 'include' => $include, 235 'exclude' => $exclude, 236 'parent_id' => $parent_id, 237 'update_meta_cache' => $update_meta_cache, 238 'update_admin_cache' => $update_admin_cache, 239 'show_hidden' => $show_hidden, 240 ) ); 241 } 242 243 if ( 'invites' == $type ) { 244 $this->total_group_count = (int) $this->groups['total']; 245 $this->group_count = (int) $this->groups['total']; 246 $this->groups = $this->groups['groups']; 247 } elseif ( 'single-group' == $type ) { 248 if ( empty( $group->id ) ) { 249 $this->total_group_count = 0; 250 $this->group_count = 0; 251 } else { 252 $this->total_group_count = 1; 253 $this->group_count = 1; 254 } 255 } else { 256 if ( empty( $max ) || $max >= (int) $this->groups['total'] ) { 257 $this->total_group_count = (int) $this->groups['total']; 258 } else { 259 $this->total_group_count = (int) $max; 260 } 261 262 $this->groups = $this->groups['groups']; 263 264 if ( !empty( $max ) ) { 265 if ( $max >= count( $this->groups ) ) { 266 $this->group_count = count( $this->groups ); 267 } else { 268 $this->group_count = (int) $max; 269 } 270 } else { 271 $this->group_count = count( $this->groups ); 272 } 273 } 274 275 // Build pagination links. 276 if ( (int) $this->total_group_count && (int) $this->pag_num ) { 277 $pag_args = array( 278 $this->pag_arg => '%#%' 279 ); 280 281 if ( defined( 'DOING_AJAX' ) && true === (bool) DOING_AJAX ) { 282 $base = remove_query_arg( 's', wp_get_referer() ); 283 } else { 284 $base = ''; 285 } 286 287 $add_args = array( 288 'num' => $this->pag_num, 289 'sortby' => $this->sort_by, 290 'order' => $this->order, 291 ); 292 293 if ( ! empty( $search_terms ) ) { 294 $query_arg = bp_core_get_component_search_query_arg( 'groups' ); 295 $add_args[ $query_arg ] = urlencode( $search_terms ); 296 } 297 298 $this->pag_links = paginate_links( array( 299 'base' => add_query_arg( $pag_args, $base ), 300 'format' => '', 301 'total' => ceil( (int) $this->total_group_count / (int) $this->pag_num ), 302 'current' => $this->pag_page, 303 'prev_text' => _x( '←', 'Group pagination previous text', 'buddypress' ), 304 'next_text' => _x( '→', 'Group pagination next text', 'buddypress' ), 305 'mid_size' => 1, 306 'add_args' => $add_args, 307 ) ); 308 } 309 } 310 311 /** 312 * Whether there are groups available in the loop. 313 * 314 * @since 1.2.0 315 * 316 * @see bp_has_groups() 317 * 318 * @return bool True if there are items in the loop, otherwise false. 319 */ 320 function has_groups() { 321 if ( $this->group_count ) { 322 return true; 323 } 324 325 return false; 326 } 327 328 /** 329 * Set up the next group and iterate index. 330 * 331 * @since 1.2.0 332 * 333 * @return object The next group to iterate over. 334 */ 335 function next_group() { 336 $this->current_group++; 337 $this->group = $this->groups[$this->current_group]; 338 339 return $this->group; 340 } 341 342 /** 343 * Rewind the groups and reset member index. 344 * 345 * @since 1.2.0 346 */ 347 function rewind_groups() { 348 $this->current_group = -1; 349 if ( $this->group_count > 0 ) { 350 $this->group = $this->groups[0]; 351 } 352 } 353 354 /** 355 * Whether there are groups left in the loop to iterate over. 356 * 357 * This method is used by {@link bp_groups()} as part of the while loop 358 * that controls iteration inside the groups loop, eg: 359 * while ( bp_groups() ) { ... 360 * 361 * @since 1.2.0 362 * 363 * @see bp_groups() 364 * 365 * @return bool True if there are more groups to show, otherwise false. 366 */ 367 function groups() { 368 if ( $this->current_group + 1 < $this->group_count ) { 369 return true; 370 } elseif ( $this->current_group + 1 == $this->group_count ) { 371 372 /** 373 * Fires right before the rewinding of groups list. 374 * 375 * @since 1.5.0 376 */ 377 do_action('group_loop_end'); 378 // Do some cleaning up after the loop. 379 $this->rewind_groups(); 380 } 381 382 $this->in_the_loop = false; 383 return false; 384 } 385 386 /** 387 * Set up the current group inside the loop. 388 * 389 * Used by {@link bp_the_group()} to set up the current group data 390 * while looping, so that template tags used during that iteration make 391 * reference to the current member. 392 * 393 * @since 1.2.0 394 * 395 * @see bp_the_group() 396 */ 397 function the_group() { 398 $this->in_the_loop = true; 399 $this->group = $this->next_group(); 400 401 if ( 0 == $this->current_group ) { 402 403 /** 404 * Fires if the current group item is the first in the loop. 405 * 406 * @since 1.1.0 407 */ 408 do_action( 'group_loop_start' ); 409 } 410 } 411 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Sun Oct 24 01:00:54 2021 | Cross-referenced by PHPXref 0.7.1 |