get_products() as $product ) {
if ( class_exists( $product['page_class'] ) ) {
new $product['page_class']();
}
}
}
/**
* Register the rotating submenu item for the currently surfaced product.
*
* Called by Area during its menu build so the item lands in the right
* position; does nothing once every product is adopted.
*
* @since 4.9.0
*
* @param string $access_capability Capability required to view the page.
*/
public function add_submenu_item( $access_capability ) {
$product = $this->get_current_product();
if ( $product === null ) {
return;
}
add_submenu_page(
Area::SLUG,
$product['label'],
$product['label'],
$access_capability,
$product['page_class']::SLUG,
[ $this, 'render_current_page' ]
);
$short_slug = substr( $product['page_class']::SLUG, strlen( Area::SLUG . '-' ) );
if ( ! in_array( $short_slug, Area::$pages_registered, true ) ) {
Area::$pages_registered[] = $short_slug;
}
}
/**
* Render the landing page for the currently surfaced product.
*
* @since 4.9.0
*/
public function render_current_page() {
$product = $this->get_current_product();
if ( $product === null ) {
return;
}
$page = new $product['page_class']();
// The id is required: all `wpms:` Tailwind utilities are build-scoped
// under `#wp-mail-smtp`, so the landing markup must live beneath it.
echo '';
$page->output();
echo '
';
}
/**
* Ordered product catalog.
*
* @since 4.9.0
*
* @return array>
*/
public function get_products() {
return [
[
'slug' => 'wpconsent',
'name' => 'WPConsent',
'label' => esc_html__( 'Privacy Compliance', 'wp-mail-smtp' ),
'page_class' => Pages\WPConsent::class,
'plugin' => 'wpconsent-cookies-banner-privacy-suite/wpconsent.php',
'plugin_pro' => 'wpconsent-premium/wpconsent-premium.php',
'activation_option' => 'wpconsent_activated',
],
[
'slug' => 'activelayer',
'name' => 'ActiveLayer',
'label' => esc_html__( 'Spam Protection', 'wp-mail-smtp' ),
'page_class' => Pages\ActiveLayer::class,
'plugin' => 'activelayer-anti-spam-spam-protection-for-forms-comments/activelayer-anti-spam-spam-protection-for-forms-comments.php',
'activation_option' => '', // No activation-time option exposed by the plugin.
],
[
'slug' => 'duplicator',
'name' => 'Duplicator',
'label' => esc_html__( 'Backups', 'wp-mail-smtp' ),
'page_class' => Pages\Duplicator::class,
'plugin' => 'duplicator/duplicator.php',
'plugin_pro' => 'duplicator-pro/duplicator-pro.php',
'activation_option' => 'duplicator_install_info', // migration reads ['time'].
],
[
'slug' => 'wpvibe',
'name' => 'WPVibe',
'label' => esc_html__( 'AI MCP', 'wp-mail-smtp' ),
'page_class' => Pages\WPVibe::class,
'plugin' => 'vibe-ai/vibe-ai.php',
'activation_option' => '', // No activation-time option exposed by the plugin.
],
[
'slug' => 'universally',
'name' => 'Universally',
'label' => esc_html__( 'Translations', 'wp-mail-smtp' ),
'page_class' => Pages\Universally::class,
'plugin' => 'universally-language-translation-multilingual-tool/universally.php',
'activation_option' => '', // No activation-time option exposed by the plugin.
],
[
'slug' => 'wpcode',
'name' => 'WPCode',
'label' => esc_html__( 'Code Snippets', 'wp-mail-smtp' ),
'page_class' => Pages\WPCode::class,
'plugin' => 'insert-headers-and-footers/ihaf.php',
'plugin_pro' => 'wpcode-premium/wpcode.php',
'activation_option' => 'ihaf_activated', // migration reads ['wpcode'].
],
];
}
/**
* Map of catalog plugin files (lite + pro) to product slug.
*
* @since 4.9.0
*
* @return array
*/
private function get_plugin_slug_map() {
$map = [];
foreach ( $this->get_products() as $product ) {
if ( ! empty( $product['plugin'] ) ) {
$map[ $product['plugin'] ] = $product['slug'];
}
if ( ! empty( $product['plugin_pro'] ) ) {
$map[ $product['plugin_pro'] ] = $product['slug'];
}
}
return $map;
}
/**
* Record first activation time of a catalog plugin (write-once).
*
* @since 4.9.0
*
* @param string $plugin Plugin file relative to the plugins dir.
* @param bool $network_wide Whether activation is network-wide.
*/
public function record_activation( $plugin, $network_wide ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed
$slug = $this->get_plugin_slug_map()[ $plugin ] ?? '';
if ( $slug === '' ) {
return;
}
$activated = (array) get_option( self::ACTIVATED_OPTION, [] );
if ( isset( $activated[ $slug ] ) ) {
return;
}
$activated[ $slug ] = time();
update_option( self::ACTIVATED_OPTION, $activated );
}
/**
* The product to surface right now, or null once every product is adopted.
*
* @since 4.9.0
*
* @return array|null
*/
public function get_current_product() {
$products = $this->get_products();
$activated = (array) get_option( self::ACTIVATED_OPTION, [] );
$now = time();
foreach ( $products as $product ) {
$timestamp = isset( $activated[ $product['slug'] ] ) ? (int) $activated[ $product['slug'] ] : 0;
if ( $timestamp === 0 || ( $now - $timestamp ) < self::ADOPTED_AFTER ) {
return $product;
}
}
// Everything adopted: surface nothing. The standard "About Us" submenu
// remains as the trailing item.
return null;
}
}