![\"\"](\"https:\/\/easydigitaldownloads.com\/development\/files\/2018\/01\/edd-sl-migration-notice-1024x242.png\")
<\/p>\nIf you were not already aware, the Easy Digital Downloads team has made a commitment to improving the performance of our platform by introducing custom database tables for data we deem qualified for this treatment. I’m elated to bring you the first beta of Software Licensing 3.6, which moves license keys to their own custom tables, providing a cleaner data organization and significantly improved performance.<\/p>\n
As we’ve been doing with our other migrations, store owners will be presented with a migration utility that allows them to move the data from the old custom post types, to the new data format. Since moving licenses is a multi-phase process, we had to rebuild the migration utility to be more flexible and verbose, so store owners could get a better picture of what was happening.<\/p>\n
Initially, store owners will be presented with an expandable admin notice informing them of this upgrade, as well as the WP-CLI command to use to complete this upgrade.<\/p>\n
<\/p>\n
Instead of immediately starting the upgrade, as we have previously done, the user needs to click to start this process. There are a possible 3 steps that need to be completed on the initial view:<\/p>\n
Only the relevant options will be shown:<\/p>\n
![\"\"](\"https:\/\/easydigitaldownloads.com\/development\/files\/2018\/01\/edd-sl-migration-step1-1024x469.png\")
<\/p>\n
Starting the upgrade will use our batch processing API to upgrade a limited number of licenses at a time, to help reduce any risks of causing errors due to server resources. When step 1 is completed a check is run to see if the number of legacy license keys matches the number of new license keys. If these numbers match, any remaining steps will be automatically started. If the numbers are different, however, the remaining steps will not be started automatically, allowing store owners to go see if there was a reason for this, and verify any necessary data was migrated prior to starting the remaining steps. When all steps are completed, users will be notified they can navigate away from the upgrades page to verify data. At this point their store is 100% using the new license tables. The old data still exists<\/em><\/strong>, until the final ‘Remove Legacy Data’ step is performed.<\/p>\n If you are running a large store, with more than a thousand licenses, we recommend running this migration over WP-CLI with the provided command. This will ensure the fastest and most reliable method of upgrading a large data set.<\/p>\n The new table schema for these tables is defined below.<\/p>\n wp_edd_licenses<\/p>\n wp_edd_licensemeta<\/p>\n wp_edd_license_activations<\/p>\n In the past, Software Licensing has always used some of the Easy Digital Downloads roles and capabilities to restrict who can view and modify licenses. In version 3.6, we’ve added 3 capabilities, which allow a granular customization as to what roles can view, edit, and delete licenses from a store. By default, the mappings for license capabilities are tied to EDD Core roles, but can be customized to your preference with a role management plugin or custom integration.<\/p>\n In version 3.5, we added support for adding beta versions of licensed products. If the API request for `get_version` was called with the `beta` flag, instead of delivering the latest stable version, the beta was delivered. Previously the only way to get this was via the license handler. In version 3.6, users are able to download beta versions from within their accounts, just like they do with stable versions. These beta files will appear anywhere that EDD outputs download files by default.<\/p>\n If a license is attached to a product that has variable pricing enabled, users with the ‘modify_licenses’ capability can now change the variable price assignment of a license.<\/p>\n Why did the status counts change after the migration?<\/strong><\/p>\n You may notice, after running the migration, that some of the status counts in the license list table have changed. This is because during the migration, some checks were run against the licenses to correct any incorrect statuses. While you may see some differences in the counts for individual statuses, the overall license count should remain the same.<\/p>\n Can my store still receive new payments and generate licenses while this migration is running?<\/strong><\/p>\n Yes! While this migration is running, your store will still be able to process payments and generate new licenses, while the old data is being migrated.<\/p>\n This is a significant update for Software Licensing and so we are testing it as extensively as possible, and we’d love help! If you’d like to help us test the beta, please see this guide<\/a>.<\/p>\n Notes:<\/p>\n\n
\n
\n
New license capabilities<\/h3>\n
\n
\n
\n
\n
Download betas from the front-end<\/h3>\n
![\"\"](\"https:\/\/easydigitaldownloads.com\/development\/files\/2018\/01\/edd-sl-frontend-beta-download-e1516663492563.png\")
<\/p>\nSwap variable price assignment<\/h3>\n
![\"\"](\"https:\/\/easydigitaldownloads.com\/development\/files\/2018\/01\/edd-sl-swap-variable-price.png\")
<\/p>\nOther improvements<\/h3>\n
\n
.edd-table<\/code>\u00a0class added to allow better theme support.<\/li>\nfinal<\/code>\u00a0keyword from the EDD_SL_License<\/code> class.<\/li>\nNotable bug fixes<\/h3>\n
\n
activate_license<\/code>\u00a0API call logged the activation twice in the license logs.<\/li>\nhttp<\/code>.<\/li>\ntime()<\/code>\u00a0instead of current_time( 'timestamp' )<\/code>.<\/li>\nempty_cart<\/code>\u00a0function now removes any renewal session data.<\/li>\n<\/ul>\nFrequently Asked Questions<\/h3>\n
Beta testing<\/h3>\n
\n