A Composer plugin that makes it easy to install commercial WordPress plugins.
Sensitive credentials (license keys, tokens) are read from environment variables or a .env
file.
- Advanced Custom Fields Pro
- Ninja Forms Add-Ons
- Gravity Forms / Add-Ons
- Polylang Pro
- PublishPress Pro
- Advanced Custom Fields Extended Pro
- WP All Import / Export Pro / Add-Ons
- WPML
⚠️ Note: Most EDD plugins, and Gravity Forms, only allow downloading the latest versions of their plugins, even if you request for a specific version.
- Packages must use the names defined below otherwise they are ignored by this plugin.
- When installing or updating a package, the package version is appended to the dist URL.
This versioned dist URL is used as the cache key to store ZIP archives of the package.
In Composer 1, the versioned dist URL is added to
composer.lock
. - Before downloading the package, the package's real download URL is retrieved and formatted
with their corresponding environment variables, as defined below.
Environment variables will never be stored inside
composer.lock
. - If an environment variable can't be resolved, the download will fail and Composer will abort.
This Composer plugin requires Composer:
- 1.0.0 and newer, or
- 2.0.2 and newer
- 2.3+ IMPORTANT: Make sure to add trailing slashes to packages'
dist
URL as below. More info: junaidbhura#34
Create a .env
file in the root of your WordPress site, where the composer.json
file lives,
which has all the license keys and settings:
ACF_PRO_KEY="<acf_pro_license_key>"
ACFE_PRO_KEY="<acf_extended_pro_license_key>"
ACFE_PRO_URL="<registered_url_for_acf_extended_pro>"
GRAVITY_FORMS_KEY="<gravity_forms_license_key>"
NINJA_FORMS_KEY="<ninja_forms_membership_license_key>"
NINJA_FORMS_URL="<registered_url_for_ninja_forms_membership>"
NINJA_FORMS_<addon_slug>_KEY="<ninja_forms_addon_license_key>"
NINJA_FORMS_<addon_slug>_URL="<registered_url_for_ninja_forms_addon>"
POLYLANG_PRO_KEY="<polylang_pro_license_key>"
POLYLANG_PRO_URL="<registered_url_for_polylang_pro>"
PUBLISHPRESS_PRO_KEY="<publishpress_pro_membership_license_key>"
PUBLISHPRESS_PRO_URL="<registered_url_for_publishpress_pro_membership>"
PUBLISHPRESS_<plugin_slug>_PRO_KEY="<publishpress_pro_license_key>"
PUBLISHPRESS_<plugin_slug>_PRO_URL="<registered_url_for_publishpress_pro>"
WP_ALL_IMPORT_PRO_KEY="<wp_all_import_license_key>"
WP_ALL_IMPORT_PRO_URL="<registered_url_for_wpai_pro>"
WP_ALL_EXPORT_PRO_KEY="<wp_all_export_license_key>"
WP_ALL_EXPORT_PRO_URL="<registered_url_for_wpae_pro>"
WPML_USER_ID="<wpml_user_id>"
WPML_KEY="<wpml_key>"
Add the following to your composer.json file:
"repositories": [
{
"type": "package",
"package": {
"name": "junaidbhura/acf-extended-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.acf-extended.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/advanced-custom-fields-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.advancedcustomfields.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/gravityforms",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.gravityforms.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/gravityformspolls",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.gravityforms.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/ninja-forms-uploads",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://ninjaforms.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/polylang-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.polylang.pro/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/publishpress-planner-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://publishpress.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wp-all-import-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.wpallimport.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wp-all-export-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.wpallimport.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wpai-acf-add-on",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.wpallimport.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wpae-acf-add-on",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.wpallimport.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wpae-user-add-on-pro",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://www.wpallimport.com/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wpml-sitepress-multilingual-cms",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://wpml.org/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
},
{
"type": "package",
"package": {
"name": "junaidbhura/wpml-string-translation",
"version": "<version_number>",
"type": "wordpress-plugin",
"dist": {
"type": "zip",
"url": "https://wpml.org/"
},
"require": {
"junaidbhura/composer-wp-pro-plugins": "*"
}
}
}
],
"require": {
"junaidbhura/acf-extended-pro": "*",
"junaidbhura/advanced-custom-fields-pro": "*",
"junaidbhura/gravityforms": "*",
"junaidbhura/gravityformspolls": "*",
"junaidbhura/ninja-forms-uploads": "*",
"junaidbhura/polylang-pro": "*",
"junaidbhura/publishpress-planner-pro": "*",
"junaidbhura/wp-all-import-pro": "*",
"junaidbhura/wp-all-export-pro": "*",
"junaidbhura/wpai-acf-add-on": "*",
"junaidbhura/wpae-acf-add-on": "*",
"junaidbhura/wpae-user-add-on-pro": "*",
"junaidbhura/wpml-sitepress-multilingual-cms": "*",
"junaidbhura/wpml-string-translation": "*"
}
You can use any Gravity Forms add-on by simply adding it's slug like so:
junaidbhura/<plugin-slug>
For example:
junaidbhura/gravityformspolls
Consult the list of all Gravity Forms add-on slugs
You can use any Ninja Forms add-on by simply adding it's slug like so:
junaidbhura/ninja-forms-<addon-slug>
The following add-ons are supported:
Package name | Environment variables |
---|---|
junaidbhura/ninja-forms-activecampaign |
NINJA_FORMS_ACTIVECAMPAIGN_<key_or_url> |
junaidbhura/ninja-forms-advanced-datepicker |
NINJA_FORMS_ADVANCED_DATEPICKER_<key_or_url> |
junaidbhura/ninja-forms-authorize-net |
NINJA_FORMS_AUTHORIZE_NET_<key_or_url> |
junaidbhura/ninja-forms-aweber |
NINJA_FORMS_AWEBER_<key_or_url> |
junaidbhura/ninja-forms-campaign-monitor |
NINJA_FORMS_CAMPAIGN_MONITOR_<key_or_url> |
junaidbhura/ninja-forms-capsule-crm |
NINJA_FORMS_CAPSULE_CRM_<key_or_url> |
junaidbhura/ninja-forms-civicrm |
NINJA_FORMS_CIVICRM_<key_or_url> |
junaidbhura/ninja-forms-cleverreach |
NINJA_FORMS_CLEVERREACH_<key_or_url> |
junaidbhura/ninja-forms-clicksend |
NINJA_FORMS_CLICKSEND_<key_or_url> |
junaidbhura/ninja-forms-conditional-logic |
NINJA_FORMS_CONDITIONAL_LOGIC_<key_or_url> |
junaidbhura/ninja-forms-constant-contact |
NINJA_FORMS_CONSTANT_CONTACT_<key_or_url> |
junaidbhura/ninja-forms-convertkit |
NINJA_FORMS_CONVERTKIT_<key_or_url> |
junaidbhura/ninja-forms-elavon |
NINJA_FORMS_ELAVON_<key_or_url> |
junaidbhura/ninja-forms-emailoctopus |
NINJA_FORMS_EMAILOCTOPUS_<key_or_url> |
junaidbhura/ninja-forms-emma |
NINJA_FORMS_EMMA_<key_or_url> |
junaidbhura/ninja-forms-excel-export |
NINJA_FORMS_EXCEL_EXPORT_<key_or_url> |
junaidbhura/ninja-forms-help-scout |
NINJA_FORMS_HELP_SCOUT_<key_or_url> |
junaidbhura/ninja-forms-hubspot |
NINJA_FORMS_HUBSPOT_<key_or_url> |
junaidbhura/ninja-forms-insightly |
NINJA_FORMS_INSIGHTLY_<key_or_url> |
junaidbhura/ninja-forms-layout-styles |
NINJA_FORMS_LAYOUT_STYLES_<key_or_url> |
junaidbhura/ninja-forms-mailchimp |
NINJA_FORMS_MAILCHIMP_<key_or_url> |
junaidbhura/ninja-forms-mailpoet |
NINJA_FORMS_MAILPOET_<key_or_url> |
junaidbhura/ninja-forms-multi-step |
NINJA_FORMS_MULTI_STEP_<key_or_url> |
junaidbhura/ninja-forms-onepagecrm |
NINJA_FORMS_ONEPAGECRM_<key_or_url> |
junaidbhura/ninja-forms-paypal-express |
NINJA_FORMS_PAYPAL_EXPRESS_<key_or_url> |
junaidbhura/ninja-forms-pdf-submissions |
NINJA_FORMS_PDF_SUBMISSIONS_<key_or_url> |
junaidbhura/ninja-forms-pipeline-crm |
NINJA_FORMS_PIPELINE_CRM_<key_or_url> |
junaidbhura/ninja-forms-post-creation |
NINJA_FORMS_POST_CREATION_<key_or_url> |
junaidbhura/ninja-forms-recurly |
NINJA_FORMS_RECURLY_<key_or_url> |
junaidbhura/ninja-forms-salesforce |
NINJA_FORMS_SALESFORCE_<key_or_url> |
junaidbhura/ninja-forms-save-progress |
NINJA_FORMS_SAVE_PROGRESS_<key_or_url> |
junaidbhura/ninja-forms-scheduled-exports |
NINJA_FORMS_SCHEDULED_EXPORTS_<key_or_url> |
junaidbhura/ninja-forms-slack |
NINJA_FORMS_SLACK_<key_or_url> |
junaidbhura/ninja-forms-stripe |
NINJA_FORMS_STRIPE_<key_or_url> |
junaidbhura/ninja-forms-trello |
NINJA_FORMS_TRELLO_<key_or_url> |
junaidbhura/ninja-forms-twilio |
NINJA_FORMS_TWILIO_<key_or_url> |
junaidbhura/ninja-forms-uploads |
NINJA_FORMS_UPLOADS_<key_or_url> |
junaidbhura/ninja-forms-user-analytics |
NINJA_FORMS_USER_ANALYTICS_<key_or_url> |
junaidbhura/ninja-forms-user-management |
NINJA_FORMS_USER_MANAGEMENT_<key_or_url> |
junaidbhura/ninja-forms-webhooks |
NINJA_FORMS_WEBHOOKS_<key_or_url> |
junaidbhura/ninja-forms-zapier |
NINJA_FORMS_ZAPIER_<key_or_url> |
junaidbhura/ninja-forms-zoho |
NINJA_FORMS_ZOHO_<key_or_url> |
You can use any PublishPress Pro plugins by simply adding it's slug like so:
junaidbhura/<plugin-slug>
The following plugins are supported:
Package name | Environment variables |
---|---|
junaidbhura/publishpress-authors-pro |
PUBLISHPRESS_AUTHORS_PRO_<key_or_url> |
junaidbhura/publishpress-blocks-pro |
PUBLISHPRESS_BLOCKS_PRO_<key_or_url> |
junaidbhura/publishpress-capabilities-pro |
PUBLISHPRESS_CAPABILITIES_PRO_<key_or_url> |
junaidbhura/publishpress-checklists-pro |
PUBLISHPRESS_CHECKLISTS_PRO_<key_or_url> |
junaidbhura/publishpress-future-pro |
PUBLISHPRESS_FUTURE_PRO_<key_or_url> |
junaidbhura/publishpress-permissions-pro |
PUBLISHPRESS_PERMISSIONS_PRO_<key_or_url> |
junaidbhura/publishpress-planner-pro |
PUBLISHPRESS_PLANNER_PRO_<key_or_url> |
junaidbhura/publishpress-revisions-pro |
PUBLISHPRESS_REVISIONS_PRO_<key_or_url> |
junaidbhura/publishpress-series-pro |
PUBLISHPRESS_SERIES_PRO_<key_or_url> |
You can use any WP All Import Pro add-on by simply adding it's slug like so:
junaidbhura/<plugin-slug>
For example:
junaidbhura/wpai-acf-add-on
You can use any WP All Export Pro add-on by simply adding it's slug like so:
junaidbhura/<plugin-slug>
For example:
junaidbhura/wpae-acf-add-on
You can use any WPML add-on by simply adding it's slug like so:
junaidbhura/wpml-<addon-slug>
The following add-ons are supported:
junaidbhura/wpml-acfml
junaidbhura/wpml-all-import
junaidbhura/wpml-buddypress-multilingual
junaidbhura/wpml-cms-nav
junaidbhura/wpml-contact-form-7-multilingual
junaidbhura/wpml-gravityforms-multilingual
junaidbhura/wpml-mailchimp-for-wp
junaidbhura/wpml-media-translation
junaidbhura/wpml-ninja-forms
junaidbhura/wpml-sticky-links
junaidbhura/wpml-string-translation
junaidbhura/wpml-translation-management
junaidbhura/wpml-types
junaidbhura/wpml-woocommerce-multilingual
junaidbhura/wpml-wp-seo-multilingual
junaidbhura/wpml-wpforms