despark/laravel-db-i18n

Database localization package for laravel framework

, _(*1)

, _(*2)

Despark's igniCMS DB Localization Module

About

This package extends despark/igni-core by adding a fully functional DB Localization Module., _(*3)

Installation

Require using Composer, _(*4)

composer require despark/laravel-db-i18n

Note: despark/igni-core comes out of the box with this module.

Example usage

config/ignicms.php php ... 'languages' => [ // Add languages that you will use in your app. [ 'locale' => 'en', 'name' => 'English', ], [ 'locale' => 'de', 'name' => 'Deutsche', ], [ 'locale' => 'fr', 'name' => 'Français', ], ], ... database/migrations/create_articles_table.php, _(*5)

```php ... /** * Run the migrations. * * @return void */
public function up() { Schema::create('articles', function (Blueprint $table) { $table->increments('id'); $table->string('url'); $table->timestamps(); }); }, <sub>(*6)</sub>

/**
 * Reverse the migrations.
 *
 * @return void
 */
public function down()
{
    Schema::dropIfExists('articles');
}

... ```, <sub>(*7)</sub>

database/migrations/create_articles_i18n_table.php, <sub>(*8)</sub>

```php ... /** * Run the migrations. * * @return void */
public function up() { Schema::create('articles_i18n', function (Blueprint $table) { $table->increments('id'); $table->unsignedInteger('parent_id'); $table->string('locale'); $table->string('title'); $table->text('content')->nullable(); $table->timestamps();, <sub>(*9)</sub>

        $table->foreign('parent_id')
               ->references('id')
               ->on('articles')
               ->onDelete('cascade')
               ->onUpdate('cascade');
    });
}

/**
 * Reverse the migrations.
 *
 * @return void
 */
public function down()
{
    Schema::dropIfExists('articles_i18n');
}

... ```, <sub>(*10)</sub>

App\Models\Article.php, <sub>(*11)</sub>

```php ...
use Despark\Cms\Models\AdminModel; use Despark\LaravelDbLocalization\Contracts\Translatable; use Despark\LaravelDbLocalization\Traits\HasTranslation;, <sub>(*12)</sub>

class Article extends AdminModel implements Translatable
{
    use HasTranslation;

    protected $table = 'articles';

    protected $translatable = [
        'title',
        'content',
    ];

    protected $fillable = [
        'title',
        'content',
        'url',
    ];

    protected $rules = [
        'title' => 'required',
        'content' => 'required',
        'url' => 'required',
    ];

    protected $identifier = 'articles';
 }

... ```, <sub>(*13)</sub>

App\Http\Controllers\Admin\ArticlesController.php, <sub>(*14)</sub>

```php ...
use Despark\Cms\Http\Controllers\AdminController;, <sub>(*15)</sub>

class ArticlesController extends AdminController
{
}

... ```, <sub>(*16)</sub>

config\entities\articles.php php return [ 'name' => 'Articles', 'description' => 'Articles resource', 'model' => App\Models\Article::class, 'controller' => App\Http\Controllers\Admin\ArticlesController::class, 'adminColumns' => [ 'title' => 'translation.title', 'created at' => 'created_at', ], 'actions' => ['edit', 'create', 'destroy'], 'adminFormFields' => [ 'title' => [ 'type' => 'text', 'label' => 'Title', ], 'content' => [ 'type' => 'textarea', 'label' => 'Content', ], 'url' => [ 'type' => 'text', 'label' => 'Url', ], ], 'adminMenu' => [ 'articles' => [ 'name' => 'Articles', 'iconClass' => 'fa-newspaper-o', 'link' => 'articles.index', ], ], ];, <sub>(*17)</sub>