README

Diagnostics and plugin management for TentaPress.

Plugin Details

Features

• Environment information (PHP, Laravel, app versions)
• Database driver and status
• Storage status
• Cache status
• Plugin list with enable/disable controls
• Plugin catalog for discovering first-party plugins (tentapress/*) with card-grid visual browsing
• Catalog icon metadata support from local/hosted catalog sources
• Install queue progress feedback on catalog install actions
• Delete actions for recent install attempts on /admin/plugins, including stale running entries
• Queue-based plugin installs from admin (vendor/package, GitHub URL, or Packagist URL)
• First-party plugin installs use an explicit pre-1.0 Composer constraint so Packagist resolution works on production installs
• Queue-based plugin updates from admin (defaults to installed plugins; full composer update gated by TP_ALLOW_FULL_COMPOSER_UPDATE=true)
• Install/update jobs auto-detect usable php and composer binaries; config overrides are optional
• Serialized install jobs to avoid overlapping Composer runs
• Runtime cache refresh for OPCache-backed hosts after plugin lifecycle changes

Dependencies

None.

Admin Menu

Configuration

// plugins/tentapress/system-info/config/system-info.php
'catalog' => [
    'local_path' => 'docs/catalog/first-party-plugins.json',
    'url' => 'https://github.com/tentaplane/tentapress/blob/main/docs/catalog/first-party-plugins.json',
    'timeout_seconds' => 5,
    'cache_ttl_seconds' => 900,
    'require_https' => true,
],

'plugin_lifecycle' => [
    'php_binary' => '',
    'composer_binary' => '',
],

• system-info ships its own defaults, so new releases do not depend on changes to the root config/tentapress.php.
• local_path points to the generated first-party catalog feed in this monorepo.
• url defaults to the TentaPress repository source-of-truth feed and is resolved to raw GitHub content when fetching.
• If hosted data is unavailable, the catalog falls back to local data (and cached hosted data when available).
• Catalog plugin entries can include an optional icon field.
• plugin_lifecycle overrides are optional and only needed when automatic binary detection is not sufficient.
• Regenerate the local feed with php artisan tp:catalog generate.
• Validate the committed feed with php artisan tp:catalog check.

Development

php artisan tp:plugins sync
php artisan tp:plugins enable tentapress/system-info

Testing

composer test
composer test:filter -- SystemInfoDiagnosticsAccessTest