[5.x] Addon Settings

README.md

@@ -22,6 +22,7 @@ The command will also give you the opportunity to indicate whether you'd like ex
 
 If you originally opt-out of importing existing content, then later change your mind, you can import existing content by running the relevant commands:
 
+- Addon Settings: `php please eloquent:import-addon-settings`
 - Assets: `php please eloquent:import-assets`
 - Blueprints and Fieldsets: `php please eloquent:import-blueprints`
 - Collections: `php please eloquent:import-collections`
@@ -47,6 +48,7 @@ If your assets are being driven by the Eloquent Driver and you're managing your
 
 If you wish to move back to flat-files, you may use the following commands to export your content out of the database:
 
+- Addon Settings: `php please eloquent:export-addon-settings`
 - Assets: `php please eloquent:export-assets`
 - Blueprints and Fieldsets: `php please eloquent:export-blueprints`
 - Collections: `php please eloquent:export-collections`

composer.json

@@ -25,7 +25,7 @@
     },
     "require": {
         "php": "^8.2",
-        "statamic/cms": "dev-master"
+        "statamic/cms": "dev-addons"
     },
     "require-dev": {
         "doctrine/dbal": "^3.8",

config/eloquent-driver.php

@@ -5,6 +5,11 @@
     'connection' => env('STATAMIC_ELOQUENT_CONNECTION', ''),
     'table_prefix' => env('STATAMIC_ELOQUENT_PREFIX', ''),
 
+    'addon_settings' => [
+        'driver' => 'file',
+        'model' => \Statamic\Eloquent\AddonSettings\AddonSettingsModel::class,
+    ],
+
     'asset_containers' => [
         'driver' => 'file',
         'model' => \Statamic\Eloquent\Assets\AssetContainerModel::class,

database/migrations/2025_07_07_100000_create_addon_settings_table.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+use Statamic\Eloquent\Database\BaseMigration as Migration;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        Schema::create($this->prefix('addon_settings'), function (Blueprint $table) {
+            $table->string('addon')->index()->primary();
+            $table->json('settings')->nullable();
+        });
+    }
+
+    public function down()
+    {
+        Schema::dropIfExists($this->prefix('addon_settings'));
+    }
+};

src/AddonSettings/AddonSettings.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Statamic\Eloquent\AddonSettings;
+
+use Illuminate\Database\Eloquent\Model;
+use Statamic\Extend\AddonSettings as AbstractAddonSettings;
+use Statamic\Facades\Addon;
+
+class AddonSettings extends AbstractAddonSettings
+{
+    protected $model;
+
+    public static function fromModel(Model $model)
+    {
+        $addon = Addon::get($model->addon);
+
+        return (new static($addon, $model->settings))->model($model);
+    }
+
+    public function toModel()
+    {
+        return self::makeModelFromContract($this);
+    }
+
+    public static function makeModelFromContract(AbstractAddonSettings $settings)
+    {
+        $class = app('statamic.eloquent.addon_settings.model');
+
+        return $class::firstOrNew(['addon' => $settings->addon()->id()])->fill([
+            'settings' => array_filter($settings->rawValues()),
+        ]);
+    }
+
+    public function model($model = null)
+    {
+        if (func_num_args() === 0) {
+            return $this->model;
+        }
+
+        $this->model = $model;
+
+        return $this;
+    }
+}

src/AddonSettings/AddonSettingsModel.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Statamic\Eloquent\AddonSettings;
+
+use Statamic\Eloquent\Database\BaseModel;
+
+class AddonSettingsModel extends BaseModel
+{
+    protected $guarded = [];
+
+    protected $table = 'addon_settings';
+
+    protected $primaryKey = 'addon';
+
+    protected $keyType = 'string';
+
+    public $timestamps = false;
+
+    protected function casts(): array
+    {
+        return [
+            'settings' => 'array',
+        ];
+    }
+}

src/AddonSettings/AddonSettingsRepository.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Statamic\Eloquent\AddonSettings;
+
+use Statamic\Contracts\Extend\AddonSettings as AddonSettingsContract;
+use Statamic\Extend\AddonSettingsRepository as FileAddonSettingsRepository;
+
+class AddonSettingsRepository extends FileAddonSettingsRepository
+{
+    public function find(string $addon): ?AddonSettingsContract
+    {
+        $model = app('statamic.eloquent.addon_settings.model')::find($addon);
+
+        if (! $model) {
+            return null;
+        }
+
+        return AddonSettings::fromModel($model);
+    }
+
+    public function save(AddonSettingsContract $settings): bool
+    {
+        return $settings->toModel()->save();
+    }
+
+    public function delete(AddonSettingsContract $settings): bool
+    {
+        return $settings->toModel()->delete();
+    }
+
+    public static function bindings(): array
+    {
+        return [
+            AddonSettingsContract::class => AddonSettings::class,
+        ];
+    }
+}

src/Commands/ExportAddonSettings.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Statamic\Eloquent\Commands;
+
+use Illuminate\Console\Command;
+use Statamic\Console\RunsInPlease;
+use Statamic\Contracts\Extend\AddonSettingsRepository as AddonSettingsRepositoryContract;
+use Statamic\Eloquent\AddonSettings\AddonSettingsModel;
+use Statamic\Extend\AddonSettingsRepository as FileAddonSettingsRepository;
+use Statamic\Facades\Addon;
+use Statamic\Statamic;
+
+class ExportAddonSettings extends Command
+{
+    use RunsInPlease;
+
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'statamic:eloquent:export-addon-settings';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Exports eloquent addon settings to flat files.';
+
+    /**
+     * Execute the console command.
+     *
+     * @return int
+     */
+    public function handle()
+    {
+        Statamic::repository(AddonSettingsRepositoryContract::class, FileAddonSettingsRepository::class);
+
+        AddonSettingsModel::all()->each(function ($model) {
+            Addon::get($model->addon)?->settings()->values($model->settings)->save();
+        });
+
+        $this->newLine();
+        $this->info('Addon settings exported');
+
+        return 0;
+    }
+}

