[class, method]. */ private const HANDLERS = array( 'sg_paypal_connect' => array( PayPalConnector::class, 'handle' ), 'sg_wizard_goal' => array( SetupPage::class, 'handleGoal' ), 'sg_wizard_page' => array( SetupPage::class, 'handlePage' ), 'sg_goal_save' => array( GoalsPage::class, 'handleSave' ), 'sg_goal_status' => array( GoalsPage::class, 'handleStatus' ), 'sg_goal_delete' => array( GoalsPage::class, 'handleDelete' ), 'sg_rule_save' => array( GoalsPage::class, 'handleRuleSave' ), 'sg_rule_toggle' => array( GoalsPage::class, 'handleRuleToggle' ), 'sg_rule_delete' => array( GoalsPage::class, 'handleRuleDelete' ), 'sg_export_csv' => array( DonationsPage::class, 'handleExport' ), 'sg_moderate' => array( DonationsPage::class, 'handleModerate' ), 'sg_test_donation' => array( OverlaysPage::class, 'handleTestDonation' ), 'sg_delete_tests' => array( OverlaysPage::class, 'handleDeleteTests' ), 'sg_regen_token' => array( OverlaysPage::class, 'handleRegenerate' ), 'sg_settings_save' => array( SettingsPage::class, 'handleSave' ), ); public static function register(): void { add_action( 'admin_menu', array( self::class, 'menu' ) ); add_action( 'admin_init', array( self::class, 'maybe_flush_rewrites' ) ); add_action( 'admin_enqueue_scripts', array( self::class, 'assets' ) ); foreach ( self::HANDLERS as $action => $cb ) { add_action( 'admin_post_' . $action, $cb ); } } /* ------------------------------------------------------------------ menu */ public static function menu(): void { $connected = PayPalConnector::isConnected(); add_menu_page( 'StreamGoals', 'StreamGoals', self::CAP, self::HOME, array( self::class, 'page_home' ), 'dashicons-heart', 58 ); add_submenu_page( self::HOME, $connected ? 'Goals' : 'Setup', $connected ? 'Goals' : 'Setup', self::CAP, self::HOME, array( self::class, 'page_home' ) ); if ( $connected ) { add_submenu_page( self::HOME, 'Setup guide', 'Setup guide', self::CAP, 'streamgoals-setup', array( SetupPage::class, 'render' ) ); } add_submenu_page( self::HOME, 'Donations', 'Donations', self::CAP, 'streamgoals-donations', array( DonationsPage::class, 'render' ) ); $pending = Store::pendingModerationCount(); if ( Settings::get( 'moderate_messages' ) || $pending > 0 ) { $badge = $pending > 0 ? ' ' . (int) $pending . '' : ''; add_submenu_page( self::HOME, 'Moderation', 'Moderation' . $badge, self::CAP, 'streamgoals-moderation', array( DonationsPage::class, 'renderModeration' ) ); } add_submenu_page( self::HOME, 'Overlays', 'Overlays', self::CAP, 'streamgoals-overlays', array( OverlaysPage::class, 'render' ) ); add_submenu_page( self::HOME, 'Settings', 'Settings', self::CAP, 'streamgoals-settings', array( SettingsPage::class, 'render' ) ); } /** First screen: the setup wizard until PayPal is connected, then the goals list. */ public static function page_home(): void { if ( PayPalConnector::isConnected() ) { GoalsPage::render(); } else { SetupPage::render(); } } /** Overlay rewrite rules (registered by Overlay\Router on init) need a one-off flush. */ public static function maybe_flush_rewrites(): void { if ( current_user_can( self::CAP ) && class_exists( \StreamGoals\Overlay\Router::class ) && \StreamGoals\Overlay\Router::flush_rules_needed() ) { flush_rewrite_rules( false ); \StreamGoals\Overlay\Router::mark_flushed(); } } /* ---------------------------------------------------------------- assets */ public static function assets( string $hook ): void { $page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification if ( 0 !== strpos( $page, 'streamgoals' ) ) { return; } wp_enqueue_style( 'streamgoals-admin', STREAMGOALS_URL . 'assets/admin/admin.css', array(), STREAMGOALS_VERSION ); wp_enqueue_script( 'streamgoals-admin', STREAMGOALS_URL . 'assets/admin/admin.js', array(), STREAMGOALS_VERSION, true ); if ( self::HOME === $page ) { wp_enqueue_script( 'streamgoals-rules', STREAMGOALS_URL . 'assets/admin/rules.js', array( 'streamgoals-admin' ), STREAMGOALS_VERSION, true ); } if ( 'streamgoals-overlays' === $page ) { wp_enqueue_script( 'streamgoals-overlays', STREAMGOALS_URL . 'assets/admin/overlays.js', array( 'streamgoals-admin' ), STREAMGOALS_VERSION, true ); } } /* --------------------------------------------------------------- helpers */ /** Capability + nonce check for every admin-post handler. Dies on failure. */ public static function guard( string $action ): void { if ( ! current_user_can( self::CAP ) ) { wp_die( esc_html__( 'You do not have permission to do that.', 'streamgoals-donate' ), 403 ); } check_admin_referer( $action ); } /** Echo an opening