Terranet\Administrator\Field\Generic

Complexity

Total Complexity

49

Size/Duplication

Total Lines	468
Duplicated Lines	0 %

Importance

Changes

0

31 Methods

Rating	Name	Duplication	Size	Complexity
A	getDescription()	0	3	1
A	id()	0	3	1
A	setDescription()	0	5	1
A	name()	0	20	3
A	getModel()	0	3	1
A	setId()	0	5	1
A	render()	0	26	5
A	setTitle()	0	5	1
A	setModel()	0	5	1
A	setName()	0	5	1
A	__construct()	0	18	5
A	title()	0	3	1
A	makeFrom()	0	3	1
A	make()	0	9	2
A	switchTo()	0	3	1
A	translatable()	0	3	1
A	sortable()	0	8	1
A	descriptionKey()	0	9	2
A	hideLabel()	0	5	1
A	setPagesVisibility()	0	9	2
A	disableSorting()	0	5	1
A	value()	0	11	3
A	setAttribute()	0	11	3
A	translationKey()	0	9	2
A	getAttributes()	0	3	1
A	template()	0	6	1
A	isVisibleOnPage()	0	3	1
A	isHiddenLabel()	0	3	1
A	showOnPages()	0	3	1
A	setValue()	0	5	1
A	hideOnPages()	0	3	1

<?php

namespace Terranet\Administrator\Field;

use Coduo\PHPHumanizer\StringHumanizer;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\View;
use Terranet\Administrator\Contracts\Sortable;
use Terranet\Administrator\Field\Traits\AcceptsCustomFormat;
use Terranet\Administrator\Field\Traits\AppliesSorting;
use Terranet\Administrator\Scaffolding;
use Terranet\Administrator\Contracts\AutoTranslatable;
use Terranet\Administrator\Traits\AutoTranslatesInstances;

abstract class Generic implements Sortable, AutoTranslatable
{
    use AcceptsCustomFormat, AppliesSorting, AutoTranslatesInstances;

    /** @var string */
    protected $id;

    /** @var string */
    protected $title;

    /** @var string */
    protected $name;

    /** @var mixed */
    protected $value;

    /** @var string */
    protected $description;

    /** @var Model */
    protected $model;

    /** @var bool */
    protected $showLabel = true;

    /** @var array */
    protected $visibility = [
        Scaffolding::PAGE_INDEX => true,
        Scaffolding::PAGE_EDIT => true,
        Scaffolding::PAGE_VIEW => true,
    ];

    /** @var array */
    protected $attributes = [
        'class' => 'form-control',
    ];

    /**
     * Generic constructor.
     *
     * @param string $title
     * @param null|string $id
     */
    private function __construct(string $title, string $id = null)
    {
        $this->setId(
            snake_case($id ?: $title)
        );

        if ($this->translator()->has($key = $this->translationKey())) {
            $this->setTitle((string) $this->translator()->trans($key));
        } else {
            $this->setTitle(
                'id' === $this->id
                    ? 'ID'
                    : StringHumanizer::humanize(str_replace(['_id', '-', '_'], ['', ' ', ' '], $this->id))
            );
        }

        if ($this->translator()->has($key = $this->descriptionKey())) {
            $this->setDescription((string) $this->translator()->trans($key));
        }
    }

    /**
     * @param $title
     * @param null $id

Are you sure the doc-type for parameter $id is correct as it would always require null to be passed?

     * @param \Closure $callback
     *
     * @return static
     */
    public static function make($title, $id = null, \Closure $callback = null): self
    {
        $instance = new static($title, $id);

        if (null !== $callback) {
            $callback->call($instance, $instance);
        }

        return $instance;
    }

    /**
     * Create new element from another.
     *
     * @param Generic $element
     * @return static
     */
    public static function makeFrom(Generic $element): self
    {
        return static::make($element->title(), $element->id());
    }

    /**
     * Switch to a new element type.
     *
     * @param string $className
     * @return mixed
     */
    public function switchTo(string $className)
    {
        return forward_static_call_array([$className, "make"], [$this->title(), $this->id()]);
    }

    /**
     * @param Model $model
     *
     * @return static
     */
    public function setModel(Model $model): self
    {
        $this->model = $model;

        return $this;
    }

    /**
     * @return Model
     */
    public function getModel()
    {
        return $this->model;
    }

    /**
     * Render Element.
     *
     * @param string $page
     *
     * @return mixed
     */
    final public function render(string $page = 'index')
    {
        if ($this->format) {
            // Each Field can define its own data for custom formatter.
            $withData = method_exists($this, 'renderWith')
                ? $this->renderWith()
                : [$this->value(), $this->model];

            return $this->callFormatter($withData);
        }

        $data = [
            'field' => $this,
            'model' => $this->model,
            'attributes' => $this->getAttributes(),
        ];

        if (method_exists($this, $dataGetter = 'on'.title_case($page))) {
            $data += call_user_func([$this, $dataGetter]);
        }

        if (View::exists($view = $this->template($page))) {
            return View::make($view, $data);
        }

        return View::make($this->template($page, 'Key'), $data);
    }

    /**
     * Return Element ID.
     *
     * @return string
     */
    public function id(): string
    {
        return $this->id;
    }

