MAINHACK

Viewing / Editing File: pro-upsell.php

<?php

// SPDX-FileCopyrightText: 2026 Ovation S.r.l. <dev@novamira.ai>
// SPDX-License-Identifier: AGPL-3.0-or-later

declare(strict_types=1);

/**
 * Novamira Pro upsell: submenu entry, Connect-page card, dismissible welcome notice.
 */

if (!defined('ABSPATH')) {
    exit();
}

const NOVAMIRA_PRO_URL = 'https://www.novamira.ai/pro/';

const NOVAMIRA_PRO_DISMISS_PREFIX = 'novamira_pro_dismissed_';

const NOVAMIRA_PRO_WELCOME_KEY = 'welcome';

/**
 * True when the Novamira Pro plugin is active.
 * License state is irrelevant — if Pro is running, the upsell is.
 */
function novamira_pro_is_active(): bool
{
    return defined('NOVAMIRA_PRO_VERSION');
}

/**
 * Third-party plugins and themes that Novamira Pro ships dedicated
 * specializations and skills for. Drives the personalized upsell copy: any of
 * these that is active on the site gets named explicitly.
 *
 * The `category` keys group entries for the generic fallback copy; see
 * novamira_pro_integration_groups().
 *
 * @return list<array{label: string, category: string, detect: callable(): bool}>
 */
function novamira_pro_integration_catalog(): array
{
    return [
        [
            'label' => 'Elementor',
            'category' => 'builder',
            'detect' => static fn(): bool => defined('ELEMENTOR_VERSION'),
        ],
        ['label' => 'Bricks', 'category' => 'builder', 'detect' => static fn(): bool => defined('BRICKS_VERSION')],
        ['label' => 'Divi', 'category' => 'builder', 'detect' => static fn(): bool => defined('ET_BUILDER_VERSION')],
        [
            'label' => 'Breakdance',
            'category' => 'builder',
            'detect' => static fn(): bool => function_exists('Breakdance\\Data\\get_global_option'),
        ],
        ['label' => 'WPBakery', 'category' => 'builder', 'detect' => static fn(): bool => defined('WPB_VC_VERSION')],
        ['label' => 'Etch', 'category' => 'builder', 'detect' => static fn(): bool => class_exists('Etch\\Plugin')],
        [
            'label' => 'GeneratePress',
            'category' => 'builder',
            'detect' => static fn(): bool => function_exists('generate_get_option'),
        ],
        [
            'label' => 'Kadence',
            'category' => 'builder',
            'detect' => static fn(): bool => class_exists('Kadence\\Theme'),
        ],
        [
            'label' => 'Mosaic',
            'category' => 'builder',
            'detect' => static fn(): bool => class_exists('Mosaic\\Database\\MosaicDB'),
        ],
        ['label' => 'ACF', 'category' => 'content', 'detect' => static fn(): bool => class_exists('ACF')],
        [
            'label' => 'JetEngine',
            'category' => 'content',
            'detect' => static fn(): bool => function_exists('jet_engine'),
        ],
        ['label' => 'Meta Box', 'category' => 'content', 'detect' => static fn(): bool => defined('RWMB_VER')],
        ['label' => 'Pods', 'category' => 'content', 'detect' => static fn(): bool => defined('PODS_VERSION')],
        ['label' => 'ACPT', 'category' => 'content', 'detect' => static fn(): bool => defined('ACPT_PLUGIN_VERSION')],
        ['label' => 'ASE', 'category' => 'content', 'detect' => static fn(): bool => defined('ASENHA_VERSION')],
        [
            'label' => 'WooCommerce',
            'category' => 'commerce',
            'detect' => static fn(): bool => class_exists('WooCommerce'),
        ],
        [
            'label' => 'Code Snippets',
            'category' => 'dev',
            'detect' => static fn(): bool => defined('CODE_SNIPPETS_VERSION'),
        ],
    ];
}

/**
 * Labels of catalog integrations whose plugin or theme is active on this site,
 * in catalog order.
 *
 * @return list<string>
 */
function novamira_pro_active_integrations(): array
{
    $active = [];
    foreach (novamira_pro_integration_catalog() as $integration) {
        if (!$integration['detect']()) {
            continue;
        }
        $active[] = $integration['label'];
    }
    return $active;
}

