Update README.md

This commit is contained in:
Nic Waller 2013-05-28 22:58:59 -07:00
parent 6938eaacda
commit c059cb2b27

View File

@ -1,4 +1,47 @@
yourls-authmgr-plugin yourls-authmgr-plugin
===================== =====================
This plugin adds role-based access controls (RBAC) to YOURLS. This plugin adds role-based access controls (RBAC) to YOURLS. By assigning users to roles like "Editor" and "Contributor" you can limit the changes they are permitted to make.
With access controls enabled, you can safely delegate access to the admin pages.
Installation
------------
1. Download the [latest release](https://github.com/nicwaller/yourls-authmgr-plugin/tags) of yourls-authmgr-plugin.
1. Copy the plugin folder into your `user/plugins` folder for YOURLS.
1. Set up the parameters for authmgr (details below)
1. Activate the plugin with the plugin manager in the YOURLS admin interface.
Default Roles
-------------
The default roles are set up as follows:
* Administrator : No limits
* Editor : Cannot manage plugins
* Contributor : Cannot manage plugins, edit URLS, or delete URLs
Configuration
-------------
Add role assignments to your `user/config.php` file.
```
$authmgr_role_assignment = array(
'administrator' => array(
'your_username',
),
'editor' => array(
'your_close_friend',
),
'contributor' => array(
'your_other_friend',
),
);
```
You can also designate a range of IP addresses that will automatically be granted all capabilities. By default, all accesses from IPv4 localhost (127.0.0.0/8) are granted full access.
```
$authmgr_admin_ipranges = array(
'127.0.0.0/8',
);
```