Difference between revisions of "Change Language Files"

From Phoenix Cart User Guide
Line 33: Line 33:
 
*'''footer-suffix''' modules shown below the footer at the bottom of the page.
 
*'''footer-suffix''' modules shown below the footer at the bottom of the page.
  
−
<!--
 
−
, look in the page footer and click the '''Privacy & Cookie Policy''' link.
 
  
−
This will open the page - you will see that this page is generated by the file '''privacy.php''' - this is shown in your browser address bar - the file name is '''privacy''' and the file type extension is '''.php'''.
 
  
−
Find this '''privacy''' file in your backup folder/directory on your computer <big>'''([[How to Back Up]])'''</big> - you will find it in the top Phoenix folder/directory - all the main pages that show in your shop will be found here.
+
You can change the text language file from admin - go to [[File:adminnavbartools.png|link=]] '''Tools → Define Languages''' to see this list:
−
 
 
−
This file contains all the code to make the page work and you should not normally change anything in it - these type of files are generally referred to as '''core code''' - it is the mechanics so don't touch it unless you know what you're doing or you will break things!
 
−
 
 
−
Open '''privacy''' with your file editor.
 
−
 
 
−
In the code there will be a reference to the text you see on the page - just a code for each different piece of text.
 
−
 
 
−
<div class="mainpage_box">
 
−
[[File:Vscprivacy.png|link=|1500px]]
 
−
</div>
 
−
 
 
−
In this case there are 4 pieces of text so there are 4 codes:
 
−
 
 
−
*<code>NAVBAR_TITLE</code> for the text that shows in the breadcrumb.
 
−
*<code>HEADING_TITLE</code> for the text that shows in the page title.
 
−
*<code>TEXT_INFORMATION</code> for the main text.
 
−
*<code>IMAGE_BUTTON_CONTINUE</code> for the text that shows in the "Continue" button.
 
−
 
 
−
They are easy to find - these language codes are always written in upper case.
 
−
 
 
−
The codes for each piece of text are '''defined''' in a statement in a corresponding '''language file'''.
 
−
 
 
−
For example, the '''defines''' for the text you see will be found in the language file found in '''includes/languages/english/privacy.php'''.
 
−
 
 
−
Note that the language file has the same name as the corresponding main page file.
 
−
 
 
−
-->
 
−
 
 
−
You can find and open language files associated with the modules from admin - go to [[File:adminnavbartools.png|link=]] '''Tools → Define Languages''' to see this:
 
 
<div class="mainpage_box">
 
<div class="mainpage_box">
 
[[File:toolsdefinelanguages.png|link=|1500px]]
 
[[File:toolsdefinelanguages.png|link=|1500px]]
 
</div>
 
</div>
  
−
<!--
+
For example, change the text that shows as '''Welcome on 1061'''.
−
*Look for '''privacy.php''' in the list.
 
−
*Click to open it to see this.
 
−
<div class="mainpage_box">
 
−
[[File:privacy.png|link=|1500px]]
 
−
</div>
 
  
−
*Look for the '''defines''' - in this case there will be 3 '''defines''' showing as
+
Look in the list for '''modules/content/index/cm_i_title.php''' and click it to make changes.
−
<pre>define('NAVBAR_TITLE', 'Privacy Notice');
 
−
define('HEADING_TITLE', 'Privacy Notice');
 
−
define('TEXT_INFORMATION', 'Put here your Privacy Notice information.');</pre>
 
  
−
These '''defines''' are for text that shows specifically on the '''privacy''' page - the '''define''' for the text that shows in the "Continue" button is not in this file because that will show on other pages too - it is found in the main '''english.php''' language file.  
+
Look in the file for the line - '''const MODULE_CONTENT_I_TITLE_PUBLIC_TITLE = 'Welcome on %s';'''.
  
−
Note: In some language files these '''defines''' are written in a different format using a '''constant''' although they work in exactly the same way e.g.
+
The '''%s''' is magic code that automatically gets your '''Store Name''' that you entered when installing CE Phoenix, that was entered as '''1061''' in the example. That can be changed from admin '''Configuration → My Store'''. Do not change or delete that '''%s''' and be sure not to delete one of the single quote marks by mistake or you will break things!.
−
<pre>const TEXT_INFORMATION = 'Put here your Privacy Notice information.';</pre>
 
  
−
The text will show between two single quote marks e.g. <pre>'Put here your Privacy Notice information.'</pre>
+
For example, change '''Welcome on''' to '''Welcome to''' and click Save.
−
Now you have the language file open, change the text between the single quotes and click save.
 
