App languages.php

From FusionPBX
Revision as of 16:42, 24 November 2012 by Mcrane (talk | contribs) (To do list)
Jump to: navigation, search

The app_languages.php is an array of all the words, phrases and sentences used in the project.

To do list

Listed by priority.

  • time_conditions - rinor (in progress)
  • recordings - soapee01 (in progress)
  • call center active
  • conferences active
  • content
  • dialplan inbound
  • dialplan outbound
  • exec
  • log_viewer
  • xmpp
  • traffic graph
  • users
  • music_on_hold
  • click_to_call
  • gateways
  • extensions
  • dialplan
  • destinations
  • contacts
  • call_flows
  • call_center
  • ivr_menu
  • modules
  • hardware_phones
  • hot_desking
  • sip_profiles
  • hunt_group
  • sql_query
  • fifo
  • fifo_list
  • vars
  • virtual tables
  • core/apps
  • core/backaup
  • core/databases
  • core/default_settings
  • core/domains
  • core/menu
  • core/upgrade
  • core/user
  • grammar_edit (assigned to mark)
  • php_edit (assigned to mark)
  • xml edit (assigned to mark)
  • provision_editor (assigned to mark)

Recently Completed

  • registrations - soapee01
  • ring_groups - soapee01
  • script_edit - soapee01
  • services - soapee01
  • settings - soapee01
  • sip_status - soapee01
  • voicemail_msgs
  • voicemail_status - soapee01
  • voicemail_greetings
  • xml_cdr
  • and more...

Guidelines

The words used in the text variable name

  • separated with a dash.
  • begin with a prefix
  • are lower case

Prefixes

  • title - the title of the page
  • description - information to describe the page or an item on the page
  • button - the label for the buttons
  • confirm - a message used to confirm and action like delete
  • label - the label for items on the page

Languages

Each word, phrase, or sentence has the language declared with the 2 letter iso code for the language and the dialect.

http://msdn.microsoft.com/en-us/library/ms533052%28v=vs.85%29.aspx

  • en-us
  • es-mx
  • de-ch
  • de-at
  • fr-ca
  • fr-ch
  • pt-pt
  • pt-br

Example File

An excerpt from the app_languages.php for Conference Center.

<?php

	$text['title-conference-center']['en-us'] = 'Conference Center';
	$text['title-conference-center']['pt-pt'] = ;

	$text['description-conference-center']['en-us'] = 'Conference Center is used to setup one or more conference rooms with a name, extension number, a required pin number length, and a description.';
	$text['description-conference-center']['pt-pt'] = ;

	$text['label-name']['en-us'] = 'Name';
	$text['label-name']['pt-pt'] = ;

	$text['label-extension']['en-us'] = 'Extension';
	$text['label-extension']['pt-pt'] = ;

	$text['label-delete']['en-us'] = 'Delete';
	$text['label-delete']['pt-pt'] = ;

	$text['label-edit']['en-us'] = 'Edit';
	$text['label-edit']['pt-pt'] = ;

	$text['button-view']['en-us'] = 'View';
	$text['button-view']['pt-pt'] = ;

	$text['button-back']['en-us'] = 'Back';
	$text['button-back']['pt-pt'] = 'Voltar';

	$text['confirm-update']['en-us'] = 'Update Complete';
	$text['confirm-update']['pt-pt'] = 'Actualização Completa';

	$text['confirm-delete']['en-us'] = 'Do you really want to delete this?';
	$text['confirm-delete']['pt-pt'] = ;

	$text['button-add']['en-us'] = 'Add';
	$text['button-add']['pt-pt'] = ;

	$text['button-save']['en-us'] = 'Save';
	$text['button-save']['pt-pt'] = 'Guardar';

?>

To use inside the code on each page that displays text. Place the following code at the top just after the permision_exists

//add multi-lingual support
	require_once "app_languages.php";
	foreach($text as $key => $value) {
		$text[$key] = $value[$_SESSION['domain']['language']['code']];
	}

To place a word, phrase or sentence it would be used in the code like the following example.

echo "<td align='left' width='30%' nowrap='nowrap'>".$text['title-conference-centers']."</td>\n";

An additional example.

echo "	<tr>\n";
echo "		<td align='left' colspan='2'>\n";
echo "			".$text['description-conference-centers']."\n";
echo "		</td>\n";
echo "	</tr>\n";
echo "</table>\n";