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

From X-Cart 4 Classic
Jump to: navigation, search
(skin1/ --> skin/common_files/)
(Actualized in the contents of ticket 104677)
Line 15: Line 15:
  
 
* message.html
 
* message.html
 
 
* permission_denied.html
 
* permission_denied.html
 
* shop_closed.html
 
* shop_closed.html
 
* under_update.html
 
* under_update.html
  
Information on how you can add static pages is available in the chapter [[#Adding Static Pages | Adding Static Pages]].
+
Instructions on adding static pages are available in [[#Adding Static Pages | Adding Static Pages]].
  
Information on how you can manage existing static pages is available in the chapter [[#Managing Static Pages | Managing Static Pages]].
+
Instructions on managing existing static pages are available in [[#Managing Static Pages | Managing Static Pages]].
  
 
==Adding Static Pages==
 
==Adding Static Pages==
  
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>
 
# ''(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 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>'.
 
 
 
A dialog box titled '<u>Static page details</u>' opens.
 
  
# In the '<u>Static page details</u>' dialog box, provide the details of the static page being created (See [[#Defining Static Page Details]]).
+
# 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>[[Image:static_pages.gif|584px]]<br><br>
# Click the '''Save''' button at the bottom of the '<u>Static page details</u>' dialog box.
+
# ''(If your store supports multiple languages)'' From the '''Language''' selector at the top of the '<u>Static pages</u>' form, select the language the static page is going to be added for.
 +
# If you are creating an embedded page, click the '''Add new...''' button in the '<u>Embedded level</u>' subsection. If you are creating a root-level page, click the '''Add new...''' button in the '<u>Root level</u>' subsection.<br><br>This opens the '<u>Static page details</u>' form.<br><br>
 +
# On the '<u>Static page details</u>' form, provide details for the static page to be created (See [[#Defining Static Page Details]]).
 +
# Click the '''Save''' button at the bottom of the '<u>Static page details</u>' form.
  
When you click on '''Save''', the static page is created. A message is displayed confirming that the static page has been created successfully.
+
Clicking '''Save''' creates the static page and pops up the confirmation message that the static page has been created successfully.
  
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.
+
To return to the list of your store's static pages, click the '''Pages list''' button at the top of the '<u>Static page details</u>' form.
  
  
Line 45: Line 41:
 
==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 on the '<u>Static pages</u>' form.
  
To find all your store's static pages for a certain language:
+
'''To find all your store's static pages for a certain language:'''
  
 
# Select the desired language as current.
 
# Select the desired language as current.
# 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/skin/common_files/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).
+
# Click the '''Find pages''' button. The '<u>Static pages</u>' form will open up a list of all the root-level static pages it finds in the <u>/xcart</u> directory and all the embedded pages it finds in the <u>/xcart/skin/common_files/pages/<current_language</u> directory (where <current_language> is a two-letter code of the language currently selected in the '''Current language''' box at the top of the page).
  
To preview a page:
+
'''To preview a 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 on the '<u>Static pages</u>' list and click the '''Preview''' button by the page title.
  
To change the order in which static page links appear in the '<u>Help</u>' menu box in a certain language:
+
'''To change the order of static page links on the '<u>Help</u>' menu box in a certain language:'''
  
 
# Select the desired language as current.
 
# Select the desired language as current.
Line 63: Line 59:
 
# Click the '''Update''' button.
 
# Click the '''Update''' button.
  
To change the availability status of an embedded page for a certain language:
+
'''To change availability status of an embedded page for a certain language:'''
  
 
# Select the desired language as current.
 
# Select the desired language as current.
# 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.
+
# Find the page to change status for on the '<u>Static pages</u>' list and then select the required status - Enabled or Disabled - from the <u>STATUS</u> drop-down box by its title.
 
# Click the '''Update''' button.
 
# Click the '''Update''' button.
  
To edit the details of a static page (name, content, etc):
+
'''To edit the details of a static page (name, content, etc.):'''
  
 
# 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 on its title.
+
# Find the page on the '<u>Static pages</u>' list and then click on its title.
# In the '<u>Static page details</u>' dialog box, edit the necessary details.
+
# On the '<u>Static page details</u>' form, edit the necessary details.
 
# Click the '''Save''' button.
 
# Click the '''Save''' button.
  
To delete a static page in a certain language:
+
'''To delete a static page in a certain language:'''
  
 
# 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 to be deleted on the '<u>Static pages</u>' list and then select the check box next to its title.
 
# Click the '''Delete selected''' button.
 
# Click the '''Delete selected''' button.
  
 
==Defining Static Page Details==
 
==Defining Static Page Details==
  
The details of a static page are defined in the '<u>Static page details</u>' dialog box:
+
Static page details are defined on the '<u>Static page details</u>' form:
  
 
: [[Image:static_page_details.gif|637px]]
 
: [[Image:static_page_details.gif|637px]]
  
For an embedded static page, provide the following details:
+
For embedded static page, provide the following details:
  
* <u>Page file</u>: The filename for this static page.
+
* <u>Page file</u>: file name of the static page.
* <u>Page name</u>: The name by which you and your customers will be able to identify this 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>: 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.
+
* <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]].
  
{{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.}}
+
{{Note|The 'Clean URL' field should 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>: The content/HTML code of this page.
+
* <u>Page content</u>: content HTML source code of the page.
  
{{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.}}
+
{{Note|You can edit the content of the page in the 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>: The title to be used in the title bar of this static page.
+
* <u>Title tag</u>: title to be used in the title tag of the static page.
* <u>META keywords</u>: The keywords to be used in the keywords meta tag of this static page.
+
* <u>META keywords</u>: keywords to be listed in the keywords meta tag of the static page.
* <u>META description</u>: The description to be used in the description meta tag of this static page.
+
* <u>META description</u>: description to be placed in the description meta tag of the static page.
  
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.
+
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.
  
* <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.
+
* <u>Status</u>: allows to specify whether the page is available for viewing to visitors of your store's Customer area.
* <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>Position</u>: position of the static page on the list on 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 a link to this page must be included into the <u>Help</u> menu box of your store's Customer area.
+
* <u>Show a link to the page in Help menu?</u>: allows to specify whether the link to this page should be included in the <u>Help</u> menu box of your store's Customer area.
  
 
For a root level static page, provide the following details:
 
For a root level static page, provide the following details:
  
* <u>Page file</u>: The filename for this static page.
+
* <u>Page file</u>: filename for this static page.
* <u>Page name</u>: The name by which you will be able to identify this static page.
+
* <u>Page name</u>: name, by which you will be able to identify this static page.
* <u>Page content</u>: The content/HTML code of this page.
+
* <u>Page content</u>: content/HTML source code of this page.
  
 
==Creating Versions of a Static Page for Other Languages==
 
==Creating Versions of a Static Page for Other Languages==
  
If your store supports more than one language, you must create the same static page in each of the supported languages.
+
If your store supports multiple languages, you must create each same static page in each of the supported languages.
  
To create a new language version of an existing static page:
+
'''To create a new language version of an existing static page:'''
  
# Select the language in which the static page exists as current for the Admin area (Use the '<u>Current language</u>' selector).
+
# Select the language, in which the static page exists as current, for the Admin area (use the '''Current language''' selector).
 
# Go to the '<u>Static pages</u>' section.
 
# Go to the '<u>Static pages</u>' section.
# 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.
+
# On the '<u>Static pages</u>' form, look up the page to be translated to other language and click on its name. This opens the '<u>Static page details</u>' form with the details of the page you have selected.
# Switch the '<u>Current language</u>' selector to the language into which you wish to translate the page.
+
# Switch the '''Current language''' selector to the language you want to translate the page to.
# In the '<u>Static page details</u>' dialog box, edit the page details.
+
# On the '<u>Static page details</u>' form, edit the page details.
#* Provide a language-specific page name, page content, status and position.
+
#* Provide the language-specific page name, 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.
+
#* 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.
 
# 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 and pops up the confirmation message that the static page has been created successfully.
  
 
== See also ==
 
== See also ==
Line 139: Line 135:
 
[[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]]
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Revision as of 15:00, 9 February 2011

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:

  • Embedded
  • Root

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 'Help' menu box. Embedded pages do not use tags like <HTML>, <HEAD>, <BODY>.

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

Four root level pages are defined by default:

  • message.html
  • permission_denied.html
  • shop_closed.html
  • under_update.html

Instructions on adding static pages are available in Adding Static Pages.

Instructions on managing existing static pages are available in Managing Static Pages.

Adding Static Pages

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.gif

  2. (If your store supports multiple languages) From the Language selector at the top of the 'Static pages' form, select the language the static page is going to be added for.
  3. If you are creating an embedded page, click the Add new... button in the 'Embedded level' subsection. If you are creating a root-level page, click the Add new... button in the 'Root level' subsection.

    This opens the 'Static page details' form.

  4. On the 'Static page details' form, provide details for the static page to be created (See #Defining Static Page Details).
  5. Click the Save button at the bottom of the 'Static page details' form.

Clicking Save creates the static page and pops up the confirmation message that the static page has been created successfully.

To return to the list of your store's static pages, click the Pages list button at the top of the 'Static page details' form.


Managing Static Pages

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

To find all your store's static pages for a certain language:

  1. Select the desired language as current.
  2. Click the Find pages button. The 'Static pages' form will open up a list of all the root-level static pages it finds in the /xcart directory and all the embedded pages it finds in the /xcart/skin/common_files/pages/<current_language directory (where <current_language> is a two-letter code of the language currently selected in the Current language box at the top of the page).

To preview a page:

  1. Select the language of the page as current.
  2. Find the page on the 'Static pages' list and click the Preview button by the page title.

To change the order of static page links on the 'Help' menu box in a certain language:

  1. Select the desired language as current.
  2. Readjust the page position numbers in the POS. column of the 'Static pages' list.
  3. Click the Update button.

To change availability status of an embedded page for a certain language:

  1. Select the desired language as current.
  2. Find the page to change status for on the 'Static pages' list and then select the required status - Enabled or Disabled - from the STATUS drop-down box by its title.
  3. Click the Update button.

To edit the details of a static page (name, content, etc.):

  1. Select the language of the page as current.
  2. Find the page on the 'Static pages' list and then click on its title.
  3. On the 'Static page details' form, edit the necessary details.
  4. Click the Save button.

To delete a static page in a certain language:

  1. Select the language of the page as current.
  2. Find the page to be deleted on the 'Static pages' list and then select the check box next to its title.
  3. Click the Delete selected button.

Defining Static Page Details

Static page details are defined on the 'Static page details' form:

Static page details.gif

For embedded static page, provide the following details:

  • 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 should 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 the 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.

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: allows to specify whether the page is available for viewing to visitors of your store's Customer area.
  • Position: position of the static page on the list on 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?: allows 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, provide the following details:

  • 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.

Creating Versions of a Static Page for Other Languages

If your store supports multiple languages, you must create each same static page in each of the supported languages.

To create a new language version of an existing static page:

  1. Select the language, in which the static page exists as current, for the Admin area (use the Current language selector).
  2. Go to the 'Static pages' section.
  3. On the 'Static pages' form, look up the page to be translated to other language and click on its name. This opens the 'Static page details' form with the details of the page you have selected.
  4. Switch the Current language selector to the language you want to translate the page to.
  5. On the 'Static page details' form, edit the page details.
    • 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.
  6. Click the Save button.

Clicking Save creates the static page and pops up the confirmation message that the static page has been created successfully.

See also

Where do I edit my "About our site", "Terms & Conditions", "Privacy statement" pages?