Passage plugin

( Installation code : kurtjensen.passage ) Requires ( RainLab.User ) This plugin adds a front end user group permission system to OctoberCMS.

Download the plugin to the plugins directory and logout and log in back into October backend. Go to the Passage Keys page via the side menu in users in the backend and add your permissions/keys.

###User Permision / Passage Key Entry######

In the backend under Users (Rainlab.Users) you will find a sidemenu item called "Passage Keys". This is where you enter your permission names and an optional description.

In the backend under Users you will find a button at the top called "User Groups". Press button to see groups. When editing a group you will find check boxes at the bottom for each "Passage Key". This is where you assign permissions for each user group.

###User Variances######

In the backend under Users (Rainlab.Users) you will find a sidemenu item called "User Variances".

User variances allow you to add permission keys to individual users. You can also remove permission from users by adding a variance and unchecking the Grant checkbox.

###User Permisions in Pages or Partials######

On a page you may restrict access to a portion of view by using the following twig functions:

{% if can('calendar_meetings') %}

<p>This will show only if the user belongs to a Rainlab.User Usergroup that includes the permision named "calendar_meetings".</p>

{% else %}

<p>This will show if the user DOES NOT belong to a Rainlab.User Usergroup that include the permision named "calendar_meetings".</p>

{% endif %}



{% if inGroup('my_admins') %}

<p>This will show only if the user belongs to a Rainlab.User Usergroup that has the code "my_admins".</p>

{% else %}

<p>This will show if the user DOES NOT belong to a Rainlab.User Usergroup that has the code "my_admins".</p>

{% endif %}


<p>This will show for all users regardless of permissions.</p>


{% if inGroupName('My Admins') %}

<p>This will show only if the user belongs to a Rainlab.User Usergroup that is named "My Admins".</p>

{% else %}

<p>This will show if the user DOES NOT belong to a Rainlab.User Usergroup that is named "My Admins".</p>

{% endif %}


<p>This will show for all users regardless of permissions.</p>

##Available Twig Functions##

• can('KeyName') - Check a passage key name

• hasKeyName('KeyName') - Check a passage key name

• hasKeyNames(['KeyName1','KeyName2','KeyName3']) - Check an array of passage key names

• hasKey(KeyId) (where KeyId is an integer) - Check a passage key id

• hasKeys([KeyId1,KeyId2,KeyId3]) - Check an array of passage key ids

• inGroupName('GroupName') - Check a passage group name

• inGroupNames(['Group Name','Group Name 2','Group Name 3']) - Check an array of passage group names

• inGroup('GroupCode') - Check a passage group code

• inGroups(['GroupCode1','GroupCode2','GroupCode3']) - Check an array of passage group codes

###User Permisions in Your Own Plugins######

// Passage Service Methods can be accessed in one of two ways:
$permission_keys_by_name = PassageService::passageKeys(); // by Alias
//OR
$permission_keys_by_name = app('PassageService')::passageKeys(); // by App Service

// Get all permision keys for the user in an array
$permission_keys_by_name = app('PassageService')::passageKeys();

/**
* OR
* 
* In your plugin you may restrict access to a portion of code:
**/

// check for permission directly using hasKeyName( $key_name )
$permissionGranted = app('PassageService')::hasKeyName('view_magic_dragon');
if($permissionGranted) {
	// Do stuff
}

/**
* OR
* 
* 	Lets say you have a model that uses a permission field containg the id of a
*   permission key and want to see if model permission matches.
* 
* 	Example:
* 	$model->perm_id = 5 which came from a dropdown that contained keys 
* 	from PassageService::passageKeys();
**/

$model = Model::first();
// check for permission directly using hasKey( $key_id )
if(PassageService::hasKey($model->perm_id)) {
    // Do Stuff
}else{
    // Do other Stuff if user does NOT have permission  
}

/**
* OR
* 
* 	Get Array of Groups
**/

// You can get array of the users groups keyed by the code of the group
$groups = PassageService::passageGroups()

/**
* OR
* 
* 	Check group membership by group code
**/

// use hasGroup($group_code) to check membership
$isCool = PassageService::hasGroup('cool_people')

/**
* OR
* 
* 	Check group membership by group Name
*   Note: Group names are not guaranteed to be unique.
*   DO NOT CHECK BY GROUP NAME if security is an issue.
**/

// use hasGroupName($group_name) to check membership
$isInGroupNamedCool = PassageService::hasGroupName('Cool')

##Available Passage Service Methods##

• passageKeys() - Get an array of all approved passage keys for the user

• can($key_name) - (alias of hasKeyName())

• hasKeyName($key_name) - Check a passage key name

• hasKey(integer $key_id) - Check a passage key id

• hasKeys(array $check_key_ids) - Check an array of passage key ids

• hasKeyNames(array $check_keys) - Check an array of passage key names

• passageGroups() - Get an array of all approved passage groups for the user

• inGroupName($group_name) - Check a passage group name

• hasGroupName($group_name) - (alias of inGroupName())

• inGroup($group_code) - Check a passage group code

• hasGroup($group_code) - (alias of inGroup())

• inGroups(array $check_group_codes) - Check an array of passage group ids

• inGroupNames(array $check_groups) - Check an array of passage group names

Like this plugin?

If you like this plugin or if you use some of my plugins, you can help me by submiting a review in the market. Small donations also help keep me motivated.

Please do not hesitate to find me in the IRC channel or contact me for assistance. Sincerely Kurt Jensen