−
-->
 
  
 
Open the website page again to see your changes or if you still have the page open, refresh or reload the page to see the changes.
 
Open the website page again to see your changes or if you still have the page open, refresh or reload the page to see the changes.
  
−
Only ever change the text between the quotes - be sure not to delete one of the quotes by mistake or you will break things!.
 
  
−
Just about every page and module in Phoenix will work this way and have it's own corresponding language file.
+
 
 +
Just about every page and module in CE Phoenix will work this way and have it's own corresponding language file.
  
 
The exceptions are the main language files named '''english.php''', there is one for the admin and one for the shop, which control text for many different pages.
 
The exceptions are the main language files named '''english.php''', there is one for the admin and one for the shop, which control text for many different pages.
  
−
All of the text can be changed in those '''define''' statements to personalise the text or messages displayed.
 
−
 
−
So remember - you can change anything in a language file define statement between those two quotes.
 
  
 
IMPORTANT: If you enter any more quotes in your text, you must use a backslash before the quote e.g. '''don\'t''' or you will confuse the system and break things!
 
IMPORTANT: If you enter any more quotes in your text, you must use a backslash before the quote e.g. '''don\'t''' or you will confuse the system and break things!

Revision as of 10:21, 29 August 2020

<historylink type="back">🠈 Back</historylink> 🠉 SET UP SHOP


ABOUT LANGUAGE FILES

CE Phoenix is English by default but other Language Packs are available to download - the links to find them are shown in the README file in the CE Phoenix download - download and install now if required. These Language Packs are independently maintained by volunteers so contact the maintainer if you need support for them.

Changes to the text shown in the shop can easily be made to localise and personalise the shop to suit you.

Let's first explain a little about the basic working mechanics of Phoenix.

Using a new installation and the main page (home page) as an example, in your browser go to your website to see similar to this:

Shop.png


Look in your browser address bar and you will see the page as yoursite.com/index.php (if it only shows yoursite.com, click the shop logo to refresh the page) so this page is named index.php.

Note that most everything in CE Phoenix is modularised so a lot of the text showing on the page will be in language files associated with those modules.

As seen in the example, the page could be described in groups of modules.

So, from the top, there are:

  • navbar modules shown in the navigation bar at the top of the page.
  • header modules shown just below the navigation bar.
  • boxes modules shown on the left and right of the central page contents.
  • index modules shown in the central page contents.
  • footer modules shown at the base of the page.
  • footer-suffix modules shown below the footer at the bottom of the page.


You can change the text language file from admin - go to Adminnavbartools.png Tools → Define Languages to see this list:

Toolsdefinelanguages.png

For example, change the text that shows as Welcome on 1061.

Look in the list for modules/content/index/cm_i_title.php and click it to make changes.

Look in the file for the line - const MODULE_CONTENT_I_TITLE_PUBLIC_TITLE = 'Welcome on %s';.

The %s is magic code that automatically gets your Store Name that you entered when installing CE Phoenix, that was entered as 1061 in the example. That can be changed from admin Configuration → My Store. Do not change or delete that %s and be sure not to delete one of the single quote marks by mistake or you will break things!.

For example, change Welcome on to Welcome to and click Save.

Open the website page again to see your changes or if you still have the page open, refresh or reload the page to see the changes.


Just about every page and module in CE Phoenix will work this way and have it's own corresponding language file.

The exceptions are the main language files named english.php, there is one for the admin and one for the shop, which control text for many different pages.


IMPORTANT: If you enter any more quotes in your text, you must use a backslash before the quote e.g. don\'t or you will confuse the system and break things!



Users most commonly want to change the following:

  • Catalog in the breadcrumb - Tools → Define Languages and look for english.php
  • Text on the front main page - Tools → Define Languages and look for modules/content/index/cm_i_title.php, modules/content/index/cm_i_customer_greeting.php
  • Text on shop information pages - Tools → Define Languages and look for privacy.php, conditions.php and shipping.php.

CE Phoenix is modular meaning some pages are comprised of different modules. In this case the language define will be found in the language file for the module and not for the page. This can make it difficult to find them but to find the language files to change text see - How to Change Text


🠈 Previous Step Next Step 🠊

Phoenix Cart User Guide, like CE Phoenix Cart, is free to use but is maintained by unpaid volunteers.

Code references are licensed under a Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales License.
All other content is the reserved Intellectual Property and Copyright of phoenixcart.org
Retrieved from ‘https://phoenixcart.org/phoenixcartwiki/index.php?title=Change_Language_Files&oldid=3547’