bbp_map_reply_meta_caps( array $caps = array(), string $cap = '', int $user_id, mixed $args = array() )
Maps topic capabilities
Description
Parameters
- $caps
-
(Optional) Capabilities for meta capability
Default value: array()
- $cap
-
(Optional) Capability name
Default value: ''
- $user_id
-
(Required) User id
- $args
-
(Optional) Arguments
Default value: array()
Return
(array) Actual capabilities for meta capability
Source
File: bp-forums/replies/capabilities.php
function bbp_map_reply_meta_caps( $caps = array(), $cap = '', $user_id = 0, $args = array() ) { // What capability is being checked? switch ( $cap ) { /** Reading ***********************************************************/ case 'read_reply' : // User cannot spectate if ( ! user_can( $user_id, 'spectate' ) ) { $caps = array( 'do_not_allow' ); // Do some post ID based logic } else { // Get the post $_post = get_post( $args[0] ); if ( !empty( $_post ) ) { // Get caps for post type object $post_type = get_post_type_object( $_post->post_type ); // Post is public if ( bbp_get_public_status_id() === $_post->post_status ) { $caps = array( 'spectate' ); // User is author so allow read } elseif ( (int) $user_id === (int) $_post->post_author ) { $caps = array( 'spectate' ); // Unknown so map to private posts } else { $caps = array( $post_type->cap->read_private_posts ); } } } break; /** Publishing ********************************************************/ case 'publish_replies' : // Moderators can always publish if ( user_can( $user_id, 'moderate' ) ) { $caps = array( 'moderate' ); } break; /** Editing ***********************************************************/ // Used primarily in wp-admin case 'edit_replies' : case 'edit_others_replies' : // Moderators can always edit if ( user_can( $user_id, 'moderate' ) ) { $caps = array( 'moderate' ); // Otherwise, block } else { $caps = array( 'do_not_allow' ); } break; // Used everywhere case 'edit_reply' : // Get the post $_post = get_post( $args[0] ); if ( !empty( $_post ) ) { // Get caps for post type object $post_type = get_post_type_object( $_post->post_type ); $caps = array(); // Add 'do_not_allow' cap if user is spam or deleted if ( bbp_is_user_inactive( $user_id ) ) { $caps[] = 'do_not_allow'; // User is author so allow edit if not in admin } elseif ( !is_admin() && ( (int) $user_id === (int) $_post->post_author ) ) { $caps[] = $post_type->cap->edit_posts; // Unknown, so map to edit_others_posts } else { $caps[] = $post_type->cap->edit_others_posts; } } break; /** Deleting **********************************************************/ case 'delete_reply' : // Get the post $_post = get_post( $args[0] ); if ( !empty( $_post ) ) { // Get caps for post type object $post_type = get_post_type_object( $_post->post_type ); $caps = array(); // Add 'do_not_allow' cap if user is spam or deleted if ( bbp_is_user_inactive( $user_id ) ) { $caps[] = 'do_not_allow'; // Moderators can always edit forum content } elseif ( user_can( $user_id, 'moderate' ) ) { $caps[] = 'moderate'; // Unknown so map to delete_others_posts } else { $caps[] = $post_type->cap->delete_others_posts; } } break; // Moderation override case 'delete_replies' : case 'delete_others_replies' : // Moderators can always delete if ( user_can( $user_id, 'moderate' ) ) { $caps = array( 'moderate' ); } break; /** Admin *************************************************************/ case 'bbp_replies_admin' : $caps = array( 'moderate' ); break; } return apply_filters( 'bbp_map_reply_meta_caps', $caps, $cap, $user_id, $args ); }
Changelog
Version | Description |
---|---|
bbPress (r4242) | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.