NAME

Mango::Role - Module representing a user role

SYNOPSIS

    my $roles = $provider->search;
    while (my $role = $roles->next) {
        print $role->name, $role->description;
    };

DESCRIPTION

Mango::Role represents a user role.

METHODS

add_user

Sames as "add_users".

add_users

Arguments: @users

Adds a list of users to the current role.

    $role->add_users(23, $otheruser);

See "add_users" in Mango::Provider::Roles for more details.

created

Returns the date and time in UTC the role was created as a DateTime object.

    print $role->created;

description

Arguments: $description

Gets/sets the description of the current role.

    print $role->description;

destroy

Deletes the current role.

    $role->destroy;

id

Returns the id of the current role.

    print $role->id;

name

Arguments: $name

Gets/sets the name of the current role.

    print $role->name;

remove_users

Arguments: @users

Removes a list of users from the current role.

    $role->remove_users(23, $otheruser);

See "remove_users" in Mango::Provider::Roles for more details.

remove_user

Sames as remove_users.

update

Saves any changes made to the role back to the provider.

    $role->password('Red');
    $role->update;

Whenever "update" is called, "updated" is automatically set to the current time in UTC.

updated

Returns the date and time in UTC the role was last updated as a DateTime object.

    print $role->updated;

SEE ALSO

Mango::Object, Mango::Provider::Roles

AUTHOR

    Christopher H. Laco
    CPAN ID: CLACO
    claco@chrislaco.com
    http://today.icantfocus.com/blog/

cpanm Mango

perl -MCPAN -e shell
install Mango