Censura Support

Language Files Overview

You can edit any language phrase in censura without having to "hack" files.

Language File Overview

/lang/ contains many files and folders with translated phrases. General sitewide phrases are stored in main.php:

$lang['SOME_PHRASE'] = 'Translated phrase';

Then when {$text->some_phrase} is called in the template (or __('SOME_PHRASE') from php code) it will return "Translated phrase" instead. Because this file would get too big storing all site phrases, phrases for specific pages are stored in the view subdirectory. The phrases in these files are in a slightly different format:

$lang['VIEW_PAGE_NAME']['SOME_PHRASE'] = 'Different Translated phrase';

This would be contained in the file views/pagename.php. These phrases override the defaults in main.php for the page to which it applies. "PAGENAME" comes from the name of the action which runs the page. If the action was PageName then the key would become PAGE_NAME. You can find out the action for a page by disabling routing and looking at the action= part of the URL. You can use variables in the translated phrase. Which variables are available depends on the page you are accessing, for example on the ProductDetail page the $product varaible wll be available, on CategoryDetail the $category varaible will be available etc.

Here are some common pages and their actions: - Home Page: Index - Product Page: ProductDetail - Review Page: ReviewDetail - Vendor List: VendorIndex - Vendor Page: VendorDetail - Category Page: CategoryDetail - User CP: User_Index

(Please note also that email phrases are stored in the email folder, and phrases in forms are in the forms folder)

Create a my_phrases.php File

In /lang/ rename README.php to myphrases.php. You can now add your own phrases in here which will always override the defaults, and won't get overwritten when you upgrade. Copy the line which contains the phrase you want to change, paste it into myphrases.php between the tags, and make your changes. For example to change the title on the product page, add the following line:

$lang['VIEW_PRODUCT_DETAIL']['TITLE'] = 'My New Title';

or you can use variables

$lang['VIEW_PRODUCT_DETAIL']['TITLE'] = '{$product->name} ... Reviews from myCensuraSite.com';

to change the meta_keywords (available as language phrases since 2.3)

$lang['VIEW_PRODUCT_DETAIL']['META_KEYWORDS'] = '{$product->name}, {$product->vendor->name}';