User Role/Capabilities

The uploader permissions are based on the WordPress roles and capabilities system. Most of necessary configuration is done during plugin activation so, in most cases, you don’t need to do anything more

Available Role

The Snax plugins provides, for the uploader, only one Snax Author (snax_author) role.

Available Capabilities

The Snax Author (snax_author) role consists of the following capabilites:

  • snax_upload_files – allows users to upload files
  • snax_add_posts – allows users to create new posts
  • snax_edit_posts – allows users to edit their own posts
  • snax_delete_posts – allows users to delete their own posts
  • snax_publish_posts – allows users to publish their own posts
  • snax_add_items – allows users to create new submissions
  • snax_delete_items – allows users to delete their own submissions
  • snax_edit_others_items – allows users to edit items of other users
  • snax_publish_items – allows users to publish their own items

Basic Configuration

By default, WordPress assigns its default role (the Subscriber role) to all new users registered on your site. If you don’t change that setting (check the section below), the Snax during the activation process will change it to the Snax Author role. From now, all new users will be able to use Snax. For old users, if you have any, you will need to assign the Snax Author role to them manually (or using some 3rd party plugin).

Generally speaking, your users have to have the Snax Author role assigned to them to start using the uploader. Optionally, users may just have Snax Author role capabilities assigned to their current role.

How To Change Default User Role (For New Users)?

To change the role that will be assigned to all new users registered on your site, please follow these simple steps:

  1. Go to the WP Dashboard > Settings > General
  2. Select the Snax Author option in the New User Default Role field
  3. Save changes

How To Assign New Role To Existing User?

To assign new role, and keep all current user roles assigned, please do as follows:

  1. Install and activate the Members plugin.
  2. Go to the WP Dashboard > Users
  3. Choose a user and click it
  4. Scroll down to the Roles section
  5. Check the box right next to the role you want to add (Snax Author role)
  6. Click the Update User button

Advanced Permissions Management

If the basic configuration is not sufficent for your site, e.g. becuase you have already defined other users permissions, you can use the Members plugin to add necessary capabilities to existing roles.

Let’s say your users (old and new) require to have the SPECIAL_ROLE role and you can’t change this. It’s not a problem, you can assign Snax capabilites to any role you want. To do this, using the Members plugin, please follow these steps:

  1. Install and activate the Members plugin.
  2. Go to the WP Dashboard > Users > Roles
  3. Click your SPECIAL_ROLE role (or any other role you want to assign Snax capabilities to).
  4. Check the box (in the “Grant” column) right beside capabilities with the snax_ prefix (full list above).
  5. Click the Update button

What do you think?