To install the Headless Refresh addon, follow these steps:
-
Install the addon via Composer:
composer require isaadsalman/headless-refresh
-
Publish the addon assets and configuration:
php artisan vendor:publish --tag=headless-refresh-config
-
Update the configuration file
config/statamic/headless-refresh.php
as needed (see the Configuration section below).
The configuration for the Headless Refresh addon is found in config/statamic/headless-refresh.php
. Modify the following options as required:
return [
'event_trigger' => env('HEADLESS_REFRESH_EVENT_TRIGGER', false),
'trigger_link' => env('HEADLESS_REFRESH_TRIGGER_LINK', null),
'deployment_message' => env('HEADLESS_REFRESH_DEPLOYMENT_MESSAGE', "Deployed"),
'events' => [
Statamic\Events\EntrySaved::class,
Statamic\Events\EntryDeleted::class,
Statamic\Events\NavSaved::class,
Statamic\Events\NavDeleted::class,
Statamic\Events\NavTreeSaved::class,
Statamic\Events\NavTreeDeleted::class,
Statamic\Events\TaxonomySaved::class,
Statamic\Events\TaxonomyDeleted::class,
],
];
event_trigger
: Set totrue
to enable the event-based trigger.trigger_link
: Define the URL or link that triggers the headless refresh.deployment_message
: Customize the message displayed upon successful deployment.events
: Specify the events that should trigger the headless refresh.
To enable the event-based trigger, set the event_trigger
to true
in the configuration file. This will trigger the headless refresh based on specified events.
You can add the Headless Refresh widget to your dashboard by including it using its handle 'headless-refresh'
.