PluginProbe
Search Atlas SEO – OTTO AI SEO Automation for WordPress / 2.7.2
Search Atlas SEO – OTTO AI SEO Automation for WordPress v2.7.2
2.7.1 2.7.2 2.7.0 2.6.26 2.6.25 2.6.24 2.6.23 2.6.22 2.6.21 2.6.20 2.6.19 2.6.18 2.6.17 2.6.16 2.6.15 2.6.14 2.6.13 2.6.12 2.6.11 2.6.10 2.6.9 2.6.8 2.6.7 2.6.6 2.6.5 All 141 releases
← All changes | includes/class-metasync-settings-fields.php +397 -542 2.6.11 → 2.7.2 View file →
@@ -46,9 +46,23 @@
46 46 // Accordion / Section helpers
47 47 // ────────────────────────────────────────────────────────────────
48 48
49 49 public function get_accordion_sections_config() {
50 - return array(
50 + // Consent switch for writing into other SEO plugins. Loaded here rather
51 + // than through the committed classmap so a stale autoload map can never
52 + // make the switch — and with it the user's only way to stop those
53 + // writes — silently disappear from the page.
54 + require_once plugin_dir_path(dirname(__FILE__)) . 'admin/class-metasync-seo-sync-settings.php';
55 +
56 + $sections = array(
57 + 'analytics' => array(
58 + 'title' => 'Usage Data & Product Improvement',
59 + 'description' => 'Choose whether to share limited usage data to help improve MetaSync',
60 + 'icon' => 'chart-bar',
61 + 'priority' => 70,
62 + 'default_open' => false,
63 + 'render_callback' => array($this, 'render_analytics_section'),
64 + ),
51 65 'connection' => array(
52 66 'title' => 'Connection & Authentication',
53 67 'description' => 'Manage your API connection and authentication settings',
54 68 'icon' => 'admin-network',
@@ -68,9 +82,9 @@
68 82 'fields' => array(
69 83 'otto_pixel_uuid',
70 84 'otto_disable_on_loggedin',
71 85 'otto_disable_preview_button',
72 - 'otto_wp_rocket_compat',
86 + 'seo_priority',
73 87 )
74 88 ),
75 89 'edge_cache' => array(
76 90 'title' => 'Edge Cache / CDN',
@@ -79,8 +93,16 @@
79 93 'priority' => 22,
80 94 'default_open' => false,
81 95 'render_callback' => array('Metasync_Edge_Cache_Settings', 'render'),
82 96 ),
97 + 'seo_plugin_sync' => array(
98 + 'title' => 'Sync to Other SEO Plugins',
99 + 'description' => 'Control whether ' . Metasync::get_whitelabel_otto_name() . '\'s SEO values are written into Yoast, Rank Math or All in One SEO',
100 + 'icon' => 'update',
101 + 'priority' => 23,
102 + 'default_open' => false,
103 + 'render_callback' => array('Metasync_Seo_Sync_Settings', 'render'),
104 + ),
83 105 'bot_detection' => array(
84 106 'title' => 'Bot Detection & Filtering',
85 107 'description' => 'Manage bot traffic and reduce unnecessary API calls',
86 108 'icon' => 'filter',
@@ -92,16 +114,8 @@
92 114 'otto_bot_blacklist',
93 115 'otto_bot_statistics_link'
94 116 )
95 117 ),
96 - 'breadcrumbs' => array(
97 - 'title' => 'Breadcrumbs',
98 - 'description' => 'Configure breadcrumb navigation display',
99 - 'icon' => 'format-links',
100 - 'priority' => 35,
101 - 'default_open' => false,
102 - 'render_callback' => array($this, 'render_breadcrumbs_section')
103 - ),
104 118 'open_graph' => array(
105 119 'title' => 'Open Graph',
106 120 'description' => 'Control which Open Graph and article meta tags are output',
107 121 'icon' => 'share',
@@ -128,8 +142,9 @@
128 142 'disable_redirection_metabox',
129 143 'disable_canonical_metabox',
130 144 'disable_social_opengraph_metabox',
131 145 'disable_schema_markup_metabox',
146 + 'disable_language_alternates_metabox',
132 147 'disable_seo_metabox',
133 148 'open_external_links'
134 149 )
135 150 ),
@@ -170,13 +185,22 @@
170 185 'fields' => array(
171 186 'permalink_structure',
172 187 'hide_dashboard_framework',
173 188 'show_admin_bar_status',
174 - 'enable_auto_updates',
175 189 'import_external_data'
176 190 )
177 191 )
178 192 );
193 +
194 + // Hidden only when there is nothing to say: no SEO plugin installed, the
195 + // switch off, and no saved originals. It is never hidden by the
196 + // access-control or whitelabel flags that can conceal Advanced Settings
197 + // — a switch that rewrites another plugin's data must stay reachable.
198 + if (!Metasync_Seo_Sync_Settings::should_display()) {
199 + unset($sections['seo_plugin_sync']);
200 + }
201 +
202 + return $sections;
179 203 }
180 204
181 205 public function get_advanced_accordion_config() {
182 206 $config = array();
@@ -201,8 +225,17 @@
201 225 'default_open' => false,
202 226 'render_callback' => array($this->admin_instance, 'render_debug_mode_section')
203 227 );
204 228
229 + $config['headless_mode'] = array(
230 + 'title' => 'Headless Mode',
231 + 'description' => 'Connect WordPress content to a separate public frontend',
232 + 'icon' => 'admin-site-alt3',
233 + 'priority' => 29,
234 + 'default_open' => false,
235 + 'render_callback' => array(Metasync_Settings_Registration::instance(), 'render_headless_mode_section')
236 + );
237 +
205 238 $config['error_logs'] = array(
206 239 'title' => 'Error Logs',
207 240 'description' => 'View and manage error logs to troubleshoot issues',
208 241 'icon' => 'warning',
@@ -275,9 +308,9 @@
275 308 $content_state = $is_open ? 'open' : 'closed';
276 309
277 310 echo '<div class="metasync-accordion-section" data-section="' . esc_attr($section_key) . '">';
278 311
279 - echo '<div class="metasync-accordion-header" role="button" tabindex="0" aria-expanded="' . $aria_expanded . '" aria-controls="' . $section_id . '">';
312 + echo '<div class="metasync-accordion-header" role="button" tabindex="0" aria-expanded="' . esc_attr($aria_expanded) . '" aria-controls="' . esc_attr($section_id) . '">';
280 313 echo '<div class="metasync-accordion-title">';
281 314 echo '<span class="metasync-accordion-icon"><span class="dashicons dashicons-' . esc_attr($section_data['icon']) . '"></span></span>';
282 315 echo '<div class="metasync-accordion-text">';
283 316 echo '<h3>' . esc_html($section_data['title']) . '</h3>';
@@ -288,9 +321,9 @@
288 321 echo '<span class="toggle-icon">▼</span>';
289 322 echo '</button>';
290 323 echo '</div>';
291 324
292 - echo '<div class="metasync-accordion-content" id="' . $section_id . '" data-state="' . $content_state . '">';
325 + echo '<div class="metasync-accordion-content" id="' . esc_attr($section_id) . '" data-state="' . esc_attr($content_state) . '">';
293 326
294 327 if (isset($section_data['render_callback']) && is_callable($section_data['render_callback'])) {
295 328 call_user_func($section_data['render_callback']);
296 329 }
@@ -312,9 +345,8 @@
312 345 </h4>
313 346 <p style="color: var(--dashboard-text-secondary); margin: 0 0 12px 0;">This action will permanently delete:</p>
314 347 <ul style="color: var(--dashboard-text-secondary); margin: 0 0 12px 20px; line-height: 1.8;">
315 348 <li>All API keys and authentication tokens</li>
316 - <li>White label branding settings</li>
317 349 <li>Plugin configuration and preferences</li>
318 350 <li>Instant indexing settings</li>
319 351 <li>Media optimization settings and cache</li>
320 352 <li>Code minification settings</li>
@@ -319,9 +351,9 @@
319 351 <li>Media optimization settings and cache</li>
320 352 <li>Code minification settings</li>
321 353 <li>All cached data and crawl information</li>
322 354 </ul>
323 - <p style="color: var(--dashboard-warning, #f59e0b); margin: 0; font-weight: 600;">You will need to reconfigure the plugin completely after this reset.</p>
355 + <p style="color: var(--dashboard-warning, #f59e0b); margin: 0; font-weight: 600;">You will need to reconfigure the plugin's operational settings after this reset.</p>
324 356 </div>
325 357 <form method="post" action="" onsubmit="return confirmClearSettings(event)">
326 358 <?php wp_nonce_field('metasync_clear_all_settings_nonce', 'clear_all_settings_nonce'); ?>
327 359 <input type="hidden" name="clear_all_settings" value="yes" />
@@ -329,8 +361,31 @@
329 361 <span class="dashicons dashicons-trash" style="margin-top:3px;font-size:15px;width:15px;height:15px;"></span> Clear All Settings
330 362 </button>
331 363 </form>
332 364 </div>
365 + <div style="background: var(--dashboard-card-bg); padding: 20px; border-radius: 8px; margin-top: 20px;">
366 + <h4 style="color: var(--dashboard-text-primary, #1e1e1e); margin: 0 0 12px 0; display: flex; align-items: center; gap: 8px;">
367 + <span class="dashicons dashicons-universal-access-alt" style="font-size:18px;width:18px;height:18px;"></span>
368 + <span>Delete data on uninstall</span>
369 + </h4>
370 + <p style="color: var(--dashboard-text-secondary); margin: 0 0 12px 0;">
371 + By default, deleting the plugin keeps your data: sitemap and redirection settings, per-post SEO values, and the plugin's database tables stay in place in case you reinstall. Enable this to also remove all of that when the plugin itself is deleted from the Plugins screen.
372 + </p>
373 + <p style="color: var(--dashboard-text-secondary); margin: 0 0 12px 0;">
374 + The Google service account and the IndexNow API key are always deleted on uninstall, regardless of this setting.
375 + </p>
376 + <form method="post" action="">
377 + <?php wp_nonce_field('metasync_uninstall_data_toggle_nonce', 'uninstall_data_toggle_nonce'); ?>
378 + <input type="hidden" name="metasync_uninstall_data_toggle_form" value="1" />
379 + <label style="color: var(--dashboard-text-primary, #1e1e1e); display: flex; align-items: center; gap: 8px; margin: 0 0 12px 0; cursor: pointer;">
380 + <input type="checkbox" name="metasync_delete_data_on_uninstall" value="yes" <?php checked(get_option('metasync_delete_data_on_uninstall', 'no'), 'yes'); ?> />
381 + Delete all plugin data (tables, settings, per-post SEO values, logs) when the plugin is uninstalled
382 + </label>
383 + <button type="submit" class="button button-secondary">
384 + Save Uninstall Setting
385 + </button>
386 + </form>
387 + </div>
333 388 <script>
334 389 function confirmClearSettings(event) {
335 390 event.preventDefault();
336 391
@@ -338,9 +393,9 @@
338 393 if (!firstConfirm) {
339 394 return false;
340 395 }
341 396
342 - var secondConfirm = confirm("🚨 FINAL WARNING 🚨\n\nThis will delete:\n• All API keys and authentication tokens\n• White label branding settings\n• Plugin configuration and preferences\n• Instant indexing settings\n• Media optimization settings and cache\n• Code minification settings\n• All cached data\n\nYou will need to reconfigure the entire plugin from scratch.\n\nType 'DELETE' in the next prompt to confirm.");
397 + var secondConfirm = confirm("🚨 FINAL WARNING 🚨\n\nThis will delete:\n• All API keys and authentication tokens\n• Plugin configuration and preferences\n• Instant indexing settings\n• Media optimization settings and cache\n• Code minification settings\n• All cached data\n\nYou will need to reconfigure the plugin's operational settings from scratch.\n\nType 'DELETE' in the next prompt to confirm.");
343 398 if (!secondConfirm) {
344 399 return false;
345 400 }
346 401
@@ -361,14 +416,18 @@
361 416 if (!function_exists('google_index_direct')) {
362 417 if (file_exists(plugin_dir_path(dirname(__FILE__)) . 'google-index/google-index-init.php')) {
363 418 require_once plugin_dir_path(dirname(__FILE__)) . 'google-index/google-index-init.php';
364 419 } else {
365 - error_log('MetaSync Google Index: google-index-init.php not found at ' . plugin_dir_path(dirname(__FILE__)) . 'google-index/google-index-init.php');
420 + error_log('MetaSync Google Index: google-index-init.php not found at ' . plugin_dir_path(dirname(__FILE__)) . 'google-index/google-index-init.php'); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- genuine failure path, bounded, no secrets
366 421 return;
367 422 }
368 423 }
369 424
370 425 $google_index = google_index_direct();
426 + if (!$google_index) {
427 + // Nothing to render against, and calling through would be fatal.
428 + return;
429 + }
371 430 $service_info = $google_index->get_service_account_info();
372 431 $is_configured = !isset($service_info['error']);
373 432
374 433 $saved_json_display = $is_configured ? $google_index->get_redacted_config_json() : '';
@@ -445,8 +504,9 @@
445 504 <table class="form-table" style="margin-top: 0;">
446 505 <tr>
447 506 <th scope="row" style="width: 200px; padding-top: 15px;">
448 507 <label for="metasync_bing_api_key_inline">IndexNow API Key <span style="color: #d63638;">*</span></label>
508 + <?php Metasync::render_tooltip_icon('metasync_bing_api_key_inline', 'This key lets Bing trust indexing requests from your site. Click \'Generate Random API Key\' if you don\'t have one — the plugin publishes the matching verification file automatically, no manual upload needed.'); ?>
449 509 </th>
450 510 <td style="padding-top: 15px;">
451 511 <input type="text"
452 512 name="metasync_bing_api_key_inline"
@@ -646,9 +706,9 @@
646 706 <p style="color: var(--dashboard-text-secondary); margin: 0 0 20px 0;">
647 707 Select which user roles can see and access this plugin's menu, settings, and options in the WordPress admin area.
648 708 </p>
649 709
650 - <form method="post" action="<?php echo admin_url('admin.php?page=' . Metasync_Admin::$page_slug . '&tab=advanced'); ?>" id="plugin-access-roles-form">
710 + <form method="post" action="<?php echo esc_url(admin_url('admin.php?page=' . Metasync_Admin::$page_slug . '&tab=advanced')); ?>" id="plugin-access-roles-form">
651 711 <?php wp_nonce_field('metasync_plugin_access_roles_nonce', 'plugin_access_roles_nonce'); ?>
652 712 <input type="hidden" name="save_plugin_access_roles" value="yes" />
653 713
654 714 <div class="metasync-role-selector-container" style="background: var(--dashboard-card-bg-alt, rgba(255,255,255,0.05)); border: 1px solid var(--dashboard-border); border-radius: 8px; padding: 16px; max-height: 300px; overflow-y: auto;">
@@ -766,9 +826,9 @@
766 826
767 827 public function can_change_memory_limit() {
768 828 $current_limit = ini_get('memory_limit');
769 829
770 - $test_result = @ini_set('memory_limit', $current_limit);
830 + $test_result = @ini_set('memory_limit', $current_limit); // phpcs:ignore Squiz.PHP.DiscouragedFunctions.Discouraged -- runtime PHP setting with no WordPress API
771 831
772 832 return $test_result !== false;
773 833 }
774 834
@@ -774,37 +834,47 @@
774 834
775 835 public function get_server_limits() {
776 836 $max_execution_time = ini_get('max_execution_time');
777 837 $memory_limit = ini_get('memory_limit');
778 -
838 +
839 + // Prefer the server-configured value: WordPress (wp_raise_memory_limit)
840 + // or this plugin (apply_memory_limit) may have already changed the
841 + // runtime limit via ini_set, so ini_get no longer reflects the server
842 + // configuration. get_cfg_var reads the php.ini value untouched.
843 + $config_memory_limit = get_cfg_var('memory_limit');
844 + if ($config_memory_limit !== false && $config_memory_limit !== '') {
845 + $memory_limit = $config_memory_limit;
846 + }
847 +
779 848 $memory_limit_mb = $this->parse_memory_limit_to_mb($memory_limit);
780 -
781 - $wp_memory_limit = null;
782 - if (defined('WP_MAX_MEMORY_LIMIT')) {
783 - $wp_memory_limit = WP_MAX_MEMORY_LIMIT;
784 - } elseif (defined('WP_MEMORY_LIMIT')) {
785 - $wp_memory_limit = WP_MEMORY_LIMIT;
786 - }
787 - $wp_memory_limit_mb = $wp_memory_limit ? $this->parse_memory_limit_to_mb($wp_memory_limit) : null;
788 -
789 - $actual_php_limit_mb = $memory_limit_mb;
790 - if ($wp_memory_limit_mb && $wp_memory_limit_mb >= 256) {
791 - $actual_php_limit_mb = 128;
792 - }
793 -
849 +
794 850 $can_change_memory = $this->can_change_memory_limit();
795 -
796 - $memory_limit_display = $actual_php_limit_mb == -1 ? 'Unlimited' : $actual_php_limit_mb . ' MB';
797 -
851 +
852 + $memory_limit_display = $memory_limit_mb == -1 ? 'Unlimited' : $memory_limit_mb . ' MB';
853 +
798 854 return array(
799 855 'max_execution_time' => $max_execution_time == -1 ? 'Unlimited' : $max_execution_time . ' seconds',
800 856 'memory_limit' => $memory_limit_display,
801 857 'max_execution_time_raw' => $max_execution_time,
802 - 'memory_limit_raw' => $actual_php_limit_mb,
858 + 'memory_limit_raw' => $memory_limit_mb,
803 859 'can_change_memory' => $can_change_memory
804 860 );
805 861 }
806 862
863 + /**
864 + * Allowed range for the Max Memory Limit setting: 64 MB up to the
865 + * server-configured memory limit (null max when the server is unlimited).
866 + */
867 + public function get_memory_limit_allowed_range() {
868 + $server_limits = $this->get_server_limits();
869 + $max = $server_limits['memory_limit_raw'] == -1 ? null : max(64, (int) $server_limits['memory_limit_raw']);
870 +
871 + return array(
872 + 'min' => 64,
873 + 'max' => $max
874 + );
875 + }
876 +
807 877 public function apply_memory_limit() {
808 878 if (!$this->can_change_memory_limit()) {
809 879 return false;
810 880 }
@@ -810,9 +880,9 @@
810 880 }
811 881
812 882 $memory_limit_mb = $this->get_execution_setting('max_memory_limit');
813 883
814 - $result = @ini_set('memory_limit', $memory_limit_mb . 'M');
884 + $result = @ini_set('memory_limit', $memory_limit_mb . 'M'); // phpcs:ignore Squiz.PHP.DiscouragedFunctions.Discouraged -- runtime PHP setting with no WordPress API
815 885
816 886 return $result !== false;
817 887 }
818 888
@@ -841,8 +911,9 @@
841 911
842 912 public function render_execution_settings_section() {
843 913 $settings = $this->get_all_execution_settings();
844 914 $server_limits = $this->get_server_limits();
915 + $memory_range = $this->get_memory_limit_allowed_range();
845 916
846 917 $warnings = array();
847 918 if ((int)$server_limits['max_execution_time_raw'] !== -1 && (int)$settings['max_execution_time'] > (int)$server_limits['max_execution_time_raw']) {
848 919 $warnings['max_execution_time'] = true;
@@ -861,16 +932,18 @@
861 932
862 933 <!-- Execution & Memory Section -->
863 934 <div style="background: var(--dashboard-card-bg-alt, rgba(255,255,255,0.05)); border: 1px solid var(--dashboard-border); border-radius: 8px; padding: 20px; margin-bottom: 20px;">
864 935 <h3 style="color: var(--dashboard-text-primary); margin: 0 0 16px 0; font-size: 16px; font-weight: 600;">Execution & Memory</h3>
865 -
866 - <div style="margin-bottom: 20px;">
936 +
937 + <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 24px;">
938 + <div>
867 939 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
868 940 Max Execution Time:
941 + <?php Metasync::render_tooltip_icon('max_execution_time', 'How many seconds a single plugin operation (like a bulk sync or scan) is allowed to run before PHP stops it. Raise this only if you see timeout errors, and only up to what your host allows.'); ?>
869 942 </label>
870 943 <div style="display: flex; align-items: center; gap: 10px;">
871 - <input type="number"
872 - id="max_execution_time"
944 + <input type="number"
945 + id="max_execution_time"
873 946 name="max_execution_time"
874 947 value="<?php echo esc_attr($settings['max_execution_time']); ?>"
875 948 min="1"
876 949 max="300"
@@ -896,16 +969,17 @@
896 969
897 970 <div>
898 971 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
899 972 Max Memory Limit:
973 + <?php Metasync::render_tooltip_icon('max_memory_limit', 'How much memory (RAM) the plugin is allowed to use for a single operation before PHP stops it. Raise this only if you see "out of memory" errors, and only up to what your host allows.'); ?>
900 974 </label>
901 975 <div style="display: flex; align-items: center; gap: 10px;">
902 - <input type="number"
903 - id="max_memory_limit"
976 + <input type="number"
977 + id="max_memory_limit"
904 978 name="max_memory_limit"
905 979 value="<?php echo esc_attr($settings['max_memory_limit']); ?>"
906 - min="64"
907 - max="512"
980 + min="<?php echo esc_attr($memory_range['min']); ?>"
981 + <?php if ($memory_range['max'] !== null): ?>max="<?php echo esc_attr($memory_range['max']); ?>"<?php endif; ?>
908 982 <?php if (!$server_limits['can_change_memory']): ?>
909 983 readonly
910 984 disabled
911 985 <?php endif; ?>
@@ -913,9 +987,9 @@
913 987 style="width: 100px; padding: 8px; border: 1px solid var(--dashboard-border); border-radius: 6px; background: <?php echo $server_limits['can_change_memory'] ? 'var(--dashboard-card-bg)' : 'rgba(128, 128, 128, 0.1)'; ?>; color: <?php echo $server_limits['can_change_memory'] ? 'var(--dashboard-text-primary)' : 'var(--dashboard-text-secondary)'; ?>; cursor: <?php echo $server_limits['can_change_memory'] ? 'text' : 'not-allowed'; ?>;" />
914 988 <span style="color: var(--dashboard-text-secondary);">MB</span>
915 989 </div>
916 990 <p style="color: var(--dashboard-text-secondary); font-size: 12px; margin: 4px 0 0 0;">
917 - Server Limit: <?php echo esc_html($server_limits['memory_limit']); ?>
991 + Server Limit: <?php echo esc_html($server_limits['memory_limit']); ?> &middot; Allowed: <?php echo $memory_range['max'] !== null ? esc_html($memory_range['min'] . '–' . $memory_range['max'] . ' MB') : esc_html($memory_range['min'] . ' MB or higher'); ?>
918 992 </p>
919 993 <?php if (!$server_limits['can_change_memory']): ?>
920 994 <p style="color: #f59e0b; font-size: 12px; margin: 4px 0 0 0; display: flex; align-items: center; gap: 4px;">
921 995 <span class="dashicons dashicons-lock" style="font-size:14px;width:14px;height:14px;color:#f59e0b;"></span>
@@ -934,21 +1008,24 @@
934 1008 </script>
935 1009 <?php endif; ?>
936 1010 <?php endif; ?>
937 1011 </div>
1012 + </div>
938 1013 </div>
939 -
1014 +
940 1015 <!-- Batch Processing Section -->
941 1016 <div style="background: var(--dashboard-card-bg-alt, rgba(255,255,255,0.05)); border: 1px solid var(--dashboard-border); border-radius: 8px; padding: 20px; margin-bottom: 20px;">
942 1017 <h3 style="color: var(--dashboard-text-primary); margin: 0 0 16px 0; font-size: 16px; font-weight: 600;">Batch Processing</h3>
943 -
944 - <div style="margin-bottom: 20px;">
1018 +
1019 + <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 24px;">
1020 + <div>
945 1021 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
946 1022 Log Processing Batch Size:
1023 + <?php Metasync::render_tooltip_icon('log_batch_size', 'How many log lines the plugin processes at once when scanning its own logs. Lower it if this causes slowdowns on smaller hosting plans; most sites can leave the default.'); ?>
947 1024 </label>
948 1025 <div style="display: flex; align-items: center; gap: 10px;">
949 - <input type="number"
950 - id="log_batch_size"
1026 + <input type="number"
1027 + id="log_batch_size"
951 1028 name="log_batch_size"
952 1029 value="<?php echo esc_attr($settings['log_batch_size']); ?>"
953 1030 min="100"
954 1031 max="5000"
@@ -960,8 +1037,9 @@
960 1037
961 1038 <div>
962 1039 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
963 1040 Action Scheduler Concurrent Batches:
1041 + <?php Metasync::render_tooltip_icon('action_scheduler_batches', 'How many background sync jobs the plugin is allowed to run at the same time. Higher values finish syncing faster but use more server resources at once — lower this if your site slows down during syncs.'); ?>
964 1042 </label>
965 1043 <div style="display: flex; align-items: center; gap: 10px;">
966 1044 <input type="number"
967 1045 id="action_scheduler_batches"
@@ -976,17 +1054,20 @@
976 1054 <span class="dashicons dashicons-warning" style="font-size:14px;width:14px;height:14px;color:#f59e0b;"></span>
977 1055 <span>Higher values increase server load</span>
978 1056 </p>
979 1057 </div>
1058 + </div>
980 1059 </div>
981 -
1060 +
982 1061 <!-- API Rate Limiting Section -->
983 1062 <div style="background: var(--dashboard-card-bg-alt, rgba(255,255,255,0.05)); border: 1px solid var(--dashboard-border); border-radius: 8px; padding: 20px; margin-bottom: 20px;">
984 1063 <h3 style="color: var(--dashboard-text-primary); margin: 0 0 16px 0; font-size: 16px; font-weight: 600;">API Rate Limiting</h3>
985 -
986 - <div style="margin-bottom: 20px;">
1064 +
1065 + <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 24px;">
1066 + <div>
987 1067 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
988 - OTTO API Calls Per Minute:
1068 + <?php echo esc_html(Metasync::get_whitelabel_otto_name()); ?> API Calls Per Minute:
1069 + <?php Metasync::render_tooltip_icon('otto_rate_limit', 'The maximum number of requests per minute the plugin will send to ' . Metasync::get_whitelabel_otto_name() . '\'s servers. Lower it if you\'re seeing rate-limit errors; most sites can leave the default.'); ?>
989 1070 </label>
990 1071 <div style="display: flex; align-items: center; gap: 10px;">
991 1072 <input type="number"
992 1073 id="otto_rate_limit"
@@ -1001,8 +1082,9 @@
1001 1082
1002 1083 <div>
1003 1084 <label style="display: block; color: var(--dashboard-text-primary); margin-bottom: 8px; font-weight: 500;">
1004 1085 Queue Auto-Cleanup:
1086 + <?php Metasync::render_tooltip_icon('queue_cleanup_days', 'How many days a completed background job is kept before the plugin automatically deletes its record. Lower it to save database space; raise it if you need to look back further when troubleshooting.'); ?>
1005 1087 </label>
1006 1088 <div style="display: flex; align-items: center; gap: 10px;">
1007 1089 <input type="number"
1008 1090 id="queue_cleanup_days"
@@ -1014,8 +1096,9 @@
1014 1096 style="width: 100px; padding: 8px; border: 1px solid var(--dashboard-border); border-radius: 6px; background: var(--dashboard-card-bg); color: var(--dashboard-text-primary);" />
1015 1097 <span style="color: var(--dashboard-text-secondary);">days</span>
1016 1098 </div>
1017 1099 </div>
1100 + </div>
1018 1101 </div>
1019 1102
1020 1103 <!-- Save Button -->
1021 1104 <div style="margin-top: 20px;">
@@ -1032,232 +1115,15 @@
1032 1115 <div id="metasync-execution-settings-message" style="display: none; margin-top: 16px; padding: 12px; border-radius: 6px;"></div>
1033 1116 </form>
1034 1117 </div>
1035 1118
1036 - <script>
1037 - jQuery(document).ready(function($) {
1038 - var $form = $('#metasync-execution-settings-form');
1039 - var $saveBtn = $('#metasync-execution-settings-save-btn');
1040 - var $message = $('#metasync-execution-settings-message');
1041 -
1042 - var serverMaxExecTime = <?php echo $server_limits['max_execution_time_raw'] == -1 ? 'Infinity' : $server_limits['max_execution_time_raw']; ?>;
1043 - var serverMaxMemory = <?php echo $server_limits['memory_limit_raw'] == -1 ? 'Infinity' : $server_limits['memory_limit_raw']; ?>;
1044 - var canChangeMemory = <?php echo $server_limits['can_change_memory'] ? 'true' : 'false'; ?>;
1045 -
1046 - function checkServerLimits() {
1047 - var maxExecTime = parseInt($('#max_execution_time').val()) || 0;
1048 - var maxMemory = parseInt($('#max_memory_limit').val()) || 0;
1049 -
1050 - if (serverMaxExecTime !== Infinity && maxExecTime > serverMaxExecTime) {
1051 - $('#max_execution_time_warning').show();
1052 - } else {
1053 - $('#max_execution_time_warning').hide();
1054 - }
1055 -
1056 - if (canChangeMemory && serverMaxMemory !== Infinity && maxMemory > serverMaxMemory) {
1057 - $('#max_memory_limit_warning').show();
1058 - } else {
1059 - $('#max_memory_limit_warning').hide();
1060 - }
1061 - }
1062 -
1063 - $('#max_execution_time, #max_memory_limit').on('input change', function() {
1064 - checkServerLimits();
1065 - $(this).css('border-color', 'var(--dashboard-border)');
1066 - });
1067 -
1068 - function highlightInvalidField($field, isValid) {
1069 - if (isValid) {
1070 - $field.css({
1071 - 'border-color': 'var(--dashboard-border)',
1072 - 'box-shadow': 'none'
1073 - });
1074 - } else {
1075 - $field.css({
1076 - 'border-color': '#ef4444',
1077 - 'box-shadow': '0 0 0 3px rgba(239, 68, 68, 0.1)'
1078 - });
1079 - }
1080 - }
1081 -
1082 - $('#max_execution_time').on('blur', function() {
1083 - var value = parseInt($(this).val()) || 0;
1084 - var isValid = value >= 1 && value <= 300 && (serverMaxExecTime === Infinity || value <= serverMaxExecTime);
1085 - highlightInvalidField($(this), isValid);
1086 - });
1087 -
1088 - $('#max_memory_limit').on('blur', function() {
1089 - if (!canChangeMemory) return;
1090 - var value = parseInt($(this).val()) || 0;
1091 - var isValid = value >= 64 && value <= 512 && (serverMaxMemory === Infinity || value <= serverMaxMemory);
1092 - highlightInvalidField($(this), isValid);
1093 - });
1094 -
1095 - checkServerLimits();
1096 -
1097 - $form.on('submit', function(e) {
1098 - e.preventDefault();
1099 -
1100 - var formData = {
1101 - action: 'metasync_save_execution_settings',
1102 - execution_settings_nonce: $('#execution_settings_nonce').val(),
1103 - max_execution_time: $('#max_execution_time').val(),
1104 - max_memory_limit: $('#max_memory_limit').val(),
1105 - log_batch_size: $('#log_batch_size').val(),
1106 - action_scheduler_batches: $('#action_scheduler_batches').val(),
1107 - otto_rate_limit: $('#otto_rate_limit').val(),
1108 - queue_cleanup_days: $('#queue_cleanup_days').val()
1109 - };
1110 -
1111 - $('input[type="number"]').css({
1112 - 'border-color': 'var(--dashboard-border)',
1113 - 'box-shadow': 'none'
1114 - });
1115 -
1116 - var hasError = false;
1117 - var errorField = null;
1118 -
1119 - if (formData.max_execution_time < 1 || formData.max_execution_time > 300) {
1120 - showMessage('Max Execution Time must be between 1 and 300 seconds.', 'error');
1121 - highlightInvalidField($('#max_execution_time'), false);
1122 - errorField = $('#max_execution_time');
1123 - hasError = true;
1124 - } else if (serverMaxExecTime !== Infinity && formData.max_execution_time > serverMaxExecTime) {
1125 - showMessage('Max Execution Time exceeds server limit of ' + serverMaxExecTime + ' seconds. Please reduce the value.', 'error');
1126 - highlightInvalidField($('#max_execution_time'), false);
1127 - errorField = $('#max_execution_time');
1128 - hasError = true;
1129 - }
1130 -
1131 - if (canChangeMemory) {
1132 - if (formData.max_memory_limit < 64 || formData.max_memory_limit > 512) {
1133 - showMessage('Max Memory Limit must be between 64 and 512 MB.', 'error');
1134 - highlightInvalidField($('#max_memory_limit'), false);
1135 - if (!hasError) {
1136 - errorField = $('#max_memory_limit');
1137 - hasError = true;
1138 - }
1139 - } else if (serverMaxMemory !== Infinity && formData.max_memory_limit > serverMaxMemory) {
1140 - showMessage('Max Memory Limit exceeds server limit of ' + serverMaxMemory + ' MB. Please reduce the value.', 'error');
1141 - highlightInvalidField($('#max_memory_limit'), false);
1142 - if (!hasError) {
1143 - errorField = $('#max_memory_limit');
1144 - hasError = true;
1145 - }
1146 - }
1147 - }
1148 -
1149 - if (formData.log_batch_size < 100 || formData.log_batch_size > 5000) {
1150 - showMessage('Log Batch Size must be between 100 and 5000 lines.', 'error');
1151 - highlightInvalidField($('#log_batch_size'), false);
1152 - if (!hasError) {
1153 - errorField = $('#log_batch_size');
1154 - hasError = true;
1155 - }
1156 - }
1157 - if (formData.action_scheduler_batches < 1 || formData.action_scheduler_batches > 10) {
1158 - showMessage('Action Scheduler Batches must be between 1 and 10.', 'error');
1159 - highlightInvalidField($('#action_scheduler_batches'), false);
1160 - if (!hasError) {
1161 - errorField = $('#action_scheduler_batches');
1162 - hasError = true;
1163 - }
1164 - }
1165 - if (formData.otto_rate_limit < 1 || formData.otto_rate_limit > 60) {
1166 - showMessage('OTTO Rate Limit must be between 1 and 60 calls per minute.', 'error');
1167 - highlightInvalidField($('#otto_rate_limit'), false);
1168 - if (!hasError) {
1169 - errorField = $('#otto_rate_limit');
1170 - hasError = true;
1171 - }
1172 - }
1173 - if (formData.queue_cleanup_days < 7 || formData.queue_cleanup_days > 90) {
1174 - showMessage('Queue Cleanup Days must be between 7 and 90 days.', 'error');
1175 - highlightInvalidField($('#queue_cleanup_days'), false);
1176 - if (!hasError) {
1177 - errorField = $('#queue_cleanup_days');
1178 - hasError = true;
1179 - }
1180 - }
1181 -
1182 - if (hasError) {
1183 - if (errorField) {
1184 - errorField.focus();
1185 - $('html, body').animate({
1186 - scrollTop: errorField.offset().top - 100
1187 - }, 300);
1188 - }
1189 - return;
1190 - }
1191 -
1192 - $saveBtn.prop('disabled', true);
1193 - $saveBtn.find('.save-text').text('Saving...');
1194 - $saveBtn.find('.save-spinner').show();
1195 - $message.hide();
1196 -
1197 - $.ajax({
1198 - url: ajaxurl,
1199 - type: 'POST',
1200 - data: formData,
1201 - success: function(response) {
1202 - if (response.success) {
1203 - showMessage(response.data.message || 'Settings saved successfully!', 'success');
1204 - $saveBtn.prop('disabled', false);
1205 - $saveBtn.find('.save-text').text('Save Settings');
1206 - $saveBtn.find('.save-spinner').hide();
1207 - setTimeout(function() {
1208 - checkServerLimits();
1209 - }, 100);
1210 - $('html, body').animate({
1211 - scrollTop: $form.offset().top - 100
1212 - }, 300);
1213 - } else {
1214 - showMessage(response.data.message || 'Error saving settings.', 'error');
1215 - $saveBtn.prop('disabled', false);
1216 - $saveBtn.find('.save-text').text('Save Settings');
1217 - $saveBtn.find('.save-spinner').hide();
1218 - $('html, body').animate({
1219 - scrollTop: $message.offset().top - 100
1220 - }, 300);
1221 - }
1222 - },
1223 - error: function() {
1224 - showMessage('An error occurred while saving settings. Please try again.', 'error');
1225 - $saveBtn.prop('disabled', false);
1226 - $saveBtn.find('.save-text').text('Save Settings');
1227 - $saveBtn.find('.save-spinner').hide();
1228 - $('html, body').animate({
1229 - scrollTop: $message.offset().top - 100
1230 - }, 300);
1231 - }
1232 - });
1233 - });
1234 -
1235 - function showMessage(text, type) {
1236 - $message.removeClass('notice-success notice-error')
1237 - .addClass('notice-' + type)
1238 - .css({
1239 - 'background': type === 'success' ? 'rgba(34, 197, 94, 0.1)' : 'rgba(239, 68, 68, 0.1)',
1240 - 'border': '1px solid ' + (type === 'success' ? 'rgba(34, 197, 94, 0.3)' : 'rgba(239, 68, 68, 0.3)'),
1241 - 'color': type === 'success' ? '#22c55e' : '#ef4444',
1242 - 'padding': '12px 16px',
1243 - 'border-radius': '6px',
1244 - 'font-size': '14px',
1245 - 'line-height': '1.5',
1246 - 'display': 'block'
1247 - })
1248 - .html('<strong style="margin-right: 8px;">' + (type === 'success' ? '✓' : '✗') + '</strong>' + text)
1249 - .show();
1250 -
1251 - if (type === 'success') {
1252 - setTimeout(function() {
1253 - $message.fadeOut(300);
1254 - }, 5000);
1255 - }
1256 - }
1257 - });
1258 - </script>
1259 1119 <?php
1120 + // Real-time validation and AJAX save for this form live in
1121 + // admin/js/metasync-execution-settings.js (enqueued on this page).
1122 + // The previous inline duplicate was removed to avoid a double-bound
1123 + // submit handler that fired the save request twice.
1124 + ?>
1125 + <?php
1260 1126 }
1261 1127
1262 1128 public function get_field_tooltips() {
1263 1129 $plugin_name = Metasync::get_effective_plugin_name();
@@ -1263,37 +1129,73 @@
1263 1129 $plugin_name = Metasync::get_effective_plugin_name();
1264 1130 $otto_name = Metasync::get_whitelabel_otto_name();
1265 1131
1266 1132 return array(
1267 - 'searchatlas_api_key' => sprintf('Connect your WordPress site to your %s dashboard to retrieve your API key and OTTO UUID. This does not create a WordPress login session.', $plugin_name),
1133 + 'searchatlas_api_key' => sprintf('Connect your WordPress site to your %1$s dashboard to retrieve your API key and %2$s UUID. This does not create a WordPress login session.', $plugin_name, $otto_name),
1268 1134 'apikey' => sprintf('Auto-generated authentication token used for secure API communication between your WordPress site and %s services. You can refresh this token if needed for security purposes.', $plugin_name),
1269 1135 'otto_pixel_uuid' => sprintf('Your unique %s tracking pixel identifier. This UUID is used to track %s modifications and analytics on your website pages.', $otto_name, $otto_name),
1270 1136 'otto_disable_on_loggedin' => sprintf('Disable %s modifications when you are logged in to WordPress. This allows you to see and edit the original content without %s\'s enhancements during editing sessions.', $otto_name, $otto_name),
1271 1137 'otto_disable_preview_button' => sprintf('Hide the %s frontend toolbar that displays the status indicator, preview button, and debug button. Enable this for a cleaner frontend experience.', $otto_name),
1138 + 'seo_priority' => sprintf('Choose which value appears first on a page when both your custom SEO value (title, description or focus keyword, edited on the post/page screen) and an approved %s suggestion are available. This changes what visitors see; it does not delete or overwrite saved values.', $otto_name),
1272 1139 'otto_wp_rocket_compat' => sprintf('WP Rocket Compatibility Mode: Controls how %s interacts with WP Rocket. "Auto" (recommended) allows both to work together by avoiding DONOTCACHEPAGE constant unless necessary for Brizy pages or SG Optimizer conflicts. This ensures WP Rocket\'s JavaScript delay and optimization features continue working.', $otto_name),
1140 + 'otto_sg_optimizer_compat' => sprintf('SiteGround Optimizer Compatibility Mode: Controls how %s renders on SiteGround hosting. "Auto" (recommended) uses the internal HTTP fetch, which protects themes that defer inline CSS to the footer (e.g. Divi). "Buffer Mode" renders in-process with no internal fetch — faster on sites whose pages can never be host-cached, for example when a plugin starts a PHP session on every request (BookingPress sessions are removed automatically, so this does not apply to them).', $otto_name),
1141 + 'bookingpress_session_compat' => 'BookingPress Session Compatibility: Controls whether MetaSync removes the PHP session BookingPress starts on every public page, so hosts such as SiteGround can page-cache the site again.',
1273 1142 'otto_disable_for_bots' => sprintf('Enable bot detection to automatically skip %s processing for search engine crawlers, SEO tools, and other bots. This reduces unnecessary API calls and improves performance.', $otto_name),
1274 1143 'otto_bot_whitelist' => sprintf('Enter bot names or user-agent patterns (one per line) that should always be processed by %s, even when "Disable for Bots" is enabled. For example: Googlebot, Bingbot. This allows you to ensure specific search engines always see your optimized content.', $otto_name),
1275 1144 'otto_bot_blacklist' => sprintf('Enter bot names or user-agent patterns (one per line) that should always be blocked from %s processing, regardless of other settings. For example: BadBot, MaliciousCrawler. Use this to exclude problematic crawlers or unwanted traffic sources.', $otto_name),
1276 1145 'otto_bot_statistics_link' => 'View detailed bot detection statistics including total hits, API calls saved, breakdown by bot type, and unique bot entries with hit counts.',
1277 - 'disable_common_robots_metabox' => 'Hide the Common Robots meta box from post and page edit screens. This removes the robots meta tag controls (index/noindex, follow/nofollow) from the editor interface.',
1278 - 'disable_advance_robots_metabox' => 'Hide the Advanced Robots meta box from post and page edit screens. This removes advanced robots directives like max-snippet, max-image-preview, and max-video-preview settings.',
1279 - 'disable_redirection_metabox' => 'Hide the Redirection meta box from post and page edit screens. This removes the URL redirect configuration options from the editor interface.',
1280 - 'disable_canonical_metabox' => 'Hide the Canonical URL meta box from post and page edit screens. This removes the canonical URL override field from the editor interface.',
1281 - 'disable_social_opengraph_metabox' => 'Hide the Social Media & Open Graph meta box from post and page edit screens. This removes Facebook, Twitter, and other social media meta tag controls from the editor.',
1282 - 'disable_schema_markup_metabox' => 'Hide the Schema Markup meta box from post and page edit screens. This removes the structured data (Article, FAQ, Product, Recipe, etc.) configuration from the editor interface.',
1146 + 'disable_common_robots_metabox' => sprintf('Hide the Common Robots meta box and stop %1$s emitting index/noindex and follow/nofollow directives on the front end. %1$s also stops overriding WordPress core or another SEO plugin\'s robots tag. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1147 + 'disable_advance_robots_metabox' => sprintf('Hide the Advanced Robots meta box and stop %1$s emitting max-snippet, max-image-preview and max-video-preview directives, including the site-wide advanced defaults. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1148 + 'disable_redirection_metabox' => 'Hide the Redirection meta box and stop redirects configured through it from running. Rules added by hand on the Redirections screen keep working. Saved redirects are kept and resume if you re-enable this.',
1149 + 'disable_canonical_metabox' => sprintf('Hide the Canonical meta box and stop %1$s emitting or overriding the canonical URL on every render path. WordPress core and third-party canonicals are left in place. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1150 + 'disable_social_opengraph_metabox' => sprintf('Hide the Social Media & Open Graph meta box and stop %1$s emitting any Open Graph, Twitter or article tags. Tags from another SEO plugin are left in place. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1151 + 'disable_schema_markup_metabox' => sprintf('Hide the Schema Markup meta box and stop %1$s emitting any JSON-LD, including the site-wide Local SEO markup and OTTO structured data. Breadcrumb markup has its own setting. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1152 + 'disable_language_alternates_metabox' => sprintf('Hide the Language Alternates (hreflang) panel in the block editor and stop %1$s emitting any hreflang tags on the front end, including the auto-detected WPML entries. While disabled, %1$s does not manage or override this data — another SEO plugin, or WPML itself, is free to handle it. Saved values are kept and restored if you re-enable this.', Metasync::get_effective_plugin_name('MetaSync')),
1283 1153 'disable_seo_metabox' => 'Hide the SEO Title & Meta Description meta box from post and page edit screens. This removes the Classic editor SEO fields (the Gutenberg sidebar is unaffected).',
1284 - 'open_external_links' => 'Automatically add target="_blank" attribute to external links appearing in your posts, pages, and other post types when rendered by Otto.',
1154 + 'open_external_links' => sprintf('Automatically add target="_blank" attribute to external links appearing in your posts, pages, and other post types when rendered by %s.', $otto_name),
1285 1155 'content_genius_sync_roles' => 'Select which WordPress user roles should be synchronized with Content Genius. This determines which users will have their profiles and permissions synced for content collaboration.',
1286 1156 'permalink_structure' => sprintf('Displays your current WordPress permalink structure. %s works best with pretty permalinks (not "Plain"). If you see a warning, visit Settings > Permalinks to change your structure.', $plugin_name),
1287 1157 'hide_dashboard_framework' => sprintf('Hide the main %s dashboard from the WordPress admin menu. This is useful if you want to reduce menu clutter but still keep the plugin active.', $plugin_name),
1288 1158 'show_admin_bar_status' => sprintf('Display the %s status indicator in the WordPress admin bar at the top of your screen. This provides quick visibility of plugin status and key metrics.', $plugin_name),
1289 - 'enable_auto_updates' => sprintf('Allow WordPress to automatically update the %s plugin when new versions are released. Recommended for security patches, but you may prefer manual updates for major versions.', $plugin_name),
1290 1159 'import_external_data' => sprintf('Import your existing SEO settings and metadata from other popular SEO plugins like Yoast, Rank Math, or All in One SEO. This makes migration to %s seamless without losing your SEO data.', $plugin_name),
1291 - 'import_seo_metadata' => 'Migrate your existing SEO titles and meta descriptions from Yoast, Rank Math, or All in One SEO. This one-click import preserves your search rankings by copying your optimized meta data to MetaSync, even if the source plugin is deactivated.',
1292 - 'default_page_builder' => 'Choose how Content Genius stores synced articles. "Gutenberg" works with all themes and page builders. Selecting a specific builder converts content to that builder\'s widget format, which inherits the builder\'s global typography and layout styles.'
1160 + 'import_seo_metadata' => sprintf('Migrate your existing SEO titles and meta descriptions from Yoast, Rank Math, or All in One SEO. This one-click import preserves your search rankings by copying your optimized meta data to %s, even if the source plugin is deactivated.', $plugin_name),
1161 + 'default_page_builder' => 'Choose how Content Genius stores synced articles. "Gutenberg" works with all themes and page builders. Selecting a specific builder converts content to that builder\'s widget format, which inherits the builder\'s global typography and layout styles.',
1162 + 'og_image_dimensions' => 'Adds your share image\'s width, height, and file type to the Open Graph tags so Facebook, LinkedIn, and others render your preview instantly at the right size instead of guessing. Leave on unless another plugin already outputs these.',
1163 + 'article_timestamps' => 'Tells social platforms and search engines when each post was first published and last updated, so shares and rich results show accurate dates. Safe to leave enabled.',
1164 + 'article_author' => 'Adds a link to the author\'s profile or archive page to each post\'s social tags, so shared articles can show author attribution. You can override the author URL per-post. Turn off if you\'d rather not expose author pages.',
1165 + 'article_section' => 'Labels each post with its main topic (its primary category) in the social tags, helping platforms categorize your content. Falls back to the first category if no primary one is set.',
1166 + 'article_tags' => 'Adds each of your WordPress post tags as a separate social "tag" so platforms understand the topics a post covers. Turn off if you don\'t want your tags exposed in share metadata.',
1167 + 'twitter_image_alt' => 'Adds descriptive alt text to the image shown when your page is shared on X/Twitter, improving accessibility for screen-reader users. Uses your saved alt text or the image\'s own alt attribute.'
1293 1168 );
1294 1169 }
1295 1170
1171 + public function render_analytics_section() {
1172 + $enabled = get_option('metasync_analytics_opt_in', 'no') === 'yes';
1173 + $plugin_name = Metasync::get_effective_plugin_name();
1174 + /* translators: %s: Plugin name. */
1175 + $heading = sprintf(__('Help improve %s', 'metasync'), $plugin_name);
1176 + /* translators: %s: Plugin name. */
1177 + $intro = sprintf(__('Allow %s to collect limited usage analytics. This helps us understand which features are used, improve the product, and identify problems.', 'metasync'), $plugin_name);
1178 + /* translators: %s: Plugin name. */
1179 + $toggle_label = sprintf(__('Share usage data with %s', 'metasync'), $plugin_name);
1180 + ?>
1181 + <div class="metasync-analytics-consent-card">
1182 + <div class="metasync-analytics-consent-copy">
1183 + <h3><?php echo esc_html($heading); ?></h3>
1184 + <p><?php echo esc_html($intro); ?></p>
1185 + <p class="description"><?php esc_html_e('We collect limited technical information such as your site URL, plugin version, WordPress and PHP versions, user role, and feature usage. We do not collect passwords, API keys, customer content, names, or email addresses.', 'metasync'); ?></p>
1186 + </div>
1187 + <label class="metasync-consent-switch" for="metasync_analytics_opt_in">
1188 + <input type="hidden" name="metasync_analytics_opt_in" value="no" />
1189 + <input type="checkbox" id="metasync_analytics_opt_in" name="metasync_analytics_opt_in" value="yes" <?php checked($enabled); ?> />
1190 + <span class="metasync-consent-slider" aria-hidden="true"></span>
1191 + <span class="screen-reader-text"><?php echo esc_html($toggle_label); ?></span>
1192 + </label>
1193 + <span class="metasync-consent-status" aria-live="polite" data-enabled-label="<?php esc_attr_e('Enabled', 'metasync'); ?>" data-disabled-label="<?php esc_attr_e('Off', 'metasync'); ?>"><?php echo $enabled ? esc_html__('Enabled', 'metasync') : esc_html__('Off', 'metasync'); ?></span>
1194 + </div>
1195 + <?php
1196 + }
1197 +
1296 1198 public function get_field_section($field_id) {
1297 1199 $sections = $this->get_accordion_sections_config();
1298 1200
1299 1201 foreach ($sections as $section_key => $section_data) {
@@ -1327,9 +1229,9 @@
1327 1229 $content_state = $is_open ? 'open' : 'closed';
1328 1230
1329 1231 echo '<div class="metasync-accordion-section" data-section="' . esc_attr($section_key) . '">';
1330 1232
1331 - echo '<div class="metasync-accordion-header" role="button" tabindex="0" aria-expanded="' . $aria_expanded . '" aria-controls="' . $section_id . '">';
1233 + echo '<div class="metasync-accordion-header" role="button" tabindex="0" aria-expanded="' . esc_attr($aria_expanded) . '" aria-controls="' . esc_attr($section_id) . '">';
1332 1234 echo '<div class="metasync-accordion-title">';
1333 1235 echo '<span class="metasync-accordion-icon"><span class="dashicons dashicons-' . esc_attr($section_data['icon']) . '"></span></span>';
1334 1236 echo '<div class="metasync-accordion-text">';
1335 1237 echo '<h3>' . esc_html($section_data['title']) . '</h3>';
@@ -1340,9 +1242,9 @@
1340 1242 echo '<span class="toggle-icon">▼</span>';
1341 1243 echo '</button>';
1342 1244 echo '</div>';
1343 1245
1344 - echo '<div class="metasync-accordion-content" id="' . $section_id . '" data-state="' . $content_state . '">';
1246 + echo '<div class="metasync-accordion-content" id="' . esc_attr($section_id) . '" data-state="' . esc_attr($content_state) . '">';
1345 1247
1346 1248 if (isset($section_data['render_callback']) && is_callable($section_data['render_callback'])) {
1347 1249 call_user_func($section_data['render_callback']);
1348 1250 } elseif (isset($section_data['fields']) && is_array($section_data['fields'])) {
@@ -1357,9 +1259,9 @@
1357 1259 echo '<tr>';
1358 1260 echo '<th scope="row">';
1359 1261 if (!empty($field['title'])) {
1360 1262 echo '<div class="metasync-field-label-wrapper">';
1361 - echo '<label for="' . esc_attr($field['id']) . '">' . $field['title'] . '</label>';
1263 + echo '<label for="' . esc_attr($field['id']) . '">' . esc_html($field['title']) . '</label>';
1362 1264
1363 1265 if (isset($tooltips[$field_id])) {
1364 1266 echo '<button type="button" class="metasync-tooltip-trigger" data-tooltip-id="' . esc_attr($field_id) . '" aria-label="More information">';
1365 1267 echo '<svg class="metasync-info-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">';
@@ -1405,13 +1307,22 @@
1405 1307 return;
1406 1308 }
1407 1309
1408 1310 echo '<table class="form-table" role="presentation">';
1311 + $llms_tooltips = array(
1312 + 'llms_txt_enabled' => 'Publishes a file at yoursite.com/llms.txt listing your key pages so AI assistants like ChatGPT and Perplexity can find and cite your content. Safe to leave off if you don\'t want AI crawlers guided to your pages.',
1313 + 'llms_full_enabled' => 'Also publishes a larger file with the full text of your posts (not just links). This exposes complete article content and can be large — keep the post limit low on smaller hosting plans.',
1314 + );
1409 1315 foreach ($wp_settings_fields[$page][$section] as $field) {
1410 1316 echo '<tr>';
1411 1317 echo '<th scope="row">';
1412 1318 if (!empty($field['title'])) {
1413 - echo '<label for="' . esc_attr($field['id']) . '">' . $field['title'] . '</label>';
1319 + echo '<div class="metasync-field-label-wrapper">';
1320 + echo '<label for="' . esc_attr($field['id']) . '">' . esc_html($field['title']) . '</label>';
1321 + if (isset($llms_tooltips[$field['id']])) {
1322 + Metasync::render_tooltip_icon($field['id'], $llms_tooltips[$field['id']]);
1323 + }
1324 + echo '</div>';
1414 1325 }
1415 1326 echo '</th>';
1416 1327 echo '<td>';
1417 1328 call_user_func($field['callback'], $field['args']);
@@ -1461,31 +1372,32 @@
1461 1372 $display_value = $current_token;
1462 1373 $status_message = 'Plugin Auth Token is active and ready for authentication.';
1463 1374 $refresh_help = 'Click refresh to generate a new token and update the heartbeat API.';
1464 1375 } else {
1465 - $display_value = 'Auto-generated when connecting to ' . esc_html(Metasync::get_effective_plugin_name());
1466 - $status_message = 'Plugin Auth Token will be automatically generated when you click "Connect to ' . esc_html(Metasync::get_effective_plugin_name()) . '".';
1376 + $display_value = 'Auto-generated when connecting to ' . Metasync::get_effective_plugin_name();
1377 + $status_message = 'Plugin Auth Token will be automatically generated when you click "Connect to ' . Metasync::get_effective_plugin_name() . '".';
1467 1378 $refresh_help = 'You can also manually generate a token by clicking refresh.';
1468 1379 }
1469 1380
1381 + printf('<div class="metasync-auth-token-row">');
1470 1382 printf(
1471 - '<input type="text" id="apikey" name="' . Metasync_Admin::option_key . '[general][apikey]" value="%s" size="40" readonly="readonly" /> ',
1383 + '<input type="text" id="apikey" name="' . esc_attr(Metasync_Admin::option_key) . '[general][apikey]" value="%s" size="40" class="regular-text" readonly="readonly" />',
1472 1384 esc_attr($display_value)
1473 1385 );
1474 -
1475 - printf('<button type="button" id="refresh-plugin-auth-token" class="button button-secondary" style="margin-left: 10px;"><span class="dashicons dashicons-controls-repeat"></span> Refresh Token</button>');
1476 - printf('<p class="description">%s %s</p>', $status_message, $refresh_help);
1386 + printf('<button type="button" id="refresh-plugin-auth-token" class="button button-secondary metasync-refresh-token-btn"><span class="dashicons dashicons-controls-repeat"></span> Refresh Token</button>');
1387 + printf('</div>');
1388 + printf('<p class="description">%s %s</p>', esc_html($status_message), esc_html($refresh_help));
1477 1389 }
1478 1390
1479 1391 public function linkgraph_token_callback()
1480 1392 {
1481 1393 printf(
1482 - '<input type="text" id="linkgraph_token" name="' . Metasync_Admin::option_key . '[general][linkgraph_token]" value="%s" size="25" readonly="readonly" />',
1394 + '<input type="text" id="linkgraph_token" name="' . esc_attr(Metasync_Admin::option_key) . '[general][linkgraph_token]" value="%s" size="25" readonly="readonly" />',
1483 1395 isset(Metasync::get_option('general')['linkgraph_token']) ? esc_attr(Metasync::get_option('general')['linkgraph_token']) : ''
1484 1396 );
1485 1397
1486 1398 printf(
1487 - '<input type="text" id="linkgraph_customer_id" name="' . Metasync_Admin::option_key . '[general][linkgraph_customer_id]" value="%s" size="25" readonly="readonly" />',
1399 + '<input type="text" id="linkgraph_customer_id" name="' . esc_attr(Metasync_Admin::option_key) . '[general][linkgraph_customer_id]" value="%s" size="25" readonly="readonly" />',
1488 1400 isset(Metasync::get_option('general')['linkgraph_customer_id']) ? esc_attr(Metasync::get_option('general')['linkgraph_customer_id']) : ''
1489 1401 );
1490 1402
1491 1403 ?>
@@ -1504,9 +1416,9 @@
1504 1416 }
1505 1417 # Stored timestamps use current_time('mysql') which is the WP site's
1506 1418 # local timezone (no offset marker on the string). Constructing
1507 1419 # DateTime without a timezone would default to UTC and produce a
1508 - # bogus diff equal to the WP timezone offset (WP-350 QA: "4 hours ago"
1420 + # bogus diff equal to the WP timezone offset (QA: "4 hours ago"
1509 1421 # after a 4-minute sync on non-UTC sites).
1510 1422 $wp_tz = function_exists('wp_timezone') ? wp_timezone() : new DateTimeZone('UTC');
1511 1423 $now = new DateTime('now', $wp_tz);
1512 1424 $ago = new DateTime($datetime, $wp_tz);
@@ -1535,12 +1447,26 @@
1535 1447 }
1536 1448
1537 1449 public function searchatlas_api_key_callback()
1538 1450 {
1539 - $current_api_key = isset(Metasync::get_option('general')['searchatlas_api_key']) ? esc_attr(Metasync::get_option('general')['searchatlas_api_key']) : '';
1451 + // Whether a key is stored at rest (encrypted or legacy plaintext).
1452 + $stored_api_key = Metasync::get_option('general')['searchatlas_api_key'] ?? '';
1453 + $has_api_key = ($stored_api_key !== '');
1454 +
1455 + // Decrypted key for masking only. Never rendered in cleartext.
1456 + // false => an encrypted key exists but cannot be decrypted (salts changed).
1457 + $decrypted_api_key = Metasync::get_searchatlas_api_key();
1458 + $decrypt_failed = ($decrypted_api_key === false);
1459 +
1460 + // Build a masked representation: bullets + last 4 chars. The cleartext
1461 + // key is never emitted into the page.
1462 + $masked_api_key = '';
1463 + if (!$decrypt_failed && $decrypted_api_key !== '') {
1464 + $masked_api_key = str_repeat('*', 8) . substr($decrypted_api_key, -4);
1465 + }
1466 +
1540 1467 $otto_uuid = isset(Metasync::get_option('general')['otto_pixel_uuid']) ? Metasync::get_option('general')['otto_pixel_uuid'] : '';
1541 -
1542 - $has_api_key = !empty($current_api_key);
1468 +
1543 1469 $has_otto_uuid = !empty($otto_uuid);
1544 1470
1545 1471 $is_fully_connected = $this->admin_instance->is_heartbeat_connected();
1546 1472
@@ -1594,11 +1520,11 @@
1594 1520 printf('<div style="padding: 10px 0; color: #666; font-size: 13px; line-height: 1.5;">');
1595 1521 printf('• Make sure you have a %s account before connecting<br/>', esc_html(Metasync::get_effective_plugin_name()));
1596 1522 printf('• The authentication window will open in a popup - please allow popups<br/>');
1597 1523 printf('• The process typically takes 15-30 seconds to complete<br/>');
1598 - printf('• Your API key will be automatically filled in the field below<br/>');
1524 + printf('• Your API key will be stored securely and shown masked below<br/>');
1599 1525 printf('• If you encounter issues, try disabling ad blockers temporarily<br/>');
1600 - printf('• Contact <a href="mailto:%s">%s</a> if you need assistance', Metasync::SUPPORT_EMAIL, Metasync::SUPPORT_EMAIL);
1526 + printf('• Contact <a href="mailto:%s">%s</a> if you need assistance', esc_attr(Metasync::SUPPORT_EMAIL), esc_html(Metasync::SUPPORT_EMAIL));
1601 1527 printf('</div>');
1602 1528 printf('</details>');
1603 1529 printf('</div>');
1604 1530
@@ -1613,30 +1539,42 @@
1613 1539 printf('<span style="color: #ff8c00; margin-left: 10px; font-weight: normal;">Partial Connection (Missing %s UUID)</span>', esc_html(Metasync::get_whitelabel_otto_name()));
1614 1540 }
1615 1541 printf('</label>');
1616 1542
1543 + // Read-only masked display. The API key is managed via one-click
1544 + // authentication only; the cleartext key is never rendered into the
1545 + // page HTML (View Source / DOM). No form input is emitted, so saving
1546 + // settings cannot overwrite or expose the stored key.
1547 + $display_has_key = (!$decrypt_failed && $masked_api_key !== '') ? '1' : '0';
1617 1548 printf(
1618 - '<input type="text" id="searchatlas-api-key" name="' . Metasync_Admin::option_key . '[general][searchatlas_api_key]" value="%s" size="40" class="regular-text" placeholder="Your API key will appear here after authentication" />',
1619 - $current_api_key
1549 + '<div id="searchatlas-api-key-display" class="metasync-api-key-masked" data-has-key="%s" style="display:inline-flex; align-items:center; min-width:320px; height:42px; padding:0 14px; font-family:monospace; font-size:15px; letter-spacing:4px; background:var(--dashboard-input-bg, #22272e); border:1px solid var(--dashboard-border, #3a424d); border-radius:6px; color:var(--dashboard-text-primary, #e6e8eb); cursor:default; user-select:none;">',
1550 + esc_attr($display_has_key)
1620 1551 );
1621 -
1552 + if ($decrypt_failed) {
1553 + printf('<em style="color:#b32d2e; font-family:sans-serif; letter-spacing:normal; font-style:normal; font-size:14px;">Stored API key could not be read. Please re-authenticate above.</em>');
1554 + } elseif ($masked_api_key !== '') {
1555 + echo esc_html($masked_api_key);
1556 + } else {
1557 + printf('<em style="color:#646970;">Not configured</em>');
1558 + }
1559 + printf('</div>');
1560 +
1622 1561 printf('<p class="description" style="margin-top: 8px;">');
1623 - if ($is_fully_connected) {
1624 - printf('Your %s API key for secure communication with the platform. Use the authentication button above to refresh or change accounts.', esc_html(Metasync::get_effective_plugin_name()));
1562 + if ($decrypt_failed) {
1563 + printf('Your stored API key could not be decrypted (your site security keys may have changed). Please re-authenticate above to reconnect.');
1564 + } elseif ($is_fully_connected) {
1565 + printf('Your %s API key is stored securely and used for communication with the platform. Use the authentication button above to refresh or change accounts.', esc_html(Metasync::get_effective_plugin_name()));
1625 1566 } elseif ($has_api_key && !$has_otto_uuid) {
1626 1567 printf('Your API key is configured but %s UUID is missing. Re-authenticate above to complete the setup and enable dashboard access.', esc_html(Metasync::get_whitelabel_otto_name()));
1627 1568 } else {
1628 - printf('This field will be automatically populated when you authenticate using the button above. You can also manually enter your API key if you have one.');
1569 + printf('Use the authentication button above to securely connect your account. Your API key is stored encrypted and shown masked here.');
1629 1570 }
1630 1571 printf('</p>');
1631 1572
1632 - ?>
1633 - <p class="description" style="margin-top: 10px; padding: 8px 12px; background: #fff9e6; border-left: 3px solid #f0b849; border-radius: 4px; font-size: 12px;">
1634 - <strong>Manual Authentication:</strong> If you manually enter your <?php echo esc_html(Metasync::get_effective_plugin_name()); ?> API Key and OTTO UUID, you also consent to the same AI-powered automation permissions described above.
1635 - </p>
1636 - <?php
1573 + printf('</div>');
1637 1574
1638 - printf('</div>');
1575 + // The OTTO Pixel UUID is shown once, by the read-only Settings-API
1576 + // field in the OTTO Server-Side Rendering section; do not repeat it here.
1639 1577
1640 1578 if( isset(Metasync::get_option('general')['searchatlas_api_key'])&&Metasync::get_option('general')['searchatlas_api_key']!=''){
1641 1579 $timestamp = @Metasync::get_option('general')['send_auth_token_timestamp'];
1642 1580 printf(
@@ -1641,9 +1579,9 @@
1641 1579 $timestamp = @Metasync::get_option('general')['send_auth_token_timestamp'];
1642 1580 printf(
1643 1581 '<p id="sendAuthTokenTimestamp" class="descriptionValue">%s (%s)</p>',
1644 1582 esc_attr($timestamp),
1645 - $this->time_elapsed_string($timestamp)
1583 + esc_html($this->time_elapsed_string($timestamp))
1646 1584 );
1647 1585
1648 1586
1649 1587 }
@@ -1651,9 +1589,9 @@
1651 1589
1652 1590 public function bing_site_verification_callback()
1653 1591 {
1654 1592 printf(
1655 - '<input type="text" id="bing_site_verification" name="' . Metasync_Admin::option_key . '[searchengines][bing_site_verification]" value="%s" size="50" />',
1593 + '<input type="text" id="bing_site_verification" name="' . esc_attr(Metasync_Admin::option_key) . '[searchengines][bing_site_verification]" value="%s" size="50" />',
1656 1594 isset(Metasync::get_option('searchengines')['bing_site_verification']) ? esc_attr(Metasync::get_option('searchengines')['bing_site_verification']) : ''
1657 1595 );
1658 1596
1659 1597 printf(' <br> <span class="description"> Enter Bing Webmaster Tools verification code: </span> ');
@@ -1662,9 +1600,9 @@
1662 1600
1663 1601 public function yandex_site_verification_callback()
1664 1602 {
1665 1603 printf(
1666 - '<input type="text" id="yandex_site_verification" name="' . Metasync_Admin::option_key . '[searchengines][yandex_site_verification]" value="%s" size="50" />',
1604 + '<input type="text" id="yandex_site_verification" name="' . esc_attr(Metasync_Admin::option_key) . '[searchengines][yandex_site_verification]" value="%s" size="50" />',
1667 1605 isset(Metasync::get_option('searchengines')['yandex_site_verification']) ? esc_attr(Metasync::get_option('searchengines')['yandex_site_verification']) : ''
1668 1606 );
1669 1607
1670 1608 printf(' <br> <span class="description"> Enter Yandex verification code: </span>');
@@ -1673,9 +1611,9 @@
1673 1611
1674 1612 public function google_site_verification_callback()
1675 1613 {
1676 1614 printf(
1677 - '<input type="text" id="google_site_verification" name="' . Metasync_Admin::option_key . '[searchengines][google_site_verification]" value="%s" size="50" />',
1615 + '<input type="text" id="google_site_verification" name="' . esc_attr(Metasync_Admin::option_key) . '[searchengines][google_site_verification]" value="%s" size="50" />',
1678 1616 isset(Metasync::get_option('searchengines')['google_site_verification']) ? esc_attr(Metasync::get_option('searchengines')['google_site_verification']) : ''
1679 1617 );
1680 1618
1681 1619 printf(' <br> <span class="description"> Enter Google Search Console verification code: </span>');
@@ -1684,9 +1622,9 @@
1684 1622
1685 1623 public function pinterest_site_verification_callback()
1686 1624 {
1687 1625 printf(
1688 - '<input type="text" id="pinterest_site_verification" name="' . Metasync_Admin::option_key . '[searchengines][pinterest_site_verification]" value="%s" size="50" />',
1626 + '<input type="text" id="pinterest_site_verification" name="' . esc_attr(Metasync_Admin::option_key) . '[searchengines][pinterest_site_verification]" value="%s" size="50" />',
1689 1627 isset(Metasync::get_option('searchengines')['pinterest_site_verification']) ? esc_attr(Metasync::get_option('searchengines')['pinterest_site_verification']) : ''
1690 1628 );
1691 1629
1692 1630 printf(' <br> <span class="description"> Enter Pinterest verification code: </span>');
@@ -1695,12 +1633,16 @@
1695 1633
1696 1634 public function local_seo_person_organization_callback()
1697 1635 {
1698 1636 $person_organization = Metasync::get_option('localseo')['local_seo_person_organization'] ?? '';
1637 + $valid_person_organizations = array('Person', 'Organization');
1699 1638 ?>
1700 1639 <div class="metasync-type-select-wrap">
1701 1640 <select id="local_seo_person_organization" name="<?php echo esc_attr(Metasync_Admin::option_key . '[localseo][local_seo_person_organization]') ?>">
1702 1641 <?php
1642 + if (!in_array($person_organization, $valid_person_organizations, true)) {
1643 + printf('<option value="0" selected="selected">Select Type</option>');
1644 + }
1703 1645 printf('<option value="Person" %s >Person</option>', selected('Person', esc_attr($person_organization)));
1704 1646 printf('<option value="Organization" %s >Organization</option>', selected('Organization', esc_attr($person_organization)));
1705 1647 ?>
1706 1648 </select>
@@ -1711,10 +1653,10 @@
1711 1653
1712 1654 public function local_seo_name_callback()
1713 1655 {
1714 1656 printf(
1715 - '<input type="text" id="local_seo_name" name="' . Metasync_Admin::option_key . '[localseo][local_seo_name]" value="%s" size="50" />',
1716 - isset(Metasync::get_option('localseo')['local_seo_name']) ? esc_attr(Metasync::get_option('localseo')['local_seo_name']) : get_bloginfo()
1657 + '<input type="text" id="local_seo_name" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_name]" value="%s" size="50" />',
1658 + isset(Metasync::get_option('localseo')['local_seo_name']) ? esc_attr(Metasync::get_option('localseo')['local_seo_name']) : esc_attr(get_bloginfo())
1717 1659 );
1718 1660
1719 1661 printf(' <br> <span class="description"> Your name or company name </span>');
1720 1662 }
@@ -1722,31 +1664,82 @@
1722 1664 public function local_seo_logo_callback()
1723 1665 {
1724 1666 $local_seo_logo = Metasync::get_option('localseo')['local_seo_logo'] ?? '';
1725 1667
1668 + // Rows saved by the legacy sanitizer hold the corrupted form of
1669 + // an attachment ID ("http://45589"). Repair it before anything reads
1670 + // the value — both so the preview resolves and so the hidden input
1671 + // re-submits the recovered ID instead of the corrupted string, which
1672 + // would otherwise survive every subsequent Save Settings.
1673 + $local_seo_logo = metasync_repair_scheme_prefixed_media_id($local_seo_logo);
1674 +
1726 1675 printf(
1727 - '<input type="hidden" id="local_seo_logo" name="' . Metasync_Admin::option_key . '[localseo][local_seo_logo]" value="%s" size="50" />',
1728 - isset(Metasync::get_option('localseo')['local_seo_logo']) ? esc_attr(Metasync::get_option('localseo')['local_seo_logo']) : ''
1676 + '<input type="hidden" id="local_seo_logo" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_logo]" value="%s" size="50" />',
1677 + esc_attr((string) $local_seo_logo)
1729 1678 );
1730 1679
1731 - printf(' <br> <input class="button-secondary" type="button" id="logo_upload_button" value="Add or Upload File">');
1680 + printf(' <br> <input class="button-secondary no-loading" type="button" id="logo_upload_button" value="Add or Upload File">');
1732 1681
1733 1682 printf(' <br><br> <span class="description bold"> Min Size: 160Χ90px, Max Size: 1920X1080px. </span> <br> <span class="description"> A squared image is preferred by the search engines. </span> <br><br> ');
1734 1683
1735 - printf('<img src="%s" id="local_seo_business_logo" width="300">', wp_get_attachment_image_src($local_seo_logo, 'medium')[0] ?? '');
1684 + printf('<span class="metasync-logo-preview-wrap">');
1736 1685
1737 - $button_type = 'hidden';
1738 - if ($local_seo_logo) {
1739 - $button_type = 'button';
1686 + // The stored value may be an attachment ID or a raw URL, so resolve
1687 + // both the way the front-end schema output already does. Anything that
1688 + // resolves to nothing — a deleted attachment, a legacy value mangled by
1689 + // an earlier save — must render no preview at all, rather than an empty
1690 + // src next to an orphaned remove button.
1691 + $logo_url = $this->resolve_media_url($local_seo_logo, 'medium');
1692 +
1693 + printf(
1694 + '<img src="%s" id="local_seo_business_logo" width="300"%s>',
1695 + esc_url($logo_url),
1696 + $logo_url ? '' : ' style="display:none"'
1697 + );
1698 +
1699 + $button_type = $logo_url ? 'button' : 'hidden';
1700 + printf('<input type="%s" class="button-secondary no-loading metasync-logo-remove-btn" id="local_seo_logo_close_btn" value="X">', esc_attr($button_type));
1701 + printf('</span>');
1702 + }
1703 +
1704 + /**
1705 + * Resolve a stored media setting to a displayable URL.
1706 + *
1707 + * These settings accept either a media-library attachment ID or a raw URL;
1708 + * returns an empty string when the value resolves to neither, so callers
1709 + * can distinguish "no image" from "image we could not resolve".
1710 + *
1711 + * @param mixed $value Attachment ID or URL as stored in the options.
1712 + * @param string $size Registered image size to request for an attachment.
1713 + * @return string Resolved URL, or '' when there is nothing to show.
1714 + */
1715 + private function resolve_media_url($value, $size = 'medium')
1716 + {
1717 + if (empty($value)) {
1718 + return '';
1740 1719 }
1741 - printf('<input type="%s" class="button-secondary" id="local_seo_logo_close_btn" value="X">', $button_type);
1720 +
1721 + // A row saved by the legacy sanitizer stores a corrupted attachment ID ("http://45589"),
1722 + // which is neither resolvable as an ID nor a usable image URL.
1723 + $value = metasync_repair_scheme_prefixed_media_id($value);
1724 +
1725 + if (empty($value)) {
1726 + return '';
1727 + }
1728 +
1729 + if (is_numeric($value)) {
1730 + $url = wp_get_attachment_image_url((int) $value, $size);
1731 + return $url ? $url : '';
1732 + }
1733 +
1734 + return (string) $value;
1742 1735 }
1743 1736
1744 1737 public function local_seo_url_callback()
1745 1738 {
1746 1739 printf(
1747 - '<input type="text" id="local_seo_url" name="' . Metasync_Admin::option_key . '[localseo][local_seo_url]" value="%s" size="50" />',
1748 - isset(Metasync::get_option('localseo')['local_seo_url']) ? esc_attr(Metasync::get_option('localseo')['local_seo_url']) : home_url()
1740 + '<input type="text" id="local_seo_url" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_url]" value="%s" size="50" />',
1741 + isset(Metasync::get_option('localseo')['local_seo_url']) ? esc_attr(Metasync::get_option('localseo')['local_seo_url']) : esc_attr(home_url())
1749 1742 );
1750 1743
1751 1744 printf(' <br> <span class="description"> URL of the item. </span>');
1752 1745 }
@@ -1753,9 +1746,9 @@
1753 1746
1754 1747 public function local_seo_email_callback()
1755 1748 {
1756 1749 printf(
1757 - '<input type="text" id="local_seo_email" name="' . Metasync_Admin::option_key . '[localseo][local_seo_email]" value="%s" size="50" />',
1750 + '<input type="text" id="local_seo_email" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_email]" value="%s" size="50" />',
1758 1751 isset(Metasync::get_option('localseo')['local_seo_email']) ? esc_attr(Metasync::get_option('localseo')['local_seo_email']) : ''
1759 1752 );
1760 1753
1761 1754 printf(' <br> <span class="description"> Search engines display your email address. </span>');
@@ -1763,9 +1756,9 @@
1763 1756
1764 1757 public function local_seo_phone_callback()
1765 1758 {
1766 1759 printf(
1767 - '<input type="text" id="local_seo_phone" name="' . Metasync_Admin::option_key . '[localseo][local_seo_phone]" value="%s" size="50" />',
1760 + '<input type="text" id="local_seo_phone" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_phone]" value="%s" size="50" />',
1768 1761 isset(Metasync::get_option('localseo')['local_seo_phone']) ? esc_attr(Metasync::get_option('localseo')['local_seo_phone']) : ''
1769 1762 );
1770 1763
1771 1764 printf(' <br> <span class="description"> Search engines may prominently display your contact phone number for mobile users. </span>');
@@ -1773,29 +1766,29 @@
1773 1766
1774 1767 public function local_seo_address_callback()
1775 1768 {
1776 1769 printf(
1777 - '<input type="text" id="local_seo_address_street" name="' . Metasync_Admin::option_key . '[localseo][address][street]" value="%s" size="50" placeholder="Street Address"/> <br>',
1770 + '<input type="text" id="local_seo_address_street" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][address][street]" value="%s" size="50" placeholder="Street Address"/> <br>',
1778 1771 isset(Metasync::get_option('localseo')['address']['street']) ? esc_attr(Metasync::get_option('localseo')['address']['street']) : ''
1779 1772 );
1780 1773
1781 1774 printf(
1782 - '<input type="text" id="local_seo_address_locality" name="' . Metasync_Admin::option_key . '[localseo][address][locality]" value="%s" size="50" placeholder="Locality"/> <br>',
1775 + '<input type="text" id="local_seo_address_locality" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][address][locality]" value="%s" size="50" placeholder="Locality"/> <br>',
1783 1776 isset(Metasync::get_option('localseo')['address']['locality']) ? esc_attr(Metasync::get_option('localseo')['address']['locality']) : ''
1784 1777 );
1785 1778
1786 1779 printf(
1787 - '<input type="text" id="local_seo_address_region" name="' . Metasync_Admin::option_key . '[localseo][address][region]" value="%s" size="50" placeholder="Region"/> <br>',
1780 + '<input type="text" id="local_seo_address_region" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][address][region]" value="%s" size="50" placeholder="Region"/> <br>',
1788 1781 isset(Metasync::get_option('localseo')['address']['region']) ? esc_attr(Metasync::get_option('localseo')['address']['region']) : ''
1789 1782 );
1790 1783
1791 1784 printf(
1792 - '<input type="text" id="local_seo_address_postalcode" name="' . Metasync_Admin::option_key . '[localseo][address][postalcode]" value="%s" size="50" placeholder="Postal Code"/> <br>',
1785 + '<input type="text" id="local_seo_address_postalcode" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][address][postalcode]" value="%s" size="50" placeholder="Postal Code"/> <br>',
1793 1786 isset(Metasync::get_option('localseo')['address']['postalcode']) ? esc_attr(Metasync::get_option('localseo')['address']['postalcode']) : ''
1794 1787 );
1795 1788
1796 1789 printf(
1797 - '<input type="text" id="local_seo_address_country" name="' . Metasync_Admin::option_key . '[localseo][address][country]" value="%s" size="50" placeholder="Country"/> <br>',
1790 + '<input type="text" id="local_seo_address_country" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][address][country]" value="%s" size="50" placeholder="Country"/> <br>',
1798 1791 isset(Metasync::get_option('localseo')['address']['country']) ? esc_attr(Metasync::get_option('localseo')['address']['country']) : ''
1799 1792 );
1800 1793 }
1801 1794
@@ -1810,9 +1803,9 @@
1810 1803 <select name="<?php echo esc_attr(Metasync_Admin::option_key . '[localseo][local_seo_business_type]') ?>">
1811 1804 <option value='0'>Select Business Type</option>
1812 1805 <?php
1813 1806 foreach ($types as $type) {
1814 - printf('<option value="%s" %s >%s</option>', $type, selected($type, esc_attr($business_type)), $type);
1807 + printf('<option value="%s" %s >%s</option>', esc_attr($type), selected($type, $business_type, false), esc_html($type));
1815 1808 }
1816 1809 ?>
1817 1810 </select>
1818 1811 <?php
@@ -1836,9 +1829,9 @@
1836 1829 <li>
1837 1830 <select name="<?php echo esc_attr(Metasync_Admin::option_key . '[localseo][days][]') ?>">
1838 1831 <?php
1839 1832 foreach ($days_name as $name) {
1840 - printf('<option value="%s" %s >%s</option>', $name, selected(esc_attr($name), esc_attr($day_name)), esc_attr($name));
1833 + printf('<option value="%s" %s >%s</option>', esc_attr($name), selected($name, $day_name, false), esc_html($name));
1841 1834 }
1842 1835 ?>
1843 1836 </select>
1844 1837 <input type="text" name="<?php echo esc_attr(Metasync_Admin::option_key . '[localseo][times][]') ?>" value="<?php echo esc_attr($day_time) ?>">
@@ -1917,9 +1910,9 @@
1917 1910
1918 1911 public function local_seo_price_range_callback()
1919 1912 {
1920 1913 printf(
1921 - '<input type="text" id="local_seo_price_range" name="' . Metasync_Admin::option_key . '[localseo][local_seo_price_range]" value="%s" size="50" />',
1914 + '<input type="text" id="local_seo_price_range" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_price_range]" value="%s" size="50" />',
1922 1915 isset(Metasync::get_option('localseo')['local_seo_price_range']) ? esc_attr(Metasync::get_option('localseo')['local_seo_price_range']) : ''
1923 1916 );
1924 1917 printf(' <br> <span class="description"> The price range of the business, for example $$$. </span>');
1925 1918 }
@@ -1932,9 +1925,9 @@
1932 1925 <?php
1933 1926 $about_page = Metasync::get_option('localseo')['local_seo_about_page'] ?? '';
1934 1927 $pages = get_pages();
1935 1928 foreach ($pages as $page) {
1936 - printf('<option value="%s" %s >%s</option>', $page->ID, selected($page->ID, esc_attr($about_page)), $page->post_title);
1929 + printf('<option value="%s" %s >%s</option>', absint($page->ID), selected($page->ID, $about_page, false), esc_html($page->post_title));
1937 1930 }
1938 1931 ?>
1939 1932 </select>
1940 1933 <?php
@@ -1949,9 +1942,9 @@
1949 1942 <?php
1950 1943 $contact_page = Metasync::get_option('localseo')['local_seo_contact_page'] ?? '';
1951 1944 $pages = get_pages();
1952 1945 foreach ($pages as $page) {
1953 - printf('<option value="%s" %s >%s</option>', $page->ID, selected($page->ID, esc_attr($contact_page)), $page->post_title);
1946 + printf('<option value="%s" %s >%s</option>', absint($page->ID), selected($page->ID, $contact_page, false), esc_html($page->post_title));
1954 1947 }
1955 1948 ?>
1956 1949 </select>
1957 1950 <?php
@@ -1960,9 +1953,9 @@
1960 1953
1961 1954 public function local_seo_map_key_callback()
1962 1955 {
1963 1956 printf(
1964 - '<input type="text" id="local_seo_map_key" name="' . Metasync_Admin::option_key . '[localseo][local_seo_map_key]" value="%s" size="50" />',
1957 + '<input type="text" id="local_seo_map_key" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_map_key]" value="%s" size="50" />',
1965 1958 isset(Metasync::get_option('localseo')['local_seo_map_key']) ? esc_attr(Metasync::get_option('localseo')['local_seo_map_key']) : ''
1966 1959 );
1967 1960
1968 1961 printf(' <br> <span class="description"> An API Key is required to display embedded Google Maps on your site. </span>');
@@ -1970,9 +1963,9 @@
1970 1963
1971 1964 public function local_seo_geo_coordinates_callback()
1972 1965 {
1973 1966 printf(
1974 - '<input type="text" id="local_seo_geo_coordinates" name="' . Metasync_Admin::option_key . '[localseo][local_seo_geo_coordinates]" value="%s" size="50" />',
1967 + '<input type="text" id="local_seo_geo_coordinates" name="' . esc_attr(Metasync_Admin::option_key) . '[localseo][local_seo_geo_coordinates]" value="%s" size="50" />',
1975 1968 isset(Metasync::get_option('localseo')['local_seo_geo_coordinates']) ? esc_attr(Metasync::get_option('localseo')['local_seo_geo_coordinates']) : ''
1976 1969 );
1977 1970
1978 1971 printf(' <br> <span class="description"> Latitude and longitude values separated by comma. </span>');
@@ -1980,9 +1973,9 @@
1980 1973
1981 1974 public function header_snippets_callback()
1982 1975 {
1983 1976 printf(
1984 - '<textarea class="wide-text" id="header_snippets" rows="8" name="' . Metasync_Admin::option_key . '[codesnippets][header_snippet]" >%s</textarea>',
1977 + '<textarea class="wide-text" id="header_snippets" rows="8" name="' . esc_attr(Metasync_Admin::option_key) . '[codesnippets][header_snippet]" >%s</textarea>',
1985 1978 isset(Metasync::get_option('codesnippets')['header_snippet']) ? esc_attr(Metasync::get_option('codesnippets')['header_snippet']) : ''
1986 1979 );
1987 1980 }
1988 1981
@@ -1988,163 +1981,13 @@
1988 1981
1989 1982 public function footer_snippets_callback()
1990 1983 {
1991 1984 printf(
1992 - '<textarea class="wide-text" id="footer_snippets" rows="8" name="' . Metasync_Admin::option_key . '[codesnippets][footer_snippet]" >%s</textarea>',
1985 + '<textarea class="wide-text" id="footer_snippets" rows="8" name="' . esc_attr(Metasync_Admin::option_key) . '[codesnippets][footer_snippet]" >%s</textarea>',
1993 1986 isset(Metasync::get_option('codesnippets')['footer_snippet']) ? esc_attr(Metasync::get_option('codesnippets')['footer_snippet']) : ''
1994 1987 );
1995 1988 }
1996 1989
1997 - public function no_index_posts_callback()
1998 - {
1999 - printf(
2000 - '<input type="checkbox" id="no_index_posts" name="' . Metasync_Admin::option_key . '[optimal_settings][no_index_posts]" value="true" %s />',
2001 - isset(Metasync::get_option('optimal_settings')['no_index_posts']) && Metasync::get_option('optimal_settings')['no_index_posts'] == 'true' ? 'checked' : ''
2002 - );
2003 -
2004 - printf(' <br> <span class="description"> Setting empty archives to <code>noindex</code> is useful for avoiding indexation of thin content pages and dilution of page rank. As soon as a post is added, the page is updated to index. </span>');
2005 - }
2006 -
2007 - public function no_follow_links_callback()
2008 - {
2009 - printf(
2010 - '<input type="checkbox" id="no_follow_links" name="' . Metasync_Admin::option_key . '[optimal_settings][no_follow_links]" value="true" %s />',
2011 - isset(Metasync::get_option('optimal_settings')['no_follow_links']) && Metasync::get_option('optimal_settings')['no_follow_links'] == 'true' ? 'checked' : ''
2012 - );
2013 -
2014 - printf(' <br> <span class="description"> Automatically add <code>rel="nofollow"</code> attribute to external links appearing in your posts, pages, and other post types. The attribute is dynamically applied when the url is displayed</span>');
2015 - }
2016 -
2017 - public function open_external_links_callback()
2018 - {
2019 - printf(
2020 - '<input type="checkbox" id="open_external_links" name="' . Metasync_Admin::option_key . '[optimal_settings][open_external_links]" value="true" %s />',
2021 - isset(Metasync::get_option('optimal_settings')['open_external_links']) && Metasync::get_option('optimal_settings')['open_external_links'] == 'true' ? 'checked' : ''
2022 - );
2023 -
2024 - printf(' <br> <span class="description"> Automatically add <code>target="_blank"</code> attribute to external links appearing in your posts, pages, and other post types. The attribute is applied when the url is displayed.</span>');
2025 - }
2026 -
2027 - public function add_alt_image_tags_callback()
2028 - {
2029 - printf(
2030 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[optimal_settings][add_alt_image_tags]" value="true" %s />',
2031 - isset(Metasync::get_option('optimal_settings')['add_alt_image_tags']) && Metasync::get_option('optimal_settings')['add_alt_image_tags'] == 'true' ? 'checked' : ''
2032 - );
2033 -
2034 - printf(' <br> <span class="description"> Automatically add <code>alt</code> attribute to Image Tags appearing in your posts, pages, and other post types. The attribute is applied when the content is displayed.</span>');
2035 - }
2036 -
2037 - public function add_title_image_tags_callback()
2038 - {
2039 - printf(
2040 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[optimal_settings][add_title_image_tags]" value="true" %s />',
2041 - isset(Metasync::get_option('optimal_settings')['add_title_image_tags']) && Metasync::get_option('optimal_settings')['add_title_image_tags'] == 'true' ? 'checked' : ''
2042 - );
2043 -
2044 - printf(' <br> <span class="description"> Automatically add <code>title</code> attribute to Image Tags appearing in your posts, pages, and other post types. The attribute is applied when the content is displayed.</span>');
2045 - }
2046 -
2047 - public function site_type_callback()
2048 - {
2049 -
2050 - $site_type = Metasync::get_option('optimal_settings')['site_info']['type'] ?? '';
2051 -
2052 - $types = [
2053 - ['name' => 'Personal Blog', 'value' => 'blog'],
2054 - ['name' => 'Community Blog/News Site', 'value' => 'news'],
2055 - ['name' => 'Personal Portfolio', 'value' => 'portfolio'],
2056 - ['name' => 'Small Business Site', 'value' => 'business'],
2057 - ['name' => 'Webshop', 'value' => 'webshop'],
2058 - ['name' => 'Other Personal Website', 'value' => 'otherpersonal'],
2059 - ['name' => 'Other Business Website', 'value' => 'otherbusiness'],
2060 - ];
2061 -
2062 - ?>
2063 - <select name="<?php echo esc_attr(Metasync_Admin::option_key . '[optimal_settings][site_info][type]') ?>" id="site_info_type">
2064 - <?php
2065 - foreach ($types as $type) {
2066 - printf('<option value="%s" %s >%s</option>', esc_attr($type['value']), selected(esc_attr($type['value']), esc_attr($site_type)), ($type['name']));
2067 - }
2068 - ?>
2069 - </select>
2070 - <?php
2071 -
2072 - }
2073 -
2074 - public function site_business_type_callback()
2075 - {
2076 -
2077 - $business_type = Metasync::get_option('optimal_settings')['site_info']['business_type'] ?? '';
2078 -
2079 - $types = self::get_business_types();
2080 - sort($types);
2081 -
2082 - ?>
2083 - <select name="<?php echo esc_attr(Metasync_Admin::option_key . '[optimal_settings][site_info][business_type]') ?>">
2084 - <option value='0'>Select Business Type</option>
2085 - <?php
2086 - foreach ($types as $type) {
2087 - printf('<option value="%s" %s >%s</option>', esc_attr($type), selected(esc_attr($type), esc_attr($business_type)), esc_attr($type));
2088 - }
2089 - ?>
2090 - </select>
2091 - <?php
2092 - }
2093 -
2094 - public function site_company_name_callback()
2095 - {
2096 -
2097 - $company_name = Metasync::get_option('optimal_settings')['site_info']['company_name'] ?? get_bloginfo('name');
2098 -
2099 - printf(
2100 - '<input type="text" name="' . Metasync_Admin::option_key . '[optimal_settings][site_info][company_name]" value="%s" size="50" />',
2101 - $company_name ? $company_name : get_bloginfo('name')
2102 - );
2103 - }
2104 -
2105 - public function site_google_logo_callback()
2106 - {
2107 -
2108 - $google_logo = Metasync::get_option('optimal_settings')['site_info']['google_logo'] ?? '';
2109 -
2110 - printf(
2111 - '<input type="hidden" id="site_google_logo" name="' . Metasync_Admin::option_key . '[optimal_settings][site_info][google_logo]" value="%s" size="50" />',
2112 - $google_logo
2113 - );
2114 -
2115 - printf(' <br> <input class="button-secondary" type="button" id="google_logo_btn" value="Add or Upload File">');
2116 - printf(' <br><br> <span class="description bold"> Min Size: 160X90px, Max Size: 1920X1080px. </span> <br> <span class="description"> A squared image is preferred by the search engines. </span> <br><br> ');
2117 - printf('<img src="%s" id="site_google_logo_img" width="300">', wp_get_attachment_image_src($google_logo, 'medium')[0] ?? '');
2118 -
2119 - $button_type = 'hidden';
2120 - if ($google_logo) {
2121 - $button_type = 'button';
2122 - }
2123 - printf('<input type="%s" class="button-secondary" id="site_google_logo_close_btn" value="X">', $button_type);
2124 - }
2125 -
2126 - public function site_social_share_image_callback()
2127 - {
2128 -
2129 - $social_share_image = Metasync::get_option('optimal_settings')['site_info']['social_share_image'] ?? '';
2130 -
2131 - printf(
2132 - '<input type="hidden" id="site_social_share_image" name="' . Metasync_Admin::option_key . '[optimal_settings][site_info][social_share_image]" value="%s" size="50" />',
2133 - $social_share_image
2134 - );
2135 -
2136 - printf(' <br> <input class="button-secondary" type="button" id="social_share_image_btn" value="Add or Upload File">');
2137 - printf(' <br><br> <span class="description bold"> The recommended image size is 1200 x 630 pixels. </span> <br> <span class="description"> When a featured image or an OpenGraph Image is not set for individual posts/pages/CPTs, this image will be used as a fallback thumbnail when your post is shared on Facebook. </span> <br><br> ');
2138 - printf('<img src="%s" id="site_social_share_img" width="300">', wp_get_attachment_image_src($social_share_image, 'medium')[0] ?? '');
2139 -
2140 - $button_type = 'hidden';
2141 - if ($social_share_image) {
2142 - $button_type = 'button';
2143 - }
2144 - printf('<input type="%s" class="button-secondary" id="site_social_image_close_btn" value="X">', $button_type);
2145 - }
2146 -
2147 1990 public function common_robot_meta_tags_callback()
2148 1991 {
2149 1992 $common_robots_meta = Metasync::get_option('common_robots_meta') ?? Metasync::get_option('common_robots_mata') ?? '';
2150 1993
@@ -2150,16 +1993,8 @@
2150 1993
2151 1994 ?>
2152 1995 <ul class="checkbox-list">
2153 1996 <li>
2154 - <input type="checkbox" name="<?php echo esc_attr(Metasync_Admin::option_key . '[common_robots_meta][index]') ?>" id="robots_common1" value="index" <?php isset($common_robots_meta['index']) ? checked('index', $common_robots_meta['index']) : '' ?>>
2155 - <label for="robots_common1">Index </br>
2156 - <span class="description">
2157 - <span>Search engines to index and show these pages in the search results.</span>
2158 - </span>
2159 - </label>
2160 - </li>
2161 - <li>
2162 1997 <input type="checkbox" name="<?php echo esc_attr(Metasync_Admin::option_key . '[common_robots_meta][noindex]') ?>" id="robots_common2" value="noindex" <?php isset($common_robots_meta['noindex']) ? checked('noindex', $common_robots_meta['noindex']) : '' ?>>
2163 1998 <label for="robots_common2">No Index </br>
2164 1999 <span class="description">
2165 2000 <span>Search engines not indexed and displayed this pages in search engine results</span>
@@ -2285,9 +2120,9 @@
2285 2120
2286 2121 public function global_open_graph_meta_callback()
2287 2122 {
2288 2123 printf(
2289 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][open_graph_meta_tags]" value="true" %s />',
2124 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][open_graph_meta_tags]" value="true" %s />',
2290 2125 isset(Metasync::get_option('common_meta_settings')['open_graph_meta_tags']) && Metasync::get_option('common_meta_settings')['open_graph_meta_tags'] == 'true' ? 'checked' : ''
2291 2126 );
2292 2127 printf(' <br> <span class="description"> Automatically add the Open Graph meta tags in a page or post.</span>');
2293 2128 }
@@ -2294,9 +2129,9 @@
2294 2129
2295 2130 public function global_facebook_meta_callback()
2296 2131 {
2297 2132 printf(
2298 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][facebook_meta_tags]" value="true" %s />',
2133 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][facebook_meta_tags]" value="true" %s />',
2299 2134 isset(Metasync::get_option('common_meta_settings')['facebook_meta_tags']) && Metasync::get_option('common_meta_settings')['facebook_meta_tags'] == 'true' ? 'checked' : ''
2300 2135 );
2301 2136 printf(' <br> <span class="description"> Automatically add the Facebook meta tags in a page or post.</span>');
2302 2137 }
@@ -2303,9 +2138,9 @@
2303 2138
2304 2139 public function global_twitter_meta_callback()
2305 2140 {
2306 2141 printf(
2307 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][twitter_meta_tags]" value="true" %s />',
2142 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][twitter_meta_tags]" value="true" %s />',
2308 2143 isset(Metasync::get_option('common_meta_settings')['twitter_meta_tags']) && Metasync::get_option('common_meta_settings')['twitter_meta_tags'] == 'true' ? 'checked' : ''
2309 2144 );
2310 2145 printf(' <br> <span class="description"> Automatically add the Twitter meta tags in a page or post.</span>');
2311 2146 }
@@ -2313,9 +2148,9 @@
2313 2148 public function og_image_dimensions_callback()
2314 2149 {
2315 2150 $val = Metasync::get_option('common_meta_settings')['og_image_dimensions'] ?? 'true';
2316 2151 printf(
2317 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][og_image_dimensions]" value="true" %s />',
2152 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][og_image_dimensions]" value="true" %s />',
2318 2153 $val === 'true' ? 'checked' : ''
2319 2154 );
2320 2155 printf('<span class="description"> Output og:image:width, og:image:height, and og:image:type when OG image metadata is available.</span>');
2321 2156 }
@@ -2323,9 +2158,9 @@
2323 2158 public function article_timestamps_callback()
2324 2159 {
2325 2160 $val = Metasync::get_option('common_meta_settings')['article_timestamps'] ?? 'true';
2326 2161 printf(
2327 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][article_timestamps]" value="true" %s />',
2162 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][article_timestamps]" value="true" %s />',
2328 2163 $val === 'true' ? 'checked' : ''
2329 2164 );
2330 2165 printf('<span class="description"> Output article:published_time and article:modified_time from the post publish and modified dates (ISO 8601).</span>');
2331 2166 }
@@ -2333,9 +2168,9 @@
2333 2168 public function article_author_callback()
2334 2169 {
2335 2170 $val = Metasync::get_option('common_meta_settings')['article_author'] ?? 'true';
2336 2171 printf(
2337 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][article_author]" value="true" %s />',
2172 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][article_author]" value="true" %s />',
2338 2173 $val === 'true' ? 'checked' : ''
2339 2174 );
2340 2175 printf('<span class="description"> Output article:author using the post author website URL or archive URL (overridable per-post via _metasync_og_article_author meta).</span>');
2341 2176 }
@@ -2343,9 +2178,9 @@
2343 2178 public function article_section_callback()
2344 2179 {
2345 2180 $val = Metasync::get_option('common_meta_settings')['article_section'] ?? 'true';
2346 2181 printf(
2347 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][article_section]" value="true" %s />',
2182 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][article_section]" value="true" %s />',
2348 2183 $val === 'true' ? 'checked' : ''
2349 2184 );
2350 2185 printf('<span class="description"> Output article:section from the primary category (falls back to first category).</span>');
2351 2186 }
@@ -2353,9 +2188,9 @@
2353 2188 public function article_tags_callback()
2354 2189 {
2355 2190 $val = Metasync::get_option('common_meta_settings')['article_tags'] ?? 'true';
2356 2191 printf(
2357 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][article_tags]" value="true" %s />',
2192 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][article_tags]" value="true" %s />',
2358 2193 $val === 'true' ? 'checked' : ''
2359 2194 );
2360 2195 printf('<span class="description"> Output one article:tag meta tag per WordPress post tag.</span>');
2361 2196 }
@@ -2363,9 +2198,9 @@
2363 2198 public function twitter_image_alt_callback()
2364 2199 {
2365 2200 $val = Metasync::get_option('common_meta_settings')['twitter_image_alt'] ?? 'true';
2366 2201 printf(
2367 - '<input type="checkbox" name="' . Metasync_Admin::option_key . '[common_meta_settings][twitter_image_alt]" value="true" %s />',
2202 + '<input type="checkbox" name="' . esc_attr(Metasync_Admin::option_key) . '[common_meta_settings][twitter_image_alt]" value="true" %s />',
2368 2203 $val === 'true' ? 'checked' : ''
2369 2204 );
2370 2205 printf('<span class="description"> Output twitter:image:alt using the stored alt text or the OG image attachment alt attribute.</span>');
2371 2206 }
@@ -2372,9 +2207,9 @@
2372 2207
2373 2208 public function facebook_page_url_callback()
2374 2209 {
2375 2210 $facebook_page_url = Metasync::get_option('social_meta')['facebook_page_url'] ?? '';
2376 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][facebook_page_url]" value="%s" size="50" />', esc_attr($facebook_page_url));
2211 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][facebook_page_url]" value="%s" size="50" />', esc_attr($facebook_page_url));
2377 2212 printf('<br><span class="description"> Enter your Facebook page URL. eg: <code>https://www.facebook.com/MetaSync/</code> </span>');
2378 2213 }
2379 2214
2380 2215 public function facebook_authorship_callback()
@@ -2379,9 +2214,9 @@
2379 2214
2380 2215 public function facebook_authorship_callback()
2381 2216 {
2382 2217 $facebook_authorship = Metasync::get_option('social_meta')['facebook_authorship'] ?? '';
2383 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][facebook_authorship]" value="%s" size="50" />', esc_attr($facebook_authorship));
2218 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][facebook_authorship]" value="%s" size="50" />', esc_attr($facebook_authorship));
2384 2219 printf('<br><span class="description"> Enter Facebook profile URL to show Facebook Authorship when your articles are being shared on Facebook. eg: <code>https://www.facebook.com/shahrukh/</code> </span>');
2385 2220 }
2386 2221
2387 2222 public function facebook_admin_callback()
@@ -2386,9 +2221,9 @@
2386 2221
2387 2222 public function facebook_admin_callback()
2388 2223 {
2389 2224 $facebook_admin = Metasync::get_option('social_meta')['facebook_admin'] ?? '';
2390 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][facebook_admin]" value="%s" size="50" />', esc_attr($facebook_admin));
2225 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][facebook_admin]" value="%s" size="50" />', esc_attr($facebook_admin));
2391 2226 printf(' <br> <span class="description"> Enter numeric user ID of Facebook. </span>');
2392 2227 }
2393 2228
2394 2229 public function facebook_app_callback()
@@ -2393,9 +2228,9 @@
2393 2228
2394 2229 public function facebook_app_callback()
2395 2230 {
2396 2231 $facebook_app = Metasync::get_option('social_meta')['facebook_app'] ?? '';
2397 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][facebook_app]" value="%s" size="50" />', esc_attr($facebook_app));
2232 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][facebook_app]" value="%s" size="50" />', esc_attr($facebook_app));
2398 2233 printf(' <br> <span class="description"> Enter numeric app ID of Facebook </span>');
2399 2234 }
2400 2235
2401 2236 public function facebook_secret_callback()
@@ -2400,9 +2235,9 @@
2400 2235
2401 2236 public function facebook_secret_callback()
2402 2237 {
2403 2238 $facebook_secret = Metasync::get_option('social_meta')['facebook_secret'] ?? '';
2404 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][facebook_secret]" value="%s" size="50" />', esc_attr($facebook_secret));
2239 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][facebook_secret]" value="%s" size="50" />', esc_attr($facebook_secret));
2405 2240 printf(' <br> <span class="description"> Enter alphanumeric access token from Facebook. </span>');
2406 2241 }
2407 2242
2408 2243 public function twitter_username_callback()
@@ -2407,9 +2242,9 @@
2407 2242
2408 2243 public function twitter_username_callback()
2409 2244 {
2410 2245 $twitter_username = Metasync::get_option('social_meta')['twitter_username'] ?? '';
2411 - printf('<input type="text" name="' . Metasync_Admin::option_key . '[social_meta][twitter_username]" value="%s" size="50" />', esc_attr($twitter_username));
2246 + printf('<input type="text" name="' . esc_attr(Metasync_Admin::option_key) . '[social_meta][twitter_username]" value="%s" size="50" />', esc_attr($twitter_username));
2412 2247 printf(' <br> <span class="description"> Twitter username of the author to add <code>twitter:creator</code> tag to post. eg: <code>MetaSync</code> </span>');
2413 2248 }
2414 2249
2415 2250 public static function get_business_types()
@@ -2584,8 +2419,14 @@
2584 2419 }
2585 2420
2586 2421 /**
2587 2422 * Render breadcrumbs settings section
2423 + *
2424 + * Rendered by the dedicated Breadcrumbs admin page. The three checkbox
2425 + * fields each ship a hidden companion input so their keys are always
2426 + * present in the submitted payload, which lets the save handlers treat an
2427 + * absent key as "this form does not manage that field" instead of
2428 + * "unchecked".
2588 2429 */
2589 2430 public function render_breadcrumbs_section() {
2590 2431 $options = Metasync::get_option('breadcrumbs', array());
2591 2432
@@ -2590,9 +2431,9 @@
2590 2431 $options = Metasync::get_option('breadcrumbs', array());
2591 2432
2592 2433 $defaults = array(
2593 2434 'enabled' => true,
2594 - 'separator' => '&raquo;',
2435 + 'separator' => '»',
2595 2436 'home_label' => 'Home',
2596 2437 'home_url' => '',
2597 2438 'show_current_page' => true,
2598 2439 'prefix_text' => '',
@@ -2600,8 +2441,19 @@
2600 2441 'disable_schema' => false,
2601 2442 );
2602 2443
2603 2444 $options = wp_parse_args($options, $defaults);
2445 +
2446 + # Older builds stored the separator as an HTML entity (e.g. "&raquo;").
2447 + # Decode before matching so the saved choice still lights up its radio.
2448 + $separator_presets = array('»', '/', '>', '·');
2449 + $separator_current = html_entity_decode((string) $options['separator'], ENT_QUOTES, 'UTF-8');
2450 + if ($separator_current === '') {
2451 + $separator_current = '»';
2452 + }
2453 + # A separator that predates the radio picker (or came from the old free
2454 + # text field) gets its own option so it stays selected and round-trips.
2455 + $separator_custom = in_array($separator_current, $separator_presets, true) ? '' : $separator_current;
2604 2456 ?>
2605 2457 <div style="background: var(--dashboard-card-bg); padding: 20px; border-radius: 8px;">
2606 2458
2607 2459 <!-- Enable/Disable -->
@@ -2606,8 +2458,9 @@
2606 2458
2607 2459 <!-- Enable/Disable -->
2608 2460 <div style="margin-bottom: 24px;">
2609 2461 <label style="display: flex; align-items: center; gap: 12px; cursor: pointer;">
2462 + <input type="hidden" name="metasync_options[breadcrumbs][enabled]" value="0">
2610 2463 <input type="checkbox"
2611 2464 name="metasync_options[breadcrumbs][enabled]"
2612 2465 value="1"
2613 2466 <?php checked($options['enabled'], 1); ?>
@@ -2612,8 +2465,9 @@
2612 2465 value="1"
2613 2466 <?php checked($options['enabled'], 1); ?>
2614 2467 style="width: 18px; height: 18px; cursor: pointer;">
2615 2468 <span style="font-weight: 500; color: var(--dashboard-text);">Enable breadcrumbs globally</span>
2469 + <?php Metasync::render_tooltip_icon('breadcrumbs_enabled', 'Shows a trail of links (e.g. Home > Blog > This Post) near the top of your pages so visitors can see where they are and navigate back up a level. Turn off to hide breadcrumbs everywhere.'); ?>
2616 2470 </label>
2617 2471 <p style="margin: 8px 0 0 0; font-size: 12px; color: var(--dashboard-text-secondary);">
2618 2472 Enable or disable breadcrumb navigation on your site
2619 2473 </p>
@@ -2621,8 +2475,9 @@
2621 2475
2622 2476 <!-- Disable Schema Markup -->
2623 2477 <div style="margin-bottom: 24px;">
2624 2478 <label style="display: flex; align-items: center; gap: 12px; cursor: pointer;">
2479 + <input type="hidden" name="metasync_options[breadcrumbs][disable_schema]" value="0">
2625 2480 <input type="checkbox"
2626 2481 name="metasync_options[breadcrumbs][disable_schema]"
2627 2482 value="1"
2628 2483 <?php checked($options['disable_schema'], 1); ?>
@@ -2627,8 +2482,9 @@
2627 2482 value="1"
2628 2483 <?php checked($options['disable_schema'], 1); ?>
2629 2484 style="width: 18px; height: 18px; cursor: pointer;">
2630 2485 <span style="font-weight: 500; color: var(--dashboard-text);">Disable breadcrumb schema markup (JSON-LD)</span>
2486 + <?php Metasync::render_tooltip_icon('breadcrumbs_disable_schema', 'Leave off. Only check this if another SEO plugin (Yoast, Rank Math, etc.) already sends breadcrumb data to Google, so you don\'t send it twice.'); ?>
2631 2487 </label>
2632 2488 <p style="margin: 8px 0 0 0; font-size: 12px; color: var(--dashboard-text-secondary);">
2633 2489 When checked, MetaSync will not output the <code style="background: rgba(0,0,0,0.1); padding: 2px 4px; border-radius: 3px;">BreadcrumbList</code> JSON-LD in <code style="background: rgba(0,0,0,0.1); padding: 2px 4px; border-radius: 3px;">&lt;head&gt;</code>. Use this if another SEO plugin already handles breadcrumb schema.
2634 2490 </p>
@@ -2639,24 +2495,21 @@
2639 2495 <label for="breadcrumb_separator" style="display: block; margin-bottom: 8px; font-weight: 500; color: var(--dashboard-text);">
2640 2496 Separator Character
2641 2497 </label>
2642 2498 <div style="display: flex; gap: 12px; flex-wrap: wrap;">
2499 + <?php foreach ($separator_presets as $separator_option) : ?>
2643 2500 <label style="display: flex; align-items: center; gap: 8px; cursor: pointer;">
2644 - <input type="radio" name="metasync_options[breadcrumbs][separator]" value="»" <?php checked($options['separator'], '»'); ?>>
2645 - <span style="color: var(--dashboard-text);">»</span>
2501 + <input type="radio" name="metasync_options[breadcrumbs][separator]" value="<?php echo esc_attr($separator_option); ?>" <?php checked($separator_current, $separator_option); ?>>
2502 + <span style="color: var(--dashboard-text);"><?php echo esc_html($separator_option); ?></span>
2646 2503 </label>
2647 - <label style="display: flex; align-items: center; gap: 8px; cursor: pointer;">
2648 - <input type="radio" name="metasync_options[breadcrumbs][separator]" value="/" <?php checked($options['separator'], '/'); ?>>
2649 - <span style="color: var(--dashboard-text);">/</span>
2650 - </label>
2651 - <label style="display: flex; align-items: center; gap: 8px; cursor: pointer;">
2652 - <input type="radio" name="metasync_options[breadcrumbs][separator]" value=">" <?php checked($options['separator'], '>'); ?>>
2653 - <span style="color: var(--dashboard-text);">></span>
2654 - </label>
2655 - <label style="display: flex; align-items: center; gap: 8px; cursor: pointer;">
2656 - <input type="radio" name="metasync_options[breadcrumbs][separator]" value="·" <?php checked($options['separator'], '·'); ?>>
2657 - <span style="color: var(--dashboard-text);">·</span>
2658 - </label>
2504 + <?php endforeach; ?>
2505 + <div style="display: flex; align-items: center; gap: 8px;">
2506 + <label style="display: flex; align-items: center; gap: 8px; cursor: pointer;">
2507 + <input type="radio" id="metasync-breadcrumb-separator-custom" name="metasync_options[breadcrumbs][separator]" value="<?php echo esc_attr($separator_custom); ?>" <?php checked($separator_custom !== ''); ?>>
2508 + <span style="color: var(--dashboard-text);">Custom</span>
2509 + </label>
2510 + <input type="text" value="<?php echo esc_attr($separator_custom); ?>" placeholder="~" maxlength="16" aria-label="Custom separator character" oninput="var r=document.getElementById('metasync-breadcrumb-separator-custom');r.value=this.value;r.checked=true" style="width: 80px; padding: 8px 10px; background: var(--dashboard-input-bg); border: 1px solid var(--dashboard-border); border-radius: 6px; color: var(--dashboard-text); font-size: 14px;">
2511 + </div>
2659 2512 </div>
2660 2513 <p style="margin: 8px 0 0 0; font-size: 12px; color: var(--dashboard-text-secondary);">
2661 2514 Choose how to separate breadcrumb items
2662 2515 </p>
@@ -2696,8 +2549,9 @@
2696 2549
2697 2550 <!-- Show Current Page -->
2698 2551 <div style="margin-bottom: 24px;">
2699 2552 <label style="display: flex; align-items: center; gap: 12px; cursor: pointer;">
2553 + <input type="hidden" name="metasync_options[breadcrumbs][show_current_page]" value="0">
2700 2554 <input type="checkbox"
2701 2555 name="metasync_options[breadcrumbs][show_current_page]"
2702 2556 value="1"
2703 2557 <?php checked($options['show_current_page'], 1); ?>
@@ -2728,8 +2582,9 @@
2728 2582 <!-- Archive Label Format -->
2729 2583 <div style="margin-bottom: 24px;">
2730 2584 <label for="breadcrumb_archive_format" style="display: block; margin-bottom: 8px; font-weight: 500; color: var(--dashboard-text);">
2731 2585 Archive Label Format
2586 + <?php Metasync::render_tooltip_icon('breadcrumb_archive_format', 'On category/archive pages, {name} is replaced with that section\'s name. Type {name} alone for just the name, or something like "Category: {name}".'); ?>
2732 2587 </label>
2733 2588 <input type="text"
2734 2589 id="breadcrumb_archive_format"
2735 2590 name="metasync_options[breadcrumbs][archive_label_format]"