Version 4.5 Release Notes

Release Information

Version 4.5.0

Release Type: Beta (For Testing)
Release Date: 19th April 2011

Version 4.5.1

Release Type: Stable Release
Release Date: 18th May 2011

Version 4.5.2

Release Type: Bug Fix/Patch Release
Release Date: 17th June 2011

Changelog

A changelog showcasing the new features and enhancements in WHMCS V4.5 can be found @ http://www.whmcs.com/members/dl.php?type=d&id=76

Upgrade Steps

To upgrade your current WHMCS installation to Version 4.5, simply follow the steps below. These same steps can be used to upgrade from any Version V3.3 or later.

Begin by taking a backup of your database using a tool such as phpMyAdmin
Now download the latest WHMCS version either from our client area (http://wiki.whmcs.com/Upgrading#Downloading_the_Latest_Version) or from the provider of your license
Next, unzip the contents of the latest WHMCS zip file download to a folder on your computer
Now remove the /images/logo.jpg file to avoid overwriting your customised logo image
Next if you have customised your WHMCS admin folder name, you should rename the admin folder in the new files to match
Upload the new files to your existing installation folder overwriting any existing files
Visit the admin area as you normally would to login and you should then see the upgrade script
Accept the license agreement
Check to confirm you have backed up your database and click the upgrade button
Once the updates finish, delete the install folder from your server

The upgrade is now completed. The only thing left to do is update your custom templates if you have any with the new and changed template files for the new version. See below for details.

Template Changes

Below is a list of all the client area template files have changed between V4.4 and V4.5. A description of the change is provided to help with merging changes.

clientareaaddcontact.tpl (added state dropdown chooser)
clientareacontacts.tpl (added state dropdown chooser)
clientareadetails.tpl (added state dropdown chooser)
clientareadomaincontactinfo.tpl (added error reporting on whois update failure)
clientareaquotes.tpl (new client area quote listing page)
clientregister.tpl (added state dropdown chooser)
configuressl-complete.tpl (updates to support more flexible SSL configurations)
configuressl-stepone.tpl (updates to support more flexible SSL configurations)
creditcard.tpl (added state dropdown chooser)
header.tpl (added link to new clientarea.php?action=quotes page - optional update)
invoicepdf.tpl (new custom fields show on invoices feature)
quotepdf.tpl (added multi-language support - optional update)
upgradesummary.tpl (added promotion code support to upgrade process)
viewinvoice.tpl (for new custom fields output & payment pending review status for 2co recurring)

The V4.5 update includes a number of new order templates. No existing template changes are needed, but to take advantage of the state dropdown chooser during checkout you will need to add the line below to the top of the viewcart.tpl template file in any active order templates.

<script type="text/javascript" src="includes/jscript/statesdropdown.js"></script>

There are a couple of admin area template file changes also as follows:

clientsummary.tpl (added new summary page hook point for HTML output)
viewticket.tpl (added predefined reply quick search)

Along with the entirely new admin template Blend which can be uploaded via the folder /admin/templates/blend/

V4.5.2 Upgrade

The V4.5.2 upgrade only contains updates to the new order forms, this includes the ajaxcart, comparison (css updates only), modern and slider template folders in /templates/orderforms/

New Language File Lines

The new language file lines for Version 4.5 can be found below the "# Version 4.5" line in each language file.

Release Notes

This upgrade will enable 2 new settings by default, Grouping of Similar Line Items and Cancellation Requests automated Invoice Cancelling. If you do not want these enabled then you will need to disable them in Setup > General Settings > Invoices

If you use the ResellerClub or any other LogicBoxes based module then in this latest release the modules have been updated to use ResellerClub's newer HTTP API for improved performance and reliability. And therefore after updating you should check over your configuration in Setup > Domain Registrars and ensure your servers IP is allowed in the LogicBoxes control panel. More info on this can be found in the ResellerClub page

If you use the 2CheckOut module, you will need to reconfigure and setup the 2CheckOut INS service after upgrading to V4.5. Please refer to the 2CheckOut page for more details

If you use the Live Chat Addon then a licensing update is needed for WHMCS V4.5. This update can be downloaded @ http://www.whmcs.com/members/dl.php?type=d&id=78 and the files from that simply need to be uploaded to the WHMCS /modules/livehelp/ folder for it to take effect.

A number of users have reported issues with their admin area constantly reloading after upgrading. This has been identified as being caused by having an old cached version of jQuery in your local browser. So clearing your temporary internet files and doing a hard refresh should prevent & resolve it.

Patches/Updates - As any issues that arise in the new release that get reported to us and fixed, we will be posting them in a dedicated thread on our forums @ http://forum.whmcs.com/showthread.php?t=38424 to save you needing to contact and wait for support