Difference between revisions of "X-Cart:Static Pages"

From X-Cart 4 Classic
Jump to: navigation, search
(Overview)
 
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
==Overview==
 
==Overview==
  
You can add static pages to your store to include additional information which does not fit into the standard X-Cart's page set. X-Cart allows you to create static pages of two types:
+
The customer-facing area of your store's website will consist primarily of product, category and manufacturer pages. However, you may feel the need to add some more information that does not fit into pages of the said types; for example, you may want to add your store's Terms and Conditions, Privacy Policy and the like. X-Cart allows you to add pages to your website where you can place any content that you feel is needed. Such pages in X-Cart are called ''static pages''. X-Cart supports two types of static pages:
  
 
* Embedded
 
* Embedded
* Root
+
* Root level
  
 
Root level pages are fully independent HTML files. They exist in X-Cart root (the directory where your X-Cart store is installed), hence the name. Root pages do not depend on the rest of X-Cart pages, so they must be full HTML-files (must include tags like <HTML>...</HTML>).
 
Root level pages are fully independent HTML files. They exist in X-Cart root (the directory where your X-Cart store is installed), hence the name. Root pages do not depend on the rest of X-Cart pages, so they must be full HTML-files (must include tags like <HTML>...</HTML>).
  
Embedded pages are pages that are placed inside standard X-Cart pages. Their look depends on the design of your store in general, as you create only the page content. The content of embedded pages is displayed in your store's Information column (corresponds to the widest column in any X-Cart's standard template scheme). Links to embedded pages appear in the '<u>Help</u>' menu box. Embedded pages do not use tags like <HTML>, <HEAD>, <BODY>.
+
Embedded pages are pages that are placed inside standard X-Cart pages. Their appearance depends on the design of your store in general, as you create only the page content. The content of embedded pages is displayed in your store's Information column (the widest column in any X-Cart's standard template scheme). Embedded pages do not use tags like <HTML>, <HEAD>, <BODY>.
  
Root level pages are stored in the directory <u>/xcart</u> (X-Cart root), embedded pages - in subdirectories of the directory <u>/xcart/skin1/pages</u>, where the subdirectories are named after the respective languages (for example, pages for the English language are stored in the directory <u>/xcart/skin1/pages/US</u>, pages for the German language - in the directory <u>/xcart/skin1/pages/DE</u>, etc).
+
Root level pages are stored in the X-Cart root directory, embedded pages - in the subdirectories of the directory <u>skin/common_files/pages</u> named after the respective languages (for example, pages for the English language are stored in the directory <u>skin/common_files/pages/en</u>, pages for the German language - in the directory <u>skin/common_files/pages/de</u>, etc.)
  
Four root level pages are defined by default:
+
{{XC 4.0}}
 +
{{Note1| <b>Note</b>: In versions prior to 4.4.x, embedded pages are stored in the corresponding subdirectories of the directory <u>skin1/pages</u> named after the respective languages (for example, pages for the English language are stored in the directory <u>skin1/pages/US</u>, pages for the German language - in the directory <u>skin1/pages/DE</u>, etc.)}}
  
* message.html
+
X-Cart comes with the following root level static pages out of the box:
  
* permission_denied.html
+
* message (<xcart_dir>/message.html)
* shop_closed.html
+
* permission_denied (<xcart_dir>/permission_denied.html)
* under_update.html
+
* shop_closed (<xcart_dir>/shop_closed.html)
  
