Difference between revisions of "Version 5.3 Release Notes"

From WHMCS Documentation

(Release Information)
(Upgrade Steps)
Line 32: Line 32:
 
==Upgrade Steps==
 
==Upgrade Steps==
  
The same usual steps for upgrading WHMCS apply to Version 5.2. They are:
+
The same usual steps for upgrading WHMCS apply to Version 5.3. They are:
  
#Begin by taking a backup of your database using a tool such as phpMyAdmin
+
'''Make a Full Backup - We cannot stress enough how important it is to *always* take a full backup before attempting any kind of upgrade. Both for WHMCS and any other software you use.  A full backup should be taken of both the WHMCS files and the database.'''
#Now download the latest WHMCS version either from our client area (http://wiki.whmcs.com/Upgrading#Downloading_the_Latest_Version) or from your web host license provider
+
 
#Next, unzip the contents of the WHMCS zip file download to a folder on your computer
+
#Begin by obtaining the latest full release download of WHMCS either from our client area or from your license provider (if using a reseller)
#Now if you have customised your WHMCS admin folder name, you should rename the admin folder in the new files to match
+
#Unzip the contents of the WHMCS zip file download to a folder on your computer
 +
##If you have renamed your "admin" directory, be sure to rename the /whmcs/admin directory in the new files to match.
 +
##Similarly, if you have customised the location of the /crons/ directory, be sure to upload that to the custom location
 
#Upload the new files to your existing installation folder replacing any existing folders & files
 
#Upload the new files to your existing installation folder replacing any existing folders & files
#Visit the admin area as you normally would to login and you should then see the upgrade script
+
#Visit your WHMCS installation and you should then be automatically redirected to the upgrade process. If you see a message saying WHMCS is not installed, this indicates you have overwritten the configuration.php file for your installation.  Stop and restore that file from your backup before continuing.
#Accept the license agreement
+
#Agree to the WHMCS End User License Agreement and follow the steps on screen to upgrade your database.
#If you are prompted for any database information *STOP*, this indicates the configuration.php file is missing and so a new install is being attempted - you need to restore the configuration.php before continuing.
+
#When prompted, delete the install folder from your server.
#Tick to confirm once you have backed up your database, and then click the upgrade button
+
#Your upgrade is now complete.
#Once the updates finish, delete the install folder from your server
+
 
 +
At this stage, the installation update is complete.  However, if you have custom template files you will want to review the Release Notes again so that you know which templates, if any, were updated and act accordingly to propagate these changes to your customised template set.
  
 
These steps can be used to upgrade from any version of WHMCS from V3.3 & later.
 
These steps can be used to upgrade from any version of WHMCS from V3.3 & later.

Revision as of 11:45, 5 February 2014

Release Information

Version 5.3.0 Beta 1

  • Release Type: Beta (For Testing)
  • Release Date: 27th September 2013

Version 5.3.1 Beta 2

  • Release Type: Beta (For Testing)
  • Release Date: 4th October 2013

Version 5.3.2 Beta 3

  • Release Type: Beta (For Testing)
  • Release Date: 23rd December 2013

Version 5.3.3 RC 1

  • Release Type: Release Candidate (For Testing)
  • Release Date: 14th January 2014

Version 5.3.3 RC 2

  • Release Type: Release Candidate (For Testing)
  • Release Date: 28th January 2014

Version 5.3.3

  • Release Type: General Release
  • Release Date: 5th February 2014

Changelog

http://docs.whmcs.com/Changelog:WHMCS_V5.3


Upgrade Steps

The same usual steps for upgrading WHMCS apply to Version 5.3. They are:

Make a Full Backup - We cannot stress enough how important it is to *always* take a full backup before attempting any kind of upgrade. Both for WHMCS and any other software you use. A full backup should be taken of both the WHMCS files and the database.

  1. Begin by obtaining the latest full release download of WHMCS either from our client area or from your license provider (if using a reseller)
  2. Unzip the contents of the WHMCS zip file download to a folder on your computer
    1. If you have renamed your "admin" directory, be sure to rename the /whmcs/admin directory in the new files to match.
    2. Similarly, if you have customised the location of the /crons/ directory, be sure to upload that to the custom location
  3. Upload the new files to your existing installation folder replacing any existing folders & files
  4. Visit your WHMCS installation and you should then be automatically redirected to the upgrade process. If you see a message saying WHMCS is not installed, this indicates you have overwritten the configuration.php file for your installation. Stop and restore that file from your backup before continuing.
  5. Agree to the WHMCS End User License Agreement and follow the steps on screen to upgrade your database.
  6. When prompted, delete the install folder from your server.
  7. Your upgrade is now complete.

At this stage, the installation update is complete. However, if you have custom template files you will want to review the Release Notes again so that you know which templates, if any, were updated and act accordingly to propagate these changes to your customised template set.

These steps can be used to upgrade from any version of WHMCS from V3.3 & later.

Remember: After upgrading, your browser may still display cached versions of the previous files. So if you get any display issues or inconsistencies, always try clearing your cache first, both in your browser, and the WHMCS templates cache (templates_c folder files)

Template Changes

Version 5.3.0

Default Templates Only (client area):

  • domainchecker.tpl:
   line46-49 - additional conditional display of errors for the domain checker.
  • header.tpl:
   additional conditional at lines 104 & 146 for livehelp activation.
  • supportticketlist.tpl:
   lines 17-21 & lines 47-48 changed to make sure search terms remain on the page through a click

Classic Client Area:

  • clientareachangesq.tpl - removed
  • domainchecker.tpl:
   * additional error handling at line 44
  • supportticketslist.tpl:
   * table definitions change at line: 11 and 33

Portal Client Area:

  • clientareachangesq.tpl - removed
  • clientareasecurity.tpl
   * remove: {include file="$template/pageheader.tpl" title=$LANG.clientareanavsecurity} at line 3
  • domainchecker.tpl
   * additonal error handling at line 51
  • supportticketslist.tpl
   * alter lines: 18, 47, 48 to keep search term on page switches.

Comparison Order Form:

  • domainoptions.tpl:
   * line 2, additional error reporting.

Modern Order Form:

  • domainoptions.tpl
   * line 2, additional error reporting.

Slider Order Form:

  • domainoptions.tpl
   * line 2, additional error reporting.
  • products.tpl
   * add in productNums array deff at line 10.
   * modify conditional at line 42.
  • viewcart.tpl
   * Add variable definition at line 2.