← Back to overview
OPEN SOURCE WordPress Plugin v1.1.5 GPLv2

MerchManager

WordPress plugin for bands and music artists to manage merchandise sales during tours and events. Built from 20+ years of experience in the European merchandise industry and given away for free to the music community.

93%
PHP
1.1.5
Version
526K
Lines of Code
20+
Doc Files

The story

Richard (Theuws Consulting) has spent more than 20 years running a European merchandise company and has always helped bands with their merchandise management. With MerchManager he hopes to help many more bands run their merch in a simple, professional way — without having to pay for yet another tool.

This is not a commercial project. There is no paid version and there never will be. In a world where everyone wants to make money off bands, this plugin is built with AI assistance and given away for free. Everyone is welcome to use it, fork it, improve it, or contribute.

Features

Everything a band needs to manage merch professionally.

Multi-band Support

Manage merchandise for multiple bands at once. Ideal for managers and labels representing multiple artists.

Tour & Show Management

Create tours, plan shows, and link sales to specific dates and venues. Complete overview of your tour schedule.

Inventory & Stock

Track stock levels in real-time, receive low-stock alerts and export reorder lists. Never run out unexpectedly.

Sales Tracking

Register sales and link them to tours and venues. See instantly which merch sells best per show.

Dynamic Sales Pages

Generate temporary sales pages for events with access codes. Fans can order merch while at the show.

Reports & CSV Export

Detailed sales and inventory reports with CSV export. Data integrity checks ensure reliable numbers.

Onboarding Wizard

5-step setup wizard for new users. Operational within 5 minutes with your first band, tour and merchandise.

Demo Data

One-click creation of sample data: band, tours, shows, merchandise and sales. Perfect for getting to know the plugin.

Mobile-First Design

Responsive design optimized for mobile use. Touch targets minimum 44px, stacked layouts on small screens.

WordPress.org Ready

Meets all WordPress.org Plugin Check requirements. Proper escaping, i18n support and security best practices.

Tech Stack

Built on proven technology.

Backend

PHP 7.4+ met WordPress hooks, Custom Post Types, prepared SQL queries

Frontend

CSS (3.1%) + JavaScript (2.7%), responsive admin UI

Database

MySQL 5.6+, custom tables met foreign keys en data-integriteitscontroles

Testing

PHPUnit, Playwright, Cypress. Unit tests, integration tests en E2E

Development

Docker + docker-compose voor lokale dev omgeving, Composer, npm

Security

Nonce verificatie, prepared statements, proper escaping, Plugin Check compliant

Requirements

WordPress 6.2 or later
PHP 7.4 or later
MySQL 5.6 or later
Browser Chrome, Firefox, Safari, Edge

Installation

Two ways to install MerchManager.

1

Download the plugin

Download the ZIP file from GitHub or search for "MerchManager" in the WordPress plugin directory.

2

Upload via WordPress

Go to Plugins → Add New → Upload Plugin and select the ZIP file. Click "Install Now".

3

Activate the plugin

Click "Activate Plugin" after installation.

4

Follow the onboarding wizard

The wizard helps you set up your first band, tour and merchandise. Operational within 5 minutes.

Or install manually via WP-CLI:

# Download and activate wp plugin install merchmanager --activate

Project Structure

Overview of the repository architecture.

merchmanager/ ├── admin/ Admin-specifieke functionaliteit │ ├── css/ Admin stylesheets │ ├── js/ Admin JavaScript │ ├── partials/ Admin view templates │ └── class-admin.php Admin class ├── includes/ Core plugin functionaliteit │ ├── post-types/ Custom post type definities │ │ └── models/ Data models │ └── services/ Business logic services ├── public/ Publieke functionaliteit ├── languages/ Vertaalbestanden ├── assets/ Iconen en branding ├── docs/ 20+ documentatiebestanden ├── tests/ PHPUnit + Playwright + Cypress ├── merchmanager.php Plugin bootstrap ├── uninstall.php Cleanup bij verwijderen ├── readme.txt WordPress.org listing └── docker-compose.yml Docker dev omgeving

Version History

Recent releases and changes.

Version Highlights
1.1.5 Final audit documentatie, UAT feedback loop
1.1.4 P2 features: Excel export, responsive, low stock alerts, tooltips
1.1.3 P0 failsafe (report data integrity), P1 security (onboarding)
1.1.0 Security WARNINGs fixed, nonce verificatie
1.0.3 Onboarding wizard, demo data, empty states, CSV export
1.0.0 Eerste release: CPTs, roles, sales, stock, CSV, rapportages

Contributing

MerchManager is open source and welcomes contributions from everyone.

License: GNU General Public License v2.0 · Tags: merchandise, sales, bands, music, inventory, tours