    /**
     * Form name.
     *
     * @return string
     */
    public function name(): string
    {
        if (null === $this->name) {
            $parts = explode('.', $this->id());

            if (count($parts) > 1) {
                $first = array_first($parts);
                $other = array_slice($parts, 1);

                $other = array_map(function ($part) {
                    return "[$part]";
                }, $other);

                return $this->name = implode('', array_merge([$first], $other));
            }

            return $this->name = $this->id();
        }

        return $this->name;
    }

    /**
     * @param string $name
     * @return Generic
     */
    public function setName(string $name): self
    {
        $this->name = $name;

        return $this;
    }

    /**
     * @param string $id
     *
     * @return static
     */
    public function setId(string $id): self
    {
        $this->id = $id;

        return $this;
    }

    /**
     * Return Element title.
     *
     * @return string
     */
    public function title(): string
    {
        return $this->title;
    }

    /**
     * @return string
     */
    public function getDescription(): ?string
    {
        return $this->description;
    }

    /**
     * @param string $title
     *
     * @return static
     */
    public function setTitle(string $title): self
    {
        $this->title = $title;

        return $this;
    }

    /**
     * @param null|string $description
     *
     * @return static
     */
    public function setDescription(?string $description): self
    {
        $this->description = $description;

        return $this;
    }

    /**
     * Make element translatable.
     *
     * @return Translatable
     */
    public function translatable()
    {
        return Translatable::make($this);
    }

    /**
     * @param bool $showLabel
     *
     * @return static
     */
    public function hideLabel(bool $hideLabel): self
    {
        $this->showLabel = !$hideLabel;

        return $this;
    }

    /**
     * @return bool
     */
    public function isHiddenLabel(): bool
    {
        return !$this->showLabel;
    }

    /**
     * string $page.
     *
     * @return bool
     */
    public function isVisibleOnPage(string $page): bool
    {
        return (bool) $this->visibility[$page] ?? false;
    }

    /**
     * @param array|string $pages
     *
     * @return static
     */
    public function hideOnPages($pages): self
    {
        return $this->setPagesVisibility((array) $pages, false);
    }

    /**
     * @param array|string $pages
     *
     * @return static
     */
    public function showOnPages($pages): self
    {
        return $this->setPagesVisibility((array) $pages, true);
    }

    /**
     * Make column sortable.
     *
     * @param null|\Closure $callback
     *
     * @return static
     */
    public function sortable(\Closure $callback = null): self
    {
        app('scaffold.module')->addSortable(

The method addSortable() does not exist on Illuminate\Foundation\Application.

            $this->id(),
            $callback
        );

        return $this;
    }

    /**
     * Remove column from Sortable collection.
     *
     * @return static
     */
    public function disableSorting(): self
    {
        app('scaffold.module')->removeSortable($this->id());

The method removeSortable() does not exist on Illuminate\Foundation\Application.

        return $this;
    }

    /**
     * Set value.
     *
     * @param $value
     *
     * @return Generic
     */
    public function setValue($value): self
    {
        $this->value = $value;

        return $this;
    }

    /**
     * Extract Element value.
     *
     * @return mixed
     */
    public function value()
    {
        if (null !== $this->value) {
            return $this->value;
        }

        if (!$this->model) {
            return null;
        }

        return $this->model->getAttribute($this->id);
    }

    /**
     * @param $key
     * @param null $value

Are you sure the doc-type for parameter $value is correct as it would always require null to be passed?

     * @param mixed $attribute
     *
     * @return static
     */
    public function setAttribute($attribute, $value = null): self
    {
        if (is_array($attribute)) {
            foreach ($attribute as $key => $value) {
                $this->setAttribute($key, $value);
            }
        } else {
            $this->attributes[$attribute] = $value;
        }

        return $this;
    }

    /**
     * @return array
     */
    public function getAttributes(): array
    {
        return $this->attributes;
    }

    /**
     * @param mixed $pages
     * @param bool $visibility
     *
     * @return $this
     */
    protected function setPagesVisibility($pages, bool $visibility): self
    {
        $pages = array_intersect($pages, array_keys($this->visibility));

        foreach ($pages as $page) {
            $this->visibility[$page] = $visibility;
        }

        return $this;
    }

    /**
     * @param string $page
     * @param string $field
     *
     * @return string
     */
    protected function template(string $page, string $field = null): string
    {
        return sprintf(
            'administrator::fields.%s.%s',
            snake_case($field ?? class_basename($this)),
            $page
        );
    }

    /**
     * @return string
     */
    public function translationKey()
    {
        $key = sprintf('administrator::columns.%s.%s', $this->translatableModule()->url(), $this->id);

The method url() does not exist on Illuminate\Foundation\Application.

        if (!$this->translator()->has($key)) {
            $key = sprintf('administrator::columns.%s.%s', 'global', $this->id);
        }

        return $key;
    }

    /**
     * @return string
     */
    public function descriptionKey()
    {
        $key = sprintf('administrator::hints.%s.%s', $this->translatableModule()->url(), $this->id);

        if (!$this->translator()->has($key)) {
            $key = sprintf('administrator::hints.%s.%s', 'global', $this->id);
        }

        return $key;
    }
}