Расширение кода

JournalPHP построен на стандартных механизмах Laravel. Добавить новую функциональность можно без форка — через Service Providers, Events, Middleware и собственный код.

Сервис-провайдеры

Провайдеры зарегистрированы в config/app.php → providers:

Provider	Назначение
AppServiceProvider	Привязки интерфейсов (AI, модерация изображений)
RepositoryServiceProvider	Репозитории данных и конфигурации
MetaBuilderServiceProvider	SEO meta builders
EventServiceProvider	Регистрация событий и Socialite-провайдеров
HorizonServiceProvider	Horizon (доступ по email из админки → Доступы, /admin-panel/system/access)
RouteServiceProvider	Загрузка файлов маршрутов

Добавить привязку сервиса

В AppServiceProvider::register():

$this->app->bind(MyServiceInterface::class, MyService::class);
// или
$this->app->singleton(AnotherService::class);

Добавить OAuth-провайдер

1. Установите пакет из SocialiteProviders
2. Зарегистрируйте Listener в EventServiceProvider:

protected $listen = [
    SocialiteWasCalled::class => [
        'SocialiteProviders\\MyProvider\\MyProviderExtendSocialite',
    ],
];

3. Добавьте поля в AuthSettingsController и resources/js/Admin/Pages/Settings/Auth/Edit.vue
4. Сохраняйте Client ID / Secret в таблице config

Поддерживаемые OAuth-провайдеры: Google, Яндекс, ВКонтакте, Facebook, Apple, GitHub. One Tap (Google, Яндекс) настраивается на той же странице.

Паттерн Repository

Добавить новую настройку через Админ-панель

1. Миграция — добавьте запись в config:

DB::table('config')->insert([
    'key' => 'my_feature',
    'value' => json_encode(['enabled' => false]),
]);

2. Интерфейс — app/Repositories/Config/Interfaces/GetMyFeatureRepositoryInterface.php

3. Реализация — app/Repositories/Config/GetMyFeatureRepository.php

4. Привязка в RepositoryServiceProvider:

$this->app->bind(
    GetMyFeatureRepositoryInterface::class,
    GetMyFeatureRepository::class
);

5. Контроллер — app/Http/Controllers/Admin/MyFeatureSettingsController.php

6. Vue-страница — resources/js/Admin/Pages/Settings/MyFeature.vue

7. Маршрут в routes/admin.php

8. Раздел в config/admin_sections.php (ключ вида settings/my-feature) и пункт меню в AppSidebar.vue

Actions

Новые бизнес-операции оформляйте как Action-классы:

namespace App\Actions\MyFeature;

class DoSomethingAction
{
    public function execute(DoSomethingDTO $dto): Result
    {
        // бизнес-логика
    }
}

Вызов из контроллера:

public function store(MyRequest $request, DoSomethingAction $action)
{
    $result = $action->execute(DoSomethingDTO::fromRequest($request));
    return back();
}

Artisan-команды

Новые команды в app/Console/Commands/. Автозагружаются через $this->load() в Kernel.php.

php artisan make:command MyCommand

Middleware

Новый Middleware:

php artisan make:middleware MyMiddleware

Регистрация в app/Http/Kernel.php (глобально или в группах маршрутов).

События и Listeners

php artisan make:event PostPublished
php artisan make:listener NotifySubscribers --event=PostPublished

Регистрация в EventServiceProvider::$listen.

Observers

Наблюдатели за жизненным циклом модели:

// AppServiceProvider::boot()
Post::observe(PostObserver::class);

Добавить раздел в Админ-панель

1. Добавьте ключ в config/admin_sections.php:

'settings/my-section' => 'Мой раздел',

2. Добавьте пункт в resources/js/Admin/Layout/AppSidebar.vue

3. Создайте контроллер и маршрут в routes/admin.php:

Route::get('/admin-panel/my-section', [MySectionController::class, 'index']);

4. Создайте Inertia-страницу в resources/js/Admin/Pages/

Сменный драйвер (Driver Pattern)

Пример добавления нового AI-провайдера:

1. Реализуйте AiServiceInterface из app/Contracts/
2. Зарегистрируйте в AiServiceProvider с условием на конфигурацию
3. Добавьте поля выбора в AI Настройки (/admin-panel/ai-settings); переменные DEEPSEEK_* в .env используются как fallback до первой настройки в админке

Локальные пакеты

Через Composer path repository:

{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/my-package"
        }
    ]
}

Зарегистрируйте Service Provider пакета в config/app.php.

Маршруты

Файл	Тип маршрутов
routes/web.php	Публичные и авторизованные
routes/admin.php	Только для администраторов

Laravel Sanctum установлен, но routes/api.php отсутствует.

Форк

MIT-лицензия разрешает любые изменения в форке. Для значительных кастомизаций — сделайте форк и работайте в отдельном репозитории. Мержите обновления из основного репозитория через git merge upstream/master.