NerdsAndCompany\Schematic\Services\Fields

Complexity

Total Complexity

51

Size/Duplication

Total Lines	430
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Test Coverage

Coverage

0%

Importance

Changes

0

22 Methods

Rating	Name	Duplication	Size	Complexity
A	getFieldFactory()	0	4	2
A	export()	0	18	3
A	getFieldDefinition()	0	8	1
B	import()	0	36	5
A	saveFieldGroupModel()	0	8	2
A	saveFieldModel()	0	12	3
A	deleteFields()	0	8	2
A	deleteGroups()	0	7	2
A	deleteFieldsAndGroups()	0	5	1
A	createFieldGroupModel()	0	9	2
A	getFieldModel()	0	4	2
A	validateFieldModel()	0	11	3
A	importFields()	0	19	3
A	unsetData()	0	9	3
A	setGlobalContext()	0	5	1
A	getFieldLayoutDefinition()	0	14	3
A	getFieldLayoutFieldsDefinition()	0	10	2
B	getFieldLayout()	0	22	4
A	getPrepareFieldLayout()	0	21	4
A	resetCraftFieldsServiceGroupsCache()	0	8	1
A	resetCraftFieldsServiceFieldsCache()	0	11	1
A	resetCraftDbSchemaContentTableCache()	0	8	1

<?php

namespace NerdsAndCompany\Schematic\Services;

use Craft\Craft;
use Craft\Exception;
use Craft\FieldModel;
use Craft\FieldGroupModel;
use Craft\FieldLayoutModel;
use Craft\ElementType;
use NerdsAndCompany\Schematic\Models\FieldFactory;

/**
 * Schematic Fields Service.
 *
 * Sync Craft Setups.
 *
 * @author    Nerds & Company
 * @copyright Copyright (c) 2015-2017, Nerds & Company
 * @license   MIT
 *
 * @see      http://www.nerds.company
 */
class Fields extends Base
{
    /**
     * @var FieldModel[]
     */
    private $fields = [];

    /**
     * @var FieldGroupModel[]
     */
    private $groups = [];

    /**
     * @var FieldFactory
     */
    private $fieldFactory;

    /**
     * @return FieldFactory
     */
    public function getFieldFactory()
    {
        return isset($this->fieldFactory) ? $this->fieldFactory : new FieldFactory();
    }

    //==============================================================================================================
    //================================================  EXPORT  ====================================================
    //==============================================================================================================

    /**
     * Export fields.
     *
     * @param FieldGroupModel[] $groups
     *
     * @return array
     */
    public function export(array $groups = [])
    {
        Craft::log(Craft::t('Exporting Fields'));

        $groupDefinitions = [];

        foreach ($groups as $group) {
            $fieldDefinitions = [];

            foreach ($group->getFields() as $field) {
                $fieldDefinitions[$field->handle] = $this->getFieldDefinition($field);
            }

            $groupDefinitions[$group->name] = $fieldDefinitions;
        }

        return $groupDefinitions;
    }

    /**
     * Get field definition.
     *
     * @param FieldModel $field
     *
     * @return array
     */
    private function getFieldDefinition(FieldModel $field)
    {
        $fieldFactory = $this->getFieldFactory();
        $schematicFieldModel = $fieldFactory->build($field->type);
        $definition = $schematicFieldModel->getDefinition($field, true);

        return $definition;
    }

    //==============================================================================================================
    //================================================  IMPORT  ====================================================
    //==============================================================================================================

    /**
     * Attempt to import fields.
     *
     * @param array $groupDefinitions
     * @param bool  $force            if set to true items not in the import will be deleted
     *
     * @return Result
     */
    public function import(array $groupDefinitions, $force = false)
    {
        Craft::log(Craft::t('Importing Fields'));

        if (!empty($groupDefinitions)) {
            $this->setGlobalContext();
            $this->resetCraftFieldsServiceGroupsCache();
            $this->groups = Craft::app()->fields->getAllGroups('name');
            $this->fields = Craft::app()->fields->getAllFields('handle');

            foreach ($groupDefinitions as $name => $fieldDefinitions) {
                try {
                    $this->beginTransaction();

                    $group = $this->createFieldGroupModel($name);

                    $this->importFields($fieldDefinitions, $group, $force);

                    $this->commitTransaction();
                } catch (\Exception $e) {
                    $this->rollbackTransaction();

                    $this->addError($e->getMessage());
                }

                $this->unsetData($name, $fieldDefinitions);
            }

            if ($force) { // Remove not imported data
                $this->deleteFieldsAndGroups();
            }
            $this->resetCraftFieldsServiceFieldsCache();
        }

        return $this->getResultModel();
    }

