lubusin / composer-edd-plugin
Composer plugin for installing pro plugins powered by EDD software licensing
Package info
github.com/lubusIN/composer-edd-plugin
Type:composer-plugin
pkg:composer/lubusin/composer-edd-plugin
Fund package maintenance!
Requires
- php: >=7.4
- composer-plugin-api: ^2.0
- vlucas/phpdotenv: ^5.6
Requires (Dev)
- composer/composer: ^2.0
- phpstan/phpstan: ^1.10 || ^2.0
- phpunit/phpunit: ^9.6 || ^10.5 || ^11.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-17 06:09:45 UTC
README
Introduction
Composer EDD Plugin allows installing and updating commercial WordPress plugins and themes powered by Easy Digital Downloads and the Software Licensing add-on via Composer.
Requirements
- PHP >= 7.4
- Composer >= 2.0
Installation
composer require lubusin/composer-edd-plugin
Usage
Step 1: Add package to composer.json
Add the product to the repositories array in your composer.json:
{
"repositories": [
{
"type": "package",
"package": {
"name": "namespace/edd-product-name",
"version": "1.2.3",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.productwebsite.com"
},
"extra": {
"edd_installer": true,
"item_name": "Product Name",
"license_var": "PRODUCT_LICENSE",
"url_var": "PRODUCT_ACTIVATION_URL"
}
}
}
]
}
Package configuration options:
name: Package name you will use forcomposer require.version: Version to install.type: Package type (wordpress-pluginorwordpress-theme).dist.url: Product store URL.extra.edd_installer: Set totrueto enable EDD licensing.extra.item_name: Name of the product in the EDD store (e.g."Product Name").extra.item_id: Numeric item ID in the EDD store (e.g.12345). Can be used instead of or in addition toitem_name.extra.license_var: Name of the environment variable storing your license key.extra.url_var: Name of the environment variable storing your site URL (or a direct URL likehttps://example.com).
Note
Some EDD stores identify products by numeric item_id rather than name. You can supply item_id, item_name, or both in extra.
Step 2: Set environment variables
Add the license and site URL to your .env file (any .env* variant such as .env.local, .env.secret, or .env.staging is automatically discovered and supported) or set them in your server/CI environment:
PRODUCT_LICENSE=your-license-key PRODUCT_ACTIVATION_URL=https://yourwebsite.com
Step 3: Install the package
composer require namespace/edd-product-name
Optional: Private stores with HTTP Basic Authentication
If the vendor store sits behind HTTP Basic Auth, add your credentials in auth.json:
{
"http-basic": {
"www.productwebsite.com": {
"username": "your-username",
"password": "your-password"
}
}
}
Troubleshooting
Insecure HTTP connection
[Composer\Downloader\TransportException]
Your configuration does not allow connections to http://www.productwebsite.com.
If the EDD store serves files over HTTP instead of HTTPS, allow it in composer.json:
{
"config": {
"secure-http": false
}
}
Licensing errors
If the EDD store rejects the license request, the error message returned by the store is shown:
EDD Error for package "namespace/edd-product-name": Your license key for this product has expired.
Check that:
- The license key is active.
- The activation URL matches the site registered on the vendor store.
- The
item_nameoritem_idmatches the vendor's product.
Development
composer test # Run PHPUnit test suite composer phpstan # Run static analysis composer check # Run both tests and analysis
Support & Contributions
Composer EDD Plugin is a free and open-source project maintained by LUBUS.
- Bugs & Feature Requests: Please open an issue in the GitHub Issue Tracker.
- Contributions: Contributions are welcome! Please review CONTRIBUTING.md before submitting pull requests.
- Commercial Support: If your organization needs dedicated assistance, custom implementation, or priority support, get in touch with LUBUS.
Security
Please do not report security vulnerabilities publicly. If you identify a security issue, contact us privately at https://lubus.in/contact-us.
Special Mentions
- Inspiration: polylang/polylang#3
- Motivation: @szepeviktor | polylang/polylang#3 (comment)
- Beta testing: @nirbhay & @ideabox
- Code inspiration:
Meet Your Artisans
LUBUS is a web design and engineering agency based in Mumbai.
License
Composer EDD Plugin is open-sourced software licensed under the MIT license.