Options / Import / Export / Customize

app/Config/Options.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace PluginFrame\Config;
+
+use PluginFrame\Core\Services\Container;
+use PluginFrame\Core\Services\Options\Interfaces\OptionStorageInterface;
+use PluginFrame\Core\Services\Options\WPOptionStorage;
+use PluginFrame\Core\Services\Options\CustomTableOption;
+use PluginFrame\Core\Services\Options\OptionManager;
+
+class Options
+{
+    public function __construct()
+    {
+        $this->pf_options_container_loader();
+    }
+
+    private function pf_options_container_loader(): void
+    {
+        Container::bind(
+            OptionStorageInterface::class . ':wp',
+            fn($c) => new WPOptionStorage()
+        );
+        Container::bind(
+            OptionStorageInterface::class . ':custom',
+            fn($c) => new CustomTableOption()
+        );
+        Container::bind(
+            OptionManager::class,
+            fn($c) => new OptionManager($c)
+        );
+        Container::bind(
+            OptionStorageInterface::class,
+            fn($c) => $c->get(OptionStorageInterface::class . ':wp')
+        );
+    }
+}

app/Core/Helpers/BootstrapHelper.php

@@ -109,6 +109,9 @@ private function load_features(): void
     {
         (new \PluginFrame\Config\Config())->priority_load_first();
 
+        // Initialize Options Container and Storage Services
+        new \PluginFrame\Config\Options();
+
         // Initialize providers and configuration.
         new \PluginFrame\Config\Providers();
 

app/Core/Helpers/OptionsHelper.php

@@ -0,0 +1,22 @@
+<?php
+namespace PluginFrame\Core\Helpers;
+
+use PluginFrame\Core\Services\Container;
+use PluginFrame\Core\Services\Options\OptionManager;
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+if (! function_exists('pf_options')) {
+    /**
+     * Shortcut to retrieve the global OptionManager.
+     *
+     * @return OptionManager
+     */
+    function pf_options(): OptionManager
+    {
+        // Use the static resolve() alias to fetch the manager
+        return Container::resolve(OptionManager::class);
+    }
+}

app/Core/PluginFrame.php

@@ -1,2 +0,0 @@
-<?php
-

app/Core/Services/Container.php

@@ -0,0 +1,90 @@
+<?php
+namespace PluginFrame\Core\Services;
+
+use Psr\Container\ContainerInterface;
+use Psr\Container\NotFoundExceptionInterface;
+
+/**
+ * A simple PSR-11–compatible service container.
+ * Implements a static singleton for global access.
+ */
+class Container implements ContainerInterface
+{
+    /** @var Container|null */
+    private static ?Container $instance = null;
+
+    /** @var array<string, callable> */
+    private array $definitions = [];
+
+    /** @var array<string, mixed> */
+    private array $instances = [];
+
+    /** Private to enforce singleton */
+    private function __construct() {}
+
+    /**
+     * Retrieve the singleton instance.
+     */
+    public static function getInstance(): Container
+    {
+        return self::$instance ??= new Container();
+    }
+
+    /**
+     * Bind a service ID to a resolver callable.
+     *
+     * @param string   $id       Service identifier.
+     * @param callable $resolver function(ContainerInterface): mixed
+     */
+    public static function bind(string $id, callable $resolver): void
+    {
+        self::getInstance()->definitions[$id] = $resolver;
+    }
+
+    /**
+     * Resolve a service by its ID.
+     *
+     * @param string $id Identifier of the entry to look for.
+     * @return mixed    The entry.
+     * @throws NotFoundExceptionInterface No entry was found for this identifier.
+     */
+    public function get(string $id): mixed
+    {
+        if (isset($this->instances[$id])) {
+            return $this->instances[$id];
+        }
+
+        if (! isset($this->definitions[$id])) {
+            throw new class("Service {$id} not found")
+                extends \Exception
+                implements NotFoundExceptionInterface {};
+        }
+
+        $resolver          = $this->definitions[$id];
+        $service           = $resolver($this);
+        $this->instances[$id] = $service;
+        return $service;
+    }
+
+    /**
+     * Static shortcut to resolve a service.
+     *
+     * @param string $id
+     * @return mixed
+     */
+    public static function resolve(string $id): mixed
+    {
+        return self::getInstance()->get($id);
+    }
+
+    /**
+     * Does this container have a resolver bound for $id?
+     *
+     * @param string $id Identifier to check.
+     * @return bool
+     */
+    public function has(string $id): bool
+    {
+        return isset($this->definitions[$id]);
+    }
+}

app/Core/Services/Options/CompositeOptionStorage.php

@@ -0,0 +1,57 @@
+<?php
+namespace PluginFrame\Core\Services\Options;
+
+use PluginFrame\Core\Services\Options\Interfaces\OptionStorageInterface;
+
+/**
+ * Composite driver: writes to multiple storage backends simultaneously.
+ */
+class CompositeOptionStorage implements OptionStorageInterface
+{
+    /** @var OptionStorageInterface[] */
+    private array $storages;
+
+    public function __construct(array $storages) {
+        $this->storages = $storages;
+    }
+
+    public function register(string $key, $default = null, array $args = []): void {
+        foreach ($this->storages as $storage) {
+            $storage->register($key, $default, $args);
+        }
+    }
+
+    public function get(string $key, $default = null) {
+        foreach ($this->storages as $storage) {
+            $value = $storage->get($key, null);
+            if (null !== $value) {
+                return $value;
+            }
+        }
+        return $default;
+    }
+
+    public function update(string $key, $value): bool {
+        $ok = true;
+        foreach ($this->storages as $storage) {
+            $ok = $ok && $storage->update($key, $value);
+        }
+        return $ok;
+    }
+
+    public function delete(string $key): bool {
+        $ok = true;
+        foreach ($this->storages as $storage) {
+            $ok = $ok && $storage->delete($key);
+        }
+        return $ok;
+    }
+
+    public function all(): array {
+        $all = [];
+        foreach ($this->storages as $storage) {
+            $all = array_merge($all, $storage->all());
+        }
+        return $all;
+    }
+}

app/Core/Services/Options/CustomTableOption.php

@@ -0,0 +1,66 @@
+<?php
+namespace PluginFrame\Core\Services\Options;
+
+use PluginFrame\Core\Services\Options\Interfaces\OptionStorageInterface;
+use wpdb;
+
+/**
+ * Stores options in a custom DB table for high-volume or structured data.
+ */
+class CustomTableOption implements OptionStorageInterface
+{
+    private wpdb $db;
+    private string $table;
+
+    public function __construct()
+    {
+        global $wpdb;
+        $this->db    = $wpdb;
+        $this->table = $wpdb->prefix . 'plugin_options';
+    }
+
+    public function register(string $key, $default = null, array $args = []): void
+    {
+        $exists = $this->db->get_var(
+            $this->db->prepare("SELECT COUNT(*) FROM {$this->table} WHERE option_key=%s", $key)
+        );
+        if (!$exists) {
+            $this->db->insert(
+                $this->table,
+                ['option_key' => $key, 'option_value' => maybe_serialize($default)],
+                ['%s','%s']
+            );
+        }
+    }
+
+    public function get(string $key, $default = null)
+    {
+        $row = $this->db->get_row(
+            $this->db->prepare("SELECT option_value FROM {$this->table} WHERE option_key=%s", $key),
+            ARRAY_A
+        );
+        return $row ? maybe_unserialize($row['option_value']) : $default;
+    }
+
+    public function update(string $key, $value): bool
+    {
+        return (bool) $this->db->update(
+            $this->table,
+            ['option_value' => maybe_serialize($value)],
+            ['option_key'   => $key],
+            ['%s'],
+            ['%s']
+        );
+    }
+
+    public function delete(string $key): bool
+    {
+        return (bool) $this->db->delete($this->table, ['option_key' => $key], ['%s']);
+    }
+
+    public function all(): array
+    {
+        $rows = $this->db->get_results("SELECT * FROM {$this->table}", ARRAY_A);
+        return array_column($rows, 'option_value', 'option_key');
+    }
+}

app/Core/Services/Options/Interfaces/OptionInterface.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace PluginFrame\Core\Services\Options\Interfaces;
+
+interface OptionInterface
+{
+    /**
+     * Register a new option into WordPress options table.
+     *
+     * @param string $key
+     * @param mixed $default
+     * @param array $args Optional args like description, type, group, etc.
+     * @return void
+     */
+    public function register(string $key, $default = null, array $args = []): void;
+
+    /**
+     * Get all registered options by this service.
+     *
+     * @return array
+     */
+    public function all(): array;
+
+    /**
+     * Get a specific option value.
+     *
+     * @param string $key
+     * @param mixed $default
+     * @return mixed
+     */
+    public function get(string $key, $default = null);
+
+    /**
+     * Update a specific option value.
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return bool
+     */
+    public function update(string $key, $value): bool;
+
+    /**
+     * Delete a registered option.
+     *
+     * @param string $key
+     * @return bool
+     */
+    public function delete(string $key): bool;
+}

app/Core/Services/Options/Interfaces/OptionStorageInterface.php

@@ -0,0 +1,14 @@
+<?php
+namespace PluginFrame\Core\Services\Options\Interfaces;
+
+/**
+ * Defines a storage strategy for plugin frame options.
+ */
+interface OptionStorageInterface
+{
+    public function register(string $key, $default = null, array $args = []): void;
+    public function get(string $key, $default = null);
+    public function update(string $key, $value): bool;
+    public function delete(string $key): bool;
+    public function all(): array;
+}