消息\u格式\u通知(字符串美元的行动,intitem_id美元,intsecondary_item_id美元,int$total\u项目,字符串美元的格式=“字符串”)
格式化Messages组件的通知。
描述
参数
- 美元的行动
-
(字符串)(必需)呈现的通知类型。
- item_id美元
-
(int)(必需)主项目id。
- secondary_item_id美元
-
(int)(必需)第二项id。
- $total\u项目
-
(int)(必需)等待用户的消息相关通知的总数。
- 美元的格式
-
(字符串)(可选)返回值的格式。'string'用于buddybar兼容的通知;“数组”的WP工具栏。默认值:“弦”。
默认值:“字符串”
返回
(字符串|数组)格式化的通知。
源
文件:bp-messages / bp-messages-notifications.php
函数消息\u格式\u通知($action,$item\u id,$secondary\u item\u id,$total\u items,$format='string'){$total\u items=(int)$total\u items;$text='';$link=trailingslashit(bp\u loggedin\u user\u domain().bp\u get\u messages\u slug()./inbox');$title=\u('messages,'buddyboss');$amount='single='single';if('new\u messages'==action')){if($total_items>1){$amount='multiple';$text=sprintf('You have%d new messages','buddyboss'),$total_items)}else{//Get message thread ID.$messages=new BP_messages_messages($item_ID);$thread ID=$message->thread ID;$link=(!empty($thread_ID))?BP_Get_messages\u thread\u视图_link($thread ID):false;if(!empty($secondary_item_id)){$text=sprintf($s('%s向您发送了一条新的私人消息,'buddyboss'),bp_core_get_user_displayname($secondary_item_id))}否则{$text=sprintf($n('youhave%s new private message','youhave%s new private messages','total_items','buddyboss'),bp_core_编号格式($total_items))}如果('string'==$format){if(!empty($link)){$return=''.esc_html($text)。';}否则{$return=esc_html($text);}/***在创建通知之前过滤新消息通知文本。**这是一个动态过滤器。可能的过滤器名称为:“-”bp_消息_多个_新消息_通知”。*-“bp_消息_单个_新消息_通知”。***@param string$返回通知文本。*@param int$total_项引用到b的消息数y通知。*@param string$text原始通知测试(即,未包装在链接中)。*@param int$item\u关联项的id.*@param int$secondary\u item\u关联项的id.*/$return=apply\u过滤器('bp\u messages\u.$amount.\u new\u message\u notification',$return,(int)$total_items、$text、$link、$item_id、$secondary_item_id);}else{/**此筛选器记录在bp messages/bp-messages-notifications.php*/$return=apply_筛选器('bp_messages.'$amount.'.\u新_message_notification',数组('text'=>$text','link=>$link'=>$link),$link,(int)$total_items、$text、$link、$link、$link、$link、$item、$id、$secondary_item)//消息组件的自定义通知操作}else{if('string'===$format){$return=$text;}else{$return=array('text'=>$text,'link'=>$link);}/***用于为自定义操作筛选bp_消息_single_new_消息_notification*的插件的Backcompat。这些插件现在应使用“bp_messages”.$action.\u notification'*/if(具有_筛选器('bp_messages_single_new_消息_notification'){if('string'==$format){/**此筛选器记录在bp messages/bp-messages-notifications.php*/$return=apply_filters('bp_messages_single_new_message_notification',$return,(int)$total_items、$text、$link、$item_id、$secondary_item__id);//请注意,还有七个参数,而不是六个参数{/**此筛选器记录在bp messages/bp-messages-notifications.php*/$return=apply_filters('bp_messages_single_new_message_notification',$return,$link,(int)$total_items,$text,$link,$item_id,$secondary_item_id);}/***在创建通知之前过滤自定义操作通知。**这是基于消息通知操作的动态过滤器。**@因为BuddyPress 2.6.0**@param array$value一个关联数组,包含通知的文本和链接*@param int$item_id关联项的id.@param int$seconda次关联项的ry_item_id.*@param int$total_items通知引用的消息数.*@param string$format返回值格式。BuddyBar兼容*通知的“string”;WP工具栏的“array”。默认值:“string”。*/$Return=apply_过滤器(“bp_消息”{$action}\u通知”,$return,$item_id,$secondary_item_id,$total_items,$format);}/***在返回格式化的消息通知之前激发。**@自BuddyPress 1.0.0以来**@param string$action消息通知的类型。*@param int$item_id主要项id.@param int$secondary_item_id次要项id.@param int$total_items要格式化的项总数。*/do\u action('messages_format_notifications'、$action、$item_id、$secondary_item_id、$total_items);return$return;}
变更日志
版本 | 描述 |
---|---|
BuddyPress 1.0.0 | 介绍了。 |