Shortly - when I tried to create plugin’s [Check for Update] and [Validate Purchase Code] feature-buttons in the plugin myself and I saw the code quality and complexity of the WordPress - Envato Market plugin, that is released by Envato, I was shocked how badly it is written and how you should not to code. So, instead of being sad, or just a telling a criticism and suggesting Envato to send that plugin developer to coding campus ASAP, I decided to help all authors and re-develop WordPress - Envato Market and deprecated Wordpress Envato Toolkit plugins, and create a new one Envato Toolkit plugin for WordPress, that is lightweight, easy to edit, based on standards and high quality code paradigms (PSR-2, PSR-4 autoloaders, D.R.Y, K.I.S.S.), and most important - scalable.
So I’m releasing the new API code libraries (standalone) and a version of them in a MVP-like plugin - NOW. And I’m giving this to everyone, under the best, almost unlimited - MIT license, to use it’s code anyhow you want for both - unlimited free or unlimited commercial use. Also, I do really hope that Envato team will accept this plugin donation, as a revamp of the original Wordpress Envato Toolkit, because - trust me on this - I do know how hard is currently for authors to accomplish 5 simple tasks to their plugin by using Envato Edge / Market API:
- customer’s purchase code validation,
- check of customer’s support expiration date (by just having a simple string in plugin’s admin page of it’s license support status - is it already expired or not yet),
- have a
[Check for Update]button in plugin admin, - get a newest available plugin’s / theme’s version number,
- a get a download link displayed for to the new plugin’s / theme’s version (without leaving WordPress admin, installing and keeping updated other plugins, or going and checking Envato website)
It is pretty much - IMPOSIBLE - with what currently Envato gives, or by trying to understand the code of WordPress - Envato Market. Or you have to dedicate a whole team work for a whole week only for these simple tasks. So I really hope, that finally authors can add these mandatory features within one day, by just taking the code of 3 libraries I’m releasing today. And for those who want to start even easier, I made a these libraries version with include to a small, MVP-like, WordPress plugin.
Envato Toolkit - Reborn
GitHub / Download Link (Standalone): https://github.com/KestutisIT/EnvatoToolkit
WordPress plugin (w.org):
https://wordpress.org/plugins/toolkit-for-envato/
It is a 3 files library + Visual UI, to validate the purchase codes of your customers,
get details about specific Envato user (country, city, total followers, total sales, avatar),
get his license purchase and support expiration dates, license type he bought,
check for updates of purchased plugins and themes and get the download links for them.
Plus - this library has Envato Item Id search feature by providing plugin’s or theme’s name and author. So - yes, this is a tool you, as a developer / author, have been looking for months.
The main purpose of this plugin is to help you to start much easier without having a headache
trying to understand WordPress - Envato Market plugins code, that is the only one built by Envato,
and has so complicated and unclear code, that you never get how it works (see example below).
For example - you would like to give an error message, if Envato user token is empty,
which is a required string, i.e. - pAA0aBCdeFGhiJKlmNOpqRStuVWxyZ44.
If you like K.I.S.S., PSR-2, D.R.Y., clean code coding standards and paradigms,
you’d probably just have these five lines of code, so that every developer would get it:
$token = get_user_meta(get_current_user_id(), 'envato_token', TRUE);
if($token == "")
{
return new \WP_Error('api_token_error', __('An API token is required.', 'envato-toolkit'));
}
Now lets see how the same task traceback looks like in WordPress - Envato Market plugin:
-
[Api.php -> request(..)]Check if the token is empty:if ( empty( $token ) ) { return new WP_Error( 'api_token_error', __( 'An API token is required.', 'envato-market' ) ); } -
[Api.php -> request(..)]Parse it from another string:$token = trim( str_replace( 'Bearer', '', $args['headers']['Authorization'] ) ); -
[Api.php -> request(..)]Parse it one more time - this time from arguments array:public function request( $url, $args = array() ) { $defaults = array( 'timeout' => 20, ); $args = wp_parse_args( $args, $defaults ); } -
[Api.php -> download(..)]Transfer the token variable one more time - this time via params:class Envato_Market_API { public function download( $id, $args = array() ) { $url = 'https://api.envato.com/v2/market/buyer/download?item_id=' . $id . '&shorten_url=true'; return $this->request( $url, $args ); } } -
[admin.php -> maybe_deferred_download(..)]Pass it again - this time get it to args array from another method call:function maybe_deferred_download( $options ) { $args = $this->set_bearer_args(); $options['package'] = envato_market()->api()->download( $vars['item_id'], $args ); return $options; } -
[admin.php -> set_bearer_args(..)]Wrap the token into multi-dimensional string array:
`` `
$args = array(
‘headers’ => array(
‘Authorization’ => 'Bearer ’ . $token,
),
); -
[admin.php -> set_bearer_args(..)]Pass the wrapped token one more time - this time get it from get_option:foreach ( envato_market()->get_option( 'items', array() ) as $item ) { if ( $item['id'] === $id ) { $token = $item['token']; break; } } -
[admin.php -> get_option(..)]So what’s in thisget_option? - Correct, another call to another method -get_options():public function get_option( $name, $default = '' ) { $options = self::get_options(); $name = self::sanitize_key( $name ); return isset( $options[ $name ] ) ? $options[ $name ] : $default; } -
[admin.php -> get_options()]Finally, after almost 10 steps in the tree, we are finally getting the original WordPress method call, but now I’m getting confused again - what is thatoption_namevariable here:public function get_options() { return get_option( $this->option_name, array() ); } -
[envato-market.php -> init_globals()]Here is it is - theoption namekey name is… Oh wait… No it is not here it. It is equals to another variable, who is is put in another clean-up function - look like I’m keep seeing this for the 2 time in the tree - the sanitization of sanitization:$this->option_name = self::sanitize_key( $this->slug ); -
[envato-market.php -> init_globals()]So theoption namekey name is the name of$this->slug. Now lets see what is the value of$this->slug:$this->slug = 'envato-market';
So it takes eleven (!) steps to understand one variable. And the whole code of that plugin is like that.
The example above was the headache I had, until I realized that I must write a new Envato API Management Toolkit,
instead of trying to use what Envato is giving, because otherwise I won’t get anything working ever.
And, I believe, that many other developers had the same issue when tried to create update check feature
for their plugins or themes.
So instead of using that library for myself, I decided that I want to help all these developers to save their time,
and I’m sharing this code with you. I’m releasing it under MIT license, which allows you to use this code
in your plugin without any restrictions for both - free and commercial use.
Plus - I’m giving a promise to you, that this plugin is and will always be 100% free, without any ads,
‘Subscribe’, ‘Follow us’, ‘Check our page’, ‘Get Pro Version’ or similar links.
If you created in hi-quality code a valuable additional functionality to the library and you want to share it
with everyone - I’m open here to support your efforts, and add your code to the plugin’s library,
so that we all together make this plugin better for authors - the better is the plugin,
the better plugins authors will make for their customers. The better quality products we will have on the internet,
the happier people will be all over the world.
Finally - the code is poetry - the better is the plugin, the happier is the world.
The pseudo-code of example output of the plugin is this:
Details about you:
----------------------------------------------------------
List of all different plugins you bought:
<?php foreach($plugins AS $pluginId => $plugin): ?>
<?='Plugin Id: '.$pluginId.', Name: '.$plugin['name'];?>, Licenses:
<?php foreach($plugin['licenses'] AS $license): ?>
Code: <?=$license['purchase_code'];?>,
Type: <?=$license['license_type'];?>,
Purchased: <?=$license['license_purchase_date'];?>,
Expires: <?=$license['support_expiration_date'];?>
Support Status: <?=$license['support_active'];?>
<?php endforeach; ?>
<?php endforeach; ?>
List of all different themes you bought:
<?php foreach($themes AS $themeId => $theme): ?>
<?='Theme Id: '.$themeId.', Name: '.$theme['name'];?>, Licenses:
<?php foreach($theme['licenses'] AS $license): ?>
Code: <?=$license['purchase_code'];?>,
Type: <?=$license['license_type'];?>,
Purchased: <?=$license['license_purchase_date'];?>,
Expires: <?=$license['support_expiration_date'];?>,
Status: <?=$license['support_active'] == 1 ? "Supported" : "Support Expired";?>
<?php endforeach; ?>
<?php endforeach; ?>
Your summary:
Your location is <?=$authorCity;?>, <?=$authorCountry;?>.
You've sold your items <?=$authorSales;?> times and you have <?=$authorFollowers;?> followers on Envato.
1. Your Customer's License Details
----------------------------------------------------------
Purchase Code: <?=$targetPurchaseCode;?>
Is Valid License: <?=$isValidTargetLicense ? 'Yes' : 'No';?>
Buyer Username: <?=$targetLicenseBuyer;?>
License Type: <?=$targetLicenseType;?>
Purchased At: <?=$targetLicensePurchaseDate;?>
Supported Until: <?=$targetLicenseSupportExpiration;?>
Support Status: <?=$targetLicenseSupportActive == 1 ? "Supported" : "Support Expired";?>
2. Details About Target Envato User - <?=$targetUsername;?>
----------------------------------------------------------
<?=$targetUsername;?> is located in <?=$targetUserCity;?>, <?=$targetUserCountry;?>.
He sold his items <?=$targetUserSales;?> times and has <?=$targetUserFollowers;?> followers on Envato.
3. Status of Purchased Plugin ID - <?=$targetPluginId;?>
----------------------------------------------------------
Plugin Name: <?=$nameOfTargetPluginId;?>
Plugin Update Available: <?=$pluginUpdateAvailable ? 'Yes' : 'No';?>
Installed Plugin Version: <?=$installedPluginVersion;?>
Available Plugin Version: <?=$availablePluginVersion;?>
Plugin Update Download URL:
<a href="<?=$pluginUpdateDownloadUrl;?>" target="_blank" title="Download newest version">Download newest version</a>
4. Status of Purchased Theme ID - <?=$targetThemeId;?>:
----------------------------------------------------------
Theme Name: <?=$nameOfTargetThemeId;?>
Theme Update Available: <?=$themeUpdateAvailable ? 'Yes' : 'No';?>
Installed Theme Version: <?=$installedThemeVersion;?>
Available Theme Version: <?=$availableThemeVersion;?>
Theme Update Download URL:
<a href="<?=$themeUpdateDownloadUrl;?>" target="_blank" title="Download newest version">Download newest version</a>
5. Envato Item Id of Purchased Plugin
----------------------------------------------------------
Searched for Name: <?=$targetPluginName;?>
Searched for Author: <?=$targetPluginAuthor;?>
Found Plugin Id: <?=$foundPluginId;?>
6. Envato Item Id of Purchased Theme
----------------------------------------------------------
Searched for Name: <?=$targetThemeName;?>
Searched for Author: <?=$targetThemeAuthor;?>
Found Theme Id: <?=$foundThemeId;?>
And the example input of the output above, it this:
$objToolkit = new EnvatoAPIManager($toolkitSettings);
// Details about you
$purchasedPlugins = $objToolkit->getPurchasedPluginsWithDetails();
$plugins = array();
foreach($purchasedPlugins AS $pluginId => $purchasedPlugin)
{
$purchasedPlugin['licenses'] = $objToolkit->getLicensesByItemId($pluginId);
$plugins[$pluginId] = $purchasedPlugin;
}
$purchasedThemes = $objToolkit->getPurchasedThemesWithDetails();
$themes = array();
foreach($purchasedThemes AS $themeId => $purchasedTheme)
{
$purchasedTheme['licenses'] = $objToolkit->getLicensesByItemId($themeId);
$themes[$themeId] = $purchasedTheme;
}
$authorDetails = $objToolkit->getUserDetails($sanitizedEnvatoUsername);
// View vars
$view->plugins = $plugins;
$view->themes = $themes;
if($authorDetails != FALSE)
{
$view->authorCity = $authorDetails['city'];
$view->authorCountry = $authorDetails['country'];
$view->authorSales = $authorDetails['sales'];
$view->authorFollowers = $authorDetails['followers'];
} else
{
$view->authorCity = '';
$view->authorCountry = '';
$view->authorSales = 0;
$view->authorFollowers = 0;
}
// 1. Details About Target Purchase Code
$targetLicenseDetails = $objToolkit->getLicenseDetails($sanitizedTargetPurchaseCode);
// View vars
$view->targetPurchaseCode = esc_html($sanitizedTargetPurchaseCode); // Ready for print
$view->isValidTargetLicense = $objToolkit->isValidLicense($sanitizedTargetPurchaseCode);
$view->targetLicenseBuyer = $targetLicenseDetails['buyer_username'];
$view->targetLicenseType = $targetLicenseDetails['license_type'];
$view->targetLicensePurchaseDate = $targetLicenseDetails['license_purchase_date'];
$view->targetLicenseSupportExpiration = $targetLicenseDetails['support_expiration_date'];
$view->targetLicenseSupportActive = $targetLicenseDetails['support_active'];
// 2. Details About Target Envato User
$targetUserDetails = $objToolkit->getUserDetails($sanitizedTargetUsername);
// View vars
$view->targetUsername = esc_html($sanitizedTargetUsername); // Ready for print
$view->targetUserCity = $targetUserDetails['city'];
$view->targetUserCountry = $targetUserDetails['country'];
$view->targetUserSales = $targetUserDetails['sales'];
$view->targetUserFollowers = $targetUserDetails['followers'];
// 3. Status of Purchased Plugin ID
$availablePluginVersion = $objToolkit->getAvailableVersion($sanitizedTargetPluginId);
$pluginUpdateAvailable = version_compare($sanitizedInstalledPluginVersion, $availablePluginVersion, '<');
// View vars
$view->targetPluginId = intval($sanitizedTargetPluginId); // Ready for print
$view->installedPluginVersion = esc_html($sanitizedInstalledPluginVersion); // Ready for print
$view->nameOfTargetPluginId = esc_html($objToolkit->getItemName($sanitizedTargetPluginId));
$view->availablePluginVersion = $availablePluginVersion;
$view->pluginUpdateAvailable = $pluginUpdateAvailable;
$view->pluginUpdateDownloadUrl = $pluginUpdateAvailable ? $objToolkit->getDownloadUrlIfPurchased($sanitizedTargetPluginId) : '';
// 4. Status of Purchased Theme ID
$availableThemeVersion = $objToolkit->getAvailableVersion($sanitizedTargetThemeId);
$themeUpdateAvailable = version_compare($sanitizedInstalledThemeVersion, $availableThemeVersion, '<');
// View vars
$view->targetThemeId = intval($sanitizedTargetThemeId); // Ready for print
$view->installedThemeVersion = esc_html($sanitizedInstalledThemeVersion); // Ready for print
$view->nameOfTargetThemeId = esc_html($objToolkit->getItemName($sanitizedTargetThemeId));
$view->availableThemeVersion = $availableThemeVersion;
$view->themeUpdateAvailable = $themeUpdateAvailable;
$view->themeUpdateDownloadUrl = $themeUpdateAvailable ? $objToolkit->getDownloadUrlIfPurchased($sanitizedTargetThemeId) : '';
// 5. Envato Item Id of Purchased Plugin
$view->targetPluginName = esc_html($sanitizedTargetPluginName); // Ready for print
$view->targetPluginAuthor = esc_html($sanitizedTargetPluginAuthor); // Ready for print
$view->foundPluginId = $objToolkit->getItemIdByPluginAndAuthorIfPurchased($sanitizedTargetPluginName, $sanitizedTargetPluginAuthor);
// 6. Envato Item Id of Purchased Theme
$view->targetThemeName = esc_html($sanitizedTargetThemeName); // Ready for print
$view->targetThemeAuthor = esc_html($sanitizedTargetThemeAuthor); // Ready for print
$view->foundThemeId = $objToolkit->getItemIdByThemeAndAuthorIfPurchased($sanitizedTargetThemeName, $sanitizedTargetThemeAuthor);
Thank you for such a great presentation.
