Xetaravel\Http\Livewire\Admin\Roles\Permissions

Complexity

Total Complexity

20

Size/Duplication

Total Lines	243
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

12 Methods

Rating	Name	Duplication	Size	Complexity
A	getRowsQueryProperty()	0	6	1
A	generateSlug()	0	3	1
A	fireFlash()	0	26	6
A	rules()	0	7	1
A	render()	0	4	1
A	makeBlankModel()	0	3	1
A	getSelectedRowsQueryProperty()	0	5	1
A	create()	0	10	2
A	save()	0	10	2
A	getRowsProperty()	0	4	1
A	edit()	0	10	2
A	mount()	0	3	1

<?php

namespace Xetaravel\Http\Livewire\Admin\Roles;

use Illuminate\Contracts\Database\Query\Builder;
use Illuminate\Contracts\View\View;
use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Support\Str;
use Livewire\Component;
use Livewire\WithPagination;
use Xetaravel\Http\Livewire\Traits\WithCachedRows;
use Xetaravel\Http\Livewire\Traits\WithSorting;
use Xetaravel\Http\Livewire\Traits\WithBulkActions;
use Xetaravel\Http\Livewire\Traits\WithPerPagePagination;
use Xetaravel\Models\Permission;

class Permissions extends Component
{
    use WithPagination;

The trait Livewire\WithPagination requires the property $paginationTheme which is not provided by Xetaravel\Http\Livewire\Admin\Roles\Permissions.

    use WithSorting;
    use WithCachedRows;
    use WithBulkActions;

The trait Xetaravel\Http\Livewire\Traits\WithBulkActions requires some properties which are not provided by Xetaravel\Http\Livewire\Admin\Roles\Permissions: $selectedRowsQuery, $rows, $rowsQuery

    use WithPerPagePagination;

The trait Xetaravel\Http\Livewire\Traits\WithPerPagePagination requires the property $paginationTheme which is not provided by Xetaravel\Http\Livewire\Admin\Roles\Permissions.

    /**
     * The string to search.
     *
     * @var string
     */
    public string $search = '';

    /**
     * Used to update in URL the query string.
     *
     * @var string[]
     */
    protected $queryString = [
        'sortField' => ['as' => 'f'],
        'sortDirection' => ['as' => 'd'],
        'search' => ['except' => '', 'as' => 's']
    ];

    /**
     * The model used in the component.
     *
     * @var Permission
     */
    public Permission $model;

    /**
     * Used to show the Edit/Create modal.
     *
     * @var bool
     */
    public bool $showModal = false;

    /**
     * Used to show the delete modal.
     *
     * @var bool
     */
    public bool $showDeleteModal = false;

    /**
     * Used to set the modal to Create action (true) or Edit action (false).
     * @var bool
     */
    public bool $isCreating = false;

    /**
     * Number of rows displayed on a page.
     * @var int
     */
    public int $perPage = 10;

    /**
     * The Livewire Component constructor.
     *
     * @return void
     */
    public function mount(): void
    {
        $this->model = $this->makeBlankModel();
    }

    /**
     * Rules used for validating the model.
     *
     * @return string[]
     */
    public function rules()
    {
        return [
            'model.name' => 'required|min:5|max:30|unique:permissions,name,' . $this->model->id,
            'model.slug' => 'unique:permissions,slug,' . $this->model->id,
            'model.description' => 'required|min:5|max:150',
            'model.is_deletable' => 'required|boolean',
        ];
    }

    /**
     * Generate the slug from the `slugStrategy()` function and assign it to the model.
     *
     * @return void
     */
    public function generateSlug(): void
    {
        $this->model->slug = Str::slug($this->model->{$this->model->slugStrategy()}, config('roles.separator'));

The property slug does not exist on Xetaravel\Models\Permission. Since you implemented __set, consider adding a @property annotation.

    }

    /**
     * Create a blank model and return it.
     *
     * @return Permission
     */
    public function makeBlankModel(): Permission
    {
        return Permission::make();
    }

