User roles and permissions in Wordpress

Introduction

User roles and permissions help control what different users can do on a WordPress site. This keeps the site safe and organized.

When you want to let someone write posts but not change site settings.

When you need to give a trusted person full control over the site.

When you want to allow users to comment but not publish content.

When you want to restrict access to certain parts of the admin dashboard.

When you want to add custom roles for special tasks on your site.

Syntax

Wordpress

<?php
// Add a new role
add_role('custom_role', 'Custom Role', [
  'read' => true,
  'edit_posts' => true,
  'delete_posts' => false
]);

// Check if user has a capability
if (current_user_can('edit_posts')) {
  // User can edit posts
}

// Remove a role
remove_role('custom_role');
?>

Roles group capabilities (permissions) for easier management.

Use current_user_can() to check permissions before actions.

Examples

This creates a new role that can edit and publish posts and moderate comments.

Wordpress

<?php
// Add an Editor role with extra capability
add_role('custom_editor', 'Custom Editor', [
  'read' => true,
  'edit_posts' => true,
  'publish_posts' => true,
  'moderate_comments' => true
]);
?>

This checks the current user's permission and shows a message accordingly.

Wordpress

<?php
// Check if current user can delete posts
if (current_user_can('delete_posts')) {
  echo 'You can delete posts.';
} else {
  echo 'You cannot delete posts.';
}
?>

This deletes the custom role from the site.

Wordpress

<?php
// Remove a custom role
remove_role('custom_editor');
?>

Sample Program

This code adds a new role with specific permissions, checks if the current user can publish posts, prints a message, and then removes the role.

Wordpress

<?php
// Add a new role called 'content_manager'
add_role('content_manager', 'Content Manager', [
  'read' => true,
  'edit_posts' => true,
  'publish_posts' => true,
  'delete_posts' => false
]);

// Check if current user can publish posts
if (current_user_can('publish_posts')) {
  echo 'You can publish posts.';
} else {
  echo 'You cannot publish posts.';
}

// Remove the role after use
remove_role('content_manager');
?>

Important Notes

Roles and permissions are stored in the database and persist until changed.

Be careful when removing roles; users assigned to that role lose those permissions.

Always check permissions before allowing sensitive actions to keep your site secure.

Summary

User roles group permissions to control what users can do.

Use add_role() to create roles and remove_role() to delete them.

Check permissions with current_user_can() before performing actions.

Practice

1. What is the main purpose of user roles in WordPress?

easy

A. To group permissions and control what users can do

B. To change the website's theme

C. To add new plugins automatically

D. To backup the website data

Solution

1. Step 1: Understand the concept of user roles

   User roles in WordPress are designed to group permissions for users.

2. Step 2: Identify the purpose of roles

   Roles control what actions users are allowed to perform on the site.

3. Final Answer:

   To group permissions and control what users can do -> Option A

4. Quick Check:

   User roles = group permissions [OK]

Hint: Roles group permissions to control user actions [OK]

Common Mistakes:

• Confusing roles with themes or plugins
• Thinking roles backup data
• Assuming roles add new features automatically

2. Which function is used to add a new user role in WordPress?

easy

A. add_user_role()

B. add_role()

C. create_role()

D. new_role()

Solution

1. Step 1: Recall WordPress role functions

   The correct function to add a new role is add_role().

2. Step 2: Verify function names

   Other options like add_user_role() or create_role() do not exist in WordPress core.

3. Final Answer:

   add_role() -> Option B

4. Quick Check:

   Adding roles = add_role() [OK]

Hint: Use add_role() to create new roles [OK]

Common Mistakes:

• Using add_user_role() which is not a WordPress function
• Confusing with create_role() or new_role()
• Trying to add roles without this function

3. What will the following code output if the current user has the 'edit_posts' capability?

if (current_user_can('edit_posts')) {
  echo 'Can edit posts';
} else {
  echo 'Cannot edit posts';
}

medium

A. Cannot edit posts

B. Syntax error

C. No output

D. Can edit posts

Solution

1. Step 1: Understand current_user_can() behavior

   This function checks if the current user has a specific capability.

2. Step 2: Analyze the condition

   If the user has 'edit_posts', the code echoes 'Can edit posts'.

3. Final Answer:

   Can edit posts -> Option D

4. Quick Check:

   Has capability = prints confirmation [OK]

Hint: current_user_can() returns true if user has capability [OK]

Common Mistakes:

• Assuming it returns false always
• Confusing capability names
• Expecting syntax errors from correct code

4. Identify the error in this code snippet for removing a user role:

remove_role('editor');

medium

A. remove_role() requires two parameters

B. remove_role() cannot remove default roles

C. No error, this code correctly removes the 'editor' role

D. The role name must be capitalized

Solution

1. Step 1: Check remove_role() usage

   The function remove_role() takes one parameter: the role slug. This usage is correct.

2. Step 2: Verify default roles behavior

   WordPress allows removing default roles like 'editor' using remove_role(). The code executes without error, though default roles may be re-registered later.

3. Final Answer:

   No error, this code correctly removes the 'editor' role -> Option C

4. Quick Check:

   remove_role() works on all roles [OK]

Hint: remove_role('editor') works fine [OK]

Common Mistakes:

• Thinking remove_role needs two parameters
• Believing default roles cannot be removed
• Assuming role names must be capitalized

5. You want to create a custom role 'content_manager' that can edit posts and moderate comments. Which code snippet correctly adds this role with these capabilities?

hard

A. add_role('content_manager', 'Content Manager', ['edit_posts' => true, 'moderate_comments' => true]);

B. add_role('content_manager', 'Content Manager', ['edit_posts', 'moderate_comments']);

C. add_role('content_manager', 'Content Manager', ['edit_posts' => false, 'moderate_comments' => true]);

D. add_role('content_manager', 'Content Manager', ['edit_posts' => true, 'delete_posts' => true]);

Solution

1. Step 1: Understand add_role() parameters

   The function takes role slug, display name, and an array of capabilities with boolean values.

2. Step 2: Check capabilities array

   Capabilities must be keys with true/false values to grant or deny permissions.

3. Step 3: Match required capabilities

   Only add_role('content_manager', 'Content Manager', ['edit_posts' => true, 'moderate_comments' => true]); correctly grants 'edit_posts' and 'moderate_comments' as true.

4. Final Answer:

   add_role('content_manager', 'Content Manager', ['edit_posts' => true, 'moderate_comments' => true]); -> Option A

5. Quick Check:

   Capabilities array with true values = correct role setup [OK]

Hint: Capabilities array needs keys with true/false values [OK]

Common Mistakes:

• Passing capabilities as list without keys
• Setting capability to false when it should be true
• Adding wrong capabilities not requested