Docs
Wire it up yourself
Guides for the BeatStore Player Plugin, BeatStore Contracts, and UI Theme. The same structure as the live docs, rebuilt for this site.
01
BeatStore WordPress Plugin
BeatStore 4.x: install the player, pick EDD or Woo, add beats, place the player, and use the REST catalog on your domain.
- Introduction: WordPress HostingBeatStore 4.x needs WordPress 6.5+, PHP 8.1+, and hosting that can serve audio.
- InstallationUpload the 4.x zip, activate Freemius, then activate Easy Digital Downloads or WooCommerce.
- Getting Started / SetupPermalinks, BeatStore → Settings, Place Player, and EDD/Woo payment gateways.
- eCommerce Plugin SelectionActivate Easy Digital Downloads or WooCommerce — exactly one. 4.x picks the backend automatically unless both are active.
- Add New Music / BeatsCreate an EDD download or Woo product, then fill the BeatStore metabox (preview, BPM, key, kind, licenses).
- Merchandise & physical productsSell merch alongside beats: use WooCommerce or EDD shop pages, and hide non-audio products from the BeatStore player.
- Playlists & orderOrder a subset of beats with BeatStore → Playlists. Default catalog order is menu_order.
- PlayerThe BeatStore player via [beatstore], the BeatStore Player block, Place Player, and /beatstore-embed/.
- FiltersListeners filter by kind, genre, mood, BPM, and search. Label beats with the BeatStore taxonomies.
- SoundCloud audio previewsConnect Client ID and Secret under BeatStore → Integrations, then paste a public track permalink on the beat.
- Dropbox audio previewsPaste a Dropbox share link on the beat. 4.x rewrites www.dropbox.com to dl.dropboxusercontent.com.
- Protect uploaded previewsPreview links expire. Your uploads folder does not get a permanent MP3 URL.
- IntegrationsMailchimp free-download gate, SoundCloud previews, Dropbox share links. Credentials live in WordPress options.
- AnalyticsPlays leaderboard, country map, and free-download stats in BeatStore → Analytics, plus optional Google Analytics / GTM play events.
- Block Editor + ElementorInsert the BeatStore Player block, or paste [beatstore] in Elementor’s Shortcode widget.
- REST APIYour catalog is a REST API on your domain. Same endpoints the BeatStore player uses.
- PHP HooksFilters and actions for themes and add-ons on the same WordPress install. Parameters, return values, and examples.
- Upgrading from 3.xKeep download/product IDs. Run BeatStore → Import (dry run, then write). Widget 3 features that did not come forward.
- TroubleshootingPHP 8.1, permalinks, CORS, SoundCloud, Mailchimp free download, Dropbox share links, protected previews, and 3.x import.
- Code Snippets3.x snippets (Woo single player, iframe cart postMessage, SameSite cart cookies) do not apply to 4.x. Use REST and PHP hooks.
02
BeatStore Contracts
Fill a private license-agreement PDF after an EDD or Woo sale. Templates map onto offers you already sell. A player key does not unlock PDFs.
- InstallationUpload the BeatStore Contracts zip, enter the Freemius key, then keep EDD or Woo as the catalog.
- Templates and offer mappingCreate agreement templates, set default amounts, and map each one onto an EDD price or Woo license. With the player, pick the PDF on the license row.
- Checkout agree and addressBuyers must accept the terms and enter a legal address before the order is placed.
- After purchaseA private PDF is written once per order line and emailed as a token download.
- Upgrading from Licenses & ContractsKeep your 13660 or 9802 key. Deactivate the old plugin. Templates and maps copy on activate.
- PlaceholdersTokens replaced in the contract HTML when the PDF is filled.