Client Area Template Files - Revision history

John: Replaced content with "
Note
This page has moved to [https://developers.whmcs.com/themes/ https://developers.whmcs.com/themes/]
"

2017-01-04T10:46:33Z

Replaced content with "<div class="docs-alert-info"> <span class="title">Note</span><br /> This page has moved to [https://developers.whmcs.com/themes/ https://developers.whmcs.com/themes/] </div>"

NickHudson: /* Intro */

2016-12-19T12:28:47Z

‎Intro

NickHudson at 12:28, 19 December 2016

2016-12-19T12:28:27Z

Nicolas: /* Using GitHub */

2016-08-09T14:12:32Z

‎Using GitHub

Matt: /* Customising the Six theme */

2016-08-08T11:19:26Z

‎Customising the Six theme

Matt: /* Navigation and Sidebar Customisation */

2016-08-08T11:19:02Z

‎Navigation and Sidebar Customisation

Nathan at 14:34, 12 July 2016

2016-07-12T14:34:41Z

Nathan: /* Creating a Custom Template */

2016-07-12T14:32:42Z

‎Creating a Custom Template

Cole at 20:08, 19 January 2016

2016-01-19T20:08:35Z

Andrew: DOCS-6350

2015-12-29T11:42:32Z

DOCS-6350

@@ Line 1: / Line 1: @@
 =Intro=
-WHMCS2 always endeavours to make the system as customisable as possible so that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
+WHMCS always endeavours to make the system as customisable as possible so that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
 *Customise the layout and content of the client area fully.

@@ Line 1: / Line 1: @@
 =Intro=
-WHMCS always endeavours to make the system as customisable as possible so that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
+WHMCS2 always endeavours to make the system as customisable as possible so that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
 *Customise the layout and content of the client area fully.

← Older revision		Revision as of 14:12, 9 August 2016
Line 63:		Line 63:
	===Using GitHub===		===Using GitHub===

−	The Six theme is made available via GitHub and provides version-by-version changes of the “Six” template as published in WHMCS. The WHMCS "Six" template repository can be found at [[~~https://github.com/WHMCS/templates-six\|~~https://github.com/WHMCS/templates-six]].	+	The Six theme is made available via GitHub and provides version-by-version changes of the “Six” template as published in WHMCS. The WHMCS "Six" template repository can be found at [[https://github.com/WHMCS/templates-six]].

@@ Line 53: / Line 53: @@
 ==Customising the Six theme==
-Six is the name of the default client area template that ships with WHMCS 6.0 and later. With this template we have introduced a number of new resources that you can use to further customise your WHMCS installation. Two of these new features are briefly addressed below and detailed information on how to customise the Six theme can be found in the [[Customising the Six Theme|Customising_the_Six_Theme]] documentation.
+Six is the name of the default client area template that ships with WHMCS 6.0 and later. With this template we have introduced a number of new resources that you can use to further customise your WHMCS installation. Two of these new features are briefly addressed below and detailed information on how to customise the Six theme can be found in the [[Customising the Six Theme]] documentation.
 ===Navigation and Sidebar Customisation===

@@ Line 59: / Line 59: @@
 In the Six theme the look and feel of the navigation bar and sidebar elements can customised via the header.tpl and sidebar.tpl (located in /includes/) template files.
-To make changes to the layout of the menus (i.e. adding, removing, and modifying items) please refer to the [[Editing Client Area Menus|Editing_Client_Area_Menus]] documentation.
+To make changes to the layout of the menus (i.e. adding, removing, and modifying items) please refer to the [[Editing Client Area Menus|Editing Client Area Menus]] documentation.
-−
 ===Using GitHub===
 The Six theme is made available via GitHub and provides version-by-version changes of the “Six” template as published in WHMCS. The WHMCS "Six" template repository can be found at [[https://github.com/WHMCS/templates-six|https://github.com/WHMCS/templates-six]].

← Older revision		Revision as of 14:34, 12 July 2016
Line 50:		Line 50:

	The image tag could be replaced with any code you wanted to display there. Replace 'paypal' with the name of your payment module. The exact value can be obtained from the tblpaymentgateways table.		The image tag could be replaced with any code you wanted to display there. Replace 'paypal' with the name of your payment module. The exact value can be obtained from the tblpaymentgateways table.
		+
		+	==Customising the Six theme==
		+
		+	Six is the name of the default client area template that ships with WHMCS 6.0 and later. With this template we have introduced a number of new resources that you can use to further customise your WHMCS installation. Two of these new features are briefly addressed below and detailed information on how to customise the Six theme can be found in the [[Customising the Six Theme\|Customising_the_Six_Theme]] documentation.
		+
		+	===Navigation and Sidebar Customisation===
		+
		+	In the Six theme the look and feel of the navigation bar and sidebar elements can customised via the header.tpl and sidebar.tpl (located in /includes/) template files.
		+
		+	To make changes to the layout of the menus (i.e. adding, removing, and modifying items) please refer to the [[Editing Client Area Menus\|Editing_Client_Area_Menus]] documentation.
		+
		+	===Using GitHub===
		+
		+	The Six theme is made available via GitHub and provides version-by-version changes of the “Six” template as published in WHMCS. The WHMCS "Six" template repository can be found at [[https://github.com/WHMCS/templates-six\|https://github.com/WHMCS/templates-six]].

@@ Line 17: / Line 17: @@
 ==Creating a Custom Template==
-−
 When customising any WHMCS templates, the first step is to create another template folder. The default templates should never be edited directly. To do this, perform the following steps:
-−
-#Duplicate one of the standard folders in the templates folder (default, portal, classic) and rename it to a custom name.
+#Duplicate one of the standard folders in the templates folder (six, five) and rename it to a custom name.
 #The directory name should be all one word and consist of just lowercase letters and numbers.
 #Now make your customisations and changes as desired. See section below for more details on this.
 #Once complete, upload the new templates folder to the templates directory of WHMCS.
-#Preview the new template by specifying it using an URL "on the fly". For example, www.yourdomain.com/whmcs/?systpl=xxxxx where xxxxx is the name of the new template. See [[Linking to WHMCS]] for more info on this.
+#Preview the new template by specifying it using an URL "on the fly". For example, www.yourdomain.com/whmcs/?systpl=xxxxx where xxxxx is the name of the new template. See [[Linking to WHMCS]] for more information.
 #Once happy with it, set it live by going to '''Setup > General Settings'''. On the first tab, choose the new custom template name from the Template's dropdown menu.
-−
 The template selected here will be referred to throughout the documentation as the active template folder. Likewise, the order form template selected in Setup > General Settings > Ordering.

@@ Line 1: / Line 1: @@
 =Intro=
-WHMCS always endeavours to make the system customisable. So that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove, and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
+WHMCS always endeavours to make the system as customisable as possible so that users can always tailor it to their exact needs. With that in mind, all pages of the WHMCS client area use templates. This allows a user to add/remove and change the look and feel of everything.  In WHMCS, use of the powerful [[Template Syntax|Smarty template system]] allows you to:
 *Customise the layout and content of the client area fully.
@@ Line 12: / Line 12: @@
 #'''Footer Template (footer.tpl)'''
-The header and footer are common to every page displayed as a wrapper around the content. Within the template folders you will see many other template files. These take the place of 'The Page Template' above. These templates define the output on each page. The templates are also named so that you can identify which relates to which page. So for example, the template that defines the WHMCS homepage at (yoursite.com/whmcs/) is homepage.tpl. The main client area page is clientareahome.tpl and so on.
+The header and footer are common to every page displayed as a wrapper around the content. Within the template folders you will see many other template files. These take the place of 'The Page Template' above. These templates define the output on each page. The templates are also named so that you can identify which relates to which page. For example, the template that defines the WHMCS homepage at (yoursite.com/whmcs/) is homepage.tpl. The main client area page is clientareahome.tpl and so on.
 '''Before starting''', please refer to the '''[[Template Syntax]]''' section of the docs. This provides information on how to work with the templates in WHMCS.
@@ Line 18: / Line 18: @@
 ==Creating a Custom Template==
-When customising any WHMCS templates, the first step is to create another template folder. The default templates should never be edited directly. So to do this, perform the following steps:
+When customising any WHMCS templates, the first step is to create another template folder. The default templates should never be edited directly. To do this, perform the following steps:
-#Duplicate one of the standard folders in the templates folder (default, portal, classic) and rename it to a custom name
+#Duplicate one of the standard folders in the templates folder (default, portal, classic) and rename it to a custom name.
 #The directory name should be all one word and consist of just lowercase letters and numbers.
 #Now make your customisations and changes as desired. See section below for more details on this.
 #Once complete, upload the new templates folder to the templates directory of WHMCS.
 #Preview the new template by specifying it using an URL "on the fly". For example, www.yourdomain.com/whmcs/?systpl=xxxxx where xxxxx is the name of the new template. See [[Linking to WHMCS]] for more info on this.
-#Once happy with it, set it live by going to '''Setup > General Settings'''. On the first tab, choose the new custom template name from the Template's dropdown menu
+#Once happy with it, set it live by going to '''Setup > General Settings'''. On the first tab, choose the new custom template name from the Template's dropdown menu.
 The template selected here will be referred to throughout the documentation as the active template folder. Likewise, the order form template selected in Setup > General Settings > Ordering.
@@ Line 31: / Line 31: @@
 ==Customising to Match Your Website==
-What most people want to do with customisation is integrate WHMCS to match the rest of their website. This can be a daunting task but it is straightforward. Following on from the above, begin by copying the HTML which controls the top of your website design. Paste this into the header.tpl file of your custom template folder.  Make sure to preserve the <head> section of code in the default WHMCS template. This contains the necessary CSS, Javascript Code & File Includes for WHMCS to function. Then copy and paste the footer code from your website design into footer.tpl.
+What most people want to do with customisation is integrate WHMCS to match the rest of their website. This can be a daunting task but it is fairly straightforward. Following on from the above, begin by copying the HTML which controls the top of your website design. Paste this into the header.tpl file of your custom template folder.  Make sure to preserve the <head> section of code in the default WHMCS template. This contains the necessary CSS, Javascript Code & File Includes for WHMCS to function. Then copy and paste the footer code from your website design into footer.tpl.
 [[File:Videotutorial.png‎|center|link=https://www.youtube.com/watch?v=9VkbPoVTHYg&hd=1|Watch Video Tutorial]]
@@ Line 37: / Line 37: @@
 ===Customising how payment gateways are displayed===
-There may be occasion where it's desirable to customise the way payment gateways display. For example, you may wish to add formatting, display images such as card logos or any other code of your own.
+There may be occasion where it's desirable to customise the way payment gateways display. For example, you may wish to add formatting, display images such as card logos, or any other code of your own.
 Due to security considerations, it isn't possible to enter HTML into the display name or payment instruction fields. Instead, you can customise the relevant template to display your desired code.