PhotoStore Documentation


How to change various text in the store?

There are two main areas in which you can change text in the store. 

Before you get started:
You will want to make sure to make a backup of any files before you make modifications to it. This way if you modify it incorrectly and cause an error you can replace it with the original again. To modify files you will need knowledge of how to use an FTP client to download files from your web hosting, modify it, and then upload it back to your hosting. When editing a language file make sure that you save the file as UTF-8 no BOM (byte object marks). If you do not save it as UTF-8 some characters may not look correct online. Also if you save with a BOM (byte object mark) the file will throw an output error in PHP. So if you see an error on your site like "output error on line 1" then you most of saved the file with a BOM.

The Manager
Using the store manager you can change various large text, like page contents, privacy policies, terms of use, etc.. Just log into your manager and go to content editor -> page content. From there you will see a list of content on your store front that you can edit. You can also go to content editor -> email content and change content that is found in the emails your store sends.

The Language Files
The lanuage files of the store will hold all the small text like a phrase or one liners. To modify a language file you will need to know how to FTP files to and from your site. You will need to know how to use a text editor to open a file and modify it. You can find your language files located in the assets/languages/ directory of your store files. In that language directory you will find a folder for each language that is currently available. For example for English you will see it at /assets/languages/english/. In each of the actual language directory you will find 7 files.
flag.png: The flag.png is just a flag image of the country the language is for.
lang.calendar.php: This file holds all the text for things related to a calendar (days, months, etc..).
lang.gateways.php: This file holds all the text for the payment gateways (paypal,  pay by mobile, etc..).
lang.manager.php: This file holds all the text for the store manager area.
lang.public.php: This file holds all the small one liner text and phrases for the store front area.
lang.settings.php: This is the setting file for the language, it holds settings like character set, version info, translated by info, name of the language, etc..
lang.widgets.php: This file holds the text for the widgets area in the store manager (dashboard area). 

To modify one of the language files you can simply open the file in your favorite text editor (try to advoid any that will put extra formatting into your files like for example Microsoft Word). Find the line you want to edit, like for example:
$lang['paymentThanks']    = "Thank you for your payment.";
Change the parts in the " ". Like for example.
$lang['paymentThanks']    = "Thank you for your payment we will contact you shortly with details.";
Now save your changes. You may have to download the file to your computer from your site, edit it, and then save the changes, then upload it back to your site files replacing the original. 
After you made the change, now you will see it on your website.

Creating a new language
To create a new language you can just copy an existing language files, and paste it to a new directory created by you for that language. The directory you create must be one word, no spaces, and all lowercase alphabet characters. Once you pasted the files in that new directory you created for that language you will want to open the lang.settings.php file and modify the contents of that file for your new language. The most important thing is the:
$langset['id']     = "english";  // Language ID - MUST MATCH THE DIRECORY NAME EXACTLY - NO SPACES - ALL LOWERCASE
That line "english" (or what ever language you copied) must match exactly the same name as your directory. If not then the new language will not work!
After you get the settings file taken care of, you may wish to change the flag.png file to match the flag of the country you are creating the new language for. After that you can now see the language as a selection in the manager settings -> languages area. You can also go ahead and now translate the additional langauge files.