    /**
     * Save field group.
     *
     * @param FieldGroupModel $group
     *
     * @throws Exception
     */
    private function saveFieldGroupModel(FieldGroupModel $group)
    {
        if (!Craft::app()->fields->saveGroup($group)) {
            $this->addErrors($group->getAllErrors());

            throw new Exception('Failed to save group');
        }
    }

    /**
     * Save field.
     *
     * @param FieldModel $field
     *
     * @throws \Exception
     */
    private function saveFieldModel(FieldModel $field)
    {
        $this->validateFieldModel($field); // Validate field
        if ($field->context === 'global') {
            $this->setGlobalContext();
        }
        if (!Craft::app()->fields->saveField($field)) {
            $this->addErrors($field->getAllErrors());

            throw new Exception('Failed to save field');
        }
    }

    /**
     * Removes fields that where not imported.
     */
    private function deleteFields()
    {
        $fieldsService = Craft::app()->fields;
        foreach ($this->fields as $field) {
            $fieldsService->deleteFieldById($field->id);
        }
        $this->resetCraftDbSchemaContentTableCache();
    }

    /**
     * Removes groups that where not imported.
     */
    private function deleteGroups()
    {
        $fieldsService = Craft::app()->fields;
        foreach ($this->groups as $group) {
            $fieldsService->deleteGroupById($group->id);
        }
    }

    /**
     * Removes fields and groups that where not imported.
     */
    private function deleteFieldsAndGroups()
    {
        $this->deleteFields();
        $this->deleteGroups();
    }

    /**
     * Creates new or updates existing group model.
     *
     * @param string $group
     *
     * @return FieldGroupModel
     */
    private function createFieldGroupModel($group)
    {
        $groupModel = (array_key_exists($group, $this->groups) ? $this->groups[$group] : new FieldGroupModel());
        $groupModel->name = $group;

        $this->saveFieldGroupModel($groupModel);

        return $groupModel;
    }

    /**
     * @param string $field
     *
     * @return FieldModel
     */
    private function getFieldModel($field)
    {
        return array_key_exists($field, $this->fields) ? $this->fields[$field] : new FieldModel();
    }

    /**
     * Validates field type, throw error when it's incorrect.
     *
     * @param FieldModel $field
     *
     * @throws \Exception
     */
    private function validateFieldModel(FieldModel $field)
    {
        if (!$field->getFieldType()) {
            $fieldType = $field->type;
            ($fieldType == 'Matrix')
                ? $this->addError("One of the field's types does not exist. Are you missing a plugin?")
                : $this->addError("Field type '$fieldType' does not exist. Are you missing a plugin?");

            throw new Exception('Failed to save field');
        }
    }

    /**
     * Import field group fields.
     *
     * @param array           $fieldDefinitions
     * @param FieldGroupModel $group
     * @param bool            $force
     *
     * @throws \Exception
     */
    private function importFields(array $fieldDefinitions, FieldGroupModel $group, $force = false)
    {
        $fieldFactory = $this->getFieldFactory();

        foreach ($fieldDefinitions as $fieldHandle => $fieldDef) {
            $field = $this->getFieldModel($fieldHandle);
            $schematicFieldModel = $fieldFactory->build($fieldDef['type']);

            if ($schematicFieldModel->getDefinition($field, true) === $fieldDef) {
                Craft::log(Craft::t('Skipping `{name}`, no changes detected', ['name' => $field->name]));
                continue;
            }

            Craft::log(Craft::t('Importing `{name}`', ['name' => $fieldDef['name']]));

            $schematicFieldModel->populate($fieldDef, $field, $fieldHandle, $group, $force);
            $this->saveFieldModel($field);
        }
    }

    /**
     * Unset group and field data else $force flag will delete it.
     *
     * @param string $name
     * @param array  $definitions
     */
    private function unsetData($name, array $definitions)
    {
        if (array_key_exists($name, $this->groups)) {
            unset($this->groups[$name]);
            foreach ($definitions as $handle => $definition) {
                unset($this->fields[$handle]);
            }
        }
    }

    /**
     * Set global field context.
     */
    private function setGlobalContext()
    {
        Craft::app()->content->fieldContext = 'global';
        Craft::app()->content->contentTable = 'content';
    }