Information on how you can add static pages is available in the chapter [[#Adding Static Pages | Adding Static Pages]].
+
It also has a few pre-created embedded pages:
 +
* About our site (<xcart_dir>/skin/common_files/pages/en/about_our_site.html)
 +
* FAQ (<xcart_dir>/skin/common_files/pages/en/faq.html)
 +
* Terms & Conditions (<xcart_dir>/skin/common_files/pages/en/terms.html)
 +
* Privacy statement (<xcart_dir>/skin/common_files/pages/en/privacy_statement.html)
 +
* Publicity (<xcart_dir>/skin/common_files/pages/en/publicity.html)
 +
(By default, links to the above named embedded pages are included into the '<u>Help</u>' menu box in your store's Customer area.)
  
Information on how you can manage existing static pages is available in the chapter [[#Managing Static Pages | Managing Static Pages]].
+
On a fresh X-Cart install, the above pages contain dummy text. Before going live with your store, you should edit the contents of the said pages so they provide meaningful content for your customers. If you do not want to use these pages, remove or disable them (See [[X-Cart:Static_Pages#Managing_Static_Pages|Managing Static Pages]] for more info).
 +
 
 +
The file <u>include/func/func.pages.php</u> defines aliases for your store's default embedded pages:
 +
<pre>
 +
$page_aliases = array(
 +
'faq' => 'faq',
 +
'about' => 'about_our_site',
 +
'business' => 'privacy_statement',
 +
'conditions' => 'terms',
 +
'publicity' => 'publicity',
 +
);
 +
</pre>
 +
As a result, the pages can be accessed at the following aliases:<br />
 +
* About our site: httр://<YOUR_XCART_STORE>/pages.php?alias=about<br />
 +
* FAQ: httр://<YOUR_XCART_STORE>/pages.php?alias=faq<br />
 +
* Terms & Conditions: httр://<YOUR_XCART_STORE>/pages.php?alias=conditions<br />
 +
* Privacy statement: httр://<YOUR_XCART_STORE>/pages.php?alias=business<br />
 +
* Publicity: httр://<YOUR_XCART_STORE>/pages.php?alias=publicity<br />
  
 
==Adding Static Pages==
 
==Adding Static Pages==
 +
 +
Both embedded and root-level static pages can be created using the '<u>Static pages</u>' section of your store's Admin area.
  
 
To add a new static page:
 
To add a new static page:
  
# Go to the '<u>Static pages</u>' section of your store's Admin area (<u>Administration menu->Static pages</u>). A dialog box '<u>Static pages</u>' opens.<br><br>[[Image:static_pages.gif|584px]]<br><br>
+
# Go to the '<u>Static pages</u>' section of your store's Admin area (<u>Content</u> -> <u>Static pages</u>). This opens the '<u>Static pages</u>' form.<br><br>[[File:Static_pages.png|632px]]<br><br>
# ''(If your store supports more than one language)'' From the Language selector at the top of the '<u>Static pages</u>' dialog box, select the language for which the static page is going to be added.
+
# ''(If your store supports multiple languages)'' From the '''Language''' selector at the top of the '<u>Static pages</u>' form, select the language in which you are going to add a static page. This switches the active language of the Admin area so you can provide content for the new page in the chosen language.
# If you are creating an embedded page, click the '''Add new...''' button in the subsection '<u>Embedded level</u>'. If you are creating a root level page, click the '''Add new...''' in the subsection '<u>Root level</u>'.
+
# Depending on the type of static page you are adding (embedded or root-level), choose either the '<u>Embedded level</u>' or the '<u>Root level</u>' subsection of the '<u>Static pages</u>' form. In the respective subsection, click the '''Add new...''' button. This opens the '<u>Static page details</u>' form.
 +
# Use the '<u>Static page details</u>' form to provide the details of the new static page (See [[#Defining Static Page Details]]).
 +
# Click the '''Save''' button at the bottom of the '<u>Static page details</u>' form to save the changes.
 +
 
 +
Clicking '''Save''' creates the static page. You should see a confirmation message.
 +
 
 +
The '''Pages list''' button at the top of the '<u>Static page details</u>' form allows you to return to the '<u>Static pages</u>' form where you will be able to see the new page added to the static pages list.
 +
 
 +
{{Note|At any moment in time, the static pages list displays only the static pages that were created in the language currently used for viewing the Admin area.}}
 +
 
 +
==Defining Static Page Details==
 +
 
 +
When you create or edit a static page, you define its details using the '<u>Static page details</u>' form.
 +
 
 +
For embedded static pages, the '<u>Static page details</u>' form looks as follows:
 +
 
 +
: [[File:Embedded_static_page_details.png|640px]]
 +
 
 +
It contains the following fields:
 +
 
 +
* <u>Page file</u>: File name of the static page.
 +
* <u>Page name</u>: Name by which you and your customers will be able to identify this static page.
 +
* <u>Clean URL</u>: Clean URL value for this static page. Instructions on editing this field are available in [[X-Cart:Clean URLs#Defining Clean URL Values]].
 +
 
 +
{{Note|The 'Clean URL' field needs to be adjusted only if the Clean URLs functionality is enabled in your X-Cart store. If the Clean URLs functionality is disabled, the 'Clean URL' field appears inactive.}}
 +
 
 +
* <u>Page content</u>: Content/HTML source code of the page.
 +
 
 +
{{Note|You can edit the content of the page in WYSIWYG mode if your store has the HTML Editor module enabled. For details, see the [[X-Cart:HTML Editor]] section in this manual.}}
 +
 
 +
* <u>Title tag</u>: Title to be used in the title tag of the static page.
 +
* <u>META keywords</u>: Keywords to be listed in the keywords meta tag of the static page.
 +
* <u>META description</u>: Description to be placed in the description meta tag of the static page.
  
A dialog box titled '<u>Static page details</u>' opens.
+
{{Note|For more information on using the description and keywords meta tags, see the [[X-Cart:Configuring Page Titles and Meta Tags]] section of this manual.}}
  
# In the '<u>Static page details</u>' dialog box, provide the details of the static page being created (See [[#Defining Static Page Details]]).
+
* <u>Status</u>: This option allows you to specify whether the page should be available for viewing to the visitors of your store's Customer area.
# Click the '''Save''' button at the bottom of the '<u>Static page details</u>' dialog box.
+
* <u>Position</u>: Position of the static page title in the list of static pages within the '<u>Static pages</u>' form and (if the '<u>Show a link to the page in Help menu?</u>' option is enabled) on the Help menu box of your store's Customer area.
 +
* <u>Show a link to the page in Help menu?</u>: This option allows you to specify whether the link to this page should be included in the <u>Help</u> menu box of your store's Customer area.
  
When you click on '''Save''', the static page is created. A message is displayed confirming that the static page has been created successfully.
+
For a root level static page, the '<u>Static page details</u>' form contains only the following fields:
  
To return to the list of your store's static pages, click the Pages list link at the top of the '<u>Static page details</u>' dialog box.
+
: [[File:Root_static_page_details.png|640px]]
  
[[Category:X-Cart user manual]]
+
* <u>Page file</u>: Filename for this static page.
 +
* <u>Page name</u>: Name by which you will be able to identify this static page.
 +
* <u>Page content</u>: Content/HTML source code of this page.
 +
 
 +
To define the details of a static page, you need to provide all the necessary information in the respective fields of the '<u>Static page details</u>' form and click the '''Save''' button at the bottom. After the static page details have been saved, you should see a confirmation message.
  
 
==Managing Static Pages==
 
==Managing Static Pages==
  
Your store's embedded and root level static pages can be managed using the controls of the '<u>Static pages</u>' dialog box.
+
Your store's embedded and root level static pages can be managed using the controls of the '<u>Static pages</u>' form.
  
To find all your store's static pages for a certain language:
+
'''Finding all static pages in a specific language'''
  
# Select the desired language as current.
+
The '<u>Static pages</u>' form can be used to output a list of static pages for a specific language. This function is especially important if you created or edited your store's static pages using an external HTML editor: to manage externally created pages from within your store's Admin area, you need to get them listed in the '<u>Static pages</u>' form. The same holds true for the pre-configured root-level pages that come with X-Cart (message.html, permission_denied.html and shop_closed.html): the said pages do not appear on the static pages list until you get X-Cart to find all the existing static pages for the English language.
# Click the '''Find pages''' button. The '<u>Static pages</u>' dialog box will provide a list of all the root level static pages that it will be able to find in the directory <u>/xcart</u> and all the embedded pages that it will be able to find in the directory <u>/xcart/skin1/pages/<current_language> </u>(where <current_language> is a two-letter code of the language currently selected in the '<u>Current language</u>' box at the top of the page).
+
 
 +
To get the 'Static pages' form to display all your store's static pages in a specific language:
 +
# ''If your store is based on X-Cart 4.5.0 or later'': Make sure that any custom HTML pages in your store use the UTF-8 charset. Failure to use UTF-8 may later cause problems displaying such pages: in your store's front end some characters in such pages may appear as diamonds with question marks (the Unicode replacement character), whereas in your store's Admin area such pages will not be displayed at all (so you will not be able to view or edit them, which rather defeats the purpose of displaying the list of static pages in Admin).
 +
# In Admin area, open the 'Static pages' form and select the desired language as current.
 +
# Click the '''Find pages''' button. The '<u>Static pages</u>' form opens up a list of all the root-level static pages it finds in the directory <u>/xcart</u> and all the embedded pages it finds in the directory <u>/xcart/skin/common_files/pages/<current_language></u> (where <current_language> is a two-letter code of the language currently selected in the language selector).
 +
 
 +
{{Note1|Warning: In fact, the resulting list will include any HTML pages that X-Cart finds in the directories <u>/xcart</u> and <u>/xcart/skin/common_files/pages/<current_language></u>. This means, for example, that if you have an HTML catalog in your store's root, clicking the '''Find pages''' button will result in that the pages of the HTML catalog will be included into the static pages list.}}
 +
 
 +
You can quickly preview the content of any static page in the static pages list by clicking the '''Preview''' link opposite its title.
 +
 
 +
'''Editing the details of an existing static page'''
 +
 
 +
You can edit the details (name, content, etc) of any static page in your store.
  
To preview a page:
+
To edit the details of a static page:
  
 
# Select the language of the page as current.
 
# Select the language of the page as current.
# Find the page in the '<u>Static pages</u>' list and click the Preview link opposite the page title.
+
# Find the page in the list on the '<u>Static pages</u>' form and then click on its title.
 +
# On the '<u>Static page details</u>' form, edit the necessary details (See [[#Defining Static Page Details]]).
 +
# Click the '''Save''' button. The static page details are updated. You should see a confirmation message.
 +
 
 +
'''Changing the availability status of an embedded static page'''
  
To change the order in which static page links appear in the '<u>Help</u>' menu box in a certain language:
+
It is possible to restrict access of users to specific embedded static pages. For example, when you are editing the content of a static page, it is a good idea to make the page temporarily unavailable for viewing, i.e. to disable it.
  
# Select the desired language as current.
+
To temporarily disable an embedded page:
# Readjust the page position numbers in the POS. column of the '<u>Static pages</u>' list.
 
# Click the '''Update''' button.
 
  
To change the availability status of an embedded page for a certain language:
+
# Select the language of the page as current.
 +
# Find the page in the list on the '<u>Static pages</u>' form and deselect the <u>Status</u> check box opposite its title.
 +
# Click the '''Update''' button. This makes the page unavailable: anyone who requests this page (excluding your store's administrator users) will get the '403 access denied' error. Disabling a static page also disables the link to this page from the <u>Help</u> menu box of your store's Customer area, if such a link is provided.
  
# Select the desired language as current.
+
To re-enable a previously disabled static page, select the respective <u>Status</u> check box and click '''Update'''.
# Find the page whose status needs to be changed in the '<u>Static pages</u>' list and select the appropriate status - Enabled or Disabled - from the <u>STATUS</u> drop-down box opposite its title.
 
# Click the '''Update''' button.
 
  
To edit the details of a static page (name, content, etc):
+
{{Note|For earlier versions, the status of a static page can be changed by selecting either ''Enabled'' or ''Disabled'' from the STATUS drop-down box opposite the page title and clicking '''Update'''.}}
  
# Select the language of the page as current.
+
'''Deleting a static page'''
# Find the page in the '<u>Static pages</u>' list and click on its title.
 
# In the '<u>Static page details</u>' dialog box, edit the necessary details.
 
# Click the '''Save''' button.
 
  
To delete a static page in a certain language:
+
If you decide you no longer need one or more static pages, you can permanently remove them:
  
 
# Select the language of the page as current.
 
# Select the language of the page as current.
# Find the page that needs to be deleted in the '<u>Static pages</u>' list and select the check box next to its title.
+
# Find the page in the list on the '<u>Static pages</u>' form and select the check box next to its title.
# Click the '''Delete selected''' button.
+
# Click the '''Delete selected''' button. This removes the selected static pages. You should see a confirmation message.
  
==Defining Static Page Details==
+
'''Providing links to embedded static pages in the Help menu box'''
  
The details of a static page are defined in the '<u>Static page details</u>' dialog box:
+
You can specify which embedded static pages need to be linked to from the '<u>Help</u>' menu box in your store's Customer area. The set of static page links included into the '<u>Help</u>' menu box is adjusted separately for each of the supported languages.
  
: [[Image:static_page_details.gif|637px]]
+
To include a link to a specific embedded static page into the '<u>Help</u>' menu box:
  
For an embedded static page, provide the following details:
+
# Select the desired language as current.
 +
# Select the '<u>Show Link</u>' check box opposite the title of the embedded static page which needs to be made accessible via a link in the '<u>Help</u>' menu box.
 +
# Click the '''Update''' button. This updates the static page details and creates a link to the page in the '<u>Help</u>' menu box. You should see a confirmation message.
  
* <u>Page file</u>: The filename for this static page.
+
'''Reordering the items in the Static pages list / Help menu box'''
* <u>Page name</u>: The name by which you and your customers will be able to identify this static page.
 
* <u>Clean URL</u>: The clean URL value for this static page. Instructions for adjusting this field are available in the section [[X-Cart:Clean URLs#Defining Clean URL Values]] of this manual.
 
  
{{Note1|Note: The field 'Clean URL' needs to be adjusted only if X-Cart's Clean URLs functionality is enabled in your store. If the Clean URLs functionality is disabled, the field 'Clean URL' is inactive.}}
+
The value of the Pos. field opposite each static page title in the 'Static pages' form defines the position of the page's title in the list on the 'Static pages' form and - for embedded pages - in the '<u>Help</u>' menu box in your store's Customer area. In general, items with a smaller Pos. field value appear earlier in the list. The order of static page titles is adjusted separately for each of the supported languages.
  
* <u>Page content</u>: The content/HTML code of this page.
+
To reorder static page titles for a specific language:
  
{{Note1|Note: You can enter the content of the page in WYSIWYG mode if your store has the module HTML Editor enabled. For details, see the section [[X-Cart:HTML Editor]] in this manual.}}
+
# Select the desired language as current.
 +
# Readjust the page position numbers in the Pos. column of the '<u>Static pages</u>' form.
 +
# Click the '''Update''' button. The page titles are reordered. You should see a confirmation message.
  
* <u>META keywords</u>: The keywords to be used in the keywords meta tag of this static page.
+
<div id="ParseSmartyTags"></div>
* <u>META description</u>: The description to be used in the description meta tag of this static page.
+
'''Using Smarty with embedded static pages'''
  
For more information on using the description and keywords meta tags, see the section [[X-Cart:Configuring Page Titles and Meta Tags]] of this manual.
+
You can allow or disallow the use of Smarty tags and syntax in your store's embedded static pages. This is done by adjusting the check box option '<u>Parse Smarty tags in the content of embedded pages</u>' displayed below the list of embedded static pages in the 'Static pages' form. All you need to do is select or deselect the check box and click the '''Update''' button.
  
* <u>Status</u>: This option allows you to specify whether this page must be available for viewing to the visitors of your store's Customer area.
+
Alternatively, you can adjust the option '<u>Parse Smarty tags in the content of embedded static pages</u>' on the '<u>General settings/General options</u>' page ('Miscellaneous' section). That is exactly the same option which appears in two places.
* <u>Position</u>: The position of this static page in the list of static pages displayed in the '<u>Static pages</u>' dialog box and (if the option '<u>Show a link to the page in Help menu?</u>' is enabled) in the Help menu box of your store's Customer area.
 
* <u>Show a link to the page in Help menu?</u>: This option allows you to specify whether a link to this page must be included into the <u>Help</u> menu box of your store's Customer area.
 
  
For a root level static page, provide the following details:
+
For more information on Smarty, see http://www.smarty.net/docs/en/ (4.7.0 and later) http://www.smarty.net/docsv2/en/ (4.6.6 and earlier).
  
* <u>Page file</u>: The filename for this static page.
+
==Creating Versions of a Static Page for Different Languages==
* <u>Page name</u>: The name by which you will be able to identify this static page.
 
* <u>Page content</u>: The content/HTML code of this page.
 
  
==Creating Versions of a Static Page for Other Languages==
+
If your store uses multiple languages, each static page used in your store will need to have a version for each of the supported languages.
  
If your store supports more than one language, you must create the same static page in each of the supported languages.
+
To create a version of an existing static page in another language:
  
To create a new language version of an existing static page:
+
# Go to the '<u>Static pages</u>' section of your store's Admin area.
 
+
# Use the language selector to switch the interface of your store's Admin area to the language, in which the static page already exists.
# Select the language in which the static page exists as current for the Admin area (Use the '<u>Current language</u>' selector).
+
# Find the name of the static page in the list on the '<u>Static pages</u>' form and click on it. This opens the '<u>Static page details</u>' form with the details of the page you have selected.
# Go to the '<u>Static pages</u>' section.
+
# Switch the language selector to the language you want to translate the page to.
# In the '<u>Static pages</u>' dialog box, find the page that you wish to translate into another language and click on its name. This opens the '<u>Static page details</u>' dialog box with the details of the page you selected.
+
# Edit the fields of the '<u>Static page details</u>' form:
# Switch the '<u>Current language</u>' selector to the language into which you wish to translate the page.
+
#* Provide the language-specific page name, content, status and position.
# In the '<u>Static page details</u>' dialog box, edit the page details.
+
#* For an embedded static page, provide the language-specific meta keywords and meta description and specify whether the link to the page in this language is to be included in the <u>Help</u> menu box of your store's Customer area. <br />{{Note|The value of the '<u>Clean URL</u>' field is the same for all the versions of an embedded static page regardless of the language. Althought the '<u>Clean URL</u>' field remains editable while a static page is being translated into another language, editing the contents of this field does not create a separate clean URL for the page version being created.}}
#* Provide a language-specific page name, page content, status and position.
 
#* For an embedded static page, provide language-specific meta keywords and meta description, and specify, whether a link to this language version of the page must be included into the <u>Help</u> menu box of your store's Customer area.
 
 
# Click the '''Save''' button.
 
# Click the '''Save''' button.
  
When you click '''Save''', the new language version of the page is created. A message is displayed confirming that the page has been updated successfully.
+
Clicking '''Save''' creates the static page in the selected language. You should see a confirmation message.
  
 
== See also ==
 
== See also ==
  
[[X-Cart:FAQs#Where_do_I_edit_my_.22About_our_site.22.2C_.22Terms_.26_Conditions.22.2C_.22Privacy_statement.22_pages.3F | Where do I edit my "About our site", "Terms & Conditions", "Privacy statement" pages?]]
+
* [[X-Cart:FAQs#Where_do_I_edit_my_.22About_our_site.22.2C_.22Terms_.26_Conditions.22.2C_.22Privacy_statement.22_pages.3F | Where do I edit my "About our site", "Terms & Conditions", "Privacy statement" pages?]]
 +
* [[X-Cart:Setting_up_file_permissions#Templates_and_directories_containing_templates_and_embedded_static_pages | Setting up proper permissions for embedded static pages' directories and files.]]
  
 +
[[Category:X-Cart user manual]]
 +
 +
[[Category:X-Cart user manual]]
 +
[[Category:X-Cart user manual]]
 +
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Latest revision as of 13:26, 21 April 2015

Overview

The customer-facing area of your store's website will consist primarily of product, category and manufacturer pages. However, you may feel the need to add some more information that does not fit into pages of the said types; for example, you may want to add your store's Terms and Conditions, Privacy Policy and the like. X-Cart allows you to add pages to your website where you can place any content that you feel is needed. Such pages in X-Cart are called static pages. X-Cart supports two types of static pages:

  • Embedded
  • Root level

Root level pages are fully independent HTML files. They exist in X-Cart root (the directory where your X-Cart store is installed), hence the name. Root pages do not depend on the rest of X-Cart pages, so they must be full HTML-files (must include tags like <HTML>...</HTML>).

Embedded pages are pages that are placed inside standard X-Cart pages. Their appearance depends on the design of your store in general, as you create only the page content. The content of embedded pages is displayed in your store's Information column (the widest column in any X-Cart's standard template scheme). Embedded pages do not use tags like <HTML>, <HEAD>, <BODY>.

Root level pages are stored in the X-Cart root directory, embedded pages - in the subdirectories of the directory skin/common_files/pages named after the respective languages (for example, pages for the English language are stored in the directory skin/common_files/pages/en, pages for the German language - in the directory skin/common_files/pages/de, etc.)

X-Cart 4.0or above
Note: In versions prior to 4.4.x, embedded pages are stored in the corresponding subdirectories of the directory skin1/pages named after the respective languages (for example, pages for the English language are stored in the directory skin1/pages/US, pages for the German language - in the directory skin1/pages/DE, etc.)

X-Cart comes with the following root level static pages out of the box:

  • message (<xcart_dir>/message.html)
  • permission_denied (<xcart_dir>/permission_denied.html)
  • shop_closed (<xcart_dir>/shop_closed.html)

It also has a few pre-created embedded pages:

  • About our site (<xcart_dir>/skin/common_files/pages/en/about_our_site.html)
  • FAQ (<xcart_dir>/skin/common_files/pages/en/faq.html)
  • Terms & Conditions (<xcart_dir>/skin/common_files/pages/en/terms.html)
  • Privacy statement (<xcart_dir>/skin/common_files/pages/en/privacy_statement.html)
  • Publicity (<xcart_dir>/skin/common_files/pages/en/publicity.html)

(By default, links to the above named embedded pages are included into the 'Help' menu box in your store's Customer area.)

On a fresh X-Cart install, the above pages contain dummy text. Before going live with your store, you should edit the contents of the said pages so they provide meaningful content for your customers. If you do not want to use these pages, remove or disable them (See Managing Static Pages for more info).

The file include/func/func.pages.php defines aliases for your store's default embedded pages:

$page_aliases = array(
'faq' => 'faq',
'about' => 'about_our_site',
'business' => 'privacy_statement',
'conditions' => 'terms',
'publicity' => 'publicity',
);

As a result, the pages can be accessed at the following aliases:

  • About our site: httр://<YOUR_XCART_STORE>/pages.php?alias=about
  • FAQ: httр://<YOUR_XCART_STORE>/pages.php?alias=faq
  • Terms & Conditions: httр://<YOUR_XCART_STORE>/pages.php?alias=conditions
  • Privacy statement: httр://<YOUR_XCART_STORE>/pages.php?alias=business
  • Publicity: httр://<YOUR_XCART_STORE>/pages.php?alias=publicity

Adding Static Pages

Both embedded and root-level static pages can be created using the 'Static pages' section of your store's Admin area.

To add a new static page:

  1. Go to the 'Static pages' section of your store's Admin area (Content -> Static pages). This opens the 'Static pages' form.

    Static pages.png

  2. (If your store supports multiple languages) From the Language selector at the top of the 'Static pages' form, select the language in which you are going to add a static page. This switches the active language of the Admin area so you can provide content for the new page in the chosen language.
  3. Depending on the type of static page you are adding (embedded or root-level), choose either the 'Embedded level' or the 'Root level' subsection of the 'Static pages' form. In the respective subsection, click the Add new... button. This opens the 'Static page details' form.
  4. Use the 'Static page details' form to provide the details of the new static page (See #Defining Static Page Details).
  5. Click the Save button at the bottom of the 'Static page details' form to save the changes.

Clicking Save creates the static page. You should see a confirmation message.

The Pages list button at the top of the 'Static page details' form allows you to return to the 'Static pages' form where you will be able to see the new page added to the static pages list.

Note: At any moment in time, the static pages list displays only the static pages that were created in the language currently used for viewing the Admin area.

Defining Static Page Details

When you create or edit a static page, you define its details using the 'Static page details' form.

For embedded static pages, the 'Static page details' form looks as follows:

Embedded static page details.png

It contains the following fields:

  • Page file: File name of the static page.
  • Page name: Name by which you and your customers will be able to identify this static page.
  • Clean URL: Clean URL value for this static page. Instructions on editing this field are available in X-Cart:Clean URLs#Defining Clean URL Values.
Note: The 'Clean URL' field needs to be adjusted only if the Clean URLs functionality is enabled in your X-Cart store. If the Clean URLs functionality is disabled, the 'Clean URL' field appears inactive.
  • Page content: Content/HTML source code of the page.
Note: You can edit the content of the page in WYSIWYG mode if your store has the HTML Editor module enabled. For details, see the X-Cart:HTML Editor section in this manual.
  • Title tag: Title to be used in the title tag of the static page.
  • META keywords: Keywords to be listed in the keywords meta tag of the static page.
  • META description: Description to be placed in the description meta tag of the static page.
Note: For more information on using the description and keywords meta tags, see the X-Cart:Configuring Page Titles and Meta Tags section of this manual.
  • Status: This option allows you to specify whether the page should be available for viewing to the visitors of your store's Customer area.
  • Position: Position of the static page title in the list of static pages within the 'Static pages' form and (if the 'Show a link to the page in Help menu?' option is enabled) on the Help menu box of your store's Customer area.
  • Show a link to the page in Help menu?: This option allows you to specify whether the link to this page should be included in the Help menu box of your store's Customer area.

For a root level static page, the 'Static page details' form contains only the following fields:

Root static page details.png
  • Page file: Filename for this static page.
  • Page name: Name by which you will be able to identify this static page.
  • Page content: Content/HTML source code of this page.

To define the details of a static page, you need to provide all the necessary information in the respective fields of the 'Static page details' form and click the Save button at the bottom. After the static page details have been saved, you should see a confirmation message.

Managing Static Pages

Your store's embedded and root level static pages can be managed using the controls of the 'Static pages' form.

Finding all static pages in a specific language

The 'Static pages' form can be used to output a list of static pages for a specific language. This function is especially important if you created or edited your store's static pages using an external HTML editor: to manage externally created pages from within your store's Admin area, you need to get them listed in the 'Static pages' form. The same holds true for the pre-configured root-level pages that come with X-Cart (message.html, permission_denied.html and shop_closed.html): the said pages do not appear on the static pages list until you get X-Cart to find all the existing static pages for the English language.

To get the 'Static pages' form to display all your store's static pages in a specific language:

  1. If your store is based on X-Cart 4.5.0 or later: Make sure that any custom HTML pages in your store use the UTF-8 charset. Failure to use UTF-8 may later cause problems displaying such pages: in your store's front end some characters in such pages may appear as diamonds with question marks (the Unicode replacement character), whereas in your store's Admin area such pages will not be displayed at all (so you will not be able to view or edit them, which rather defeats the purpose of displaying the list of static pages in Admin).
  2. In Admin area, open the 'Static pages' form and select the desired language as current.
  3. Click the Find pages button. The 'Static pages' form opens up a list of all the root-level static pages it finds in the directory /xcart and all the embedded pages it finds in the directory /xcart/skin/common_files/pages/<current_language> (where <current_language> is a two-letter code of the language currently selected in the language selector).
Warning: In fact, the resulting list will include any HTML pages that X-Cart finds in the directories /xcart and /xcart/skin/common_files/pages/<current_language>. This means, for example, that if you have an HTML catalog in your store's root, clicking the Find pages button will result in that the pages of the HTML catalog will be included into the static pages list.

You can quickly preview the content of any static page in the static pages list by clicking the Preview link opposite its title.

Editing the details of an existing static page

You can edit the details (name, content, etc) of any static page in your store.

To edit the details of a static page:

  1. Select the language of the page as current.
  2. Find the page in the list on the 'Static pages' form and then click on its title.
  3. On the 'Static page details' form, edit the necessary details (See #Defining Static Page Details).
  4. Click the Save button. The static page details are updated. You should see a confirmation message.

Changing the availability status of an embedded static page

It is possible to restrict access of users to specific embedded static pages. For example, when you are editing the content of a static page, it is a good idea to make the page temporarily unavailable for viewing, i.e. to disable it.

To temporarily disable an embedded page:

  1. Select the language of the page as current.
  2. Find the page in the list on the 'Static pages' form and deselect the Status check box opposite its title.
  3. Click the Update button. This makes the page unavailable: anyone who requests this page (excluding your store's administrator users) will get the '403 access denied' error. Disabling a static page also disables the link to this page from the Help menu box of your store's Customer area, if such a link is provided.

To re-enable a previously disabled static page, select the respective Status check box and click Update.

Note: For earlier versions, the status of a static page can be changed by selecting either Enabled or Disabled from the STATUS drop-down box opposite the page title and clicking Update.

Deleting a static page

If you decide you no longer need one or more static pages, you can permanently remove them:

  1. Select the language of the page as current.
  2. Find the page in the list on the 'Static pages' form and select the check box next to its title.
  3. Click the Delete selected button. This removes the selected static pages. You should see a confirmation message.

Providing links to embedded static pages in the Help menu box

You can specify which embedded static pages need to be linked to from the 'Help' menu box in your store's Customer area. The set of static page links included into the 'Help' menu box is adjusted separately for each of the supported languages.

To include a link to a specific embedded static page into the 'Help' menu box:

  1. Select the desired language as current.
  2. Select the 'Show Link' check box opposite the title of the embedded static page which needs to be made accessible via a link in the 'Help' menu box.
  3. Click the Update button. This updates the static page details and creates a link to the page in the 'Help' menu box. You should see a confirmation message.

Reordering the items in the Static pages list / Help menu box

The value of the Pos. field opposite each static page title in the 'Static pages' form defines the position of the page's title in the list on the 'Static pages' form and - for embedded pages - in the 'Help' menu box in your store's Customer area. In general, items with a smaller Pos. field value appear earlier in the list. The order of static page titles is adjusted separately for each of the supported languages.

To reorder static page titles for a specific language:

  1. Select the desired language as current.
  2. Readjust the page position numbers in the Pos. column of the 'Static pages' form.
  3. Click the Update button. The page titles are reordered. You should see a confirmation message.

Using Smarty with embedded static pages

You can allow or disallow the use of Smarty tags and syntax in your store's embedded static pages. This is done by adjusting the check box option 'Parse Smarty tags in the content of embedded pages' displayed below the list of embedded static pages in the 'Static pages' form. All you need to do is select or deselect the check box and click the Update button.

Alternatively, you can adjust the option 'Parse Smarty tags in the content of embedded static pages' on the 'General settings/General options' page ('Miscellaneous' section). That is exactly the same option which appears in two places.

For more information on Smarty, see http://www.smarty.net/docs/en/ (4.7.0 and later) http://www.smarty.net/docsv2/en/ (4.6.6 and earlier).

Creating Versions of a Static Page for Different Languages

If your store uses multiple languages, each static page used in your store will need to have a version for each of the supported languages.

To create a version of an existing static page in another language:

  1. Go to the 'Static pages' section of your store's Admin area.
  2. Use the language selector to switch the interface of your store's Admin area to the language, in which the static page already exists.
  3. Find the name of the static page in the list on the 'Static pages' form and click on it. This opens the 'Static page details' form with the details of the page you have selected.
  4. Switch the language selector to the language you want to translate the page to.
  5. Edit the fields of the 'Static page details' form:
    • Provide the language-specific page name, content, status and position.
    • For an embedded static page, provide the language-specific meta keywords and meta description and specify whether the link to the page in this language is to be included in the Help menu box of your store's Customer area.
      Note: The value of the 'Clean URL' field is the same for all the versions of an embedded static page regardless of the language. Althought the 'Clean URL' field remains editable while a static page is being translated into another language, editing the contents of this field does not create a separate clean URL for the page version being created.
  6. Click the Save button.

Clicking Save creates the static page in the selected language. You should see a confirmation message.

See also