    /**
     * Function to render the component.
     *
     * @return View
     */
    public function render()
    {
        return view('livewire.admin.roles.permissions', [
            'permissions' => $this->rows

The property rows does not exist on Xetaravel\Http\Livewire\Admin\Roles\Permissions. Since you implemented __get, consider adding a @property annotation.

        ]);
    }

    /**
     * Create and return the query for the items.
     *
     * @return Builder
     */
    public function getRowsQueryProperty(): Builder
    {
        $query = Permission::query()
            ->search('name', $this->search);

        return $this->applySorting($query);
    }

    /**
     * Build the query or get it from the cache and paginate it.
     *
     * @return LengthAwarePaginator
     */
    public function getRowsProperty(): LengthAwarePaginator
    {
        return $this->cache(function () {
            return $this->applyPagination($this->rowsQuery);

The property rowsQuery does not exist on Xetaravel\Http\Livewire\Admin\Roles\Permissions. Since you implemented __get, consider adding a @property annotation.

        });
    }

    /**
     * Create a blank model and assign it to the model. (Used in create modal)
     *
     * @return void
     */
    public function create(): void
    {
        $this->isCreating = true;
        $this->useCachedRows();

        // Reset the model to a blank model before showing the creating modal.
        if ($this->model->getKey()) {
            $this->model = $this->makeBlankModel();
        }
        $this->showModal = true;
    }

    /**
     * Set the model (used in modal) to the permission we want to edit.
     *
     * @param Permission $permission The permission id to update.
     * (Livewire will automatically fetch the model by the id)
     *
     * @return void
     */
    public function edit(Permission $permission): void
    {
        $this->isCreating = false;
        $this->useCachedRows();

        // Set the model to the permission we want to edit.
        if ($this->model->isNot($permission)) {
            $this->model = $permission;
        }
        $this->showModal = true;
    }

    /**
     * Validate and save the model.
     *
     * @return void
     */
    public function save(): void
    {
        $this->validate();

        if ($this->model->save()) {
            $this->fireFlash('save', 'success');
        } else {
            $this->fireFlash('save', 'danger');
        }
        $this->showModal = false;
    }

    /**
     * Display a flash message regarding the action that fire it and the type of the message, then emit an
     * `alert ` event.
     *
     * @param string $action The action that fire the flash message.
     * @param string $type The type of the message, success or danger.
     * @param int $deleteCount If set, the number of permissions that has been deleted.
     *
     * @return void
     */
    public function fireFlash(string $action, string $type, int $deleteCount = 0)
    {
        switch ($action) {
            case 'save':
                if ($type == 'success') {
                    session()->flash(
                        'success',
                        $this->isCreating ? "The permission has been created successfully !" :
                            "The permission <b>{$this->model->title}</b> has been edited successfully !"

The property title does not exist on Xetaravel\Models\Permission. Since you implemented __get, consider adding a @property annotation.

                    );
                } else {
                    session()->flash('danger', "An error occurred while saving the permission !");
                }
                break;

            case 'delete':
                if ($type == 'success') {
                    session()->flash('success', "<b>{$deleteCount}</b> permissions has been deleted successfully !");
                } else {
                    session()->flash('danger', "An error occurred while deleting the permissions !");
                }
                break;
        }

        // Emit the alert event to the front so the DIsmiss can trigger the flash message.
        $this->emit('alert');
    }

    /**
     * Get all select rows that are deletable by their id, preparing for deleting them.
     *
     * @return mixed
     */
    public function getSelectedRowsQueryProperty()
    {
        return (clone $this->rowsQuery)

The property rowsQuery does not exist on Xetaravel\Http\Livewire\Admin\Roles\Permissions. Since you implemented __get, consider adding a @property annotation.

            ->unless($this->selectAll, fn($query) => $query->whereKey($this->selected))
            ->where('is_deletable', '=', true);
    }
}