Xetaravel\Http\Livewire\Admin\Discuss\Categories

Complexity

Total Complexity

20

Size/Duplication

Total Lines	254
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

12 Methods

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

<?php

namespace Xetaravel\Http\Livewire\Admin\Discuss;

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\DiscussCategory;

class Categories extends Component
{
    use WithPagination;

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

    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\Discuss\Categories: $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\Discuss\Categories.

    /**
     * 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 DiscussCategory
     */
    public DiscussCategory $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 color of the category displayed in the modal in realtime.
     *
     * @var string
     */
    public $color = '#dddddd';

    /**
     * The Livewire Component constructor.
     *
     * @return void
     */
    public function mount(): void
    {
        $this->model = $this->makeBlankModel();
        $this->perPage = config('xetaravel.pagination.blog.article_per_page');
    }

    /**
     * Rules used for validating the model.
     *
     * @return string[]
     */
    public function rules()
    {
        return [
            'model.title' => 'required|min:5',
            'model.slug' => 'unique:discuss_categories,slug,' . $this->model->id,
            'model.description' => 'required|min:10',
            'model.color' => 'min:7|max:9',
            'model.icon' => 'required',
            'model.level' => 'required|integer',
            'model.is_locked' => '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()});
    }

    /**
     * Set the color from the color model to display the color in the modal.
     *
     * @return void
     */
    public function generateColor(): void
    {
        $this->color = $this->model->color;
    }

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

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

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

        ]);
    }

    /**
     * Create and return the query for the items.
     *
     * @return Builder
     */
    public function getRowsQueryProperty(): Builder
    {
        $query = DiscussCategory::query()
            ->search('title', $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\Discuss\Categories. 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->color = '#dddddd';
        }
        $this->showModal = true;
    }

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

        // Set the model to the category we want to edit.
        if ($this->model->isNot($category)) {
            $this->model = $category;
            $this->color = $category->color;
        }
        $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 categories 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 category has been created successfully !" :
                            "The category <b>{$this->model->title}</b> has been edited successfully !"
                    );
                } else {
                    session()->flash('danger', "An error occurred while saving the category !");
                }
                break;

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

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