Changeset 3749195 for roxyapi/trunk/src/Admin/SettingsPage.php

Timestamp:

10/15/2026 07:29:29 PM (4 days ago)

Author:

roxyapi

Message:

Update to version 1.21.0 from GitHub

File:

• roxyapi/trunk/src/Admin/SettingsPage.php (modified) (7 diffs)

roxyapi/trunk/src/Admin/SettingsPage.php

@@ -21 +21 @@
         public const OPTION_NAME  = 'roxyapi_settings';
         public const OPTION_GROUP = 'roxyapi';
+        public const HELP_SLUG    = 'roxyapi-help';
 
         public static function register(): void {
@@ -86 +87 @@
 
                 // Register the first submenu explicitly to rename the auto-generated
-                // duplicate to "Settings" (a tabbed screen) while keeping the default
-                // landing slug used by the post-activation redirect.
+                // duplicate to "Settings" (a tabbed screen).
                 add_submenu_page(
                         self::PAGE_SLUG,
@@ -104 +104 @@
                         ShortcodesPage::PAGE_SLUG,
                         array( ShortcodesPage::class, 'render' )
+                );
+
+                add_submenu_page(
+                        self::PAGE_SLUG,
+                        esc_html__( 'Create a reading', 'roxyapi' ),
+                        esc_html__( 'Create a reading', 'roxyapi' ),
+                        'manage_options',
+                        BuilderPage::PAGE_SLUG,
+                        array( BuilderPage::class, 'render' )
                 );
 
@@ -121 +130 @@
                         );
                 }
+
+                add_submenu_page(
+                        self::PAGE_SLUG,
+                        esc_html__( 'Help', 'roxyapi' ),
+                        esc_html__( 'Help', 'roxyapi' ),
+                        'manage_options',
+                        self::HELP_SLUG,
+                        array( self::class, 'render_help' )
+                );
         }
 
@@ -147 +165 @@
         }
 
+        /**
+         * Settings tabs in display order, shared with the settings template.
+         *
+         * @return array<string, string> Tab labels keyed by slug.
+         */
+        public static function tabs(): array {
+                return array(
+                        'connect'       => __( 'Connect', 'roxyapi' ),
+                        'branding'      => __( 'Branding', 'roxyapi' ),
+                        'display'       => __( 'Display', 'roxyapi' ),
+                        'sell-readings' => __( 'Sell readings', 'roxyapi' ),
+                        'privacy'       => __( 'Privacy', 'roxyapi' ),
+                        'advanced'      => __( 'Advanced', 'roxyapi' ),
+                );
+        }
+
         public static function render(): void {
                 if ( ! current_user_can( 'manage_options' ) ) {
@@ -172 +206 @@
                 // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only tab selector on a manage_options page.
                 $active_tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'connect';
-                if ( ! in_array( $active_tab, array( 'connect', 'branding', 'display', 'privacy', 'advanced' ), true ) ) {
+                if ( ! isset( self::tabs()[ $active_tab ] ) ) {
                         $active_tab = 'connect';
                 }
@@ -244 +278 @@
         }
 
+        public static function render_help(): void {
+                if ( ! current_user_can( 'manage_options' ) ) {
+                        return;
+                }
+
+                // The template escapes every label and URL at the source.
+                echo Templates::render( 'admin-help', array() ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Template escape contract.
+        }
+
         public static function enqueue( string $hook ): void {
+                if ( $hook === get_plugin_page_hookname( self::HELP_SLUG, self::PAGE_SLUG ) && current_user_can( 'manage_options' ) ) {
+                        Assets::enqueue_admin_css();
+                        return;
+                }
                 if ( $hook !== 'toplevel_page_' . self::PAGE_SLUG ) {
                         return;