bp\u有\u文件夹(数组|字符串$args='')
初始化文件夹循环。
描述
根据传递的$args，bp_有_文件夹（）填充$document\u folder\u template全局，允许使用BuddyPress模板和模板函数来显示文档文件夹项目的列表。
参数
- $args
-
(大堆|一串)（可选）用于限制文档循环内容的参数。大多数参数的格式与BP_文档_文件夹：：get（）. 但是，由于此处接受的参数的格式在许多方面不同，并且bp_有_文件（）以动态方式确定一些默认参数，我们也在此处列出所有接受的参数。参数可以作为关联数组或URL查询字符串传递（例如，“author_id=4&privacy=public”）。
- “页面”
（国际）获取哪一页的结果。如果不使用per_页面而使用page=1，则不会导致分页。默认值：1。 - “每页”
（int|bool）每页的结果数。默认值：20。 - “页面参数”
（字符串）在分页链接中用作查询参数的字符串。默认值：“acpage”。 - “马克斯”
（int|bool）要返回的最大结果数。默认值：false（无限制）。 - “田地”
（字符串）要检索的活动字段。“全部”用于获取整个文档对象，“ID”用于仅获取文档ID。默认值为“全部”。 - “总数”
（字符串| bool）如果为true，则运行额外的DB查询以计算查询的文档项总数。默认值：false。 - “排序”
（字符串）“ASC”或“DESC”。默认值为：“DESC”。 - “排除”
（数组| bool）要排除的文档ID数组。默认值：false。 - “包括”
（数组| bool）要查询的精确文档ID数组。提供“include”数组将覆盖参数数组中传递的所有其他筛选器。查看单个文档项的永久链接页面时，此值默认为该项的ID。否则，默认值为false。 - “搜索术语”
（字符串）按搜索词限制结果。默认值：false。 - “用户id”
（int | array | bool）应提取其文档的用户的ID。传递单个ID或ID数组。查看用户配置文件页面时，“user_ID”默认为显示用户的ID。否则默认为false。 - “组id”
（int | array | bool）应提取其文档的组的ID。传递单个ID或ID数组。查看组页面时，“组ID”默认为显示组的ID。否则默认为false。 - “隐私”
（数组）按隐私限制结果。默认值：public | grouponly。
默认值：“”
- “页面”
回来
（布尔）找到文档时返回true，否则返回false。
来源
文件：bp文档/bp-document-template.php
函数bp_有文件夹（$args=''）{global$document_folder_template；/**智能默认值。*///用户筛选。$User_id=bp_displated_User_id（）？bp_displated_User_id（）：false；$search_terms_default=false；$search_query_arg=bp_core_get_component_search_query_arg（'folder'）；if（！empty（$REQUEST[$search_query查询_arg）{$search\u terms\u default=stripslashes（$\u REQUEST[$search\u query\u arg]）}$privacy=array（'public'）；if（is\u user\u loggein（））{$privacy[]='loggedin'；if（bp\u处于活动状态（'friends'））{//获取登录用户id.$current\u user\u id=get\u current用户id（）；//检查登录用户是否是显示用户的朋友。$is_friend=friends_check_friends（$current_user_id，$user_id）；/***检查登录用户是否是显示用户的朋友。*或者检查登录用户和显示用户是否相同*/if（$is_friends | |！empty（$current_user_id）&&&$current_user_id===$user_id=$user_id）{$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'）；}/**解析参数。*///注意：用于筛选的任何参数都可以是单个值，也可以是多个//值，逗号分隔。$r=bp_解析_Args（$args，数组）（'include'=>false，//传递文件夹id或字符串id，以逗号分隔。'exclude'=>false，//传递活动id或字符串id，以逗号分隔。'sort'=>DESC'，//排序DESC或ASC。'page'=>1，//要加载的页面。'per_page'=>20，//每页的项目数。'page'=>acpage'，//请参阅https://buddypress.trac.wordpress.org/ticket/3679。'max'=>false，//返回的最大数量。'fields'=>all'，'count\u total'=>false，//过滤。'user\u id'=>user\u id，//要过滤的用户id。'group\u id'=>group\u id，//要过滤的组id。'privacy'=>privacy，//要过滤的隐私-public，onlyme，loggedin，friends，grouponly//搜索。'search\u terms'=>search\u default，），'has_folders'）；if（bp_is_group_single（）&&bp_is_group_folders（）&&false=$r['include']）{$r['include']=（int）bp_action_变量（1）}/**智能覆盖。*///搜索条件。if（！empty（$_REQUEST['s']）&&empty（$r['Search_terms'））{$r['Search_terms']=$_REQUEST[]不要超过每页的最大值。如果}（！empty（$r['max']）和（（int）$r['per_page']>（int）$r['max']）{$r['per_page']=$r['max']；}/**Query*/$document_folder_template=新的BP_document_folder_模板（$r）；/***筛选是否有文档要显示。**@自BuddyBoss 1.4.0以来**@param bool$value是否有文档项要显示。*@param string$document\u folder\u template当前使用的文档文件夹模板。*@param array$r传入BP\u document\u folder\u template类的参数数组。*/返回apply_筛选器（'bp_has_folder'，$document_folder_template->has_folders（），$document_folder_template，$r）；}
变更日志
| 版本 | 描述 |
|---|---|
| Buddyboss1.4.0 | 介绍。 |