`panel:plugins`

Menampilkan plugin apa saja yang terpasang, pada Panel mana plugin diregistrasikan, serta version dan compatibility requirement-nya.

Gunakan command ini ketika sebuah Panel bermasalah dan Anda perlu mengetahui:

screen/resource/widget berasal dari plugin mana;
version plugin yang sedang digunakan.

Output command ini juga berguna untuk disertakan dalam bug report.

bash

php artisan panel:plugins

Contoh:

text

+-------+---------+---------+---------------------+---------+----------+
| Panel | ID      | Name    | Package             | Version | Requires |
+-------+---------+---------+---------------------+---------+----------+
| admin | billing | Billing | acme/panda-billing  | 1.4.1   | ^1.2     |
| admin | audit   | Audit   | in this application | unknown | any      |
| app   | billing | Billing | acme/panda-billing  | 1.4.1   | ^1.2     |
+-------+---------+---------+---------------------+---------+----------+

Sebuah Panel dengan beberapa plugin memiliki beberapa sumber:

Resources;
Pages;
Widgets;
Routes.

Saat salah satunya bermasalah, mengetahui plugin dan version jauh lebih berguna daripada stack trace yang hanya menyebut framework.

Signature

text

panel:plugins
    {--panel= : Only this panel}

Option	Default	Efek
`--panel=`	semua Panel	Filter berdasarkan Panel id dengan exact match, bukan prefix.

bash

php artisan panel:plugins
php artisan panel:plugins --panel=admin

Panel id berasal dari provider class:

text

AdminPanelProvider
→ admin

Jika value tidak cocok dengan Panel mana pun, command menghasilkan zero rows dan tidak dianggap failure.

Empty string dianggap sama dengan tidak memberikan filter.

Jika tidak ada plugin:

text

INFO  No plugins are registered.

Column pada Report

Column	Sumber	Fallback
Panel	`Panel::getId()`	—
ID	key pada `Panel::getPlugins()`, yaitu `PanelPlugin::id()`	—
Name	`PluginMetadata::$name`	Base `Plugin` memberi headline dari id
Package	`PluginMetadata::$package`	`in this application`
Version	`PluginMetadata::version()`	`unknown`
Requires	`PluginMetadata::$requiresPanel`	`any`

in this application dan unknown memiliki arti berbeda.

in this application berarti plugin tidak mendeklarasikan Composer package. Ini valid untuk project-local plugin yang version-nya mengikuti application.

unknown berarti metadata menyebut package yang tidak diketahui Composer. Ini biasanya metadata bug pada plugin.

Sumber Version

Version dibaca langsung dari Composer installed package data melalui:

php

Composer\InstalledVersions::getPrettyVersion()

Jadi jika report menampilkan:

text

1.4.1

itulah actual installed version, bukan version string yang harus di-update manual oleh plugin author.

PluginMetadata:

php

use PandaPanel\Plugins\PluginMetadata;

final readonly class PluginMetadata
{
    public function __construct(
        public string $name,
        public ?string $package = null,
        public ?string $requiresPanel = null,
        public ?string $url = null,
    ) {}

    public function version(): ?string;

    /** @return array{name: string, package: string|null, version: string|null, requiresPanel: string|null, url: string|null} */
    public function toArray(): array;
}

Contoh plugin metadata:

php

use PandaPanel\Plugins\Plugin;
use PandaPanel\Plugins\PluginMetadata;

final class BillingPlugin extends Plugin
{
    public function metadata(): PluginMetadata
    {
        return new PluginMetadata(
            name: 'Billing',
            package: 'acme/panda-billing',
            requiresPanel: '^1.2',
            url: 'https://example.com/panda-billing',
        );
    }
}

url tersedia di metadata tetapi tidak ditampilkan sebagai table column agar report tidak terlalu lebar.

Baca menggunakan:

php

$plugin->metadata()->toArray();

Membaca Data yang Sama dari Code

php

use PandaPanel\Core\PanelManager;

$manager = app(PanelManager::class);

foreach ($manager->all() as $panel) {
    foreach ($panel->getPlugins() as $id => $plugin) {
        $metadata = $plugin->metadata();

        printf(
            "%s / %s %s\n",
            $panel->getId(),
            $id,
            $metadata->version() ?? 'unknown',
        );
    }
}

