feat: add 10 more Elementor tools — revisions, performance settings, CPT support, maintenance mode, site settings (200 total, 52 Elementor)

includes/Elementor/Abilities/ElementorTools.php

@@ -5,6 +5,12 @@ defined('ABSPATH') || exit;
 /**
  * All Elementor MCP tools — pages, layouts, widgets, templates, globals.
  * No Freemius, no pro gates. All tools always available when Elementor is active.
+ *
+ * Tool counts:
+ *   - Original 32 layout/widget/template/kit tools
+ *   - +10 CSS/replace/custom-CSS/experiments/page-template tools
+ *   - +10 revisions/performance/CPT/maintenance/site-settings tools
+ *   Total: 52 Elementor tools / 200 plugin-wide
  */
 class ElementorTools {
 
@@ -16,14 +22,14 @@ class ElementorTools {
 
     public function getToolDefinitions(): array {
         return [
-            // ── existing 32 tools ──────────────────────────────────────────
+            // ── Layout / Widget / Template / Kit (original 32) ─────────────
             $this->def('elementor_create_page','Create a new WordPress page with Elementor enabled. Returns post_id, edit_url, preview_url.',['title'=>['type'=>'string'],'status'=>['type'=>'string','default'=>'draft','enum'=>['draft','publish']],'post_type'=>['type'=>'string','default'=>'page'],'template'=>['type'=>'string'],'content'=>['type'=>'array','items'=>['type'=>'object']]],['title'],'write','createPage'),
             $this->def('elementor_get_page','Get the full Elementor element tree JSON for a page.',['post_id'=>['type'=>'integer']],['post_id'],'read','getPage'),
             $this->def('elementor_update_page_settings','Update page-level Elementor settings (background, padding, custom CSS, layout).',['post_id'=>['type'=>'integer'],'settings'=>['type'=>'object']],['post_id','settings'],'write','updatePageSettings'),
             $this->def('elementor_delete_page_content','Clear all Elementor content from a page, resetting it to blank.',['post_id'=>['type'=>'integer']],['post_id'],'write','deletePageContent'),
             $this->def('elementor_import_template','Import a JSON element structure into a page at an optional position.',['post_id'=>['type'=>'integer'],'template_json'=>['type'=>'array','items'=>['type'=>'object']],'position'=>['type'=>'integer']],['post_id','template_json'],'write','importTemplate'),
             $this->def('elementor_export_page','Export a page\'s full Elementor data as JSON.',['post_id'=>['type'=>'integer']],['post_id'],'read','exportPage'),
-            $this->def('elementor_add_container','Add a flex or grid container to an Elementor page. Use parent_id for nesting, position for insertion index (-1 = append). Settings: flex_direction, flex_wrap, flex_justify_content, flex_align_items, gap, padding, background_color, border_border, etc.',['post_id'=>['type'=>'integer'],'parent_id'=>['type'=>'string'],'position'=>['type'=>'integer'],'settings'=>['type'=>'object']],['post_id'],'write','addContainer'),
+            $this->def('elementor_add_container','Add a flex or grid container to an Elementor page. Use parent_id for nesting, position for insertion index (-1 = append).',['post_id'=>['type'=>'integer'],'parent_id'=>['type'=>'string'],'position'=>['type'=>'integer'],'settings'=>['type'=>'object']],['post_id'],'write','addContainer'),
             $this->def('elementor_update_container','Update settings on an existing container element.',['post_id'=>['type'=>'integer'],'element_id'=>['type'=>'string'],'settings'=>['type'=>'object']],['post_id','element_id'],'write','updateContainer'),
             $this->def('elementor_update_element','Update settings on any Elementor element by ID.',['post_id'=>['type'=>'integer'],'element_id'=>['type'=>'string'],'settings'=>['type'=>'object'],'merge'=>['type'=>'boolean','default'=>true]],['post_id','element_id','settings'],'write','updateElement'),
             $this->def('elementor_remove_element','Remove any element (container or widget) from a page by element ID.',['post_id'=>['type'=>'integer'],'element_id'=>['type'=>'string']],['post_id','element_id'],'write','removeElement'),
@@ -50,29 +56,29 @@ class ElementorTools {
             $this->def('elementor_get_page_outline','Get a simplified structural outline of an Elementor page (containers + widget types).',['post_id'=>['type'=>'integer']],['post_id'],'read','getPageOutline'),
             $this->def('elementor_delete_items','Delete one or more elements (containers or widgets) from a page by element_id. Use element_ids array.',['post_id'=>['type'=>'integer'],'element_ids'=>['type'=>'array','items'=>['type'=>'string']],'element_id'=>['type'=>'string']],['post_id'],'write','deleteItems'),
 
-            // ── NEW 10 tools ───────────────────────────────────────────────
+            // ── CSS / Regeneration / Migration (+10) ───────────────────────
-
-            // CSS / Regeneration
             $this->def('elementor_flush_css','Flush and regenerate all Elementor CSS files across the entire site. Call after bulk design changes.',[],[],'write','flushCss'),
             $this->def('elementor_regenerate_css','Regenerate the Elementor CSS file for a single post/page.',['post_id'=>['type'=>'integer']],['post_id'],'write','regenerateCss'),
-
+            $this->def('elementor_replace_urls','Find and replace a URL string across ALL Elementor data in the database. Essential for domain migrations.',['old_url'=>['type'=>'string'],'new_url'=>['type'=>'string']],['old_url','new_url'],'admin','replaceUrls'),
-            // Replace URLs (migration / domain change)
-            $this->def('elementor_replace_urls','Find and replace a URL string across ALL Elementor data in the database. Essential for domain migrations and staging-to-production pushes.',['old_url'=>['type'=>'string'],'new_url'=>['type'=>'string']],['old_url','new_url'],'admin','replaceUrls'),
-
-            // Kit custom CSS
             $this->def('elementor_get_kit_custom_css','Get the global custom CSS stored in the Elementor Site Kit.',[],[],'read','getKitCustomCss'),
             $this->def('elementor_update_kit_custom_css','Set the global custom CSS in the Elementor Site Kit. Replaces existing kit-level CSS.',['css'=>['type'=>'string']],['css'],'write','updateKitCustomCss'),
-
-            // Per-page custom CSS
             $this->def('elementor_get_page_custom_css','Get the custom CSS set for a specific Elementor page (page-level, not kit-level).',['post_id'=>['type'=>'integer']],['post_id'],'read','getPageCustomCss'),
             $this->def('elementor_update_page_custom_css','Set the custom CSS for a specific Elementor page.',['post_id'=>['type'=>'integer'],'css'=>['type'=>'string']],['post_id','css'],'write','updatePageCustomCss'),
-
-            // Experiments / Feature Flags
             $this->def('elementor_list_experiments','List all Elementor feature flags (experiments) with their current state.',[],[],'read','listExperiments'),
             $this->def('elementor_set_experiment','Activate or deactivate an Elementor feature flag by name.',['name'=>['type'=>'string'],'state'=>['type'=>'string','enum'=>['active','inactive','default']]],['name','state'],'admin','setExperiment'),
-
-            // Page template
             $this->def('elementor_set_page_template','Set the WordPress page template for a post (e.g. elementor_canvas, elementor-full-width, default).',['post_id'=>['type'=>'integer'],'template'=>['type'=>'string']],['post_id','template'],'write','setPageTemplate'),
+
+            // ── Revisions / Performance / CPT / Maintenance / Site (+10) ───
+            $this->def('elementor_get_revisions','List all saved revisions for an Elementor post. Returns id, type, author, timestamp.',['post_id'=>['type'=>'integer']],['post_id'],'read','getRevisions'),
+            $this->def('elementor_restore_revision','Restore an Elementor post to a specific revision by revision ID.',['post_id'=>['type'=>'integer'],'revision_id'=>['type'=>'integer']],['post_id','revision_id'],'write','restoreRevision'),
+            $this->def('elementor_get_performance_settings','Get all Elementor performance settings (CSS print method, font display, lazy load, FA4 shim, caching, etc.).',[],[],'read','getPerformanceSettings'),
+            $this->def('elementor_update_performance_settings','Update one or more Elementor performance settings. Fields: css_print_method (external|internal), google_font (1|), load_fa4_shim (1|), lazy_load_background_images (1|), meta_generator_tag (1|), unfiltered_files_upload (1|), font_display (auto|block|swap|fallback|optional), google_maps_api_key (string), element_cache_ttl (int hours), optimized_gutenberg_loading (1|).',['settings'=>['type'=>'object']],['settings'],'admin','updatePerformanceSettings'),
+            $this->def('elementor_get_cpt_support','Get the list of post types where Elementor editor is enabled.',[],[],'read','getCptSupport'),
+            $this->def('elementor_set_cpt_support','Set which post types Elementor editor is enabled for. Pass post_types as array of slugs.',['post_types'=>['type'=>'array','items'=>['type'=>'string']]],['post_types'],'admin','setCptSupport'),
+            $this->def('elementor_get_maintenance_mode','Get current Elementor maintenance/coming-soon mode state.',[],[],'read','getMaintenanceMode'),
+            $this->def('elementor_set_maintenance_mode','Enable or disable Elementor maintenance or coming-soon mode.',['mode'=>['type'=>'string','enum'=>['maintenance','coming_soon','']],'page_id'=>['type'=>'integer'],'exclude_mode'=>['type'=>'string','enum'=>['logged_in','exclude_admins','']]],['mode'],'admin','setMaintenanceMode'),
+            $this->def('elementor_get_site_settings','Get Elementor site-level settings: Google Maps API key, font settings, CSS method, and other global options.',[],[],'read','getSiteSettings'),
+            $this->def('elementor_update_site_settings','Update Elementor site-level settings. Fields: google_maps_api_key, meta_generator_tag, google_font, font_display, load_fa4_shim, unfiltered_files_upload, css_print_method.',['settings'=>['type'=>'object']],['settings'],'admin','updateSiteSettings'),
         ];
     }
 
@@ -83,7 +89,7 @@ class ElementorTools {
     }
 
     // =========================================================
-    // EXISTING METHODS
+    // LAYOUT / WIDGET / TEMPLATE / KIT METHODS
     // =========================================================
 
     public function createPage(array $args): array {
@@ -423,7 +429,7 @@ class ElementorTools {
     }
 
     // =========================================================
-    // NEW METHODS — CSS / Regeneration
+    // CSS / REGENERATION / MIGRATION METHODS
     // =========================================================
 
     public function flushCss(array $args): array {
@@ -435,31 +441,23 @@ class ElementorTools {
     public function regenerateCss(array $args): array {
         $post_id = (int)($args['post_id'] ?? 0);
         if (!$post_id) throw new \RuntimeException('post_id is required.');
-        if (!class_exists('\Elementor\Core\Files\CSS\Post')) throw new \RuntimeException('Elementor CSS class not found.');
         $css_file = new \Elementor\Core\Files\CSS\Post($post_id);
         $css_file->update();
         return ['success'=>true,'post_id'=>$post_id,'message'=>"CSS regenerated for post {$post_id}."];
     }
 
-    // =========================================================
-    // NEW METHODS — Replace URLs
-    // =========================================================
-
     public function replaceUrls(array $args): array {
         $old = trim($args['old_url'] ?? '');
         $new = trim($args['new_url'] ?? '');
         if (empty($old) || empty($new)) throw new \RuntimeException('old_url and new_url are required.');
         if ($old === $new) return ['success'=>true,'updated'=>0,'message'=>'old_url and new_url are identical.'];
-
         global $wpdb;
         $posts = $wpdb->get_col($wpdb->prepare(
             "SELECT pm.post_id FROM {$wpdb->postmeta} pm WHERE pm.meta_key='_elementor_data' AND pm.meta_value LIKE %s",
             '%' . $wpdb->esc_like($old) . '%'
         ));
-
         $updated = 0;
         $errors  = [];
-
         foreach ($posts as $pid) {
             $raw = get_post_meta((int)$pid, '_elementor_data', true);
             if (empty($raw)) continue;
@@ -468,22 +466,15 @@ class ElementorTools {
             if ($new_raw === $raw) continue;
             $result = update_post_meta((int)$pid, '_elementor_data', wp_slash($new_raw));
             if ($result !== false) {
-                if (class_exists('\Elementor\Core\Files\CSS\Post')) {
+                if (class_exists('\Elementor\Core\Files\CSS\Post')) (new \Elementor\Core\Files\CSS\Post((int)$pid))->update();
-                    (new \Elementor\Core\Files\CSS\Post((int)$pid))->update();
-                }
                 $updated++;
             } else {
                 $errors[] = (int)$pid;
             }
         }
-
         return ['success'=>true,'old_url'=>$old,'new_url'=>$new,'posts_found'=>count($posts),'updated'=>$updated,'errors'=>$errors];
     }
 
-    // =========================================================
-    // NEW METHODS — Kit & page-level custom CSS
-    // =========================================================
-
     public function getKitCustomCss(array $args): array {
         $kit = $this->getActiveKit();
         if (!$kit) return ['css'=>'','note'=>'No active Elementor kit.'];
@@ -497,9 +488,7 @@ class ElementorTools {
         $settings = get_post_meta($kit->ID, '_elementor_page_settings', true) ?: [];
         $settings['custom_css'] = $args['css'] ?? '';
         update_post_meta($kit->ID, '_elementor_page_settings', $settings);
-        if (class_exists('\Elementor\Core\Files\CSS\Post')) {
+        if (class_exists('\Elementor\Core\Files\CSS\Post')) (new \Elementor\Core\Files\CSS\Post($kit->ID))->update();
-            (new \Elementor\Core\Files\CSS\Post($kit->ID))->update();
-        }
         return ['success'=>true,'kit_id'=>$kit->ID,'bytes'=>strlen($settings['custom_css'])];
     }
 
@@ -516,29 +505,16 @@ class ElementorTools {
         $settings = get_post_meta($post_id, '_elementor_page_settings', true) ?: [];
         $settings['custom_css'] = $args['css'] ?? '';
         update_post_meta($post_id, '_elementor_page_settings', $settings);
-        if (class_exists('\Elementor\Core\Files\CSS\Post')) {
+        if (class_exists('\Elementor\Core\Files\CSS\Post')) (new \Elementor\Core\Files\CSS\Post($post_id))->update();
-            (new \Elementor\Core\Files\CSS\Post($post_id))->update();
-        }
         return ['success'=>true,'post_id'=>$post_id,'bytes'=>strlen($settings['custom_css'])];
     }
 
-    // =========================================================
-    // NEW METHODS — Experiments / Feature Flags
-    // =========================================================
-
     public function listExperiments(array $args): array {
         if (!class_exists('\Elementor\Plugin')) throw new \RuntimeException('Elementor not active.');
         $features = \Elementor\Plugin::instance()->experiments->get_features();
         $list = [];
         foreach ($features as $name => $feature) {
-            $list[] = [
+            $list[] = ['name'=>$name,'title'=>$feature['title']??$name,'description'=>$feature['description']??'','state'=>$feature['state']??'default','default'=>$feature['default']??'inactive','is_active'=>\Elementor\Plugin::instance()->experiments->is_feature_active($name)];
-                'name'        => $name,
-                'title'       => $feature['title'] ?? $name,
-                'description' => $feature['description'] ?? '',
-                'state'       => $feature['state'] ?? 'default',
-                'default'     => $feature['default'] ?? 'inactive',
-                'is_active'   => \Elementor\Plugin::instance()->experiments->is_feature_active($name),
-            ];
         }
         return ['experiments'=>$list,'total'=>count($list)];
     }
@@ -553,30 +529,179 @@ class ElementorTools {
         $feature = $experiments->get_features($name);
         if (!$feature) throw new \RuntimeException("Experiment '{$name}' not found.");
         $option_key = $experiments->get_feature_option_key($name);
-        if ($state === 'default') {
+        if ($state === 'default') delete_option($option_key);
-            delete_option($option_key);
+        else update_option($option_key, $state);
-        } else {
-            update_option($option_key, $state);
-        }
         return ['success'=>true,'name'=>$name,'state'=>$state,'is_active'=>$experiments->is_feature_active($name)];
     }
 
-    // =========================================================
-    // NEW METHODS — Page Template
-    // =========================================================
-
     public function setPageTemplate(array $args): array {
         $post_id  = (int)($args['post_id'] ?? 0);
         $template = $args['template'] ?? '';
         if (!$post_id) throw new \RuntimeException('post_id is required.');
         if ($template === 'default') $template = '';
         update_post_meta($post_id, '_wp_page_template', $template);
-        if ($template && class_exists('\Elementor\Core\Files\CSS\Post')) {
+        if ($template && class_exists('\Elementor\Core\Files\CSS\Post')) (new \Elementor\Core\Files\CSS\Post($post_id))->update();
-            (new \Elementor\Core\Files\CSS\Post($post_id))->update();
-        }
         return ['success'=>true,'post_id'=>$post_id,'template'=>$template ?: 'default'];
     }
 
+    // =========================================================
+    // REVISIONS
+    // =========================================================
+
+    public function getRevisions(array $args): array {
+        $post_id = (int)($args['post_id'] ?? 0);
+        if (!$post_id) throw new \RuntimeException('post_id is required.');
+        if (!class_exists('\Elementor\Plugin')) throw new \RuntimeException('Elementor not active.');
+        $revisions = \Elementor\Plugin::instance()->revisions_manager->get_revisions($post_id);
+        $clean = array_map(fn($r) => ['id'=>$r['id'],'type'=>$r['type'],'author'=>$r['author']??'','timestamp'=>$r['timestamp']??0], $revisions ?? []);
+        return ['post_id'=>$post_id,'revisions'=>$clean,'total'=>count($clean)];
+    }
+
+    public function restoreRevision(array $args): array {
+        $post_id     = (int)($args['post_id'] ?? 0);
+        $revision_id = (int)($args['revision_id'] ?? 0);
+        if (!$post_id || !$revision_id) throw new \RuntimeException('post_id and revision_id are required.');
+        if (!class_exists('\Elementor\Plugin')) throw new \RuntimeException('Elementor not active.');
+        \Elementor\Plugin::instance()->revisions_manager->restore_revision($post_id, $revision_id);
+        if (class_exists('\Elementor\Core\Files\CSS\Post')) (new \Elementor\Core\Files\CSS\Post($post_id))->update();
+        return ['success'=>true,'post_id'=>$post_id,'restored_revision_id'=>$revision_id];
+    }
+
+    // =========================================================
+    // PERFORMANCE SETTINGS
+    // =========================================================
+
+    public function getPerformanceSettings(array $args): array {
+        return [
+            'css_print_method'            => get_option('elementor_css_print_method', 'external'),
+            'google_font'                 => get_option('elementor_google_font', '1'),
+            'load_fa4_shim'               => get_option('elementor_load_fa4_shim', ''),
+            'lazy_load_background_images' => get_option('elementor_lazy_load_background_images', '1'),
+            'meta_generator_tag'          => get_option('elementor_meta_generator_tag', ''),
+            'unfiltered_files_upload'     => get_option('elementor_unfiltered_files_upload', ''),
+            'font_display'                => get_option('elementor_font_display', 'auto'),
+            'google_maps_api_key'         => get_option('elementor_google_maps_api_key', ''),
+            'element_cache_ttl'           => (int)get_option('elementor_element_cache_ttl', 24),
+            'optimized_gutenberg_loading' => get_option('elementor_optimized_gutenberg_loading', '1'),
+        ];
+    }
+
+    public function updatePerformanceSettings(array $args): array {
+        $settings = $args['settings'] ?? [];
+        if (empty($settings)) throw new \RuntimeException('settings object is required.');
+        $map = [
+            'css_print_method'            => ['key'=>'elementor_css_print_method',            'allowed'=>['external','internal']],
+            'google_font'                 => ['key'=>'elementor_google_font',                 'allowed'=>['1','']],
+            'load_fa4_shim'               => ['key'=>'elementor_load_fa4_shim',               'allowed'=>['1','']],
+            'lazy_load_background_images' => ['key'=>'elementor_lazy_load_background_images', 'allowed'=>['1','']],
+            'meta_generator_tag'          => ['key'=>'elementor_meta_generator_tag',          'allowed'=>['1','']],
+            'unfiltered_files_upload'     => ['key'=>'elementor_unfiltered_files_upload',     'allowed'=>['1','']],
+            'font_display'                => ['key'=>'elementor_font_display',                'allowed'=>['auto','block','swap','fallback','optional']],
+            'google_maps_api_key'         => ['key'=>'elementor_google_maps_api_key',         'allowed'=>null],
+            'element_cache_ttl'           => ['key'=>'elementor_element_cache_ttl',           'allowed'=>null,'type'=>'int'],
+            'optimized_gutenberg_loading' => ['key'=>'elementor_optimized_gutenberg_loading', 'allowed'=>['1','']],
+        ];
+        $updated = []; $errors = [];
+        foreach ($settings as $field => $value) {
+            if (!isset($map[$field])) { $errors[] = "Unknown field: {$field}"; continue; }
+            $def = $map[$field];
+            if (!empty($def['allowed']) && !in_array((string)$value, $def['allowed'], true)) {
+                $errors[] = "Invalid value for {$field}: {$value}. Allowed: " . implode(', ', $def['allowed']); continue;
+            }
+            $write_val = isset($def['type']) && $def['type']==='int' ? (int)$value : (string)$value;
+            update_option($def['key'], $write_val);
+            $updated[$field] = $write_val;
+        }
+        return ['success'=>empty($errors),'updated'=>$updated,'errors'=>$errors];
+    }
+
+    // =========================================================
+    // CPT SUPPORT
+    // =========================================================
+
+    public function getCptSupport(array $args): array {
+        return [
+            'supported_post_types' => (array)(get_option('elementor_cpt_support') ?: ['post','page']),
+            'available_post_types' => array_keys(get_post_types(['public'=>true], 'names')),
+        ];
+    }
+
+    public function setCptSupport(array $args): array {
+        $post_types = $args['post_types'] ?? [];
+        if (empty($post_types) || !is_array($post_types)) throw new \RuntimeException('post_types must be a non-empty array.');
+        $all_types = array_keys(get_post_types(['public'=>true], 'names'));
+        $invalid = array_diff($post_types, $all_types);
+        if (!empty($invalid)) throw new \RuntimeException('Invalid post types: ' . implode(', ', $invalid));
+        update_option('elementor_cpt_support', $post_types);
+        return ['success'=>true,'supported_post_types'=>$post_types];
+    }
+
+    // =========================================================
+    // MAINTENANCE MODE
+    // =========================================================
+
+    public function getMaintenanceMode(array $args): array {
+        $mode    = get_option('elementor_maintenance_mode_mode', '');
+        $page_id = (int)get_option('elementor_maintenance_mode_page_id', 0);
+        return [
+            'mode'         => $mode ?: 'disabled',
+            'page_id'      => $page_id,
+            'page_url'     => $page_id ? get_permalink($page_id) : '',
+            'exclude_mode' => get_option('elementor_maintenance_mode_exclude_mode', ''),
+            'is_active'    => !empty($mode),
+        ];
+    }
+
+    public function setMaintenanceMode(array $args): array {
+        $mode         = $args['mode'] ?? '';
+        $page_id      = isset($args['page_id']) ? (int)$args['page_id'] : 0;
+        $exclude_mode = $args['exclude_mode'] ?? '';
+        if (!in_array($mode, ['maintenance','coming_soon',''], true)) throw new \RuntimeException('mode must be: maintenance, coming_soon, or empty string.');
+        update_option('elementor_maintenance_mode_mode', $mode);
+        if ($page_id) update_option('elementor_maintenance_mode_page_id', $page_id);
+        if ($exclude_mode !== '') update_option('elementor_maintenance_mode_exclude_mode', $exclude_mode);
+        return ['success'=>true,'mode'=>$mode ?: 'disabled','page_id'=>$page_id ?: (int)get_option('elementor_maintenance_mode_page_id',0),'exclude_mode'=>$exclude_mode ?: get_option('elementor_maintenance_mode_exclude_mode','')];
+    }
+
+    // =========================================================
+    // SITE SETTINGS
+    // =========================================================
+
+    public function getSiteSettings(array $args): array {
+        return [
+            'google_maps_api_key'     => get_option('elementor_google_maps_api_key', ''),
+            'meta_generator_tag'      => get_option('elementor_meta_generator_tag', ''),
+            'google_font'             => get_option('elementor_google_font', '1'),
+            'font_display'            => get_option('elementor_font_display', 'auto'),
+            'load_fa4_shim'           => get_option('elementor_load_fa4_shim', ''),
+            'unfiltered_files_upload' => get_option('elementor_unfiltered_files_upload', ''),
+            'css_print_method'        => get_option('elementor_css_print_method', 'external'),
+            'elementor_version'       => get_option('elementor_version', ''),
+            'pro_version'             => get_option('elementor_pro_version', ''),
+        ];
+    }
+
+    public function updateSiteSettings(array $args): array {
+        $settings = $args['settings'] ?? [];
+        if (empty($settings)) throw new \RuntimeException('settings object is required.');
+        $allowed = [
+            'google_maps_api_key'     => 'elementor_google_maps_api_key',
+            'meta_generator_tag'      => 'elementor_meta_generator_tag',
+            'google_font'             => 'elementor_google_font',
+            'font_display'            => 'elementor_font_display',
+            'load_fa4_shim'           => 'elementor_load_fa4_shim',
+            'unfiltered_files_upload' => 'elementor_unfiltered_files_upload',
+            'css_print_method'        => 'elementor_css_print_method',
+        ];
+        $updated = []; $errors = [];
+        foreach ($settings as $field => $value) {
+            if (!isset($allowed[$field])) { $errors[] = "Unknown or read-only field: {$field}"; continue; }
+            update_option($allowed[$field], (string)$value);
+            $updated[$field] = (string)$value;
+        }
+        return ['success'=>empty($errors),'updated'=>$updated,'errors'=>$errors];
+    }
+
     // =========================================================
     // PRIVATE HELPERS
     // =========================================================