<?php

[0] Fix | Delete

[1] Fix | Delete

if ( ! defined( 'ABSPATH' ) ) {

[2] Fix | Delete

exit;

[3] Fix | Delete

}

[4] Fix | Delete

[5] Fix | Delete

// phpcs:ignore Generic.Commenting.DocComment.MissingShort

[6] Fix | Delete

/** @noinspection AutoloadingIssuesInspection */

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Register menu elements and do other global tasks.

[10] Fix | Delete

*

[11] Fix | Delete

* @since 1.0.0

[12] Fix | Delete

*/

[13] Fix | Delete

class WPForms_Admin_Menu {

[14] Fix | Delete

[15] Fix | Delete

/**

[16] Fix | Delete

* Primary class constructor.

[17] Fix | Delete

*

[18] Fix | Delete

* @since 1.0.0

[19] Fix | Delete

*/

[20] Fix | Delete

public function __construct() {

[21] Fix | Delete

[22] Fix | Delete

$this->hooks();

[23] Fix | Delete

}

[24] Fix | Delete

[25] Fix | Delete

/**

[26] Fix | Delete

* Hooks.

[27] Fix | Delete

*

[28] Fix | Delete

* @since 1.9.7.3

[29] Fix | Delete

*

[30] Fix | Delete

* @return void

[31] Fix | Delete

*/

[32] Fix | Delete

private function hooks(): void {

[33] Fix | Delete

[34] Fix | Delete

// Let's make some menus.

[35] Fix | Delete

add_action( 'admin_menu', [ $this, 'register_menus' ], 9 );

[36] Fix | Delete

add_action( 'admin_head', [ $this, 'hide_wpforms_submenu_items' ] );

[37] Fix | Delete

add_action( 'admin_head', [ $this, 'adjust_pro_menu_item' ] );

[38] Fix | Delete

add_action( 'admin_head', [ $this, 'admin_menu_styles' ], 11 );

[39] Fix | Delete

[40] Fix | Delete

// Plugins page settings link.

[41] Fix | Delete

add_filter( 'plugin_action_links_' . plugin_basename( WPFORMS_PLUGIN_DIR . 'wpforms.php' ), [ $this, 'settings_link' ], 10, 4 );

[42] Fix | Delete

[43] Fix | Delete

add_action( 'activated_plugin', [ $this, 'activated_rotation_plugin' ], 10, 2 );

[44] Fix | Delete

}

[45] Fix | Delete

[46] Fix | Delete

/**

[47] Fix | Delete

* Register our menus.

[48] Fix | Delete

*

[49] Fix | Delete

* @since 1.0.0

[50] Fix | Delete

*/

[51] Fix | Delete

public function register_menus(): void {

[52] Fix | Delete

[53] Fix | Delete

$manage_cap = wpforms_get_capability_manage_options();

[54] Fix | Delete

$access = wpforms()->obj( 'access' );

[55] Fix | Delete

[56] Fix | Delete

if ( ! $access || ! method_exists( $access, 'get_menu_cap' ) ) {

[57] Fix | Delete

return;

[58] Fix | Delete

}

[59] Fix | Delete

[60] Fix | Delete

// Default Forms top level menu item.

[61] Fix | Delete

add_menu_page(

[62] Fix | Delete

esc_html__( 'WPForms', 'wpforms-lite' ),

[63] Fix | Delete

esc_html__( 'WPForms', 'wpforms-lite' ),

[64] Fix | Delete

$access->get_menu_cap( 'view_forms' ),

[65] Fix | Delete

'wpforms-overview',

[66] Fix | Delete

[ $this, 'admin_page' ],

[67] Fix | Delete

// phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode

[68] Fix | Delete

'data:image/svg+xml;base64,' . base64_encode( '<svg width="1792" height="1792" viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="#9ea3a8" d="M643 911v128h-252v-128h252zm0-255v127h-252v-127h252zm758 511v128h-341v-128h341zm0-256v128h-672v-128h672zm0-255v127h-672v-127h672zm135 860v-1240q0-8-6-14t-14-6h-32l-378 256-210-171-210 171-378-256h-32q-8 0-14 6t-6 14v1240q0 8 6 14t14 6h1240q8 0 14-6t6-14zm-855-1110l185-150h-406zm430 0l221-150h-406zm553-130v1240q0 62-43 105t-105 43h-1240q-62 0-105-43t-43-105v-1240q0-62 43-105t105-43h1240q62 0 105 43t43 105z"/></svg>' ),

[69] Fix | Delete

/**

[70] Fix | Delete

* Filters WPForms menu position.

[71] Fix | Delete

*

[72] Fix | Delete

* @since 1.6.0.2

[73] Fix | Delete

*

[74] Fix | Delete

* @param string|int|float $position Menu position.

[75] Fix | Delete

*/

[76] Fix | Delete

apply_filters( 'wpforms_menu_position', '58.9' ) // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName

[77] Fix | Delete

);

[78] Fix | Delete

[79] Fix | Delete

// All Forms sub menu item.

[80] Fix | Delete

add_submenu_page(

[81] Fix | Delete

'wpforms-overview',

[82] Fix | Delete

esc_html__( 'WPForms', 'wpforms-lite' ),

[83] Fix | Delete

esc_html__( 'All Forms', 'wpforms-lite' ),

[84] Fix | Delete

$access->get_menu_cap( 'view_forms' ),

[85] Fix | Delete

'wpforms-overview',

[86] Fix | Delete

[ $this, 'admin_page' ]

[87] Fix | Delete

);

[88] Fix | Delete

[89] Fix | Delete

// Add New submenu item.

[90] Fix | Delete

add_submenu_page(

[91] Fix | Delete

'wpforms-overview',

[92] Fix | Delete

esc_html__( 'WPForms Builder', 'wpforms-lite' ),

[93] Fix | Delete

esc_html__( 'Add New Form', 'wpforms-lite' ),

[94] Fix | Delete

$access->get_menu_cap( [ 'create_forms', 'edit_forms' ] ),

[95] Fix | Delete

'wpforms-builder',

[96] Fix | Delete

[ $this, 'admin_page' ]

[97] Fix | Delete

);

[98] Fix | Delete

[99] Fix | Delete

// Entries sub menu item.

[100] Fix | Delete

add_submenu_page(

[101] Fix | Delete

'wpforms-overview',

[102] Fix | Delete

esc_html__( 'Form Entries', 'wpforms-lite' ),

[103] Fix | Delete

esc_html__( 'Entries', 'wpforms-lite' ),

[104] Fix | Delete

$access->get_menu_cap( 'view_entries' ),

[105] Fix | Delete

'wpforms-entries',

[106] Fix | Delete

[ $this, 'admin_page' ]

[107] Fix | Delete

);

[108] Fix | Delete

[109] Fix | Delete

// Payments sub menu item.

[110] Fix | Delete

add_submenu_page(

[111] Fix | Delete

'wpforms-overview',

[112] Fix | Delete

esc_html__( 'Payments', 'wpforms-lite' ),

[113] Fix | Delete

esc_html__( 'Payments', 'wpforms-lite' ) . $this->get_new_badge_html(),

[114] Fix | Delete

$manage_cap,

[115] Fix | Delete

WPForms\Admin\Payments\Payments::SLUG,

[116] Fix | Delete

[ $this, 'admin_page' ]

[117] Fix | Delete

);

[118] Fix | Delete

[119] Fix | Delete

do_action_deprecated( // phpcs:ignore WPForms.Comments.PHPDocHooks.RequiredHookDocumentation

[120] Fix | Delete

'wpform_admin_menu',

[121] Fix | Delete

[ $this ],

[122] Fix | Delete

'1.5.5 of the WPForms plugin',

[123] Fix | Delete

'wpforms_admin_menu'

[124] Fix | Delete

);

[125] Fix | Delete

[126] Fix | Delete

/**

[127] Fix | Delete

* Fires after constructing the WPForms admin menu.

[128] Fix | Delete

*

[129] Fix | Delete

* @since 1.5.4.2

[130] Fix | Delete

*

[131] Fix | Delete

* @param WPForms_Admin_Menu $instance WPForms Admin Menu instance.

[132] Fix | Delete

*/

[133] Fix | Delete

do_action( 'wpforms_admin_menu', $this );

[134] Fix | Delete

[135] Fix | Delete

// Templates sub menu item.

[136] Fix | Delete

add_submenu_page(

[137] Fix | Delete

'wpforms-overview',

[138] Fix | Delete

esc_html__( 'WPForms Templates', 'wpforms-lite' ),

[139] Fix | Delete

esc_html__( 'Form Templates', 'wpforms-lite' ),

[140] Fix | Delete

$access->get_menu_cap( 'edit_forms' ),

[141] Fix | Delete

'wpforms-templates',

[142] Fix | Delete

[ $this, 'admin_page' ]

[143] Fix | Delete

);

[144] Fix | Delete

[145] Fix | Delete

// Settings submenu item.

[146] Fix | Delete

add_submenu_page(

[147] Fix | Delete

'wpforms-overview',

[148] Fix | Delete

esc_html__( 'WPForms Settings', 'wpforms-lite' ),

[149] Fix | Delete

esc_html__( 'Settings', 'wpforms-lite' ),

[150] Fix | Delete

$manage_cap,

[151] Fix | Delete

'wpforms-settings',

[152] Fix | Delete

[ $this, 'admin_page' ]

[153] Fix | Delete

);

[154] Fix | Delete

[155] Fix | Delete

// Tools sub menu item.

[156] Fix | Delete

add_submenu_page(

[157] Fix | Delete

'wpforms-overview',

[158] Fix | Delete

esc_html__( 'WPForms Tools', 'wpforms-lite' ),

[159] Fix | Delete

esc_html__( 'Tools', 'wpforms-lite' ),

[160] Fix | Delete

$access->get_menu_cap( [ 'create_forms', 'view_forms', 'view_entries' ] ),

[161] Fix | Delete

'wpforms-tools',

[162] Fix | Delete

[ $this, 'admin_page' ]

[163] Fix | Delete

);

[164] Fix | Delete

[165] Fix | Delete

// Hidden placeholder paged used for misc content.

[166] Fix | Delete

add_submenu_page(

[167] Fix | Delete

'wpforms-settings',

[168] Fix | Delete

esc_html__( 'WPForms', 'wpforms-lite' ),

[169] Fix | Delete

esc_html__( 'Info', 'wpforms-lite' ),

[170] Fix | Delete

$access->get_menu_cap( 'any' ),

[171] Fix | Delete

'wpforms-page',

[172] Fix | Delete

[ $this, 'admin_page' ]

[173] Fix | Delete

);

[174] Fix | Delete

[175] Fix | Delete

// Addons submenu page.

[176] Fix | Delete

add_submenu_page(

[177] Fix | Delete

'wpforms-overview',

[178] Fix | Delete

esc_html__( 'WPForms Addons', 'wpforms-lite' ),

[179] Fix | Delete

'<span style="color:#f18500">' . esc_html__( 'Addons', 'wpforms-lite' ) . '</span>',

[180] Fix | Delete

$access->get_menu_cap( 'edit_forms' ),

[181] Fix | Delete

'wpforms-addons',

[182] Fix | Delete

[ $this, 'admin_page' ]

[183] Fix | Delete

);

[184] Fix | Delete

[185] Fix | Delete

// Rotating submenu.

[186] Fix | Delete

$rotation = $this->get_rotating_submenu();

[187] Fix | Delete

[188] Fix | Delete

if ( $rotation ) {

[189] Fix | Delete

add_submenu_page(

[190] Fix | Delete

'wpforms-overview',

[191] Fix | Delete

$rotation['page_title'],

[192] Fix | Delete

$rotation['menu_title'],

[193] Fix | Delete

$manage_cap,

[194] Fix | Delete

$rotation['menu_slug'],

[195] Fix | Delete

[ $this, 'admin_page' ]

[196] Fix | Delete

);

[197] Fix | Delete

}

[198] Fix | Delete

[199] Fix | Delete

// SMTP submenu page.

[200] Fix | Delete

add_submenu_page(

[201] Fix | Delete

'wpforms-overview',

[202] Fix | Delete

esc_html__( 'SMTP', 'wpforms-lite' ),

[203] Fix | Delete

esc_html__( 'SMTP', 'wpforms-lite' ),

[204] Fix | Delete

$manage_cap,

[205] Fix | Delete

WPForms\Admin\Pages\SMTP::SLUG,

[206] Fix | Delete

[ $this, 'admin_page' ]

[207] Fix | Delete

);

[208] Fix | Delete

[209] Fix | Delete

// About submenu page.

[210] Fix | Delete

add_submenu_page(

[211] Fix | Delete

'wpforms-overview',

[212] Fix | Delete

esc_html__( 'About WPForms', 'wpforms-lite' ),

[213] Fix | Delete

esc_html__( 'About Us', 'wpforms-lite' ),

[214] Fix | Delete

$access->get_menu_cap( 'any' ),

[215] Fix | Delete

WPForms_About::SLUG,

[216] Fix | Delete

[ $this, 'admin_page' ]

[217] Fix | Delete

);

[218] Fix | Delete

[219] Fix | Delete

// Community submenu page.

[220] Fix | Delete

add_submenu_page(

[221] Fix | Delete

'wpforms-overview',

[222] Fix | Delete

esc_html__( 'Community', 'wpforms-lite' ),

[223] Fix | Delete

esc_html__( 'Community', 'wpforms-lite' ),

[224] Fix | Delete

$manage_cap,

[225] Fix | Delete

WPForms\Admin\Pages\Community::SLUG,

[226] Fix | Delete

[ $this, 'admin_page' ]

[227] Fix | Delete

);

[228] Fix | Delete

[229] Fix | Delete

if ( ! wpforms()->is_pro() ) {

[230] Fix | Delete

add_submenu_page(

[231] Fix | Delete

'wpforms-overview',

[232] Fix | Delete

esc_html__( 'Upgrade to Pro', 'wpforms-lite' ),

[233] Fix | Delete

esc_html__( 'Upgrade to Pro', 'wpforms-lite' ),

[234] Fix | Delete

$manage_cap,

[235] Fix | Delete

wpforms_admin_upgrade_link( 'admin-menu' )

[236] Fix | Delete

);

[237] Fix | Delete

}

[238] Fix | Delete

}

[239] Fix | Delete

[240] Fix | Delete

/**

[241] Fix | Delete

* Hide the "Add New" admin menu item if a user can't create forms.

[242] Fix | Delete

*

[243] Fix | Delete

* @since 1.5.8

[244] Fix | Delete

*/

[245] Fix | Delete

public function hide_wpforms_submenu_items(): void {

[246] Fix | Delete

[247] Fix | Delete

if ( wpforms_current_user_can( 'create_forms' ) ) {

[248] Fix | Delete

return;

[249] Fix | Delete

}

[250] Fix | Delete

[251] Fix | Delete

global $submenu;

[252] Fix | Delete

[253] Fix | Delete

if ( ! isset( $submenu['wpforms-overview'] ) ) {

[254] Fix | Delete

return;

[255] Fix | Delete

}

[256] Fix | Delete

[257] Fix | Delete

foreach ( $submenu['wpforms-overview'] as $key => $item ) {

[258] Fix | Delete

if ( isset( $item[2] ) && $item[2] === 'wpforms-builder' ) {

[259] Fix | Delete

unset( $submenu['wpforms-overview'][ $key ] );

[260] Fix | Delete

break;

[261] Fix | Delete

}

[262] Fix | Delete

}

[263] Fix | Delete

[264] Fix | Delete

$this->hide_wpforms_menu_item();

[265] Fix | Delete

}

[266] Fix | Delete

[267] Fix | Delete

/**

[268] Fix | Delete

* Hide the "WPForms" admin menu if it has no submenu items.

[269] Fix | Delete

*

[270] Fix | Delete

* @since 1.5.8

[271] Fix | Delete

*/

[272] Fix | Delete

public function hide_wpforms_menu_item(): void {

[273] Fix | Delete

[274] Fix | Delete

global $submenu, $menu;

[275] Fix | Delete

[276] Fix | Delete

if ( ! empty( $submenu['wpforms-overview'] ) ) {

[277] Fix | Delete

return;

[278] Fix | Delete

}

[279] Fix | Delete

[280] Fix | Delete

unset( $submenu['wpforms-overview'] );

[281] Fix | Delete

[282] Fix | Delete

foreach ( $menu as $key => $item ) {

[283] Fix | Delete

if ( isset( $item[2] ) && $item[2] === 'wpforms-overview' ) {

[284] Fix | Delete

unset( $menu[ $key ] );

[285] Fix | Delete

break;

[286] Fix | Delete

}

[287] Fix | Delete

}

[288] Fix | Delete

}

[289] Fix | Delete

[290] Fix | Delete

/**

[291] Fix | Delete

* Make changes to the PRO menu item.

[292] Fix | Delete

*

[293] Fix | Delete

* @since 1.8.1

[294] Fix | Delete

*/

[295] Fix | Delete

public function adjust_pro_menu_item(): void {

[296] Fix | Delete

[297] Fix | Delete

global $submenu;

[298] Fix | Delete

[299] Fix | Delete

// Bail if a plugin menu is not registered.

[300] Fix | Delete

if ( ! isset( $submenu['wpforms-overview'] ) ) {

[301] Fix | Delete

return;

[302] Fix | Delete

}

[303] Fix | Delete

[304] Fix | Delete

$upgrade_link_position = key(

[305] Fix | Delete

array_filter(

[306] Fix | Delete

$submenu['wpforms-overview'],

[307] Fix | Delete

static function ( $item ) {

[308] Fix | Delete

[309] Fix | Delete

return strpos( urldecode( $item[2] ), 'wpforms.com/lite-upgrade' ) !== false;

[310] Fix | Delete

}

[311] Fix | Delete

)

[312] Fix | Delete

);

[313] Fix | Delete

[314] Fix | Delete

// Bail if "Upgrade to Pro" menu item is not registered.

[315] Fix | Delete

if ( $upgrade_link_position === null ) {

[316] Fix | Delete

return;

[317] Fix | Delete

}

[318] Fix | Delete

[319] Fix | Delete

// Add the PRO badge to the menu item.

[320] Fix | Delete

// phpcs:disable WordPress.WP.GlobalVariablesOverride.Prohibited

[321] Fix | Delete

if ( isset( $submenu['wpforms-overview'][ $upgrade_link_position ][4] ) ) {

[322] Fix | Delete

$submenu['wpforms-overview'][ $upgrade_link_position ][4] .= ' wpforms-sidebar-upgrade-pro';

[323] Fix | Delete

} else {

[324] Fix | Delete

$submenu['wpforms-overview'][ $upgrade_link_position ][] = 'wpforms-sidebar-upgrade-pro';

[325] Fix | Delete

}

[326] Fix | Delete

[327] Fix | Delete

$current_screen = get_current_screen();

[328] Fix | Delete

$upgrade_utm_content = $current_screen === null ? 'Upgrade to Pro' : 'Upgrade to Pro - ' . $current_screen->base;

[329] Fix | Delete

// phpcs:ignore WordPress.Security.NonceVerification.Recommended

[330] Fix | Delete

$upgrade_utm_content = empty( $_GET['view'] ) ? $upgrade_utm_content : $upgrade_utm_content . ': ' . sanitize_key( $_GET['view'] );

[331] Fix | Delete

[332] Fix | Delete

// Add utm_content to the menu item.

[333] Fix | Delete

$submenu['wpforms-overview'][ $upgrade_link_position ][2] = esc_url(

[334] Fix | Delete

add_query_arg(

[335] Fix | Delete

'utm_content',

[336] Fix | Delete

$upgrade_utm_content,

[337] Fix | Delete

$submenu['wpforms-overview'][ $upgrade_link_position ][2]

[338] Fix | Delete

)

[339] Fix | Delete

);

[340] Fix | Delete

// phpcs:enable WordPress.WP.GlobalVariablesOverride.Prohibited

[341] Fix | Delete

}

[342] Fix | Delete

[343] Fix | Delete

/**

[344] Fix | Delete

* Wrapper for the hook to render our custom settings pages.

[345] Fix | Delete

*

[346] Fix | Delete

* @since 1.0.0

[347] Fix | Delete

*/

[348] Fix | Delete

public function admin_page(): void {

[349] Fix | Delete

[350] Fix | Delete

/**

[351] Fix | Delete

* Fires to show the WPForms admin page.

[352] Fix | Delete

*

[353] Fix | Delete

* @since 1.0.0

[354] Fix | Delete

*/

[355] Fix | Delete

do_action( 'wpforms_admin_page' ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName

[356] Fix | Delete

}

[357] Fix | Delete

[358] Fix | Delete

/**

[359] Fix | Delete

* Add a settings link to the Plugins page.

[360] Fix | Delete

*

[361] Fix | Delete

* @since 1.3.9

[362] Fix | Delete

*

[363] Fix | Delete

* @param array|mixed $links Plugin row links.

[364] Fix | Delete

* @param string $plugin_file Path to the plugin file relative to the plugins' directory.

[365] Fix | Delete

* @param array $plugin_data An array of plugin data. See `get_plugin_data()`.

[366] Fix | Delete

* @param string $context The plugin context.

[367] Fix | Delete

*

[368] Fix | Delete

* @return array $links

[369] Fix | Delete

* @noinspection PhpUnusedParameterInspection

[370] Fix | Delete

* @noinspection HtmlUnknownTarget

[371] Fix | Delete

* @noinspection PhpMissingParamTypeInspection

[372] Fix | Delete

*/

[373] Fix | Delete

public function settings_link( $links, $plugin_file, $plugin_data, $context ): array { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed

[374] Fix | Delete

[375] Fix | Delete

$custom['wpforms-pro'] = sprintf(

[376] Fix | Delete

'<a href="%1$s" aria-label="%2$s" target="_blank" rel="noopener noreferrer"

[377] Fix | Delete

style="color: #00a32a; font-weight: 700;"

[378] Fix | Delete

onmouseover="this.style.color=\'#008a20\';"

[379] Fix | Delete

onmouseout="this.style.color=\'#00a32a\';"

[380] Fix | Delete

>%3$s</a>',

[381] Fix | Delete

esc_url(

[382] Fix | Delete

wpforms_admin_upgrade_link(

[383] Fix | Delete

'all-plugins',

[384] Fix | Delete

'Get WPForms Pro'

[385] Fix | Delete

)

[386] Fix | Delete

),

[387] Fix | Delete

esc_attr__( 'Upgrade to WPForms Pro', 'wpforms-lite' ),

[388] Fix | Delete

esc_html__( 'Get WPForms Pro', 'wpforms-lite' )

[389] Fix | Delete

);

[390] Fix | Delete

[391] Fix | Delete

$custom['wpforms-settings'] = sprintf(

[392] Fix | Delete

'<a href="%s" aria-label="%s">%s</a>',

[393] Fix | Delete

esc_url(

[394] Fix | Delete

add_query_arg(

[395] Fix | Delete

[ 'page' => 'wpforms-settings' ],

[396] Fix | Delete

admin_url( 'admin.php' )

[397] Fix | Delete

)

[398] Fix | Delete

),

[399] Fix | Delete

esc_attr__( 'Go to WPForms Settings page', 'wpforms-lite' ),

[400] Fix | Delete

esc_html__( 'Settings', 'wpforms-lite' )

[401] Fix | Delete

);

[402] Fix | Delete

[403] Fix | Delete

$custom['wpforms-docs'] = sprintf(

[404] Fix | Delete

'<a href="%1$s" aria-label="%2$s" target="_blank" rel="noopener noreferrer">%3$s</a>',

[405] Fix | Delete

esc_url(

[406] Fix | Delete

add_query_arg(

[407] Fix | Delete

[

[408] Fix | Delete

'utm_content' => 'Documentation',

[409] Fix | Delete

'utm_campaign' => 'liteplugin',

[410] Fix | Delete

'utm_medium' => 'all-plugins',

[411] Fix | Delete

'utm_source' => 'WordPress',

[412] Fix | Delete

],

[413] Fix | Delete

'https://wpforms.com/docs/'

[414] Fix | Delete

)

[415] Fix | Delete

),

[416] Fix | Delete

esc_attr__( 'Read the documentation', 'wpforms-lite' ),

[417] Fix | Delete

esc_html__( 'Docs', 'wpforms-lite' )

[418] Fix | Delete

);

[419] Fix | Delete

[420] Fix | Delete

return array_merge( $custom, (array) $links );

[421] Fix | Delete

}

[422] Fix | Delete

[423] Fix | Delete

/**

[424] Fix | Delete

* Determine which submenu item to show (rotation).

[425] Fix | Delete

*

[426] Fix | Delete

* Current behavior:

[427] Fix | Delete

* - Show item until the plugin has been activated for 7 or more days.

[428] Fix | Delete

* - Once 7+ days have passed since activation - show next item.

[429] Fix | Delete

* - Once the last item has been active for more than 7 days, always display the first item (WP Consent page).

[430] Fix | Delete

*

[431] Fix | Delete

* @since 1.9.8.6

[432] Fix | Delete

*

[433] Fix | Delete

* @return array|null { menu_title, page_title, menu_slug } or null to show none.

[434] Fix | Delete

*/

[435] Fix | Delete

private function get_rotating_submenu(): ?array {

[436] Fix | Delete

[437] Fix | Delete

$items = $this->get_rotation_items();

[438] Fix | Delete

$now = time();

[439] Fix | Delete

$defaults = [

[440] Fix | Delete

'label' => '',

[441] Fix | Delete

'menu_slug' => '',

[442] Fix | Delete

'slug' => '',

[443] Fix | Delete

'plugin_file' => '',

[444] Fix | Delete

];

[445] Fix | Delete

[446] Fix | Delete

// Find the first item that should be displayed.

[447] Fix | Delete

foreach ( $items as $item ) {

[448] Fix | Delete

$item = wp_parse_args( $item, $defaults );

[449] Fix | Delete

[450] Fix | Delete

$label = (string) $item['label'];

[451] Fix | Delete

$menu_slug = (string) $item['menu_slug'];

[452] Fix | Delete

$plugin_slug = (string) $item['slug'];

[453] Fix | Delete

[454] Fix | Delete

if ( empty( $label ) || empty( $menu_slug ) ) {

[455] Fix | Delete

continue; // Skip misconfigured items.

[456] Fix | Delete

}

[457] Fix | Delete

[458] Fix | Delete

$timestamp = $this->get_promo_plugin_activation_timestamp( $plugin_slug );

[459] Fix | Delete

[460] Fix | Delete

// Show if a plugin has never activated or within 7 days of activation.

[461] Fix | Delete

$within = $timestamp === 0 || ( $now - $timestamp ) < 7 * DAY_IN_SECONDS;

[462] Fix | Delete

[463] Fix | Delete

if ( $within ) {

[464] Fix | Delete

return [

[465] Fix | Delete

'menu_title' => $label,

[466] Fix | Delete

'page_title' => $label,

[467] Fix | Delete

'menu_slug' => $menu_slug,

[468] Fix | Delete

];

[469] Fix | Delete

}

[470] Fix | Delete

}

[471] Fix | Delete

[472] Fix | Delete

// If all items are considered "complete", return the first one (cycle back).

[473] Fix | Delete

$first = $items[0];

[474] Fix | Delete

$label = $first['label'];

[475] Fix | Delete

$menu_slug = $first['menu_slug'];

[476] Fix | Delete

[477] Fix | Delete

if ( ! empty( $label ) && ! empty( $menu_slug ) ) {

[478] Fix | Delete

return [

[479] Fix | Delete

'menu_title' => $label,

[480] Fix | Delete

'page_title' => $label,

[481] Fix | Delete

'menu_slug' => $menu_slug,

[482] Fix | Delete

];

[483] Fix | Delete

}

[484] Fix | Delete

[485] Fix | Delete

return null;

[486] Fix | Delete

}

[487] Fix | Delete

[488] Fix | Delete

/**

[489] Fix | Delete

* List of rotating plugins files.

[490] Fix | Delete

*

[491] Fix | Delete

* @since 1.9.8.6

[492] Fix | Delete

*

[493] Fix | Delete

* @return array

[494] Fix | Delete

*/

[495] Fix | Delete

private function get_rotation_plugins(): array {

[496] Fix | Delete

[497] Fix | Delete

return [

[498] Fix | Delete

'wpconsent-cookies-banner-privacy-suite/wpconsent.php' => 'wpconsent',

[499] Fix | Delete