Pro Features

Overview

Magical Shop Builder Pro is a premium add-on that extends the free plugin with powerful advanced features. It requires the free version of Magical Shop Builder to be installed and activated. Pro status is managed through existing option names (mgppro_is_active, mgppro_has_valid_lic) for backward compatibility.

The Pro system includes:

• Centralized pro feature management — handled by class-mpd-pro.php (~250 lines), which registers pro widgets, enqueues pro assets, and manages the pro status checks.
• Pro Lock trait — a reusable PHP trait that widgets use to lock specific controls and features behind the pro gate.
• Development mode support — define the MPD_PRO_DEV_MODE constant to unlock all pro features during development without a license key.

// Enable Pro development mode (unlocks all pro features without a license)
define( 'MPD_PRO_DEV_MODE', true );

Free vs Pro Comparison

The following table shows a complete comparison of features available in the free version versus what’s unlocked with Pro:

Pro-Exclusive Widgets

These widgets are only available when Magical Shop Builder Pro is activated with a valid license:

Pro Widget Enhancements

In addition to exclusive widgets, Pro unlocks advanced features in existing free widgets:

Products Grid — Pro Enhancements

• Image Flip on Hover — Shows a secondary product image when hovering over the product card, creating a dynamic browsing experience.
• Stock Progress Bar — Visual progress bar showing remaining stock levels, creating urgency for low-stock items.
• Action Icons — Wishlist, Share, QR Code, and Video action icon buttons overlaid on product cards for quick interactions.

Product Gallery — Video Support

• YouTube and Vimeo Videos — Embed product videos directly in the WooCommerce product gallery alongside product images.
• Video position is configurable: display the video first (before images) or last (after images).
• Videos are added per-product via the Product Video metabox.

Multi-Step Checkout

• Full step-by-step checkout wizard — Break the checkout process into clear, manageable steps for improved conversion rates.
• Comprehensive implementation (~2,755 lines) with full Elementor controls for each step.
• Customizable step labels, icons, colors, and progress indicators.

Product Video Metabox

Pro adds a “Product Video” tab to the WooCommerce product data panel (~453 lines), allowing store owners to attach video content to their products:

Supported Platforms

• YouTube — Paste any YouTube video URL
• Vimeo — Paste any Vimeo video URL

Configuration Options

• Video URL — The YouTube or Vimeo video link
• Video Position — Choose where the video appears in the gallery:
  • First — Video displays before product images
  • Last — Video displays after product images
• Live Preview — Preview the video directly in the admin panel while editing

Meta Keys

_mpd_product_video_url       // The YouTube or Vimeo video URL
_mpd_product_video_position  // 'first' or 'last' — video placement in gallery

How Pro Locking Works (Developer Info)

The Pro Lock trait (trait-mpd-pro-lock.php) provides a set of methods that widgets use to gate features behind the pro check. This makes it easy to add pro-only controls to any widget while maintaining a clean upgrade path.

Available Methods

Usage Example

use Jesuspended\MagicalProductsDisplay\Traits\Pro_Lock;

class My_Widget extends \Elementor\Widget_Base {
    use Pro_Lock;

    protected function register_controls() {
        // Add a pro-only control
        $this->add_control(
            'image_flip',
            [
                'label'   => $this->pro_label( 'Image Flip' ),
                'type'    => \Elementor\Controls_Manager::SWITCHER,
                'default' => $this->pro_value( 'yes', '' ),
            ]
        );

        // Show upgrade notice if not pro
        if ( ! $this->is_pro() ) {
            $this->add_control(
                'pro_notice',
                [
                    'type' => \Elementor\Controls_Manager::RAW_HTML,
                    'raw'  => $this->get_pro_notice( 'Upgrade to unlock Image Flip.' ),
                ]
            );
        }
    }
}

License Activation

Follow these steps to activate your Pro license and unlock all premium features:

1. Install the free plugin — Install and activate the free Magical Shop Builder plugin from WordPress.org or upload it manually.
2. Install the Pro add-on — Install and activate the Magical Shop Builder Pro add-on plugin (provided after purchase).
3. Navigate to the dashboard — Go to Magical Shop Builder > Dashboard in your WordPress admin.
4. Enter your license key — Locate the License section on the dashboard and paste your license key.
5. Click “Activate License” — Click the activation button to validate and activate your key.

License Management via REST API

Pro license status can also be managed programmatically through the REST API:

GET    /wp-json/mpd/v1/license    // Check current license status
POST   /wp-json/mpd/v1/license    // Activate a license key
DELETE /wp-json/mpd/v1/license    // Deactivate the current license

Upgrade to Pro