Ticket #38276: poc-1.php

<?php

/**
 * Check if something is accessible to the current user.
 *
 * Checks whether the current user is allowed to see this item.
 *
 * @since 4.7.0
 *
 * @param string $type The type of thing this is, e.g., 'post', 'term', etc.
 * @param int    $id   The ID of the thing.
 *
 * @return bool Whether the thing is accessible to the current user.
 */
function is_thing_accessible( $type, $id ) {
        return is_thing_accessible_for_user( get_current_user_id(), $type, $id );
}

/**
 * Check if something is accessible to a particular user.
 *
 * Checks whether the user is allowed to see this item.
 *
 * @since 4.7.0
 *
 * @param int    $user_id The ID of the user, or 0 for non-logged-in users.
 * @param string $type    The type of thing this is, e.g., 'post', 'term', etc.
 * @param int    $id      The ID of the thing.
 *
 * @return bool Whether the thing is accessible to the user.
 */
function is_thing_accessible_for_user( $user_id, $type, $id ) {

        // Everything is public by default, unless restricted by something.
        $is_accessible = true;

        switch ( $type ) {

                case 'post':
                        $post_status = get_post_status_object( get_post_status( $id ) );

                        // If the post doesn't have a public status, fall back to the caps API.
                        if ( ! $post_status || ! $post_status->public ) {
                                $is_accessible = user_can( $user_id, 'read_post', $id );
                        }
                break;
        }

        /**
         * Filter whether a thing is accessible to a user.
         *
         * @since 4.7.0
         *
         * @param bool   $is_accessible Whether the thing is accessible to this user.
         * @param int    $user_id       The ID of the user, or 0 for non-logged-in users.
         * @param string $type          The type of thing this is, e.g., 'post', 'term', etc.
         * @param int    $id            The ID of the thing.
         */
        return apply_filters( 'is_thing_accessible', $is_accessible, $user_id, $type, $id );
}