Download the PHP package groupone/marketplace without Composer

Marketplace Module

A reusable WordPress plugin module for managing and displaying a marketplace of plugins with a React frontend and PHP backend. Designed to be embedded into other plugins while providing install/activate functionality and a REST API.

Table of Contents

• Features
• Requirements
• Installation with Mozart
• Configuration Options
• Assets Path Configuration
• How It Works
• Asset Copying

Features

• React-based frontend for displaying plugin listings
• Backend PHP controller & model to handle API requests and install/activate actions
• Works inside WordPress Admin and can be used in React apps
• REST API endpoint for fetching plugin data
• Flexible CSS loading – custom or default styles
• Composer-ready with PSR-4 autoloading
• Mozart-compatible for distribution and wrapping namespaces to avoid conflicts

Requirements

• PHP >= 7.4
• WordPress >= 6.2
• Composer (for development and building)
• Mozart (for wrapping namespaces and copying assets)

Installation with Mozart (Recommended for Distributable Plugins)

This module is designed to work when your plugin uses the Mozart tool to prefix namespaces and copy assets at build time.

Step-by-step

1) Add repository details (under repositories) and other dependencies to your plugin's composer.json

Note: Example of a complete composer.json (replace YourPlugin with your plugin's namespace and path incopy-assets where you want to copy assets ):

2) Install dependencies and run Mozart

When adding this module to a plugin that already has a composer.json and composer.lock:

• First time (after adding the dependency): run composer update groupone/marketplace to update your lock file and install the package. You can also run composer update if you want to update all dependencies.
• On CI or environments using an existing lock file: run composer install.

Either command will trigger the defined Composer scripts (mozart-compose and copy-assets).

Examples:

3) Bootstrap the module in your plugin code(replace YourPlugin with your plugin's namespace)

Configuration Options

• parent_menu_slug: WordPress menu slug under which the module submenu will be added. Default: options-general.php
• page_title: Page title for the Marketplace screen. Default: Plugin Marketplace
• menu_title: Menu title for the submenu. Default: Marketplace
• menu_slug: Slug used for the submenu and page. Default: plugin-marketplace
• addons_menu_slug: Slug used for the addons submenu and page. Default: onecom-marketplace-products
• addons_page_title: Page title for the your add-ons screen. Default: Marketplace Products
• addons_menu_title: Menu title for the your add-ons submenu. Default: Your add-ons
• api_url: External API endpoint returning marketplace data. Default: ""
• brand: Optional brand identifier used when constructing marketplace API requests. Can be used to filter or customize marketplace content based on brand. Default: ""
• payload: Optional key-value array passed in the request body for API authentication when fetching plugins. Can be used to include authentication tokens, API keys, or other custom data required by the marketplace API. Default: []
• css_url: URL to a custom CSS file that styles the frontend. Default: ""
• css_handle: WordPress style handle when registering/enqueuing styles. Default: marketplace-frontend-style
• assets_path: Filesystem path to the package root containing the frontend/ directory. If empty, the module auto-detects it (see below).
• register_menu: Boolean flag to control automatic menu registration. Set to false to skip menu registration when your plugin handles it manually (prevents duplicate menus). Default: true
• mixp_props: Optional key-value array for custom Mixpanel properties. Used to send additional tracking data. Including 'is_sandbox' => true will switch the tracking to the sandbox Mixpanel project. Default: []
• mixp_distinct_id: Optional string for Mixpanel tracking to identify a unique user. Default: ""
• data_consent_status: Boolean flag for user data consent. Controls whether tracking is enabled. Default: false

Assets Path Configuration

• Explicit: Pass assets_path in the config.(optional) if you are not following the path as mentioned in composer json & moved assets to a custom path Example:

How It Works

When booted, the module:

• Registers a submenu page under the provided parent_menu_slug
• Enqueues the React frontend (frontend/build assets)
• Localizes configuration and labels to JavaScript
• Registers a REST route at /wp-json/marketplace/v1/plugins
• Provides AJAX handlers to install, activate, and deactivate plugins

Asset Copying

How to reference assets

• If you keep the default structure suggested in the example composer.json, assets_path can be omitted because auto-detection will locate the package root.
• If you move files to a custom location, pass assets_path explicitly so the module can find frontend/build/index.js and related files.