README

Resources

Installation

The preferred way to install this extension is through composer.

Either run

$ php composer.phar require --prefer-dist simialbi/yii2-ticket

or add

"simialbi/yii2-ticket": "^1.0.0"

to the require section of your composer.json.

Usage

In order to use this module, you will need to:

Setup Module your application so that the module is available.
Create a user identity class which extends UserInterface.
Assign roles to users

Setup Module

Configure the module in the modules section of your Yii configuration file.

'modules' => [
    'ticket' => [
        'class' => 'simialbi\yii2\ticket\Module',
        //'richTextFields' => true,
        //'kanbanModule' => 'kanban',
        //'smsProvider' => 'smsProvider',
        //'canAssignTicketsToNonAgents' => false,
        //'on ticketCreated' => function ($event) {},
        //[...]
    ]
]

Parameters

Parameter	Description
`richTextFields`	Set this parameter to true to use rich text fields. To do this you need to add `simialbi/yii2-summernote` to the require section of your composer.json.
`kanbanModule`	If you use the Kanban Module too, you can put the id of the module here to use link functionality.
`smsProvider`	If you want to add SMS notification functionality, insert the sms component id here. It must implement `\simialbi\yii2\sms\ProviderInterface`.
`canAssignTicketsToNonAgents`	If set to true, agents can assign tickets to non agents

Events

Event	Description
`EVENT_TICKET_CREATED`	Will be triggered after a new ticket was created.
`EVENT_TICKET_UPDATED`	Will be triggered after a ticket was updated.
`EVENT_TICKET_ASSIGNED`	Will be triggered after a ticket was assigned to an agent.
`EVENT_TICKET_RESOLVED`	Will be triggered after a ticket was resolved.
`EVENT_TICKET_COMMENTED`	Will be triggered after a ticket received a new comment.

Setup console config and apply migrations

Apply the migrations either with the following command: yii migrate --migration-namespaces='simialbi\yii2\ticket\migrations' or configure your console like this:

[
    'controllerMap' => [
        'migrate' => [
            'class' => 'yii\console\controllers\MigrateController',
            'migrationNamespaces' => [
                'simialbi\yii2\ticket\migrations'
            ]
        ]
    ]
]

and apply the yii migrate command.

Be sure to have an authManager configured. The migration process creates the needed roles by this module.

Create identity

Create an identity class which implements simialbi\yii2\models\UserInterface e.g.:

<?php
use yii\db\ActiveRecord;
use simialbi\yii2\models\UserInterface;

class User extends ActiveRecord implements UserInterface
{
    /**
     * {@inheritDoc}
     */
    public static function tableName()
    {
        return 'user';
    }

    /**
     * {@inheritDoc}
     */
    public static function findIdentity($id)
    {
        return static::findOne($id);
    }

    /**
     * {@inheritDoc}
     */
    public static function findIdentityByAccessToken($token, $type = null)
    {
        return static::findOne(['access_token' => $token]);
    }

    /**
     * {@inheritDoc}
     */
    public function getId()
    {
        return $this->id;
    }

    /**
     * {@inheritDoc}
     */
    public function getAuthKey()
    {
        return $this->auth_key;
    }

    /**
     * {@inheritDoc}
     */
    public function validateAuthKey($authKey)
    {
        return $this->getAuthKey() === $authKey;
    }

    /**
     * {@inheritDoc}
     */
    public function getImage() {
        return $this->image;
    }

    /**
     * {@inheritDoc}
     */
    public function getName() {
        return trim($this->first_name . ' ' . $this->last_name);
    }

    /**
     * {@inheritDoc}
     */
    public function getEmail() {
        return $this->email;
    }

    /**
     * {@inheritDoc}
     */
    public function getMobile() {
        return $this->mobile;
    }

    /**
     * {@inheritDoc}
     */
    public static function findIdentities() {
        return static::find()->all();
    }
}

After creating this class define it as identity class in your application configuration:

'components' => [
    'user' => [
        'identityClass' => 'app\models\User'
    ]
]

Assign roles to users

The migration process created the needed roles and permissions by this module. You should now have the following roles created:

Role	Description
`ticketAuthor`	Users with this role assigned can create new tickets, update and close their own tickets and create new comments in their own tickets.
`ticketAgent`	Users with this role assigned can take tickets in assigned topics, create comments in tickets they have taken and resolve tickets.
`ticketAdministrator`	Users with this role assigned can administrate topics, take tickets in all topics, create comments in all tickets, assign tickets to agents and resolve all tickets.

Assign the roles to the corresponding users. Afterwards you can navigate to /ticket/topic to administrate your ticket topics (e.g. IT). Each user with a role assigned can navigate to /ticket to view either their own tickets (ticketAuthor), tickets of the topics they were assigned (ticketAgent) or all tickets of all topics (ticketAdministrator).

License

yii2-ticket is released under MIT license. See bundled LICENSE for details.

simialbi / yii2-ticket

Maintainers

Details