From 79de284f53feb3549bc7df47a758953531ba2d11 Mon Sep 17 00:00:00 2001
From: Vladimir Bryzgalov <vladimir.bryzgalov@gmail.com>
Date: Sat, 16 May 2026 19:39:18 +0500
Subject: [PATCH] feat(wpmc S4): OptionsPage scaffold + main_town_slug filter
 wiring

---
 includes/class-options-page.php | 21 +++++++++++++++++++++
 tests/OptionsPageTest.php       | 29 +++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+)
 create mode 100644 includes/class-options-page.php
 create mode 100644 tests/OptionsPageTest.php

diff --git a/includes/class-options-page.php b/includes/class-options-page.php
new file mode 100644
index 0000000..f030996
--- /dev/null
+++ b/includes/class-options-page.php
@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+
+namespace WPMultiCity;
+
+final class OptionsPage
+{
+    public const PAGE_SLUG = 'wp-multi-city';
+    public const GROUP_KEY = 'group_wpmc_routing';
+
+    public static function register(): void
+    {
+        \add_action('acf/init', [self::class, 'do_register']);
+        \add_filter('wpmc_main_town_slug', [Helpers::class, 'main_town_slug'], 5);
+    }
+
+    public static function do_register(): void
+    {
+        // Implementation in Task 8.
+    }
+}
diff --git a/tests/OptionsPageTest.php b/tests/OptionsPageTest.php
new file mode 100644
index 0000000..e821965
--- /dev/null
+++ b/tests/OptionsPageTest.php
@@ -0,0 +1,29 @@
+<?php
+declare(strict_types=1);
+
+namespace WPMultiCity\Tests;
+
+use WPMultiCity\OptionsPage;
+
+final class OptionsPageTest extends TestCase
+{
+    public function test_register_attaches_acf_init_action(): void
+    {
+        OptionsPage::register();
+
+        self::assertNotFalse(
+            has_action('acf/init', [OptionsPage::class, 'do_register']),
+            'OptionsPage::register() must hook acf/init'
+        );
+    }
+
+    public function test_register_attaches_main_town_slug_filter(): void
+    {
+        OptionsPage::register();
+
+        self::assertNotFalse(
+            has_filter('wpmc_main_town_slug', ['WPMultiCity\\Helpers', 'main_town_slug']),
+            'OptionsPage::register() must hook wpmc_main_town_slug filter'
+        );
+    }
+}