Skip to content
Emre Akay edited this page Jul 4, 2014 · 33 revisions

Aauth is a User Authorization Library for CodeIgniter 2.x, which aims to make easy some essential jobs such as login, permissions and access operations. Despite ease of use, it has also very advanced features like private messages, groupping, access management, public access etc..

After Quick Start, Take a look detailed Documentation from wiki

Features


  • User Management and Operations (login, logout, register, vertification via e-mail, forgoten password, ban management, login ddos protection)
  • Group Operations (Creaing, deleting groups, membership management)
  • Admin and Public Group support (Public permissions) Permission Management (creating,deleting permissons, allow, deny groups, public permissions, permission checking)
  • Group Permissions
  • User Permissions (new)
  • User and System Variables (new)
  • Login Ddos Protection (new)
  • Private Messages (pm between users)
  • Error Mesages and Validations
  • Langugage and config file support
  • Flexible

What is new in Verison 2


  • User Permissions
  • User and System Variables
  • Login Ddos Protection
  • Some functions has changed
  • Some bugs fixed

if you were using Version 1 before, take a look at Migration Page from here.

Quick Start


Let's start :)
Firstly we will load Aauth Library to system

$this->load->library("Aauth");

thats OK.

Now we will create 2 new users, Ali and John

$this->aauth->create_user('ali@ali.com','alispass','Ali Akay');
$this->aauth->create_user('john@john.com','johnspass','John Button');

thats it. now we have two users.

Lets Create two group governors and commons :)

$this->aauth->create_group('governors');
$this->aauth->create_user('commons');

ok now we have two groups.

Lets create a permissions 'incrase_tax' and 'change_government'

$this->aauth->create_perm('increase_tax');
$this->aauth->create_perm('change_government');

Ok, now lets give accesses. logically 'governors' will have 'increase_tax' permission and 'commons' will have 'change_government' access.
ok lets give proper access with alow() function

$this->aauth->allow('governors','increase_tax');
$this->aauth->allow('commons','change_government');
  
  
$this->aauth->allow_group('commons','increase_tax');

Ops wait a minute. commons cannot 'increase_tax'. we need to fix it, we will use deny() to take back permission.

$this->aauth->deny('commons','increase_tax');

Ok now lets check if commons can 'increase_tax'

if($this->aauth->is_allowed('commons','increase_tax')){
    // i dont think so
} else {
   // do sth in the middle
}

i think 'increse_tax' must have never been created. delete it

$this->aauth->delete_perm('increase_tax');

now better.

So what about public people? (public means not logged users). can public people travel? Lets assume we have permissions namely 'travel' , of course.

$this->aauth->allow('public','travel')

So Admin? what can he do? He can access everthing, You dont need to give permiision ( allow() ) him, he already has.

ok lets lokk at private messages. John (his id=3) will send pm to Ali(id=4)

$this->aauth->send_pm(3,4,'Hi bro. i need you',' can you gimme your credit card?')

sorry John you will be banned :(

$this->aauth->ban_user(3);

Quick Start is done but thats not the end
Take a look detailed Documentation from wiki

Dont forget to watch Aauth.
You can also contribute and help me :)

Aauth Version 2 has been released

Some functions has changed. Dont forget to scan the new features and functions from Wiki

Clone this wiki locally