API:

Method	Signature
`PanelManager::all()`	`all(): list<Panel>` — sorted berdasarkan Panel id
`Panel::getPlugins()`	`getPlugins(): array<string, PanelPlugin>`
`Panel::hasPlugin()`	`hasPlugin(string $id): bool`
`Panel::plugin()`	`plugin(string $id): ?PanelPlugin`
`PanelPlugin::metadata()`	`metadata(): PluginMetadata`

hasPlugin() hanya memeriksa plugin id, bukan version. ID harus stabil antar-release.

Bagaimana Plugin Dipasang ke Panel

Plugin diregistrasikan secara eksplisit pada Panel Provider.

Plugin tidak:

didiscover otomatis;
didaftarkan melalui config/panda-panel.php.

Contoh:

php

use Acme\PandaBilling\BillingPlugin;
use PandaPanel\Core\Panel;
use PandaPanel\Core\PanelProvider;

final class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->path('admin')
            ->plugins([new BillingPlugin]);
    }
}

Dua plugin dengan id yang sama pada Panel yang sama menyebabkan:

php

PandaPanel\Exceptions\PanelRegistrationException::duplicatePlugin()

saat boot.

requiresPanel juga diperiksa saat plugin diregistrasikan. Dengan begitu incompatible plugin dapat melaporkan compatibility problem sejak registration, bukan gagal jauh di dalam request.

Command Plugin Lain: `panel:publish`

Plugin yang membawa Vue components perlu mempublish component ke source tree application karena component registry menggunakan build-time import.meta.glob.

Signature:

text

panel:publish
    {plugin? : Only this plugin}
    {--force : Overwrite files that already exist}

Contoh:

bash

php artisan panel:publish
php artisan panel:publish billing
php artisan panel:publish billing --force

Output:

text

  [billing] /app/resources/js/pages/Panels/Admin/Widgets/Invoices.vue ..... published
  [billing] /app/resources/js/pages/Panels/Admin/Widgets/Plan.vue ... exists, skipped
INFO  Published 2 file(s).

Command berjalan melalui semua plugin pada semua Panel kemudian membaca:

php

publishes(): array<string, string>

dengan bentuk:

text

source path
→ destination path

Directory juga didukung.

Existing destination dilewati secara default dan dilaporkan.

--force menimpa existing file.

Source yang tidak ada hanya menghasilkan warning:

text

WARN  [billing] /app/vendor/acme/panda-billing/resources/js does not exist.

Jika tidak ada yang perlu dipublish:

text

Nothing to publish.

dengan exit 0.

Exit Codes

panel:plugins dan panel:publish selalu return:

text

Listing zero plugin adalah hasil valid.

Publish source yang tidak ada juga dilaporkan sebagai warning, bukan command failure.

Hal yang Perlu Diperhatikan

Plugin tampil satu kali per Panel tempat ia diregistrasikan. Plugin yang sama pada dua Panel menghasilkan dua row karena konfigurasi masing-masing Panel dapat berbeda.
--panel melakukan exact match terhadap id, bukan path atau display name.
Plugin tidak didiscover. Composer package yang terinstall tetapi tidak dimasukkan ke plugins([...]) tidak akan muncul.
unknown menandakan metadata package yang tidak dapat ditemukan Composer.
panel:publish tidak menimpa file secara default. Dengan --force, file ditimpa tanpa backup; commit dulu.
Published plugin component membutuhkan frontend build. import.meta.glob dievaluasi saat build.

panel:plugins ​

Signature ​

Column pada Report ​

Sumber Version ​

Membaca Data yang Sama dari Code ​

Bagaimana Plugin Dipasang ke Panel ​

Command Plugin Lain: panel:publish ​

Exit Codes ​

Hal yang Perlu Diperhatikan ​

Lihat Juga ​

`panel:plugins`

Signature

Column pada Report

Sumber Version

Membaca Data yang Sama dari Code

Bagaimana Plugin Dipasang ke Panel

Command Plugin Lain: `panel:publish`

Exit Codes

Hal yang Perlu Diperhatikan

Lihat Juga