/**
 * The full catalog rendered as grouped prose for the generic (no-match) copy,
 * e.g. "page builders (Elementor, Bricks, …), custom fields plugins (ACF, …),
 * WooCommerce, and Code Snippets". Built from the catalog so every integration
 * is named in exactly one place.
 */
function novamira_pro_integration_groups(): string
{
    // Category render order and prefix. An empty prefix lists the labels bare
    // (used for single-entry categories like WooCommerce / Code Snippets).
    $group_labels = [
        'builder' => __('page builders', domain: 'novamira'),
        'content' => __('custom fields plugins', domain: 'novamira'),
        'commerce' => '',
        'dev' => '',
    ];

/** @var array<string, list<string>> $labels_by_category */
    $labels_by_category = [];
    foreach (novamira_pro_integration_catalog() as $integration) {
        $labels_by_category[$integration['category']][] = $integration['label'];
    }

$segments = [];
    foreach ($group_labels as $category => $prefix) {
        $labels = $labels_by_category[$category] ?? [];
        if ($labels === []) {
            continue;
        }
        $list = wp_sprintf('%l', $labels);
        $segments[] = $prefix === '' ? $list : sprintf('%s (%s)', $prefix, $list);
    }

return wp_sprintf('%l', $segments);
}

/**
 * One-line Pro upsell blurb, shared by the welcome notice and the Connect card.
 * Names the integrations the user already runs; falls back to the full grouped
 * catalog when none are detected.
 */
function novamira_pro_upsell_blurb(): string
{
    $active = novamira_pro_active_integrations();
    if ($active === []) {
        return sprintf(
            /* translators: %s: grouped list of integrations, e.g. "page builders (Elementor, Bricks), WooCommerce". */
            __(
                'Novamira Pro adds specializations that combine abilities and skills for %s, plus memory that persists between sessions.',
                domain: 'novamira',
            ),
            novamira_pro_integration_groups(),
        );
    }

return sprintf(
        /* translators: %s: comma-separated list of detected plugin names, e.g. "Elementor, ACF, and WooCommerce". */
        __(
            'Novamira Pro adds specializations that combine abilities and skills for the tools you\'re already running (%s), plus memory that persists between sessions.',
            domain: 'novamira',
        ),
        wp_sprintf('%l', $active),
    );
}

/**
 * Append a "Get Pro" submenu entry that links out to novamira.ai/pro/.
 * Uses the $submenu global because add_submenu_page() doesn't accept external URLs.
 */
add_action(
    'admin_menu',
    static function (): void {
        if (novamira_pro_is_active()) {
            return;
        }
        // @mago-expect lint:no-global -- $submenu is WP core's only mutable handle for adding an external-URL submenu item.
        global $submenu;
        if (!is_array($submenu) || !is_array($submenu['novamira-connect'] ?? null)) {
            return;
        }
        $entries = $submenu['novamira-connect'];
        $entries[] = [
            '<span style="color:#f8ca50;font-weight:600;">' . esc_html__('Get Pro', domain: 'novamira') . '</span>',
            novamira_manage_capability(),
            esc_url(NOVAMIRA_PRO_URL . '?utm_source=plugin&utm_medium=submenu'),
        ];
        $submenu['novamira-connect'] = $entries;
    },
    priority: 99,
);

/**
 * Add a "Get Pro" action link on the Plugins page row for Novamira Free.
 */
add_filter(
    'plugin_action_links_' . plugin_basename(dirname(__DIR__) . '/novamira.php'),
    static function (array $links): array {
        if (novamira_pro_is_active()) {
            return $links;
        }
        $url = esc_url(NOVAMIRA_PRO_URL . '?utm_source=plugin&utm_medium=plugins_row');
        $links[] =
            '<a href="'
            . $url
            . '" target="_blank" rel="noopener">'
            . esc_html__('Get Pro', domain: 'novamira')
            . '</a>';
        return $links;
    },
);

add_action('admin_footer', static function (): void {
    if (!novamira_current_user_can_manage()) {
        return;
    }
    ?>
    <script>
    (function() {
        var links = document.querySelectorAll('#toplevel_page_novamira-connect .wp-submenu a');
        for (var i = 0; i < links.length; i++) {
            if (links[i].href.indexOf('novamira.ai/pro') !== -1) {
                links[i].target = '_blank';
                links[i].rel = 'noopener';
            }
        }
    })();
    </script>
    <?php
});

