User roles and permissions in Wordpress - Mini Project: Build & Apply

User Roles and Permissions in WordPress

📖 Scenario: You are building a WordPress site for a small community blog. You want to manage who can write posts, who can edit them, and who can only read content.

🎯 Goal: Learn how to create and assign user roles with specific permissions in WordPress using PHP code in a plugin or theme functions file.

📋 What You'll Learn

Create a new user role with custom capabilities

Set a capability threshold variable

Assign capabilities to the new role using a loop

Register the new role in WordPress

💡 Why This Matters

🌍 Real World

Managing user roles and permissions is essential for controlling access on WordPress sites, especially for blogs, membership sites, or online stores.

💼 Career

Understanding WordPress roles and capabilities is important for developers customizing sites, creating plugins, or managing site security.

1

Create a new user role array

Create an array called custom_caps with these exact capabilities: 'read', 'edit_posts', and 'delete_posts'.

Wordpress

# Your code here

Hint

Use array() to list the capabilities exactly as given.

2

Set minimum capability level

Create a variable called min_capability and set it to the string 'edit_posts'.

Wordpress

<?php
$custom_caps = array('read', 'edit_posts', 'delete_posts');
# Your code here

Hint

Assign the string 'edit_posts' to $min_capability.

3

Assign capabilities to new role

Use a foreach loop with variable $cap to iterate over $custom_caps and inside the loop add each capability to a new array called $role_caps with the value true.

Wordpress

<?php
$custom_caps = array('read', 'edit_posts', 'delete_posts');
$min_capability = 'edit_posts';
# Your code here

Hint

Initialize $role_caps as an empty array before the loop.

4

Register the new user role

Use the WordPress function add_role to create a new role called 'custom_editor' with the display name 'Custom Editor' and capabilities from $role_caps.

Wordpress

<?php
$custom_caps = array('read', 'edit_posts', 'delete_posts');
$min_capability = 'edit_posts';
$role_caps = array();
foreach ($custom_caps as $cap) {
    $role_caps[$cap] = true;
}
# Your code here

Hint

Call add_role with the exact role key, display name, and capabilities array.

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