lovata/oc-shopaholic-plugin

View on GitHub
models/Category.php

Summary

Maintainability
B
4 hrs
Test Coverage
<?php namespace Lovata\Shopaholic\Models;

use Backend\Models\ImportModel;

use Kharanenka\Scope\ActiveField;
use Kharanenka\Scope\CodeField;
use Kharanenka\Scope\ExternalIDField;
use Kharanenka\Scope\NameField;
use Kharanenka\Scope\SlugField;

use October\Rain\Database\Traits\Sluggable;
use October\Rain\Database\Traits\Validation;
use October\Rain\Database\Traits\NestedTree;
use System\Models\SiteDefinition;

use Lovata\Toolbox\Traits\Helpers\TraitCached;
use Lovata\Toolbox\Traits\Models\MultisiteHelperTrait;
use Lovata\Shopaholic\Classes\Import\ImportCategoryModelFromCSV;

/**
 * Class Category
 * @package Lovata\Shopaholic\Models
 * @author  Andrey Kharanenka, a.khoronenko@lovata.com, LOVATA Group
 *
 * @mixin \October\Rain\Database\Builder
 * @mixin \Eloquent
 *
 * @property                                                                                     $id
 * @property bool                                                                                $active
 * @property string                                                                              $name
 * @property string                                                                              $slug
 * @property string                                                                              $code
 * @property string                                                                              $external_id
 * @property string                                                                              $preview_text
 * @property string                                                                              $description
 * @property array                                                                               $site_list
 * @property \October\Rain\Argon\Argon                                                           $created_at
 * @property \October\Rain\Argon\Argon                                                           $updated_at
 *
 * Nested tree properties
 * @property int                                                                                 $parent_id
 * @property int                                                                                 $nest_left
 * @property int                                                                                 $nest_right
 * @property int                                                                                 $nest_depth
 * @property Category                                                                            $parent
 * @property \October\Rain\Database\Collection|Category[]                                        $children
 * @method static $this children()
 *
 * Relations
 * @property \System\Models\File                                                                 $preview_image
 * @property \System\Models\File                                                                 $icon
 * @property \October\Rain\Database\Collection|\System\Models\File[]                             $images
 *
 * @property \October\Rain\Database\Collection|Product[]                                         $product
 * @method \October\Rain\Database\Relations\HasMany|Product product()
 *
 * @property \October\Rain\Database\Collection|SiteDefinition[]                                  $site
 * @method \October\Rain\Database\Relations\MorphToMany|SiteDefinition site()
 *
 * @property \October\Rain\Database\Collection|Product[]                                         $product_link
 * @method static \October\Rain\Database\Relations\BelongsToMany|Product product_link()
 *
 * @method static $this getByParentID(int $iParentID)
 *
 * Properties for Shopaholic
 * @see     \Lovata\PropertiesShopaholic\Classes\Event\CategoryModelHandler::addModelRelationConfig
 *
 * @property bool                                                                                $inherit_property_set
 * @property \October\Rain\Database\Collection|\Lovata\PropertiesShopaholic\Models\PropertySet[] $property_set
 * @method static \October\Rain\Database\Relations\BelongsToMany|\Lovata\PropertiesShopaholic\Models\PropertySet property_set()
 *
 * @property \October\Rain\Database\Collection|\Lovata\PropertiesShopaholic\Models\Property[]    $product_property
 * @property \October\Rain\Database\Collection|\Lovata\PropertiesShopaholic\Models\Property[]    $offer_property
 *
 * Search for Shopaholic, Sphinx for Shopaholic
 * @property string                                                                              $search_synonym
 * @property string                                                                              $search_content
 *
 * Discounts for Shopaholic
 * @property \October\Rain\Database\Collection|\Lovata\DiscountsShopaholic\Models\Discount[]     $discount
 * @method static \October\Rain\Database\Relations\BelongsToMany|\Lovata\DiscountsShopaholic\Models\Discount discount()
 *
 * Coupons for Shopaholic
 * @property \October\Rain\Database\Collection|\Lovata\CouponsShopaholic\Models\CouponGroup[]    $coupon_group
 * @method static \October\Rain\Database\Relations\BelongsToMany|\Lovata\CouponsShopaholic\Models\CouponGroup coupon_group()
 *
 * Campaign for Shopaholic
 * @property \October\Rain\Database\Collection|\Lovata\CampaignsShopaholic\Models\Campaign[]     $campaign
 * @method static \October\Rain\Database\Relations\BelongsToMany|\Lovata\CampaignsShopaholic\Models\Campaign campaign()
 *
 * VKontakte for Shopaholic
 * @property int                                                                                 $category_vk_id
 */
