JezK

Edit File: Manager.php

<?php

namespace WeDevs\Dokan\Admin\Notices;

use WeDevs\Dokan\Traits\ChainableContainer;

/**
 * Dokan Admin notices handler class
 *
 * @since 3.3.3
 */
class Manager {
    use ChainableContainer;

/**
     * Class constructor
     *
     * @since 3.3.3
     */
    public function __construct() {
        $this->init_classes();
        $this->init_hooks();
    }

/**
     * Register all notices classes to chainable container
     *
     * @since 3.3.3
     *
     * @return void
     */
    private function init_classes() {
        $this->container['whats_new']              = new WhatsNew();
        $this->container['plugin_review']          = new PluginReview();
        $this->container['limited_time_promotion'] = new LimitedTimePromotion();
        $this->container['upgrade_v4']             = new UpgradeToV4();
    }

/**
     * Handle notices that has no ajax action
     *
     *  @since 3.3.3
     *
     * @return void
     */
    private function init_hooks() {
        add_action( 'admin_enqueue_scripts', [ $this, 'load_dokan_admin_notices_styles' ] );
        add_action( 'admin_notices', [ $this, 'render_missing_woocommerce_notice' ] );
        add_action( 'admin_notices', [ $this, 'render_global_admin_notices_html' ] );
        add_filter( 'dokan_admin_notices', [ $this, 'show_permalink_setting_notice' ] );
        add_filter( 'dokan_admin_notices', [ $this, 'show_admin_logo_update_notice' ] );
        add_action( 'wp_ajax_dismiss_dokan_admin_logo_update_notice', [ $this, 'dismiss_dokan_admin_logo_update_notice' ] );
        add_filter( 'dokan_admin_notices', [ $this, 'show_admin_plugin_update_notice' ] );
        add_filter( 'dokan_admin_notices', [ $this, 'show_vendor_onboarding_page_notice' ] );
    }

/**
     * Load admin notices style and styles
     *
     * @since 3.3.6
     *
     * @return void
     */
    public function load_dokan_admin_notices_styles() {
        wp_enqueue_style( 'dokan-global-admin-css', DOKAN_PLUGIN_ASSEST . '/css/global-admin.css', [], filemtime( DOKAN_DIR . '/assets/css/global-admin.css' ) );
    }

/**
     * Render dokan global admin notices via Vue.js
     *
     * @since 3.3.3
     *
     * @return void
     */
    public function render_global_admin_notices_html() {
        echo '<div id="dokan-admin-notices"></div>';
    }

/**
     * Missing WooCommerce notice
     *
     * @since 2.9.16
     *
     * @return void
     */
    public function render_missing_woocommerce_notice() {
        // check wooCommerce is available and active
        $has_woocommerce = dokan()->has_woocommerce();

// check if woocommerce installed
        $woocommerce_installed = dokan()->is_woocommerce_installed();

if ( ( ! $has_woocommerce || ! $woocommerce_installed ) && current_user_can( 'activate_plugins' ) ) {
            dokan_get_template(
                'admin-notice-dependencies.php', [
                    'has_woocommerce' => $has_woocommerce,
                    'woocommerce_installed' => $woocommerce_installed,
                ]
            );
        }
    }

/**
     * Display permalink format not working for Dokan notice
     *
     * @since 3.3.3
     *
     * @param array $notices
     *
     * @return array
     */
    public function show_permalink_setting_notice( $notices ) {
        if ( empty( get_option( 'permalink_structure' ) ) ) {
            $notices[] = [
                'type'        => 'alert',
                /* translators: %s permalink settings url */
                'description' => sprintf( __( 'The <strong>Plain</strong> permalink structure is not working for the Dokan plugin. Please change your permalink structure from <a href="%s">Settings > Permalinks</a>', 'dokan-lite' ), admin_url( 'options-permalink.php' ) ),
                'priority'    => 1,
                'actions'     => [
                    [
                        'type'   => 'primary',
                        'text'   => __( 'Go to Settings', 'dokan-lite' ),
                        'action' => admin_url( 'options-permalink.php' ),
                    ],
                ],
            ];
        }

return $notices;
    }

/**
     * Display dokan admin logo update notice.
     *
     * @since 3.14.0
     *
     * @param array $notices
     *
     * @return array
     */
    public function show_admin_logo_update_notice( array $notices ): array {
        if ( 'yes' !== get_option( 'dismiss_dokan_admin_logo_update_notice', 'no' ) ) {
            $notices[] = [
                'priority'          => 1,
                'show_close_button' => true,
                'type'              => 'info',
                'title'             => __( 'Dokan came up with a new look!', 'dokan-lite' ),
                'description'       => __( 'A new rebranded look is introduced in the entire platform. Check the updated visuals in different places.', 'dokan-lite' ),
                'ajax_data'         => [
                    'action' => 'dismiss_dokan_admin_logo_update_notice',
                    'nonce'  => wp_create_nonce( 'dismiss_dokan_admin_logo_update_notice_nonce' ),
                ],
            ];
        }

return $notices;
    }

/**
     * Dismisses dokan admin logo update notice.
     *
     * @since 3.14.0
     *
     * @return void
     */
    public function dismiss_dokan_admin_logo_update_notice() {
        $this->dismiss_notice( 'dismiss_dokan_admin_logo_update_notice' );
    }

/**
     * Dismisses dokan notice.
     *
     * @since 3.14.0
     *
     * @param string $option_name The name of the option to update.
     *
     * @return void
     */
    private function dismiss_notice( string $option_name ) {
        // Check nonce actions.
        if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['nonce'] ) ), $option_name . '_nonce' ) ) {
            wp_send_json_error( __( 'Invalid nonce', 'dokan-lite' ) );
        }

