bagisto-admin-theme-development

管理画面テーマの開発

概要

Bagisto での管理画面テーマ開発では、Laravel パッケージとしてまとめたカスタム管理画面テーマを作成します。最終的には、独立して配布・保守できる自己完結型のパッケージになります。

適用するタイミング

次の場合にこのスキルを有効にします。

• カスタム管理画面テーマをパッケージとして作成するとき
• 配布用の管理画面テーマパッケージを構築するとき
• 管理画面のスタイルをカスタマイズするとき
• デフォルトの管理画面テンプレートをオーバーライドするとき

Bagisto 管理画面テーマのアーキテクチャ

コアコンポーネント

コンポーネント	目的	場所
テーマ設定	利用可能な管理画面テーマを定義します	config/themes.php
ビューのパス	Blade テンプレートファイル	テーマ設定で定義
アセットのパス	CSS、JS、画像	テーマ設定で定義
管理画面のサービスプロバイダー	ビューとコンポーネントを読み込みます	packages/Webkul/Admin/src/Providers/AdminServiceProvider.php

主な設定プロパティ

// config/themes.php
'admin-default' => 'default',

'admin' => [
    'default' => [
        'name' => 'Default',
        'assets_path' => 'public/themes/admin/default',
        'views_path' => 'resources/admin-themes/default/views',
        'vite' => [
            'hot_file' => 'admin-default-vite.hot',
            'build_directory' => 'themes/admin/default/build',
            'package_assets_directory' => 'src/Resources/assets',
        ],
    ],
],

参照ファイル — 現在のタスクに必要なものだけを読み込む

ファイル	読み込むタイミング
creating-a-theme.md	テーマパッケージのスキャフォールディングと登録
assets.md	Vite パイプライン、ビルド、開発サーバーのワークフロー
layouts.md	管理画面のレイアウト、Blade コンポーネント、カスタムレイアウト
reference.md	パッケージの構成、主要ファイル、注意点、テスト

必須サブスキル： 変更を完了とする前に、bagisto-change-verification を使用してください。