MOON
Server: Apache
System: Linux res.emeff.ca 3.10.0-962.3.2.lve1.5.24.10.el7.x86_64 #1 SMP Wed Mar 20 07:36:02 EDT 2019 x86_64
User: accemeff (1004)
PHP: 7.0.33
Disabled: NONE
Upload Files
File: /home/accemeff/vendor/craftcms/cms/src/models/FieldLayout.php
<?php
/**
 * @link https://craftcms.com/
 * @copyright Copyright (c) Pixel & Tonic, Inc.
 * @license https://craftcms.github.io/license/
 */

namespace craft\models;

use Craft;
use craft\base\Field;
use craft\base\FieldInterface;
use craft\base\Model;

/**
 * FieldLayout model class.
 *
 * @author Pixel & Tonic, Inc. <support@pixelandtonic.com>
 * @since 3.0
 */
class FieldLayout extends Model
{
    // Properties
    // =========================================================================

    /**
     * @var int|null ID
     */
    public $id;

    /**
     * @var string|null Type
     */
    public $type;

    /**
     * @var string|null UID
     */
    public $uid;

    /**
     * @var
     */
    private $_tabs;

    /**
     * @var
     */
    private $_fields;

    // Public Methods
    // =========================================================================

    /**
     * @inheritdoc
     */
    public function rules()
    {
        $rules = parent::rules();
        $rules[] = [['id'], 'number', 'integerOnly' => true];
        return $rules;
    }

    /**
     * Returns the layout’s tabs.
     *
     * @return FieldLayoutTab[] The layout’s tabs.
     */
    public function getTabs(): array
    {
        if ($this->_tabs !== null) {
            return $this->_tabs;
        }

        if (!$this->id) {
            return [];
        }

        return $this->_tabs = Craft::$app->getFields()->getLayoutTabsById($this->id);
    }

    /**
     * Return the field layout config or null if no fields configured.
     *
     * @return array|null
     */
    public function getConfig()
    {
        $output = [];

        foreach ($this->getTabs() as $tab) {
            $tabData = [
                'name' => $tab->name,
                'sortOrder' => $tab->sortOrder,
            ];

            /** @var Field $field */
            foreach ($tab->getFields() as $field) {
                $tabData['fields'][$field->uid] = [
                    'required' => $field->required,
                    'sortOrder' => $field->sortOrder
                ];
            }
            $output['tabs'][] = $tabData;
        }

        return $output ?: null;
    }

    /**
     * Return a field layout created from config data.
     *
     * @param array $config Config data to use.
     * @return self
     */
    public static function createFromConfig(array $config): self
    {
        $layout = new self();

        $tabs = [];
        $fieldService = Craft::$app->getFields();

        if (!empty($config['tabs']) && is_array($config['tabs'])) {
            foreach ($config['tabs'] as $tab) {
                $layoutTab = new FieldLayoutTab();
                $layoutTab->name = $tab['name'];
                $layoutTab->sortOrder = $tab['sortOrder'];

                if (!empty($tab['fields']) && is_array($tab['fields'])) {
                    $layoutFields = [];

                    foreach ($tab['fields'] as $uid => $field) {
                        /** @var Field $createdField */
                        $createdField = $fieldService->getFieldByUid($uid);

                        if ($createdField) {
                            $createdField->sortOrder = $field['sortOrder'];
                            $createdField->required = $field['required'];
                            $layoutFields[] = $createdField;
                        }
                    }

                    $layoutTab->setFields($layoutFields);
                    $tabs[] = $layoutTab;
                }
            }
        }

        if (!empty($tabs)) {
            $layout->setTabs($tabs);
        }

        return $layout;
    }

    /**
     * Returns the layout’s fields.
     *
     * @return FieldInterface[] The layout’s fields.
     */
    public function getFields(): array
    {
        if ($this->_fields !== null) {
            return $this->_fields;
        }

        if (!$this->id) {
            return [];
        }

        return $this->_fields = Craft::$app->getFields()->getFieldsByLayoutId($this->id);
    }

    /**
     * Returns the layout’s fields’ IDs.
     *
     * @return array The layout’s fields’ IDs.
     */
    public function getFieldIds(): array
    {
        $ids = [];

        foreach ($this->getFields() as $field) {
            /** @var Field $field */
            $ids[] = $field->id;
        }

        return $ids;
    }

    /**
     * Returns a field by its handle.
     *
     * @param string $handle The field handle.
     * @return Field|FieldInterface|null
     */
    public function getFieldByHandle(string $handle)
    {
        foreach ($this->getFields() as $field) {
            /** @var Field $field */
            if ($field->handle === $handle) {
                return $field;
            }
        }

        return null;
    }

    /**
     * Sets the layout’s tabs.
     *
     * @param array|FieldLayoutTab[] $tabs An array of the layout’s tabs, which can either be FieldLayoutTab
     * objects or arrays defining the tab’s attributes.
     */
    public function setTabs($tabs)
    {
        $this->_tabs = [];

        foreach ($tabs as $tab) {
            if (is_array($tab)) {
                $tab = new FieldLayoutTab($tab);
            }

            $tab->setLayout($this);
            $this->_tabs[] = $tab;
        }
    }

    /**
     * Sets the layout']”s fields.
     *
     * @param FieldInterface[] $fields An array of the layout’s fields, which can either be
     * FieldLayoutFieldModel objects or arrays defining the tab’s
     * attributes.
     */
    public function setFields(array $fields)
    {
        $this->_fields = $fields;
    }
}