Skip to main content

​
Overview

Attributes can be associated to Eloquent models to allow custom data to be stored. Typically, these will be used the most with Products where different information is needed to be stored and presented to visitors. For example, a television might have the following attributes assigned…
  • Screen Size
  • Screen Technology
  • Tuner
  • Resolution

​
Attributes

Lunar\Models\Attribute
FieldDescription
attribute_typeMorph map of the model type that can use attribute, e.g. product
attribute_group_idThe associated group
positionAn integer used to define the sorting order of attributes within attribute groups
nameLaravel Collection of translations {'en': 'Screen Size'}
handleKebab-cased reference, e.g. screen-size
sectionAn optional name to define where an attribute should be used.
typeThe field type to be used, e.g. Lunar\FieldTypes\Number
requiredBoolean
default_value
configurationMeta data stored as a Laravel Collection
systemIf set to true, indicates it should not be deleted

​
Field Types

TypeConfig
Lunar\FieldTypes\NumberInteger or Decimal
Lunar\FieldTypes\TextSingle-line, Multi-line, Rich Text
Lunar\FieldTypes\TranslatedTextSingle-line, Multi-line, Rich Text
Lunar\FieldTypes\ListFieldAn re-orderable list of text values
::: tip INFO More field types will be coming soon. :::

​
Models that use Attributes

  • Lunar\Models\Product
  • Lunar\Models\ProductVariant
  • Lunar\Models\Collection

​
Saving Attribute Data

$product->attribute_data = collect([
    'meta_title' => new \Lunar\FieldTypes\Text('The best screwdriver you will ever buy!'),
    'pack_qty' => new \Lunar\FieldTypes\Number(2),
    'description' => new \Lunar\FieldTypes\TranslatedText(collect([
        'en' => new \Lunar\FieldTypes\Text('Blue'),
        'fr' => new \Lunar\FieldTypes\Text('Bleu'),
    ])),
]);

​
Adding attributes to your own model

use Lunar\Base\Casts\AsAttributeData;
use Lunar\Base\Traits\HasAttributes;

class Collection extends Model
{
    use HasAttributes;

    /**
     * Define which attributes should be cast.
     *
     * @var array
     */
    protected $casts = [
        'attribute_data' => AsAttributeData::class,
    ];

    //...
}
Then ensure you have a JSON field on your model’s table called attribute_data. ::: tip When loading models it is advised you eager load the attribute data required. :::

​
Accessing Attribute Data.

There will come times where you need to be able to retrieve the attribute data you have stored against a model. When you target the attribute_data property it will be cast as a collection and resolved into it’s corresponding field type. 
dump($product->attribute_data);

Illuminate\Support\Collection {#1522 ▼
  #items: array:2 [▼
    "name" => Lunar\FieldTypes\TranslatedText {#1533 ▼
      #value: Illuminate\Support\Collection {#1505 ▼
        #items: array:3 [▼
          "de" => Lunar\FieldTypes\Text {#1506 ▼
            #value: "Leren laarzen"
          }
          "en" => Lunar\FieldTypes\Text {#1514 ▼
            #value: "Leather boots"
          }
          "fr" => Lunar\FieldTypes\Text {#1502 ▼
            #value: "Bottes en cuires"
          }
        ]
      }
    }
    "description" => Lunar\FieldTypes\Text {#1537 ▼
      #value: "<p>I'm a description!</p>"
    }
  ]
}
If you need to just get the value for one field, you can use the translateAttribute method on the model: 
// Leather boots
$product->translateAttribute('name');

// Bootes en cuires
$product->translateAttribute('name', 'fr');

// Leather boots
$product->translateAttribute('name', 'FOO');
// We will default here to either the current system locale or the first value available.

​
Advanced usage

use Lunar\Base\Traits\HasAttributes;

class ProductType extends Model
{
    use HasAttributes;

    //...
}



use Lunar\Base\Casts\AsAttributeData;

class Product extends Model
{
    /**
     * Define which attributes should be cast.
     *
     * @var array
     */
    protected $casts = [
        'attribute_data' => AsAttributeData::class,
    ];

    //...
}



use Lunar\Base\Casts\AsAttributeData;

class ProductVariant extends Model
{
    /**
     * Define which attributes should be cast.
     *
     * @var array
     */
    protected $casts = [
        'attribute_data' => AsAttributeData::class,
    ];

    //...
}

​
Attribute Groups

Attribute Groups form a collection of attributes that are logically grouped together for display purposes. A good example might be an “SEO” attribute group which has attributes for “Meta Title” and “Meta Description”. 
Lunar\Models\AttributeGroup
FieldDescription
nameLaravel Collection of translations {'en': 'SEO'}
handleKebab-cased reference, e.g. seo
positionAn integer used to define the sorting order of groups