From c6407d7cd854e3590367c5de7266d70d8309fb18 Mon Sep 17 00:00:00 2001 From: Coleman Watts Date: Sat, 1 Aug 2015 15:10:02 -0400 Subject: [PATCH] CRM-16172 - Add help text to Localization Settings page --- .../CRM/Admin/Form/Setting/Localization.hlp | 88 +++++++++++++++++++ .../CRM/Admin/Form/Setting/Localization.tpl | 64 ++++++-------- 2 files changed, 116 insertions(+), 36 deletions(-) create mode 100644 templates/CRM/Admin/Form/Setting/Localization.hlp diff --git a/templates/CRM/Admin/Form/Setting/Localization.hlp b/templates/CRM/Admin/Form/Setting/Localization.hlp new file mode 100644 index 0000000000..271085350b --- /dev/null +++ b/templates/CRM/Admin/Form/Setting/Localization.hlp @@ -0,0 +1,88 @@ +{* + +--------------------------------------------------------------------+ + | CiviCRM version 4.6 | + +--------------------------------------------------------------------+ + | Copyright CiviCRM LLC (c) 2004-2015 | + +--------------------------------------------------------------------+ + | This file is a part of CiviCRM. | + | | + | CiviCRM is free software; you can copy, modify, and distribute it | + | under the terms of the GNU Affero General Public License | + | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. | + | | + | CiviCRM is distributed in the hope that it will be useful, but | + | WITHOUT ANY WARRANTY; without even the implied warranty of | + | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | + | See the GNU Affero General Public License for more details. | + | | + | You should have received a copy of the GNU Affero General Public | + | License and the CiviCRM Licensing Exception along | + | with this program; if not, contact CiviCRM LLC | + | at info[AT]civicrm[DOT]org. If you have questions about the | + | GNU Affero General Public License or the licensing of CiviCRM, | + | see the CiviCRM license FAQ at http://civicrm.org/licensing | + +--------------------------------------------------------------------+ +*} +{capture assign="money_format_help"} + {ts}Special symbols include:{/ts} + + {ts 1='href="http://php.net/manual/en/function.money-format.php"'}For a full list of options see the php money_format documentation.{/ts} +{/capture} +{htxt id="inheritLocale"} +

+ {ts}If checked, CiviCRM will follow CMS language changes.{/ts} +

+{/htxt} +{htxt id="defaultCurrency"} +

+ {ts}Default currency assigned to contributions and other monetary transactions.{/ts} +

+{/htxt} +{htxt id="moneyformat"} +

+ {ts}Format for displaying monetary amounts with currency symbol.{/ts} +

+ {$money_format_help} +

+{/htxt} +{htxt id="moneyvalueformat"} +

+ {ts}Format for displaying monetary values without the currency symbol.{/ts} +

+ {$money_format_help} +

+{/htxt} +{htxt id="customTranslateFunction"} +

+ {ts}You may override the ts() function in CiviCRM by defining your own translation function.{/ts} +

+{/htxt} +{htxt id="legacyEncoding"} +

+ {ts}If import files are NOT encoded as UTF-8, specify an alternate character encoding for these files. The default of Windows-1252 will work for Excel-created .CSV files on many computers.{/ts} +

+{/htxt} +{htxt id="fieldSeparator"} +

+ {ts}Global CSV separator character. Modify this setting to enable import and export of different kinds of CSV files (for example: ',' ';' ':' '|' ).{/ts} +

+{/htxt} +{htxt id="defaultContactCountry"} +

+ {ts}This value is selected by default when adding a new contact address.{/ts} +

+{/htxt} +{htxt id="countryLimit"} +

+ {ts}Which countries are available in the Country selection field when adding or editing contact addresses. Profile and Custom 'Country' fields also use this setting. To include ALL countries, leave the right-hand box empty.{/ts} +

+{/htxt} +{htxt id="provinceLimit"} +

+ {ts}State/province listings are populated dynamically based on the selected Country for all standard contact address editing forms, as well as for Profile forms which include both a Country and a State/Province field. This setting controls which countries' states and/or provinces are available in the State/Province selection field for Custom Fields or for Profile forms which do NOT include a Country field.{/ts} +

+{/htxt} diff --git a/templates/CRM/Admin/Form/Setting/Localization.tpl b/templates/CRM/Admin/Form/Setting/Localization.tpl index eb0c931535..b2bfa9b380 100644 --- a/templates/CRM/Admin/Form/Setting/Localization.tpl +++ b/templates/CRM/Admin/Form/Setting/Localization.tpl @@ -24,13 +24,16 @@ +--------------------------------------------------------------------+ *}
-
{include file="CRM/common/formButtons.tpl" location="top"}
+
+ {ts}Configure CiviCRM for your country and language.{/ts} + {docURL page="i18n Administrator's Guide: Using CiviCRM in your own language" resource="wiki"} +
+
{include file="CRM/common/formButtons.tpl" location="top"}

