Vanilo uses Concord to manage its models. It means that every Vanilo model is ready to be customized by the application.
It's also very important that Vanilo will be aware of the customized model and it will be used in every piece of the code.
As an example if you customize the OrderItem model the Order::items() relationship will be
automatically using the customized OrderItem model instead of the built in one.
Custom Model Example
- Let's customize the
OrderItemmodel in our application, by adding an additional field and a relationship to it. - In the example we will add a
Referralrelationship to order items. - We assume that the
Referralmodel + table already exists in the application.
The customization of the order item model consists of 3 steps:
- Create the custom model class
- Register the customized model
- Create a migration for the extra fields
Custom Model Class
namespace App;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Vanilo\Order\Models\OrderItem as BaseOrderItem;
class OrderItem extends BaseOrderItem
{
public function referral(): BelongsTo
{
return $this->belongsTo(Referral::class);
}
}
Registering the Custom Model
To use the customized model in your application register it in the AppServiceProvider::boot()
method:
// app/Providers/AppServiceProvider.php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Vanilo\Order\Contracts\OrderItem as OrderItemContract;
class AppServiceProvider extends ServiceProvider
{
public function boot()
{
$this->app->concord->registerModel(
OrderItemContract::class, \App\OrderItem::class
);
}
}
Create a Migration
Just do it as with any usual Laravel migration:
// database/migrations/yyyy_mm_dd_HHiiss_add_referral_to_order_items.php
use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;
class AddReferralToOrderItems extends Migration
{
public function up()
{
Schema::table('order_items', function (Blueprint $table) {
$table->integer('referral_id')->unsigned();
$table->foreign('referral_id')->references('id')->on('referrals');
});
}
public function down()
{
Schema::table('order_items', function (Blueprint $table) {
$table->dropColumn('referral_id');
});
}
}
What Has Been Achived
1.) Whenever you retrieve an order its items are App\OrderItem model instances:
$order = Order::find(1);
$firstItem = $order->items->first();
echo get_class($firstItem);
// App\OrderItem
2.) You can set the referral_id:
$order = Order::create([
'number' => 'PO123456'
]);
$order->items()->create([
'product_type' => 'product',
'product_id' => 1234,
'price' => 100,
'name' => 'Something to sell',
'referral_id' => 456,
'quantity' => 1
]);
3.) You can use the referral relationship:
foreach ($order->items as $item) {
echo get_class($item->referral);
}
// App\Referral
Notes
- If you just want to add simple fields to a model, it's not necessary to use a custom model since Eloquent will automatically be able to use those fields. In this case a migration is sufficient
- If you don't want to inherit from the base model you can do so. But you have to implement the base
interface in your model and you have to register it with Concord's
registerModelmethod.