src/Commands/ImportAddonSettings.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Statamic\Eloquent\Commands;
+
+use Illuminate\Console\Command;
+use Statamic\Console\RunsInPlease;
+use Statamic\Contracts\Extend\AddonSettingsRepository as AddonSettingsRepositoryContract;
+use Statamic\Extend\AddonSettingsRepository as FileAddonSettingsRepository;
+use Statamic\Facades\Addon;
+use Statamic\Statamic;
+
+class ImportAddonSettings extends Command
+{
+    use RunsInPlease;
+
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'statamic:eloquent:import-addon-settings';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Imports file-based addon settings into the database.';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): int
+    {
+        Statamic::repository(AddonSettingsRepositoryContract::class, FileAddonSettingsRepository::class);
+
+        Addon::all()
+            ->filter(fn ($addon) => collect($addon->settings()->rawValues())->filter()->isNotEmpty())
+            ->each(function ($addon) {
+                app('statamic.eloquent.addon_settings.model')::updateOrCreate(
+                    ['addon' => $addon->id()],
+                    ['settings' => $addon->settings()->rawValues()]
+                );
+            });
+
+        $this->components->info('Addon settings imported successfully.');
+
+        return 0;
+    }
+}

src/ServiceProvider.php

@@ -8,6 +8,7 @@
 use Statamic\Contracts\Assets\AssetRepository as AssetRepositoryContract;
 use Statamic\Contracts\Entries\CollectionRepository as CollectionRepositoryContract;
 use Statamic\Contracts\Entries\EntryRepository as EntryRepositoryContract;
+use Statamic\Contracts\Extend\AddonSettingsRepository as AddonSettingsRepositoryContract;
 use Statamic\Contracts\Forms\FormRepository as FormRepositoryContract;
 use Statamic\Contracts\Forms\SubmissionRepository as FormSubmissionRepositoryContract;
 use Statamic\Contracts\Globals\GlobalRepository as GlobalRepositoryContract;
@@ -19,6 +20,7 @@
 use Statamic\Contracts\Taxonomies\TaxonomyRepository as TaxonomyRepositoryContract;
 use Statamic\Contracts\Taxonomies\TermRepository as TermRepositoryContract;
 use Statamic\Contracts\Tokens\TokenRepository as TokenRepositoryContract;
+use Statamic\Eloquent\AddonSettings\AddonSettingsRepository;
 use Statamic\Eloquent\Assets\AssetContainerContents as EloquentAssetContainerContents;
 use Statamic\Eloquent\Assets\AssetContainerRepository;
 use Statamic\Eloquent\Assets\AssetQueryBuilder;
@@ -171,6 +173,10 @@ private function publishMigrations(): void
             __DIR__.'/../database/migrations/2024_07_16_100000_create_sites_table.php' => database_path('migrations/2024_07_16_100000_create_sites_table.php'),
         ], 'statamic-eloquent-site-migrations');
 
+        $this->publishes($addonSettingMigrations = [
+            __DIR__.'/../database/migrations/2025_07_07_100000_create_addon_settings_table.php' => database_path('migrations/2025_07_07_100000_create_addon_settings_table.php'),
+        ], 'statamic-eloquent-addon-setting-migrations');
+
         $this->publishes(
             array_merge(
                 $taxonomyMigrations,
@@ -189,6 +195,7 @@ private function publishMigrations(): void
                 $revisionMigrations,
                 $tokenMigrations,
                 $siteMigrations,
+                $addonSettingMigrations
             ),
             'migrations'
         );
@@ -204,6 +211,7 @@ private function publishMigrations(): void
 
     public function register()
     {
+        $this->registerAddonSettings();
         $this->registerAssetContainers();
         $this->registerAssets();
         $this->registerBlueprints();
@@ -224,6 +232,19 @@ public function register()
         $this->registerSites();
     }
 
+    private function registerAddonSettings()
+    {
+        if (config('statamic.eloquent-driver.addon_settings.driver', 'file') != 'eloquent') {
+            return;
+        }
+
+        $this->app->bind('statamic.eloquent.addon_settings.model', function () {
+            return config('statamic.eloquent-driver.addon_settings.model');
+        });
+
+        Statamic::repository(AddonSettingsRepositoryContract::class, AddonSettingsRepository::class);
+    }
+
     private function registerAssetContainers()
     {
         // if we have this config key then we started on 2.1.0 or earlier when
@@ -549,6 +570,7 @@ protected function addAboutCommandInfo()
         }
 
         AboutCommand::add('Statamic Eloquent Driver', collect([
+            'Addon Settings' => config('statamic.eloquent-driver.addon_settings.driver', 'file'),
             'Asset Containers' => config('statamic.eloquent-driver.asset_containers.driver', 'file'),
             'Assets' => config('statamic.eloquent-driver.assets.driver', 'file'),
             'Blueprints' => config('statamic.eloquent-driver.blueprints.driver', 'file'),