{ts}Language and Currency{/ts}

- + {if $form.languageLimit} @@ -45,14 +48,12 @@ {/if} - - + + - - + + @@ -67,52 +68,43 @@ - - + + - - + + - - + + - - + + - - + +
{$form.lcMessages.label}{$form.lcMessages.html}
- {ts}Default language used for this installation.{/ts}		{$form.lcMessages.html}
{$form.inheritLocale.label}{$form.inheritLocale.html}
- {ts}If checked, CiviCRM will follow CMS language changes.{/ts}		{$form.inheritLocale.label} {help id='inheritLocale' title=$form.inheritLocale.label}{$form.inheritLocale.html}
{$form.defaultCurrency.label}{$form.defaultCurrency.html}
- {ts}Default currency assigned to contributions and other monetary transactions.{/ts}		{$form.defaultCurrency.label} {help id='defaultCurrency' title=$form.defaultCurrency.label}{$form.defaultCurrency.html}
{$form.monetaryThousandSeparator.label}{$form.currencyLimit.html}
{$form.moneyformat.label}{$form.moneyformat.html}
- {ts}Format for displaying monetary amounts.{/ts}		{$form.moneyformat.label} {help id='moneyformat' title=$form.moneyformat.label}{$form.moneyformat.html}
{$form.moneyvalueformat.label}{$form.moneyvalueformat.html}
- {ts}Format for displaying monetary values.{/ts}		{$form.moneyvalueformat.label} {help id='moneyvalueformat' title=$form.moneyvalueformat.label}{$form.moneyvalueformat.html}
{$form.customTranslateFunction.label}{$form.customTranslateFunction.html}
- {ts}Function name to use for translation inplace of the default CiviCRM translate function. {/ts}		{$form.customTranslateFunction.label} {help id='customTranslateFunction' title=$form.customTranslateFunction.label}{$form.customTranslateFunction.html}
{$form.legacyEncoding.label}{$form.legacyEncoding.html}
- {ts}If import files are NOT encoded as UTF-8, specify an alternate character encoding for these files. The default of Windows-1252 will work for Excel-created .CSV files on many computers.{/ts}		{$form.legacyEncoding.label} {help id='legacyEncoding' title=$form.legacyEncoding.label}{$form.legacyEncoding.html}
{$form.fieldSeparator.label}{$form.fieldSeparator.html}
- {ts}Global CSV separator character. Modify this setting to enable import and export of different kinds of CSV files (for example: ',' ';' ':' '|' ).{/ts}		{$form.fieldSeparator.label} {help id='fieldSeparator' title=$form.fieldSeparator.label}{$form.fieldSeparator.html}

{ts}Contact Address Fields - Selection Values{/ts}

- - + + - - + + - - + + - - + +
{$form.defaultContactCountry.label}{$form.defaultContactCountry.html}
- {ts}This value is selected by default when adding a new contact address.{/ts}		{$form.defaultContactCountry.label} {help id='defaultContactCountry' title=$form.defaultContactCountry.label}{$form.defaultContactCountry.html}
{$form.defaultContactStateProvince.label}{$form.defaultContactStateProvince.html}
- {ts}This value is selected by default when adding a new contact address.{/ts}		{$form.defaultContactStateProvince.label} {help id='defaultContactCountry' title=$form.defaultContactStateProvince.label}{$form.defaultContactStateProvince.html}
{$form.countryLimit.label}{$form.countryLimit.html}
- {ts}Which countries are available in the Country selection field when adding or editing contact addresses. Profile and Custom 'Country' fields also use this setting. To include ALL countries, leave the right-hand box empty.{/ts}		{$form.countryLimit.label} {help id='countryLimit' title=$form.countryLimit.label}{$form.countryLimit.html}
{$form.provinceLimit.label}{$form.provinceLimit.html}
- {ts}State/province listings are populated dynamically based on the selected Country for all standard contact address editing forms, as well as for Profile forms which include both a Country and a State/Province field. This setting controls which countries' states and/or provinces are available in the State/Province selection field for Custom Fields or for Profile forms which do NOT include a Country field.{/ts}		{$form.provinceLimit.label} {help id='provinceLimit' title=$form.provinceLimit.label}{$form.provinceLimit.html}

{ts}Multiple Languages Support{/ts}

-- 2.25.1