Changeset 12687

Timestamp:

07/03/2023 06:19:58 PM (22 months ago)

Author:

coffee2code

Message:

Moderation: Add Photo Admin role.

See #7119.

File:

• sites/trunk/wordpress.org/public_html/wp-content/plugins/photo-directory/inc/moderation.php (modified) (4 diffs)

sites/trunk/wordpress.org/public_html/wp-content/plugins/photo-directory/inc/moderation.php

@@ -64 +64 @@
 
     /**
-     * Adds the 'Photos Moderator' role.
-     */
-    public static function add_roles() {
-        add_role(
-            'photos_moderator',
-            __( 'Photos Moderator', 'wporg-photos' ),
-            [
-                // Capabilities for photo posts.
-                'read'                    => true,
-                'edit_photos'             => true,
-                'delete_photos'           => true,
-                'publish_photos'          => true,
-                'edit_others_photos'      => true,
-                'delete_others_photos'    => true,
-                'edit_published_photos'   => true,
-                'delete_published_photos' => true,
+     * Returns all capabilities for photos-related roles.
+     *
+     * @param bool $for_photos_admin Optional. Should capabilites include those
+     *                               exclusive to Photo Admins?
+     *                               Default false.
+     * @return array
+     */
+    public static function get_photos_caps( $for_photos_admin = false ) {
+        $caps = [
+            // Capabilities for photo posts.
+            'read'                    => true,
+            'edit_photos'             => true,
+            'delete_photos'           => true,
+            'publish_photos'          => true,
+            'edit_others_photos'      => true,
+            'delete_others_photos'    => true,
+            'edit_published_photos'   => true,
+            'delete_published_photos' => true,
+            'upload_files'            => true,
+        ];
+
+        if ( $for_photos_admin ) {
+            $caps = array_merge( $caps, [
+                // Manage flagged and private photos.
+                'manage_flagged_photos'   => true,
+                'delete_private_photos'   => true,
                 'edit_private_photos'     => true,
-                'delete_private_photos'   => true,
                 'read_private_photos'     => true,
-                'upload_files'            => true,
                 // Capabilities for posts and media.
                 'edit_posts'              => true,
@@ -92 +100 @@
                 'edit_published_posts'    => true,
                 'delete_published_posts'  => true,
-                'edit_private_posts'      => true,
-                'delete_private_posts'    => true,
-                'read_private_posts'      => true,
                 'edit_post'               => true,
                 'delete_post'             => true,
                 'read_post'               => true,
-            ]
-        );
+            ] );
+        }
+
+        return $caps;
+    }
+
+    /**
+     * Adds the photos-specific roles.
+     *
+     * Adds:
+     * - photos_moderator: User who can moderate photos.
+     * - photos_administrator: Same as photos moderator, but can additionally:
+     *     - Access and manage private (aka flagged) photos.
+     *     - Create/edit/delete posts.
+     */
+    public static function add_roles() {
+        // Remove the roles first, in case the permission set has changed.
+        remove_role( 'photos_moderator' );
+        remove_role( 'photos_administrator' );
+
+        add_role(
+            'photos_moderator',
+            __( 'Photo Moderator', 'wporg-photos' ),
+            self::get_photos_caps()
+        );
+
+        $admin_caps = self::get_photos_caps( true );
+
+        add_role(
+            'photos_administrator',
+            __( 'Photo Admin', 'wporg-photos' ),
+            $admin_caps
+        );
+
+        // Add capabilites to administrator role.
+        $admin = get_role( 'administrator' );
+        if ( $admin ) {
+            foreach ( $admin_caps as $cap => $val ) {
+                $admin->add_cap( $cap );
+            }
+        }
+    }
+
+    /**
+     * Removes the photo-specific roles.
+     *
+     * Removes:
+     * - photos_moderator
+     * - photos_administrator
+     */
+    public static function remove_roles() {
+        remove_role( 'photos_moderator' );
+        remove_role( 'photos_administrator' );
+
+        // Remove added capabilites from administrator role.
+        $admin = get_role( 'administrator' );
+        foreach ( self::get_photos_caps( true ) as $cap => $val ) {
+            // Only remove photos-specific caps.
+            if ( false !== strpos( $cap, 'photo' ) ) {
+                $admin->remove_cap( $cap );
+            }
+        }
     }
 
@@ -562 +627 @@
         }
 
-        $content .= '<h2>' . __( 'Submissions awaiting moderation', 'wporg-photos' ) . "</h2>\n";
+        $content .= '<h3>' . __( 'Submissions awaiting moderation', 'wporg-photos' ) . "</h3>\n";
         $content .= '<p>';
         $max_pending_submissions = User::get_concurrent_submission_limit( $user_id );
@@ -661 +726 @@
 
 register_activation_hook( WPORG_PHOTO_DIRECTORY_DIRECTORY . '/photo-directory.php', [ __NAMESPACE__ . '\Moderation', 'add_roles' ] );
+register_deactivation_hook( WPORG_PHOTO_DIRECTORY_DIRECTORY . '/photo-directory.php', [ __NAMESPACE__ . '\Moderation', 'remove_roles' ] );
 
 add_action( 'plugins_loaded', [ __NAMESPACE__ . '\Moderation', 'init' ] );