    //==============================================================================================================
    //=============================================  FIELD LAYOUT  =================================================
    //==============================================================================================================

    /**
     * Get field layout definition.
     *
     * @param FieldLayoutModel $fieldLayout
     *
     * @return array
     */
    public function getFieldLayoutDefinition(FieldLayoutModel $fieldLayout)
    {
        if ($fieldLayout->getTabs()) {
            $tabDefinitions = [];

            foreach ($fieldLayout->getTabs() as $tab) {
                $tabDefinitions[$tab->name] = $this->getFieldLayoutFieldsDefinition($tab->getFields());
            }

            return ['tabs' => $tabDefinitions];
        }

        return ['fields' => $this->getFieldLayoutFieldsDefinition($fieldLayout->getFields())];
    }

    /**
     * Get field layout fields definition.
     *
     * @param FieldLayoutFieldModel[] $fields
     *
     * @return array
     */
    private function getFieldLayoutFieldsDefinition(array $fields)
    {
        $fieldDefinitions = [];

        foreach ($fields as $field) {
            $fieldDefinitions[$field->getField()->handle] = $field->required;
        }

        return $fieldDefinitions;
    }

    /**
     * Attempt to import a field layout.
     *
     * @param array $fieldLayoutDef
     *
     * @return FieldLayoutModel
     */
    public function getFieldLayout(array $fieldLayoutDef)
    {
        $layoutFields = [];
        $requiredFields = [];

        if (array_key_exists('tabs', $fieldLayoutDef)) {
            foreach ($fieldLayoutDef['tabs'] as $tabName => $tabDef) {
                $layoutTabFields = $this->getPrepareFieldLayout($tabDef);
                $requiredFields = array_merge($requiredFields, $layoutTabFields['required']);
                $layoutFields[$tabName] = $layoutTabFields['fields'];
            }
        } elseif (array_key_exists('fields', $fieldLayoutDef)) {
            $layoutTabFields = $this->getPrepareFieldLayout($fieldLayoutDef);
            $requiredFields = $layoutTabFields['required'];
            $layoutFields = $layoutTabFields['fields'];
        }

        $fieldLayout = Craft::app()->fields->assembleLayout($layoutFields, $requiredFields);
        $fieldLayout->type = ElementType::Entry;

        return $fieldLayout;
    }

    /**
     * Get a prepared fieldLayout for the craft assembleLayout function.
     *
     * @param array $fieldLayoutDef
     *
     * @return array
     */
    private function getPrepareFieldLayout(array $fieldLayoutDef)
    {
        $layoutFields = [];
        $requiredFields = [];

        foreach ($fieldLayoutDef as $fieldHandle => $required) {
            $field = Craft::app()->fields->getFieldByHandle($fieldHandle);
            if ($field instanceof FieldModel) {

The class Craft\FieldModel does not exist. Did you forget a USE statement, or did you not list all dependencies?

                $layoutFields[] = $field->id;

                if ($required) {
                    $requiredFields[] = $field->id;
                }
            }
        }

        return [
            'fields' => $layoutFields,
            'required' => $requiredFields,
        ];
    }

    /**
     * Reset craft fields service groups cache using reflection.
     */
    private function resetCraftFieldsServiceGroupsCache()
    {
        $obj = Craft::app()->fields;
        $refObject = new \ReflectionObject($obj);
        $refProperty = $refObject->getProperty('_fetchedAllGroups');
        $refProperty->setAccessible(true);
        $refProperty->setValue($obj, false);
    }

    /**
     * Reset craft fields service fields cache using reflection.
     */
    private function resetCraftFieldsServiceFieldsCache()
    {
        $obj = Craft::app()->fields;
        $refObject = new \ReflectionObject($obj);
        $refProperty1 = $refObject->getProperty('_allFieldsInContext');
        $refProperty1->setAccessible(true);
        $refProperty1->setValue($obj, array());
        $refProperty2 = $refObject->getProperty('_fieldsByContextAndHandle');
        $refProperty2->setAccessible(true);
        $refProperty2->setValue($obj, array());
    }

    /**
     * Reset craft db schema content table cache using reflection.
     */
    private function resetCraftDbSchemaContentTableCache()
    {
        $obj = Craft::app()->db->schema;
        $refObject = (new \ReflectionObject($obj))->getParentClass()->getParentClass();
        $refProperty = $refObject->getProperty('_tables');
        $refProperty->setAccessible(true);
        $refProperty->setValue($obj, array());
    }
}