Obtaining the Online Store URL Correctly
In order to direct extension users to the online store that sells licenses for this extension, the link to the online store is placed on the screens of the extension. For an example, see the “License required” messages in section “Available Licensing Models”. Resellers or Service providers may choose to manipulate this link depending on how they wish to sell licenses to their customers (see the Administrator’s Guide section “Reselling extensions” for information). Therefore, it is important know how to correctly provide and obtain the online store URL that is actual for this specific Plesk installation.
- Do not hardcode the specific online store URL into the extension GUI.
- Use the buy_url property in the meta.xml file
to provide the online store URL. For example, extensions sold through
Plesk Online Store have in their
meta.xml
files the following entry:<buy_url>https://go.plesk.com/buy-plesk-ext/</buy_url>
- Use the appropriate SDK methods to retrieve this URL.
Obtaining License Purchase URL
Use the pm_Context::getBuyUrl() method to get the actual online store URL.
Plesk will generate a URL similar to this:
https://go.plesk.com/buy-plesk-ext/example?kn=PLSK.00000001.0000&buyUrlCoupon=happyHacking
Obtaining License Upgrade URL
When implementing Multiple Offers licensing, you will need to provide a user with directions to where they can upgrade their license, if they need. Use the pm_Context::getUpgradeLicenseUrl() method to obtain the actual URL for upgrading the current extension’s license.
Plesk will generate a URL similar to this:
https://go.plesk.com/buy-plesk-ext/example?kn=PLSK.00000001.0000&ekn=123456&a=upgrade
The time when to present the user with the invitation to upgrade the license is up to the developer. Usually, it is done when one or several of the corresponding resource limits are either depleted or nearing depletion.