// Check permission.
        if ( ! current_user_can( 'manage_woocommerce' ) ) { // phpcs:ignore
            wp_send_json_error( __( 'You have no permission to do that', 'dokan-lite' ) );
        }

// Dismiss dokan admin logo notice.
        update_option( $option_name, 'yes' );
        wp_send_json_success();
    }

/**
     * Show admin notice if dokan lite is updated to v3.14.0 and dokan pro is not updated to minimum v3.14.0.
     *
     * @since 3.14.0
     *
     * @param $notices
     *
     * @return mixed
     */
    public function show_admin_plugin_update_notice( $notices ) {
        if (
            version_compare( DOKAN_PLUGIN_VERSION, '3.14.0', '>=' ) &&
            defined( 'DOKAN_PRO_PLUGIN_VERSION' ) &&
            version_compare( DOKAN_PRO_PLUGIN_VERSION, '3.14.0', '<' )
        ) {
            $notices[] = [
                'priority'          => 1,
                'show_close_button' => false,
                'type'              => 'alert',
                'scope'             => 'global',
                'title'             => __( 'Dokan Update Required', 'dokan-lite' ),
                'description'       => __( 'To ensure all the feature compatibility and accessibility, Dokan Pro minimum v3.14.0 is required.', 'dokan-lite' ),
                'actions'     => [
                    [
                        'type'   => 'primary',
                        'text'   => __( 'Update Now', 'dokan-lite' ),
                        'action' => admin_url( 'plugins.php' ),
                    ],
                ],
            ];
        }

return $notices;
    }

/**
     * Show admin notice if vendor onboarding page is not configured.
     *
     * @since 5.0.0
     *
     * @param array $notices
     *
     * @return array
     */
    public function show_vendor_onboarding_page_notice( $notices ) {
        // Check if vendor onboarding page is configured
        if ( $this->is_vendor_onboarding_page_configured() ) {
            return $notices;
        }

$is_legacy_tools_page = get_transient( 'dokan_legacy_tools_page' );
        $tools_page_slug      = $is_legacy_tools_page ? 'dokan' : 'dokan-dashboard';
        $settings_url         = admin_url( 'admin.php?page=' . $tools_page_slug ) . '#/tools';

$dokan_pages = get_option( 'dokan_pages', [] );
        $page_id = isset( $dokan_pages['vendor_onboarding'] ) ? $dokan_pages['vendor_onboarding'] : 0;

// Check if page was configured but is now deleted or unpublished
        if ( $page_id && (int) $page_id > 0 ) {
            $page = get_post( $page_id );

if ( ! $page ) {
                // Page doesn't exist
                $notice_title = esc_html__( 'Vendor Onboarding page not found!', 'dokan-lite' );
                $notice_description = sprintf(
                    /* translators: %s: Settings link */
                    esc_html__( 'The configured Vendor Onboarding page has been deleted. Please set a new page in %s', 'dokan-lite' ),
                    sprintf(
                        '<a href="%s">%s</a>',
                        esc_url( $settings_url ),
                        esc_html__( 'Dokan → Tools → Page Installation', 'dokan-lite' )
                    )
                );
            } else {
                // Page exists but is not published
                $notice_title = esc_html__( 'Vendor Onboarding page is not published!', 'dokan-lite' );
                $notice_description = sprintf(
                    /* translators: %s: Settings link */
                    esc_html__( 'The configured Vendor Onboarding page is not published. Please publish it or configure a new page in %s', 'dokan-lite' ),
                    sprintf(
                        '<a href="%s">%s</a>',
                        esc_url( $settings_url ),
                        esc_html__( 'Dokan → Tools → Page Installation', 'dokan-lite' )
                    )
                );
            }
        } else {
            // Page not configured at all
            $notice_title = esc_html__( 'Vendor Onboarding feature is almost ready!', 'dokan-lite' );
            $notice_description = sprintf(
                /* translators: %s: Settings link */
                esc_html__( 'Dokan Vendor Onboarding requires a dedicated page to be configured. Please set it in %s', 'dokan-lite' ),
                sprintf(
                    '<a href="%s">%s</a>',
                    esc_url( $settings_url ),
                    esc_html__( 'Dokan → Tools → Page Installation', 'dokan-lite' )
                )
            );
        }

$notices[] = [
            'type'        => 'warning',
            'title'       => $notice_title,
            'description' => $notice_description,
            'priority'    => 5,
            'scope'       => 'global',
        ];

return $notices;
    }

/**
     * Check if vendor onboarding page is configured.
     *
     * @since 5.0.0
     *
     * @return bool
     */
    private function is_vendor_onboarding_page_configured() {
        $dokan_pages = get_option( 'dokan_pages', [] );

// Check if vendor_onboarding key exists and has a valid page ID
        if ( ! isset( $dokan_pages['vendor_onboarding'] ) || empty( $dokan_pages['vendor_onboarding'] ) ) {
            return false;
        }

$page_id = $dokan_pages['vendor_onboarding'];

// Verify the page ID is not zero or empty
        if ( ! $page_id || 0 === (int) $page_id ) {
            return false;
        }

// Verify the page actually exists and is published
        $page = get_post( $page_id );

if ( ! $page || 'publish' !== $page->post_status ) {
            return false;
        }

return true;
    }
}