class Category extends ImportModel
{
    use Validation;
    use NestedTree;
    use Sluggable;
    use ActiveField;
    use NameField;
    use SlugField;
    use CodeField;
    use ExternalIDField;
    use TraitCached;
    use MultisiteHelperTrait;

    public $table = 'lovata_shopaholic_categories';

    public $implement = [
        '@RainLab.Translate.Behaviors.TranslatableModel',
    ];

    public $translatable = ['name', 'preview_text', 'description'];

    public $rules = [
        'name' => 'required',
        'slug' => 'required|unique:lovata_shopaholic_categories',
    ];

    public $attributeNames = [
        'name' => 'lovata.toolbox::lang.field.name',
        'slug' => 'lovata.toolbox::lang.field.slug',
    ];

    public $slugs = ['slug' => 'name'];

    public $attachOne = [
        'preview_image' => 'System\Models\File',
        'icon'          => 'System\Models\File',
        'import_file'   => [\System\Models\File::class, 'public' => false],
    ];
    public $attachMany = ['images' => 'System\Models\File'];

    public $belongsTo = [];
    public $belongsToMany = [
        'product_link' => [
            Product::class,
            'table' => 'lovata_shopaholic_additional_categories',
        ],
    ];
    public $hasMany = ['product' => Product::class];
    public $morphToMany = [
        'site' => [
            SiteDefinition::class,
            'name'     => 'entity',
            'table'    => 'lovata_shopaholic_entity_site_relation',
            'otherKey' => 'site_id',
        ],
    ];

    public $appends = [];
    public $purgeable = [];
    public $fillable = [
        'active',
        'name',
        'slug',
        'code',
        'external_id',
        'preview_text',
        'description',
    ];

    public $cached = [
        'id',
        'name',
        'slug',
        'code',
        'preview_text',
        'description',
        'parent_id',
        'preview_image',
        'icon',
        'images',
        'updated_at',
    ];

    public $dates = ['created_at', 'updated_at'];
    public $casts = [];

    public $visible = [];
    public $hidden = [];

    /**
     * Before validate event handler
     */
    public function beforeValidate()
    {
        if (empty($this->slug)) {
            $this->slugAttributes();
        }
    }

    /**
     * Get by parent ID
     * @param Category $obQuery
     * @param string   $sData
     * @return Category
     */
    public function scopeGetByParentID($obQuery, $sData)
    {
        return $obQuery->where('parent_id', $sData);
    }

    /**
     * Import item list from CSV file
     * @param array $arElementList
     * @param null  $sSessionKey
     * @throws \Throwable
     */
    public function importData($arElementList, $sSessionKey = null)
    {
        if (empty($arElementList)) {
            return;
        }

        $obImport = new ImportCategoryModelFromCSV();
        $obImport->setDeactivateFlag();

        foreach ($arElementList as $iKey => $arImportData) {
            $obImport->import($arImportData);
            $sResultMethod = $obImport->getResultMethod();
            if (in_array($sResultMethod, ['logUpdated', 'logCreated'])) {
                $this->$sResultMethod();
            } else {
                $sErrorMessage = $obImport->getResultError();
                $this->$sResultMethod($iKey, $sErrorMessage);
            }
        }

        $obImport->deactivateElements();
    }
}