Search by

lubusin / composer-edd-plugin

ajitbohra

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!

lubusIN

Statistics

Installs: 319

Dependents: 0

Suggesters: 0

Stars: 15

Open Issues: 0

v2.0.1 2026-11-17 06:04 UTC

This package is auto-updated.

Last update: 2026-11-17 06:09:45 UTC


README

Composer EDD Plugin Logo

Latest Version on Packagist GitHub Tests Action Status Total Downloads License

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 for composer require.
  • version: Version to install.
  • type: Package type (wordpress-plugin or wordpress-theme).
  • dist.url: Product store URL.
  • extra.edd_installer: Set to true to 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 to item_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 like https://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_name or item_id matches 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

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.