← All changes | metasync.php +213 -40 2.6.16 → 2.7.2 View file →

		@@ -11,13 +11,13 @@
11	11	* @link https://searchatlas.com/
12	12	* @since 1.0.0
13	13	*
14	14	* @wordpress-plugin
15		- * Plugin Name: Search Atlas: The Premier AI SEO Plugin for Instant Optimization
	15	+ * Plugin Name: Search Atlas SEO - OTTO AI SEO Automation for WordPress
16	16	* Plugin URI: https://searchatlas.com/
17	17	* Description: Search Atlas SEO is an intuitive WordPress Plugin that transforms the most complicated, most labor-intensive SEO tasks into streamlined, straightforward processes. With a few clicks, the meta-bulk update feature automates the re-optimization of meta tags using AI to increase clicks. Stay up-to-date with the freshest Google Search data for your entire site or targeted URLs within the Meta Sync plug-in page.
18		- * Version: 2.6.16
19		- * Requires PHP: 8.2
	18	+ * Version: 2.7.2
	19	+ * Requires PHP: 8.1
20	20	* Author: Search Atlas
21	21	* Author URI: https://searchatlas.com
22	22	* License: GPL v3
23	23	* License URI: https://www.gnu.org/licenses/gpl-3.0.txt
		@@ -31,20 +31,41 @@
31	31
32	32	// Composer classmap autoloader — loads all plugin classes on demand.
33	33	require_once __DIR__ . '/vendor/autoload.php';
34	34
	35	+// Canonical sanitizer — required explicitly (not via the committed classmap)
	36	+// so it is guaranteed loadable everywhere canonicals are read or written.
	37	+require_once __DIR__ . '/includes/class-metasync-canonical-sanitizer.php';
	38	+
	39	+// Editor-settings feature flags — required explicitly for the same reason: they
	40	+// gate output in the OTTO buffer and in third-party filter callbacks, both of
	41	+// which can run before the classmap has resolved anything else.
	42	+require_once __DIR__ . '/includes/class-metasync-feature-flags.php';
	43	+Metasync_Feature_Flags::register_invalidation();
	44	+
	45	+// Consent gate and write-once backup for third-party SEO storage — required
	46	+// explicitly for the same reason: every writer into Yoast / Rank Math / AIOSEO
	47	+// consults it, and a class that fails to load would read as "no consent" and
	48	+// silently stop those writes.
	49	+require_once __DIR__ . '/includes/class-metasync-seo-backup.php';
	50	+
	51	+// Loaded beside the backup class because it is the only reader of what that
	52	+// class writes. Restore is inert until something calls it, so loading it early
	53	+// costs nothing and keeps the pair together.
	54	+require_once __DIR__ . '/includes/class-metasync-seo-restore.php';
	55	+
35	56	/**
36	57	* Currently plugin version.
37	58	* Start at version 1.0.0 and use SemVer - https://semver.org
38	59	* Rename this for your plugin and update it as you release new versions.
39	60	*/
40		-$metasync_version = '2.6.16';
	61	+$metasync_version = '2.7.2';
41	62	define('METASYNC_VERSION', preg_match('/^\d+\.\d+/', $metasync_version) ? $metasync_version : '9.9.9');
42	63	/**
43	64	* Define the current required php version
44	65	* This will be used to validate whether the user can install the plugin or not
45	66	*/
46		-define('METASYNC_MIN_PHP', '8.2');
	67	+define('METASYNC_MIN_PHP', '8.1');
47	68
48	69	/**
49	70	* Define the current required php version
50	71	* This will be used to validate whether the user can install the plugin or not
		@@ -74,8 +95,18 @@
74	95	define('METASYNC_GA4_MEASUREMENT_ID', 'G-SBLWW1EMTJ');
75	96	define('METASYNC_GA4_API_SECRET', 'nMGs22mxQ3qVUy-aInqfZA');
76	97
77	98	/**
	99	+ * PostHog product analytics configuration.
	100	+ * The write key is a public project key embedded by design (same precedent
	101	+ * as the GA4 secret above); set METASYNC_POSTHOG_API_KEY in the environment
	102	+ * to override it - including to an empty string, which disables PostHog.
	103	+ */
	104	+define('METASYNC_POSTHOG_HOST', 'https://posthog.internal.searchatlas.com');
	105	+$metasync_posthog_key = getenv('METASYNC_POSTHOG_API_KEY');
	106	+define('METASYNC_POSTHOG_API_KEY', false !== $metasync_posthog_key ? $metasync_posthog_key : 'phc_ntSayCJE7Ad9eBHRG6ygBaY4BJMa8rFjXcXESun9ftkh'); // gitleaks:allow -- public write-only PostHog project key
	107	+
	108	+/**
78	109	* Define whether to show the plugin status in WordPress admin top navigation bar
79	110	* Set to false to hide the status indicator
80	111	*/
81	112	define('METASYNC_SHOW_ADMIN_BAR_STATUS', true);
		@@ -108,9 +139,9 @@