/**
 * Flag the welcome notice on first activation.
 */
register_activation_hook(dirname(__DIR__) . '/novamira.php', callback: 'novamira_pro_upsell_on_activate');
function novamira_pro_upsell_on_activate(): void
{
    if (get_option('novamira_pro_upsell_installed_at') === false) {
        update_option('novamira_pro_upsell_installed_at', time(), autoload: false);
    }
}

/**
 * Handle dismiss requests (AJAX GET from the notice).
 */
add_action('admin_init', static function (): void {
    $key = $_GET['novamira_pro_dismiss'] ?? null;
    if (!is_string($key) || $key === '') {
        return;
    }
    if (!novamira_current_user_can_manage()) {
        return;
    }
    $key = sanitize_key($key);
    update_user_meta(get_current_user_id(), NOVAMIRA_PRO_DISMISS_PREFIX . $key, meta_value: 1);
    wp_die('Dismissed', title: 'Dismissed', args: ['response' => 200]);
});

/**
 * Render the one-time welcome notice until dismissed.
 */
add_action('admin_notices', callback: 'novamira_render_pro_welcome_notice');

$dismiss_url = add_query_arg(['novamira_pro_dismiss' => NOVAMIRA_PRO_WELCOME_KEY], admin_url());
    $pro_url = esc_url(NOVAMIRA_PRO_URL . '?utm_source=plugin&utm_medium=welcome_notice');
    ?>
    <div class="notice notice-info is-dismissible novamira-pro-notice" data-dismiss-url="<?php echo
        esc_url($dismiss_url)
    ; ?>" style="border-left-color:#f8ca50;">
        <p style="font-size:14px;margin:10px 0;">
            <strong><?php esc_html_e('Novamira Pro is here.', domain: 'novamira'); ?></strong>
            <?php echo esc_html(novamira_pro_upsell_blurb()); ?>
            &nbsp;
            <a href="<?php echo
                $pro_url
            ; ?>" target="_blank" rel="noopener" class="button button-primary" style="background:#f8ca50;border-color:#f8ca50;color:#1a1a1a;">
                <?php esc_html_e('Discover more', domain: 'novamira'); ?>
            </a>
        </p>
    </div>
    <script>
    (function() {
        var notices = document.querySelectorAll('.novamira-pro-notice');
        for (var i = 0; i < notices.length; i++) {
            notices[i].addEventListener('click', function(e) {
                if (e.target && e.target.classList.contains('notice-dismiss')) {
                    var url = this.getAttribute('data-dismiss-url');
                    if (url) { fetch(url, {credentials: 'same-origin'}); }
                }
            });
        }
    })();
    </script>
    <?php
}

/**
 * Render a Pro upsell card — called from the Connect page.
 */
function novamira_render_pro_upsell_card(): void
{
    if (novamira_pro_is_active()) {
        return;
    }
    $pro_url = esc_url(NOVAMIRA_PRO_URL . '?utm_source=plugin&utm_medium=connect_card');
    ?>
    <div class="novamira-pro-card" style="margin:24px 0;padding:20px 24px;border:1px solid #e0e0e0;border-left:4px solid #f8ca50;border-radius:4px;background:#fffdf5;">
        <h2 style="margin:0 0 6px;font-size:16px;">
            <?php esc_html_e('Novamira Pro', domain: 'novamira'); ?>
            <span style="display:inline-block;margin-left:6px;padding:1px 8px;font-size:10px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;background:#f8ca50;color:#1a1a1a;border-radius:3px;vertical-align:middle;">
                <?php esc_html_e('Beta', domain: 'novamira'); ?>
            </span>
        </h2>
        <p style="margin:0 0 12px;color:#50575e;">
            <?php echo esc_html(novamira_pro_upsell_blurb()); ?>
        </p>
        <a href="<?php echo
            $pro_url
        ; ?>" target="_blank" rel="noopener" class="button button-primary" style="background:#f8ca50;border-color:#f8ca50;color:#1a1a1a;">
            <?php esc_html_e('Get Novamira Pro', domain: 'novamira'); ?>
        </a>
    </div>
    <?php
}

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: pro-upsell.php

Server Info

System Features

User Info