Upgrade to version 2
All versions 2 of Billing Extension have nothing in common with ones of the previous generation (v1). It's a brand new module. If you are running any version of Billing Extension from 1.4.6 (11/10/2016) up to 1.5.10 (22/08/2018) read this guide to upgrade to latest version.
The following pages with their relative functionalities have been removed from admin interface:
- Clients. Confusing. Its functionalities will be implemented in a new page not yet available at the moment of writing
- Reports. It became obsolete since now you can view and export data with SorTables
- Promotions, Support and Incidents pages were all out of place for a billing software. They've been included in Mercury
These features have been removed too:
- Invoice Due Date was capable of overriding default due date of invoices. Not so useful
- Invoice Automation was rarely used but we have plans to reintroduce this feature in a new light
- Multi-Brand. Too complex to use
- Mailing System of Toggle Invoicing. We will bring this feature back at a later stage
- Level 3 Tax based on Products/Services. Nobody ever used it therefore we're removing it
The upgrade to version 2 involves all your invoices, payments, shapshots and settings. Before attempting the upgrade, we strongly recommend you to try it on a testing environment that is an exact copy of your WHMCS.
If you have uninvoiced payments (eg. if you are using manual invoicing or Simplified Invoicing), generate invoices right now before starting the upgrade!
As we have already said, don't try the upgrade on the real setup. First try to run it on a testing environment. Only when you are totally sure that everything is working fine repeat the upgrading procedure on your real WHMCS. Don't forget to backup all your files and database before trying it!
- Run or import this query in phpMyAdmin
- Delete the following directory modules/addons/BillingExtension
- Upload version 2 of the module
- Visit Setup > Addon Modules > Billing Extension and click Deactivate
- Once done click Activate and wait for the process to finish
- Click Configure, insert your license key and grant permissions
- Insert Integration Code
It's important to notice that the installer will try to keep all your settings in this specific order: WHMCS, EU VAT Addon, Billing Extension. That means that first it imports WHMCS settings. If EU VAT Addon is installed it imports data and overrides default settings of WHMCS. The same process repeats for the old Billing Extension. This way most of your customizations will be preserved.
Q: Can I repeat the upgrading procedure?
A: You can repeat the upgrade as many times as you want. Simply press Deactivate and Activate. The deactivation of Billing Extension v2 doesn't change/remove any setting of WHMCS, EU VAT Addon and Billing Extension v1. The only information lost are the ones of Billing Extension v2.
A: If something isn't working as expected, you can restore the original settings by deactivating Billing Extension v2. Once done delete modules/addons/BillingExtension (v2) directory and replace it with the old Billing Extension (v1) you had previously installed on your system. Finally run or import this query in phpMyAdmin.
Q: It's all working good. Should I remove any table from my database?
A: If you are 100% sure that everything is working fine, you can delete all the tables used by the old Billing Extension v1. Run or import this query in phpMyAdmin. You can also remove the following file (if they exist):