User permissions

Snax 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.

Roles and capabilities

Snax provides only one Snax Author (snax_author) role and 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
  • snax_vote_posts - allows users to vote on posts
  • snax_vote_items - allow users to vote on submissions

Basic configuration

By default, Wordpress assigns its default role (the Subsciber role) to all new users registered on your site. If you don't change that setting, Snax during 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, all your user needs to start using Snax is the Snax Author role assigned to him.

How to change default user role (for all 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 admin panel › 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 admin panel › 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 admin panel › Users › Roles
  3. Click your SPECIAL_ROLE role (or any other role you want to assign Snax capabilites to).
  4. Check the box (in the "Grant" column) right beside capabilites with the snax_ prefix (full list above).
  5. Click the Update button