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.