bp_has_albums (|字符串数组args美元＝＇＇）
初始化专辑循环。
描述
根据传递的$args，bp_has_albums ()填充$media_album_template全局变量，允许使用BuddyPress模板和模板函数来显示媒体相册项列表。
参数
- args美元
-
（数组|字符串）(可选)限制媒体循环内容的参数。大多数参数的格式与BP_Media_Album: get ()．但是，因为这里接受的参数的格式在许多方面不同，而且因为bp_has_media ()以动态方式确定一些默认参数，这里也列出了所有可接受的参数。参数可以作为一个关联数组传递，或者作为一个URL查询字符串(例如，'author_id=4&privacy=public')。
- “页面”
(int)获取结果的哪一页。使用page=1而不使用per_page将不会导致分页。默认值:1。 - “per_page”
(int | bool)每页的结果数。默认值:20。 - “page_arg”
(字符串)在分页链接中用作查询参数的字符串。默认值:“acpage”。 - “马克斯”
(int | bool)返回的最大结果数。默认值:false(无限)。 - “字段”
(字符串)要检索的活动字段。'all'获取整个媒体对象，'ids'仅获取媒体id。默认的“所有”。 - “count_total”
(字符串| bool)如果为true，则运行一个额外的DB查询来计算查询的媒体项总数。默认值:false。 - “排序”
(字符串)“ASC”或“DESC”。默认值:“DESC”。 - “排除”
(数组| bool)要排除的媒体id数组。默认值:false。 - “包括”
(数组| bool)要查询的精确媒体id数组。提供一个'include'数组将覆盖参数数组中传递的所有其他过滤器。当查看单个媒体项的永久链接页面时，此值默认为该项的ID。否则默认为false。 - “search_term”
(字符串)通过搜索词限制结果。默认值:false。 - “user_id”
(int数组| | bool)应该获取其媒体的用户的ID。传递单个ID或ID数组。当查看用户配置文件页面时，'user_id'默认为显示的用户ID。否则默认为false。 - “group_id”
(int数组| | bool)应该获取其媒体的组的ID。传递单个ID或ID数组。当查看组页面时，“group_id”默认为显示组的ID。否则默认为false。 - “隐私”
(数组)用隐私来限制结果。默认值:public | grouponly。
默认值:“
- “页面”
返回
(保龄球)当找到媒体时返回true，否则返回false。
源
文件:bp-media / bp-media-template.php
Function bp_has_albums($args = ") {global $media_album_template;/* *智能默认值。*/ /用户过滤。$user_id = bp_displayed_user_id() ?bp_displayed_user_id():假;美元search_terms_default = false;$search_query_arg = bp_core_get_component_search_query_arg('专辑');如果(!$_REQUEST[$search_query_arg]) {$search_terms_default = strip斜杠($_REQUEST[$search_query_arg]);} $ private = array('public'); if ( is_user_logged_in() ) { $privacy[] = 'loggedin'; if ( bp_is_active( 'friends' ) ) { $is_friend = friends_check_friendship( get_current_user_id(), $user_id ); if( $is_friend ) { $privacy[] = 'friends'; } } if ( bp_is_my_profile() ) { $privacy[] = 'onlyme'; } } $group_id = false; if ( bp_is_group() ) { $group_id = bp_get_current_group_id(); $user_id = false; $privacy = array( 'grouponly' ); } /* * Parse Args. */ // Note: any params used for filtering can be a single value, or multiple // values comma separated. $r = bp_parse_args( $args, array( 'include' => false, // Pass an album_id or string of IDs comma-separated. 'exclude' => false, // Pass an activity_id or string of IDs comma-separated. 'sort' => 'DESC', // Sort DESC or ASC. 'page' => 1, // Which page to load. 'per_page' => 20, // Number of items per page. 'page_arg' => 'acpage', // See https://buddypress.trac.wordpress.org/ticket/3679. 'max' => false, // Max number to return. 'fields' => 'all', 'count_total' => false, // Filtering 'user_id' => $user_id, // user_id to filter on. 'group_id' => $group_id, // group_id to filter on. 'privacy' => $privacy, // privacy to filter on - public, onlyme, loggedin, friends, grouponly. // Searching. 'search_terms' => $search_terms_default, ), 'has_albums' ); /* * Smart Overrides. */ // Search terms. if ( ! empty( $_REQUEST['s'] ) && empty( $r['search_terms'] ) ) { $r['search_terms'] = $_REQUEST['s']; } // Do not exceed the maximum per page. if ( ! empty( $r['max'] ) && ( (int) $r['per_page'] > (int) $r['max'] ) ) { $r['per_page'] = $r['max']; } /* * Query */ $media_album_template = new BP_Media_Album_Template( $r ); /** * Filters whether or not there are media albums to display. * * @since BuddyBoss 1.0.0 * * @param bool $value Whether or not there are media items to display. * @param string $media_album_template Current media album template being used. * @param array $r Array of arguments passed into the BP_Media_Album_Template class. */ return apply_filters( 'bp_has_album', $media_album_template->has_albums(), $media_album_template, $r ); }
更新日志
| 版本 | 描述 |
|---|---|
| BuddyBoss 1.0.0 | 介绍了。 |