Command and config reference

'license' => [
    'key'        => env('CMS_LICENSE_KEY'),
    'repository' => 'packages.mcgstrategic.dev',   // CMS_LICENSE_REPOSITORY
],

'panel'  => ['id' => 'cms', 'path' => 'cms', 'brand' => 'CMS', 'default_parent' => 'homepage'],
'route'  => ['prefix' => '', 'middleware' => ['web'], 'frontend' => true], // CMS_FRONTEND_ENABLED

// Read-only delivery API. Off by default; see The delivery API.
'api' => [
    'enabled'     => false,                      // CMS_API_ENABLED
    'prefix'      => 'api/cms/v1',               // CMS_API_PREFIX
    'middleware'  => ['api', 'auth:sanctum'],
    'draft_guard' => 'sanctum',                  // CMS_API_DRAFT_GUARD
    'origins'     => [],                         // CMS_API_ORIGINS, comma-separated
],

'webhooks'      => ['enabled' => true, 'urls' => [], 'secret' => env('CMS_WEBHOOK_SECRET'), 'timeout' => 5],
'notifications' => ['enabled' => false, 'timeout' => 5],   // CMS_NOTIFICATIONS_ENABLED

'cache'  => ['enabled' => true, 'store' => null, 'ttl' => null, 'allowed_query_params' => []],
'media'  => ['disk' => 'public', 'max_upload_kb' => 10240, 'sanitize_svg' => true],
'dashboard' => ['widgets' => [/* four package widgets */], 'columns' => 2],
'vite'   => ['entries' => ['resources/css/app.css']],

// Editing a block from the public site, for an editor signed in to the panel.
'inline_editing'            => true,
'inline_editing_vite_entry' => null,   // null uses the panel's own stylesheet

'navigation' => [
    'types' => ['page'],
    'root'  => 'auto',   // 'top', or a path or content id
    'derived' => ['max_columns' => 6, 'max_links_per_column' => 6, 'max_dropdown_links' => 12],
],
'menus' => ['enabled' => true],

'theme' => [
    'skin' => null,         // press, signal, marquee, saas, arcade, market, or null
    'skins' => [],          // extra skins beyond the six that ship, key => label
    'skin_fonts' => [],     // Bunny Fonts families for an application skin, key => list
    'mode' => null, 'toggle' => true, 'fonts' => true,
    'menus' => ['header' => null, 'footer' => null],
    'home_link' => true,    // true or absent: the translated Home; null or '': none; a string: that label
],

'layouts'    => ['discover' => true, 'register' => []],
'preview'    => ['ttl_minutes' => 60],
'versions'   => ['keep' => null],
'draft_view' => [
    'enabled' => true, 'reload' => true, 'polling' => true, 'poll_seconds' => 2,
    'auth_check_seconds' => 60,   // session check for an open editor tab; 0 disables it
],

'snippets'     => ['enabled' => true, 'path_prefix' => '/_snippets'],
'layout_areas' => ['enabled' => true, 'path_prefix' => '/_layout-areas'],

'forms' => [
    'enabled' => true,
    'upload_disk' => 'local',                 // must be a private disk
    'upload_directory' => 'cms/form-uploads',
    'max_upload_kb' => 10240,
    'turnstile' => [
        'site_key' => env('CMS_TURNSTILE_SITE_KEY'),
        'secret_key' => env('CMS_TURNSTILE_SECRET_KEY'),
        'skip_locally' => true,
    ],
    'throttle' => ['per_minute' => 5, 'per_hour' => 20],
    'min_seconds' => 2,
    'retention_days' => null,
    'mail_from' => null,
],

'tags'    => ['enabled' => true, 'prefix' => 'tags', 'per_page' => 20],
'sitemap' => ['enabled' => true, 'robots' => true, 'ttl' => 3600, 'disallow' => ['/cms-preview']],
'feed'    => ['enabled' => true, 'path' => '/feed.xml', 'source' => null, 'limit' => 20, 'ttl' => 3600],
'structured_data' => ['enabled' => true],

'consent' => [
    'enabled' => true,
    'privacy_url' => '/privacy',
    'analytics_category' => 'analytics',
    'categories' => [
        ['key' => 'functional', 'label' => 'Functional', 'required' => true,  'default' => true],
        ['key' => 'analytics',  'label' => 'Analytics',  'required' => false, 'default' => false],
    ],
],

'permissions' => ['enabled' => false, 'super_admin' => null],

// The map block's address lookup (the Find button). The map itself has no settings.
'maps' => [
    'geocoder' => [
        'enabled' => true,
        'endpoint' => 'https://nominatim.openstreetmap.org/search',
        'user_agent' => null,   // null builds one from app.name and app.url
        'timeout' => 5,
        'cache_days' => 30,
    ],
],

'content_types' => [
    'discover' => ['App\\Cms\\ContentTypes' => null],
    'register' => [],
],

'blocks' => [
    'discover' => ['App\\Cms\\Blocks' => null],
    // Single-file Livewire blocks, keyed by component-name prefix. null
    // derives the directory under resources/views/livewire. [] switches it off.
    'livewire' => ['blocks' => null],
    'register' => [],
    'disable'  => [],
    'override' => [],
    'raw_html_ability' => null,
    'embed' => ['allowed_hosts' => []],
],

'mcp' => [
    'enabled' => true,
    'handle'  => 'cms',
    'name'    => env('CMS_MCP_NAME'),   // null reports "Filament CMS: " followed by app.name
    'actor'   => null,
    'local'   => ['trusted' => true],
    'web'     => ['enabled' => false, 'path' => '/mcp/cms', 'middleware' => []],
    'blocks'  => ['denied' => [], 'gated' => ['html']],
    // webhooks and notifications are always denied in addition to this list
    'settings'=> ['denied' => ['analytics']],
],

// Multilingual content. Off by default; see Multilingual sites.
'scoping' => [
    'sites_enabled'   => false,
    'locales_enabled' => false,   // CMS_LOCALES_ENABLED
    'default_locale'  => 'en',    // CMS_DEFAULT_LOCALE
    'locales'         => [],      // CMS_LOCALES, comma-separated
],
// Run php artisan cms:locales:backfill after enabling locales.

'theme' => [
    // ...
    // A colophon line at the end of the footer, for a license credit that
    // requires attribution. Rendered unescaped, so it can link to the license.
    // Stored in config, not the database, so no editor can change it.
    'footer_note' => null,
],