differentdevelopment/different-core

Dokumentáció

Telepítés

Egy teljesen új projekt esetén a telepítéshez a következő parancsokat kell futtatni:

laravel new PROJEKT-NEVE

composer require backpack/crud

composer require --dev backpack/generators

Adatbázis létrehozása és az .env-ben felvenni!

php artisan backpack:install

Fontos: Ha a Different-Core csomagot szeretnéd fejleszteni akkor létre kell hozni egy packages nevű mappát a gyökérkönyvtárban, és oda kicheckoutolni a repo-t!

composer require differentdevelopment/Different-Core

Backpack PRO kiegészítő feltelepítése: https://backpackforlaravel.com/products/pro-for-unlimited-projects (Installation rész)

composer require backpack/pro

Telepítés után

A parancsok lefuttatása után állítsuk be az alábbi értékeket a konfigurációs fájlokban:

config\backpack\base.php

'view_namespace' => 'different-core::',

'default_date_format' => 'YYYY. MMM. D.',

'default_datetime_format' => 'YYYY. MMM. D. HH:mm',

'avatar_type' => 'getProfileImageUrl',

'guard' => null,

'passwords' => null,

'project_name' => 'PROJEKT-NEVE',

'project_logo' => 'PROJEKT-NEVE',

'home_link' => '', // Csak admin rendszerek esetén, amúgy 'admin'

'developer_name' => 'Different Fejlesztő Kft.',

'developer_link' => 'https://different.hu',

'show_powered_by' => false,

config\app.php

'timezone' => 'Europe/Budapest',

'locale' => 'hu',

config\base.php

'middleware_class' => [ ... \Different\DifferentCore\app\Http\Middlewares\SetLangMiddleware::class, ]

config/backpack/crud.php

Itt a locales-t kitölteni, melyek a választható nyelvek.

config\auth.php

'model' => Different\DifferentCore\app\Models\User::class,

database\seeders\DatabaseSeeder.php

    public function run()
    {
        $this->call(\Different\DifferentCore\Database\Seeds\DifferentSeeder::class);
    }

app\Providers\RouteServiceProvider.php

public const HOME = '/';

Ne felejtsd el az .env fájl helyes kitöltését!

Ha ez megvolt akkor már csak az alábbi pár parancsot kell lefuttatni:

php artisan migrate --seed

php artisan vendor:publish --tag=config

Opcionális csomagok / kiegészítések

Módosított Backpack design

php artisan vendor:publish --tag=scss --force

Módosítsd a színeket a backpack-overrides.scss fájlban a :root { selectorban. Színek generálásához érdemes ezt használni: https://ionicframework.com/docs/theming/color-generator

Új elemet felvenni a vite.config.js fájlban a laravel -> input tömbhöz:

'resources/scss/backpack-overrides.scss'

Az új elemet felvenni a config/backpack/base.php -> vite_styles tömbhöz:

'resources/scss/backpack-overrides.scss',

yarn majd yarn dev futtatása.

Rendszer szintű logolás

Nyisd meg a app\Exceptions\Handler.php fájlt és módosítsd a register metódust erre:

    public function register()
    {
        $this->reportable(function (Throwable $e) {
            if ($this->shouldReport($e)) {
                store_system_logs($e);
            }
        });
    }

Larastan

A csomag előre telepítve van viszont rendszerenként a phpstan.neon config fájlt létre kell hozni.

https://packagist.org/packages/nunomaduro/larastan#1.0.3

Később futtatni a ./vendor/bin/phpstan analyse vagy automatizálni.

Demo projekt

https://github.com/differentdevelopment/Different-Core-Demo-Project