Log into your account at FusionInvoice.com and download the latest package. Save it locally to your computer.
Navigate to the downloaded install package and unzip the contents.
If you are upgrading from version 2017-6 or lower:
Delete the app folder from the FusionInvoice folder on your server.
Upload the following folders to the FusionInvoice folder on your server and let them merge/overwrite the existing folders:
If you are upgrading from version 2017-7 or higher:
Upload the following folders to the FusionInvoice folder on your server and let them merge/overwrite the existing folders:
It is recommended that you use a standard FTP program such as FileZilla to upload the files to your server.
Visit http://YourFusionInvoiceURL/setup in your web browser. If your http://YourFusionInvoiceURL/setup produces an error, try using http://YourFusionInvoiceURL/index.php/setup instead. This step will upgrade your database. Once this step is completed, you should be able to log back into your upgraded FusionInvoice system.
FusionInvoice 2017-7 removes support for PayPal's classic API and implements support for PayPal's REST API. This means you'll need to create a new set of API keys in PayPal and configure FusionInvoice to use those. Steps to obtain PayPal's REST API keys are available here.
Log into your account at FusionInvoice.com and download the add-on package to upgrade. Save it locally to your computer.
Navigate to the downloaded Add-on package and unzip the contents.
Upload the unzipped add-on folder from your computer to the custom/addons folder on your server and let it merge/overwrite the existing folder. It is recommended that you use a standard FTP program such as FileZilla to upload the folder to your server.
Log into your FusionInvoice install and go to System -> Add-ons and press the Upgrade button for the add-on if it appears. If the Upgrade button doesn't appear, then no further action is required and the add-on should be upgraded and ready to use.
Log into your account at FusionInvoice.com and download the latest package. Save it locally to your computer.
Navigate to the downloaded install package and unzip the contents.
Delete the app folder from the FusionInvoice installation on your server.
Delete the vendor folder from the FusionInvoice installation on your server.
Upload the following folders to the FusionInvoice folder on your server and let them merge/overwrite the existing folders:
It is recommended that you use a standard FTP program such as FileZilla to upload the files to your server.
Visit http://YourFusionInvoiceURL/setup in your web browser. If your http://YourFusionInvoiceURL/setup produces an error, try using http://YourFusionInvoiceURL/index.php/setup instead. This step will upgrade your database. Once this step is completed, you should be able to log back into your upgraded FusionInvoice system.
If you are using custom quote and/or invoice templates, there are some minor changes you'll need to make. If any of these exist in your custom template(s), they should be changed as follows:
For custom invoice templates:
Change this: | To this: |
---|---|
$invoice->user->company | $invoice->companyProfile->company |
$invoice->user->formatted_address | $invoice->companyProfile->formatted_address |
$invoice->user->phone | $invoice->companyProfile->phone |
$invoice->user->fax | $invoice->companyProfile->fax |
$invoice->user->mobile | $invoice->companyProfile->mobile |
$invoice->user->web | $invoice->companyProfile->web |
$invoice->user->address | $invoice->companyProfile->address |
$invoice->user->city | $invoice->companyProfile->city |
$invoice->user->state | $invoice->companyProfile->state |
$invoice->user->zip | $invoice->companyProfile->zip |
$invoice->user->country | $invoice->companyProfile->country |
Logo::size(width, height) | $invoice->companyProfile->logo(width, height) |
For custom quote templates:
Change this: | To this: |
---|---|
$quote->user->company | $quote->companyProfile->company |
$quote->user->formatted_address | $quote->companyProfile->formatted_address |
$quote->user->phone | $quote->companyProfile->phone |
$quote->user->fax | $quote->companyProfile->fax |
$quote->user->mobile | $quote->companyProfile->mobile |
$quote->user->web | $quote->companyProfile->web |
$quote->user->address | $quote->companyProfile->address |
$quote->user->city | $quote->companyProfile->city |
$quote->user->state | $quote->companyProfile->state |
$quote->user->zip | $quote->companyProfile->zip |
$quote->user->country | $quote->companyProfile->country |
Logo::size(width, height) | $quote->companyProfile->logo(width, height) |
Save copies of the following configuration files from your server to your local computer:
If you created or purchased custom templates, save copies of those files to your local computer from the following locations on your server:
Create a backup of your MySQL database from phpMyAdmin (or whatever tool you use to manage your databases).
Delete the entire folder from your server which contains the FusionInvoice folders and files. Recreate the empty folder once it has been deleted.
Log into your account at FusionInvoice.com and download the latest package. Save it locally to your computer.
Navigate to the downloaded install package and unzip the contents.
Open config/database.php from the unzipped installer package. Edit the file and point it to your existing FusionInvoice database and save the modified file. Use your backed up database.php file for reference purposes.
Typically you should only have to configure the host, database, username and password values to connect to your database. Compatibility with MySQL and MariaDB is 100% guaranteed. Other database types may or may not work as expected and are not supported.
'mysql' => [ 'host' => 'localhost', 'database' => 'fusioninvoice', 'username' => 'root', 'password' => 'password', 'prefix' => '', 'driver' => 'mysql', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'strict' => false, ],
Open config/app.php from the unzipped installer package and replace the ReplaceThisWithYourOwnLicenseKey value with your license key listed in your FusionInvoice.com account panel and save the modified file. Be sure there are no leading or trailing spaces in this value when you save the file.
'key' => 'ReplaceThisWithYourOwnLicenseKey',
Upload the unzipped files from your computer to the empty folder on your server you recreated earlier. It is recommended that you use a standard FTP program such as FileZilla to upload the files to your server. This initial upload may take a few minutes to complete.
Apply recursive write permissions to the following folders (including all the folders and files contained within):
The exact steps to set the appropriate permissions will depend on your web host and server configuration. FusionInvoice cannot advise on the exact steps or permissions to apply to make these folders writable. If you have questions about this step, please contact your web host or system administrator.
Visit http://YourFusionInvoiceURL/setup in your web browser. If http://YourFusionInvoiceURL/setup produces an error, try using http://YourFusionInvoiceURL/index.php/setup instead. This step will upgrade your v2 database. Once this step is completed, you should be able to log into your upgraded FusionInvoice system.
Once logged into FusionInvoice, go to System -> System Settings and update the following settings:
This portion of the documentation only applies if you have created or purchased customized templates for FusionInvoice v2 and would like to use those same templates in FusionInvoice 2017. Below are the steps to follow, which should be easily achieved by using find and replace in your text / code editor.
For custom invoice templates:
Change this: | To this: |
---|---|
{{{ | {{ |
}}} | }} |
{{ $logo }} | {!! $invoice->companyProfile->logo() !!} |
{{ $invoice->user->formatted_address }} | {!! $invoice->user->formatted_address !!} |
{{ $invoice->client->formatted_address }} | {!! $invoice->client->formatted_address !!} |
{{ $invoice->formatted_terms }} | {!! $invoice->formatted_terms !!} |
{{ $invoice->formatted_footer }} | {!! $invoice->formatted_footer !!} |
{{ $item->name }} | {!! $item->name !!} |
{{ $item->formatted_description }} | {!! $item->formatted_description !!} |
$invoice->amount->formatted_item_subtotal | $invoice->amount->formatted_subtotal |
For custom quote templates:
Change this: | To this: |
---|---|
{{{ | {{ |
}}} | }} |
{{ $logo }} | {!! $quote->companyProfile->logo() !!} |
{{ $quote->user->formatted_address }} | {!! $quote->user->formatted_address !!} |
{{ $quote->client->formatted_address }} | {!! $quote->client->formatted_address !!} |
{{ $quote->formatted_terms }} | {!! $quote->formatted_terms !!} |
{{ $quote->formatted_footer }} | {!! $quote->formatted_footer !!} |
{{ $item->name }} | {!! $item->name !!} |
{{ $item->formatted_description }} | {!! $item->formatted_description !!} |
$quote->amount->formatted_item_subtotal | $quote->amount->formatted_subtotal |
Save your changes and upload the file to custom/templates/invoice_templates if it's an invoice template or to custom/templates/quote_templates if it's a quote template.
This should result in a fully upgraded system! From here on, your upgrades will be much simpler :)