socialite.brannanatkinson.com

upload mass deface mass delete console info server
name : HasPreferences.php
 <?php

namespace Statamic\Preferences;

use Closure;
use Statamic\Support\Arr;
use Statamic\Support\Str;

trait HasPreferences
{
    /**
     * Get or set preferences.
     *
     * @param  null|array  $preferences
     * @return $this
     */
    public function preferences($preferences = null)
    {
        if (is_null($preferences)) {
            return $this->getPreferences();
        }

        $this->setPreferences($preferences);

        return $this;
    }

    /**
     * Get the preferences.
     *
     * @return array
     */
    abstract protected function getPreferences();

    /**
     * Set array of preferences.
     *
     * @param  array  $preferences
     * @return $this
     */
    abstract public function setPreferences($preferences);

    /**
     * Merge array of preferences.
     *
     * @param  array  $preferences
     * @return $this
     */
    abstract public function mergePreferences($preferences);

    /**
     * Set preference (dot notation in key supported).
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return $this
     */
    public function setPreference($key, $value)
    {
        $prefs = $this->getPreferences();

        Arr::set($prefs, $key, $value);

        $this->setPreferences($prefs);

        return $this;
    }

    /**
     * Remove preference (dot notation in key supported).
     *
     * @param  string  $key
     * @param  null|mixed  $value
     * @param  bool  $cleanup
     * @return $this
     */
    public function removePreference($key, $value = null, $cleanup = true)
    {
        if (is_null($value)) {
            $prefs = $this->getPreferences();
            Arr::forget($prefs, $key);
            $this->setPreferences($prefs);
        } else {
            $this->removePreferenceValue($key, $value);
        }

        if ($cleanup) {
            $this->cleanupPreference($key);
        }

        return $this;
    }

    /**
     * Remove a specific array value from a preference.
     *
     * @param  string  $key
     * @param  mixed  $value
     */
    protected function removePreferenceValue($key, $value)
    {
        $values = collect($this->getPreference($key));

        $removableKey = $values->search($value);

        if ($removableKey !== false) {
            $this->setPreference($key, $values->forget($removableKey)->values()->all());
        }

        return $this;
    }

    /**
     * Get preference (dot notation in key supported).
     *
     * @param  string  $key
     * @return mixed
     */
    public function getPreference($key)
    {
        return Arr::get($this->getPreferences(), $key);
    }

    /**
     * Check if preference exists (dot notation in key supported).
     *
     * @param  string  $key
     * @return bool
     */
    public function hasPreference($key)
    {
        return Arr::has($this->getPreferences(), $key);
    }

    /**
     * Modify a preference using a callback.
     *
     * @param  string  $key
     * @return $this
     */
    public function modifyPreference($key, Closure $callback)
    {
        $value = $this->getPreference($key);

        $prefs = $this->getPreferences();

        Arr::set($prefs, $key, $callback($value));

        $this->setPreferences($prefs);

        return $this;
    }

    /**
     * Append array of preferences onto an array of preferences.
     *
     * @param  string  $key
     * @param  array  $array
     * @return $this
     */
    public function appendPreferences($key, $array)
    {
        foreach ($array as $value) {
            $this->appendPreference($key, $value);
        }

        return $this;
    }

    /**
     * Append a value onto an array of preferences (will convert to array if necessary).
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return $this
     */
    public function appendPreference($key, $value)
    {
        return $this->modifyPreference($key, function ($original) use ($value) {
            $array = (array) $original;
            $array[] = $value;

            return $array;
        });
    }

    /**
     * Cleanup preference and it's parents to avoid leaving empty array/object data in yaml.
     *
     * @param  string  $key
     * @return $this
     */
    public function cleanupPreference($key)
    {
        $preference = $this->getPreference($key);

        if (is_int($preference) || is_bool($preference) || $preference) {
            return $this;
        }

        if ($this->hasPreference($key)) {
            $this->removePreference($key);
        }

        return Str::contains($key, '.')
            ? $this->cleanupPreference(preg_replace('/\.[^.]+$/', '', $key))
            : $this;
    }
}
UnknownSec Shell