108	139	return $sanitized;
109	140	}
110	141	}
111	142
112		-// Skip heavy MetaSync init on admin-ajax requests that don't target our own actions (Sentry issue 7441226449 / WP-227).
	143	+// Skip heavy MetaSync init on admin-ajax requests that don't target our own actions (Sentry issue 7441226449).
113	144	if (!function_exists('metasync_is_non_metasync_admin_ajax')) {
114	145	function metasync_is_non_metasync_admin_ajax() {
115	146	static $result = null;
116	147	if ($result !== null) {
		@@ -115,13 +146,19 @@
115	146	static $result = null;
116	147	if ($result !== null) {
117	148	return $result;
118	149	}
	150	+ // The MCP bridge intentionally boots WordPress with DOING_AJAX set, but it
	151	+ // is a MetaSync entry point rather than an unrelated admin AJAX request.
	152	+ // The constant is only ever defined as true by the bridge bootstraps.
	153	+ if (defined('METASYNC_MCP_BRIDGE')) {
	154	+ return ($result = false);
	155	+ }
119	156	if (!defined('DOING_AJAX') || !DOING_AJAX) {
120	157	return ($result = false);
121	158	}
122		- $action = isset($_POST['action']) ? sanitize_text_field(wp_unslash($_POST['action']))
123		- : (isset($_GET['action']) ? sanitize_text_field(wp_unslash($_GET['action'])) : '');
	159	+ $action = isset($_POST['action']) ? sanitize_text_field(wp_unslash($_POST['action'])) // phpcs:ignore WordPress.Security.NonceVerification.Missing -- read-only action-name prefix check during boot
	160	+ : (isset($_GET['action']) ? sanitize_text_field(wp_unslash($_GET['action'])) : ''); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only action-name prefix check during boot
124	161	if ($action === '') {
125	162	return ($result = true);
126	163	}
127	164	if (strpos($action, 'metasync_') === 0 || strpos($action, 'meta_sync_') === 0 || $action === 'sample-permalink') {
		@@ -133,9 +170,9 @@
133	170
134	171	// Lazy-load guard: only initialise the MCP server when the request is actually targeting
135	172	// the MCP REST route (or its sibling SEO-inventory route, which depends on $metasync_mcp_server
136	173	// for its permission callback). Saves ~2-5 MB / 10-50 ms on the 99.9% of requests that never
137		-// touch MCP. See WP-255.
	174	+// touch MCP.
138	175	if (!function_exists('metasync_is_mcp_rest_request')) {
139	176	function metasync_is_mcp_rest_request(): bool {
140	177	$uri = isset($_SERVER['REQUEST_URI']) ? (string) $_SERVER['REQUEST_URI'] : '';
141	178	if ($uri === '') {
		@@ -161,8 +198,9 @@
161	198
162	199	// Phase 2 — these files have file-level side effects (add_action outside class body)
163	200	// and must remain as explicit require_once until refactored.
164	201	require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-api-backoff-rest.php';
	202	+require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-data-store.php';
165	203	require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-error-logger.php';
166	204
167	205	// Shared helpers (custom/LPS page detection + query exclusion) — loaded in all
168	206	// request contexts (admin, REST, MCP, AJAX) so every SEO surface uses one rule.
		@@ -167,8 +205,13 @@
167	205	// Shared helpers (custom/LPS page detection + query exclusion) — loaded in all
168	206	// request contexts (admin, REST, MCP, AJAX) so every SEO surface uses one rule.
169	207	require_once plugin_dir_path( __FILE__ ) . 'includes/metasync-helpers.php';
170	208
	209	+// Shared "results per page" selector helper used by the Redirections, 404
	210	+// Monitor, Changes Log and Media Library admin list tables. Loaded early so
	211	+// the helper class is available before any list table instantiates.
	212	+require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-per-page-helper.php';
	213	+
171	214	/**
172	215	* Include the Otto Pixel Php Code
173	216	*/
174	217	if (!metasync_is_non_metasync_admin_ajax()) {
		@@ -220,9 +263,9 @@
220	263	#craft the message
221	264	sprintf(
222	265	'%s requires WordPress version %s or later. You are currently using version %s. Please update WordPress to activate this plugin.',
223	266	esc_html($plugin_name),
224		- METASYNC_MIN_WP,
	267	+ esc_html(METASYNC_MIN_WP),
225	268	esc_html($wp_version)
226	269	),
227	270
228	271	#the plugin title as page title
		@@ -242,9 +285,9 @@
242	285	#craft the message
243	286	sprintf(
244	287	'%s requires PHP version %s or later. You are currently using version %s. Please update PHP to activate this plugin.',
245	288	esc_html($plugin_name),
246		- METASYNC_MIN_PHP,
	289	+ esc_html(METASYNC_MIN_PHP),
247	290	esc_html($php_version)
248	291	),
249	292
250	293	#the plugin title as page title
		@@ -261,9 +304,9 @@
261	304
262	305	// Set initial version
263	306	update_option('metasync_version', METASYNC_VERSION);
264	307
265		- // WP-315: Record activation timestamp so Divi CSS fix transients
	308	+ // Record activation timestamp so Divi CSS fix transients
266	309	// auto-invalidate after plugin deactivate/reactivate cycles.
267	310	update_option('metasync_activated_at', (string) time());
268	311
269	312	// Clear all cache plugins to ensure fresh start
		@@ -268,10 +311,14 @@
268	311
269	312	// Clear all cache plugins to ensure fresh start
270	313	Metasync_Cache_Purge::purge_all('plugin_activation');
271	314
272		- // WP-332: Migrate physical sitemap files on activation.
	315	+ // Migrate physical sitemap files on activation.
273	316	metasync_migrate_physical_sitemaps();
	317	+
	318	+ // Consent-gated analytics: the activation event only fires if the user
	319	+ // previously opted in (re-activation) — a brand-new install is OFF.
	320	+ Metasync_PostHog::get_instance()->track('plugin_activated', array());
274	321	}
275	322
276	323	// Log-sync removed - error monitoring now handled by Sentry
277	324	// require_once plugin_dir_path(__FILE__) . 'log-sync/log-sync.php';
		@@ -305,9 +352,9 @@
305	352	register_activation_hook(__FILE__, 'activate_metasync');
306	353	register_deactivation_hook(__FILE__, 'deactivate_metasync');
307	354
308	355	/**
309		- * WP-332: Migrate physical sitemap .xml files into transients and delete them.
	356	+ * Migrate physical sitemap .xml files into transients and delete them.
310	357	*
311	358	* Physical files in ABSPATH cause nginx/Plesk to 403 before WordPress can
312	359	* serve them. Called from both the activation hook and the version-gate
313	360	* migration so it covers fresh activations and auto-updates.
		@@ -336,19 +383,90 @@
336	383	if (empty($candidates)) {
337	384	return;
338	385	}
339	386
	387	+ // Ownership gate: other plugins (Yoast and friends) write files with the
	388	+ // exact same names (sitemap_index.xml, sitemap1.xml, ...), so a name match
	389	+ // alone must never authorize deleting a physical file. A file is only
	390	+ // migrated when this plugin left evidence it wrote it.
	391	+ $tracked_names = [];
	392	+ $tracked_files = get_option('metasync_sitemap_files', []);
	393	+ if (is_array($tracked_files)) {
	394	+ foreach ($tracked_files as $entry) {
	395	+ $name = is_array($entry) && isset($entry['filename']) ? $entry['filename'] : $entry;
	396	+ if (is_string($name) && '' !== $name) {
	397	+ $tracked_names[] = $name;
	398	+ }
	399	+ }
	400	+ }
340	401	$virtual_index = get_option('metasync_sitemap_virtual_index', []);
	402	+ if (!is_array($virtual_index)) {
	403	+ $virtual_index = [];
	404	+ }
	405	+ $parked_names = array_keys($virtual_index);
	406	+ $generator_ran = !empty($tracked_names) && false !== get_option('metasync_sitemap_last_generated');
	407	+
	408	+ $ours = [];
	409	+ $metasync_files_found = false;
	410	+ foreach ($candidates as $file) {
	411	+ $bn = basename($file);
	412	+
	413	+ // A parked name proves MetaSync owned the file at an earlier point, but
	414	+ // an expired transient no longer proves that a file currently on disk
	415	+ // is ours. A different plugin may have recreated the same basename.
	416	+ if (in_array($bn, $parked_names, true)) {
	417	+ if (false !== get_transient('metasync_vsm_' . md5($bn))) {
	418	+ continue;
	419	+ }
	420	+ continue;
	421	+ }
	422	+
	423	+ // Chunk, index, news, and video files are migratable only when their
	424	+ // exact basename is recorded by MetaSync's generator/configuration.
	425	+ if (in_array($bn, $tracked_names, true) && $generator_ran) {
	426	+ $ours[] = $file;
	427	+ $metasync_files_found = true;
	428	+ continue;
	429	+ }
	430	+
	431	+ if ($bn === 'news-sitemap.xml' && null !== get_option('metasync_news_sitemap_settings', null)) {
	432	+ $ours[] = $file;
	433	+ $metasync_files_found = true;
	434	+ continue;
	435	+ }
	436	+ if ($bn === 'video-sitemap.xml' && null !== get_option('metasync_video_sitemap_settings', null)) {
	437	+ $ours[] = $file;
	438	+ $metasync_files_found = true;
	439	+ }
	440	+ }
	441	+
	442	+ // Do not infer ownership of sitemap_index.xml from another sitemap: Yoast,
	443	+ // Rank Math, and other SEO plugins commonly use the same root filename.
	444	+ // It must be explicitly recorded in MetaSync's tracked file list.
	445	+ $ours = array_values(array_unique($ours));
	446	+
	447	+ if (empty($ours)) {
	448	+ return;
	449	+ }
	450	+
341	451	$migrated_files = [];
342	452
343		- foreach ($candidates as $file) {
	453	+ foreach ($ours as $file) {
344	454	$bn = basename($file);
345	455	$content = @file_get_contents($file);
346	456	if (false !== $content) {
347	457	$tkey = 'metasync_vsm_' . md5($bn);
348		- set_transient($tkey, $content, 30 * DAY_IN_SECONDS);
	458	+ // The news sitemap's entries are only valid inside Google News'
	459	+ // 48-hour window, so it must not be migrated in under a 30-day
	460	+ // TTL — that would re-introduce the staleness the generator's
	461	+ // own bounded TTL exists to prevent. Regenerate-on-miss rebuilds
	462	+ // it with a fresh date_query when this expires.
	463	+ $ttl = ('news-sitemap.xml' === $bn) ? (int) (DAY_IN_SECONDS / 4) : 30 * DAY_IN_SECONDS;
	464	+ set_transient($tkey, $content, $ttl);
349	465	if (false !== get_transient($tkey)) {
350		- @unlink($file);
	466	+ // The parked transient doubles as a 30-day backup of the
	467	+ // content before the file is removed from disk.
	468	+ @wp_delete_file($file);
351	469	$virtual_index[$bn] = $tkey;
352	470	if ($bn !== 'sitemap_index.xml' && $bn !== 'news-sitemap.xml' && $bn !== 'video-sitemap.xml') {
353	471	$migrated_files[] = [
354	472	'filename' => $bn,
		@@ -379,10 +497,17 @@
379	497
380	498	$current_version = get_option('metasync_version', '0.0.0');
381	499	$plugin_version = METASYNC_VERSION;
382	500
383		- // If versions don't match, run migration
384		- if (version_compare($current_version, $plugin_version, '<')) {
	501	+ // If versions don't match, run migration. Dev builds store the 9.9.9
	502	+ // placeholder version, which compares greater than every real release —
	503	+ // once stored, a plain "<" comparison never fires again and migrations
	504	+ // are silently skipped forever. Also enter when the stored version is the
	505	+ // placeholder but the running version is a real release, so the migration
	506	+ // runner's dev-build escape hatch becomes reachable and the stored version
	507	+ // is corrected to the real release.
	508	+ if (version_compare($current_version, $plugin_version, '<')
	509	+ || ('9.9.9' === $current_version && '9.9.9' !== $plugin_version)) {
385	510	// Import whitelabel settings only if the JSON file is new or changed
386	511	// (prevents overwriting admin UI changes on every version check)
387	512	Metasync_Activator::check_whitelabel_settings_update();
388	513
		@@ -388,8 +513,13 @@
388	513
389	514	// Run version-specific migrations first
390	515	MetaSync_DBMigration::run_version_migrations($current_version, $plugin_version);
391	516
	517	+ // The developer endpoint-switching panel has been removed. Reset its
	518	+ // persisted staging mode so upgrades cannot keep routing API requests
	519	+ // to staging without a visible warning or a supported recovery path.
	520	+ delete_option('metasync_dev_endpoint_mode');
	521	+
392	522	// Migration for v2.7.0+: Remove AI Agent, switch to plugin auth token, make MCP always-on
393	523	if (version_compare($current_version, '2.7.0', '<')) {
394	524	// Remove old MCP API key option
395	525	delete_option('metasync_mcp_api_key');
		@@ -409,9 +539,9 @@
409	539	update_option('metasync_options', $options);
410	540	}
411	541	}
412	542
413		- // WP-299: One-time purge of stale OTTO SEO cron backlog.
	543	+ // One-time purge of stale OTTO SEO cron backlog.
414	544	// Prior versions could accumulate thousands of metasync_process_seo_job and
415	545	// metasync_process_otto_crawl_url_job events due to unbounded rescheduling.
416	546	// Clear the backlog once on update; the new code prevents re-accumulation.
417	547	if (!get_option('metasync_wp299_cron_cleanup_done')) {
		@@ -420,9 +550,39 @@
420	550	wp_unschedule_hook('metasync_process_otto_batch_cache_job');
421	551	update_option('metasync_wp299_cron_cleanup_done', true, false);
422	552	}
423	553
424		- // WP-332: Migrate physical sitemap files on version update.
	554	+ // One-time cleanup of canonical values corrupted to the literal
	555	+ // "Array" (emitted as http://Array once the 2.6.16 canonical filters
	556	+ // started reading them). The sanitizer prevents new corruption; this
	557	+ // repairs the rows already in the database. Cache purge below pushes
	558	+ // the clean pages live. Claimed via add_option() — it fails if the row
	559	+ // already exists, so concurrent requests can't run the cleanup twice,
	560	+ // and the claim lands BEFORE the work: everything inside is idempotent
	561	+ // and the read-side sanitizer already protects output if a run is
	562	+ // interrupted.
	563	+ if (false === get_option('metasync_canonical_cleanup_done')
	564	+ && add_option('metasync_canonical_cleanup_done', 'running', '', false)) {
	565	+ MetaSync_DBMigration::cleanup_corrupted_canonicals();
	566	+ update_option('metasync_canonical_cleanup_done', 'done', false);
	567	+ }
	568	+
	569	+ // One-time repair of Local Business logos corrupted to "http://<id>".
	570	+ // The sanitizer fix stopped new corruption; this restores the
	571	+ // attachment ID on sites that saved a logo before it. The corrupted
	572	+ // value encodes the original ID exactly, so the rewrite is lossless.
	573	+ // Claimed via add_option() — it fails when the row already exists, so
	574	+ // concurrent requests can't run the repair twice, and the claim lands
	575	+ // BEFORE the work: the repair itself is idempotent, and the read-side
	576	+ // normalisation in the schema output and admin preview already
	577	+ // protects output if a run is interrupted.
	578	+ if (false === get_option('metasync_local_seo_logo_repair_done')
	579	+ && add_option('metasync_local_seo_logo_repair_done', 'running', '', false)) {
	580	+ MetaSync_DBMigration::repair_corrupted_local_seo_logo();
	581	+ update_option('metasync_local_seo_logo_repair_done', 'done', false);
	582	+ }
	583	+
	584	+ // Migrate physical sitemap files on version update.
425	585	metasync_migrate_physical_sitemaps();
426	586
427	587	// Run full migration to ensure all tables are up to date
428	588	MetaSync_DBMigration::run_migrations();
		@@ -454,9 +614,9 @@
454	614	if (!isset($hook_extra['type']) || $hook_extra['type'] !== 'plugin') {
455	615	return;
456	616	}
457	617
458		- // WP-427: By the time upgrader_process_complete fires, the upgrader may have
	618	+ // By the time upgrader_process_complete fires, the upgrader may have
459	619	// deleted the directory this (old, still-in-memory) copy of the plugin was
460	620	// loaded from — e.g. when the installed dir name differs from the package's
461	621	// root dir ('metasync-develop' vs 'metasync'). The Composer classmap then
462	622	// points at files that no longer exist, so autoloading Metasync_Activator
		@@ -522,9 +682,9 @@
522	682	}
523	683	}
524	684
525	685	if ($should_import) {
526		- Metasync_Activator::check_whitelabel_settings_update();
	686	+ Metasync_Activator::check_whitelabel_settings_update(true);
527	687	}
528	688	}
529	689
530	690	// Hook into WordPress upgrader to detect plugin updates
		@@ -533,26 +693,31 @@
533	693	/**
534	694	* Fallback: Check for whitelabel file changes on admin pages
535	695	* This handles edge cases where upgrader_process_complete doesn't fire
536	696	* (e.g., FTP uploads, manual file replacements)
537		- * Only checks once per admin session to minimize performance impact
	697	+ * Only checks once per admin request to minimize performance impact
538	698	*/
539		-// function metasync_check_whitelabel_on_admin()
540		-// {
541		-// // Only check once per admin session to avoid overhead
542		-// static $checked = false;
543		-// if ($checked) {
544		-// return;
545		-// }
546		-// $checked = true;
	699	+function metasync_check_whitelabel_on_admin()
	700	+{
	701	+ static $checked = false;
	702	+ if ($checked || !current_user_can('manage_options')) {
	703	+ return;
	704	+ }
	705	+ $checked = true;
547	706
548		-// require_once plugin_dir_path(__FILE__) . 'includes/class-metasync-activator.php';
549		-// Metasync_Activator::check_whitelabel_settings_update();
550		-// }
	707	+ require_once plugin_dir_path(__FILE__) . 'includes/class-metasync-activator.php';
551	708
552		-// Check for whitelabel changes on admin pages (fallback for edge cases)
553		-// add_action('admin_init', 'metasync_check_whitelabel_on_admin', 1);
	709	+ // Surface a persistently failing White Label import instead of
	710	+ // retrying it silently on every admin request.
	711	+ add_action('admin_notices', array('Metasync_Activator', 'render_whitelabel_import_failure_notice'));
554	712
	713	+ Metasync_Activator::check_whitelabel_settings_update();
	714	+}
	715	+
	716	+// Retry package imports on an authorized admin request when an update completed
	717	+// through the public version-check or stale-classmap fallback path.
	718	+add_action('admin_init', 'metasync_check_whitelabel_on_admin', 1);
	719	+
555	720	// Include Media Optimization Module
556	721	if (!metasync_is_non_metasync_admin_ajax()) {
557	722	require_once plugin_dir_path(__FILE__) . 'media-optimization/media-optimization-loader.php';
558	723	}
		@@ -569,9 +734,9 @@
569	734	$plugin->run();
570	735	}
571	736	run_metasync();
572	737
573		-// WP-530: MCP server bootstrap (server + tool registration) extracted to keep this entry file lean.
	738	+// MCP server bootstrap (server + tool registration) extracted to keep this entry file lean.
574	739	require_once plugin_dir_path( __FILE__ ) . 'includes/mcp-server-bootstrap.php';
575	740
576	741	/**
577	742	* Schedule a daily cron event to auto-purge Sync History records older than 90 days.
		@@ -601,15 +766,23 @@
601	766	echo '<script>window.__SA_DYO_INITIALIZED__=true;</script>' . "\n";
602	767	}
603	768	add_action('wp_head', 'metasync_output_dyo_init_flag', 1);
604	769
605		-// WP-530: Runtime feature initialisers (GA4, API backoff, review notice, JWT accessor, debug mode) extracted to keep this entry file lean.
	770	+// Shared analytics helper is loaded in all request contexts so server-side feature
	771	+// events can use the same consent gate as admin analytics.
	772	+require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-posthog.php';
	773	+require_once plugin_dir_path( __FILE__ ) . 'includes/class-metasync-analytics-consent-notice.php';
	774	+
	775	+/**
	776	+ * Runtime feature initialisers (GA4, API backoff, review notice, JWT accessor,
	777	+ * debug mode) extracted to keep this entry file lean.
	778	+ */
606	779	require_once plugin_dir_path( __FILE__ ) . 'includes/metasync-runtime-init.php';
607	780
608	781	/**
609	782	* Append a "Website Studio" post state to LPS-synced / MetaSync custom pages in
610	783	* the admin Pages list, so site owners can tell at a glance which pages are
611		- * managed by Website Studio and shouldn't be hand-edited (WP-491).
	784	+ * managed by Website Studio and shouldn't be hand-edited.
612	785	*
613	786	* Hooks WordPress core's display_post_states filter — the same mechanism that
614	787	* renders the grey inline tags like "— Front Page" / "— Draft" — so the label
615	788	* is native-styled and only appears next to relevant page titles, with no