* @since 1.47.0 */ namespace AdvancedAds\Admin\Pages; use AdvancedAds\Abstracts\Screen; use AdvancedAds\Admin\Groups\Create_Modal; use AdvancedAds\Admin\Groups\List_Table; use AdvancedAds\Constants; use AdvancedAds\Utilities\Conditional; defined( 'ABSPATH' ) || exit; /** * Groups. */ class Groups extends Screen { /** * Groups list table (built on load so columns register before admin-header). * * @var List_Table|null */ private $list_table = null; /** * Screen unique id. * * @return string */ public function get_id(): string { return 'groups'; } /** * Register screen into WordPress admin area. * * @return void */ public function register_screen(): void { $hook = add_submenu_page( ADVADS_SLUG, __( 'Ad Groups & Rotations', 'advanced-ads' ), __( 'Groups & Rotation', 'advanced-ads' ), Conditional::user_cap( 'advanced_ads_edit_ads' ), ADVADS_SLUG . '-groups', [ $this, 'display' ] ); $this->set_hook( $hook ); add_action( 'load-' . $hook, [ $this, 'load_screen' ] ); } /** * Prepare the groups screen before it renders — WP_Terms_List_Table expects taxonomy/post_type on the current screen. * * @return void */ public function load_screen(): void { $wp_screen = get_current_screen(); if ( $wp_screen ) { $wp_screen->taxonomy = Constants::TAXONOMY_GROUP; $wp_screen->post_type = Constants::POST_TYPE_AD; } add_screen_option( 'per_page', [ 'default' => 20, 'option' => 'edit_' . Constants::TAXONOMY_GROUP . '_per_page', ] ); // ponytail: Must call before manage_{screen}_columns. $this->list_table = new List_Table(); } /** * Enqueue assets * * @return void */ public function enqueue_assets(): void { wp_advads()->registry->enqueue_style( 'screen-groups-listing' ); wp_advads()->registry->enqueue_script( 'screen-groups-listing' ); // Localize texts. $i18n = [ 'groups' => [ 'save' => __( 'Save', 'advanced-ads' ), 'saveNew' => __( 'Save New Group', 'advanced-ads' ), 'updated' => __( 'Group updated', 'advanced-ads' ), 'deleted' => __( 'Group deleted', 'advanced-ads' ), /* translators: an ad group title. */ 'confirmation' => __( 'You are about to permanently delete %s', 'advanced-ads' ), ], ]; wp_advads_json_add( 'i18n', $i18n ); } /** * Display screen content. * * @return void */ public function display(): void { global $wp_list_table; $wp_list_table = $this->list_table; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- WordPress reads the list table from this global. ( new Create_Modal() )->hooks(); include_once ADVADS_ABSPATH . 'views/admin/groups/page.php'; } /** * Get page header arguments * * @return array */ public function define_header_args(): array { return [ 'title' => __( 'Your Groups', 'advanced-ads' ), 'breadcrumb_title' => __( 'Groups', 'advanced-ads' ), 'manual_url' => 'https://wpadvancedads.com/manual/ad-groups/', ]; } /** * Add actions to the header * * @return void */ public function header_actions(): void { ?>