CRM/Admin/Form/Setting/Localization.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.4                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2013                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  10  | CiviCRM is free software; you can copy, modify, and distribute it  |
  11  | under the terms of the GNU Affero General Public License           |
  12  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  13  |                                                                    |
  14  | CiviCRM is distributed in the hope that it will be useful, but     |
  15  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  16  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  17  | See the GNU Affero General Public License for more details.        |
  18  |                                                                    |
  19  | You should have received a copy of the GNU Affero General Public   |
  20  | License and the CiviCRM Licensing Exception along                  |
  21  | with this program; if not, contact CiviCRM LLC                     |
  22  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  23  | GNU Affero General Public License or the licensing of CiviCRM,     |
  24  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  25  +--------------------------------------------------------------------+
  26 */
  27
  28 /**
  29  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2013
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * This class generates form components for Localization
  38  *
  39  */
  40 class CRM_Admin_Form_Setting_Localization extends CRM_Admin_Form_Setting {
  41   // use this variable to store mappings that we compute in buildForm and also
  42   // use in postProcess (CRM-1496)
  43   protected $_currencySymbols;
  44
  45   /**
  46    * Function to build the form
  47    *
  48    * @return void
  49    * @access public
  50    */
  51   public function buildQuickForm() {
  52     $config = CRM_Core_Config::singleton();
  53
  54     $i18n = CRM_Core_I18n::singleton();
  55     CRM_Utils_System::setTitle(ts('Settings - Localization'));
  56
  57     $locales = CRM_Core_I18n::languages();
  58     $warningTitle = json_encode(ts("Warning"));
  59     $domain = new CRM_Core_DAO_Domain();
  60     $domain->find(TRUE);
  61     if ($domain->locales) {
  62       // for multi-lingual sites, populate default language drop-down with available languages
  63       $lcMessages = array();
  64       foreach ($locales as $loc => $lang) {
  65         if (substr_count($domain->locales, $loc)) {
  66           $lcMessages[$loc] = $lang;
  67         }
  68       }
  69       $this->addElement('select', 'lcMessages', ts('Default Language'), $lcMessages);
  70
  71       // add language limiter and language adder
  72       $this->addCheckBox('languageLimit', ts('Available Languages'), array_flip($lcMessages), NULL, NULL, NULL, NULL, ' &nbsp; ');
  73       $this->addElement('select', 'addLanguage', ts('Add Language'), array_merge(array('' => ts('- select -')), array_diff($locales, $lcMessages)));
  74
  75       // add the ability to return to single language
  76       $warning = ts('This will make your CiviCRM installation a single-language one again. THIS WILL DELETE ALL DATA RELATED TO LANGUAGES OTHER THAN THE DEFAULT ONE SELECTED ABOVE (and only that language will be preserved).');
  77       $this->assign('warning', $warning);
  78       $warning = json_encode($warning);
  79       $this->addElement('checkbox', 'makeSinglelingual', ts('Return to Single Language'),
  80         NULL, array('onChange' => "if (this.checked) CRM.alert($warning, $warningTitle)")
  81       );
  82     }
  83     else {
  84       // for single-lingual sites, populate default language drop-down with all languages
  85       $this->addElement('select', 'lcMessages', ts('Default Language'), $locales);
  86
  87       $warning = ts('Enabling multiple languages changes the schema of your database, so make sure you know what you are doing when enabling this function; making a database backup is strongly recommended.');
  88       $this->assign('warning', $warning);
  89       $warning = json_encode($warning);
  90       $validTriggerPermission = CRM_Core_DAO::checkTriggerViewPermission(TRUE);
  91
  92       if ($validTriggerPermission &&
  93         !$config->logging
  94       ) {
  95         $this->addElement('checkbox', 'makeMultilingual', ts('Enable Multiple Languages'),
  96           NULL, array('onChange' => "if (this.checked) CRM.alert($warning, $warningTitle)")
  97         );
  98       }
  99     }
 100
 101     $this->addElement('checkbox', 'inheritLocale', ts('Inherit CMS Language'));
 102     $this->addElement('text', 'monetaryThousandSeparator', ts('Thousands Separator'), array('size' => 2));
 103     $this->addElement('text', 'monetaryDecimalPoint', ts('Decimal Delimiter'), array('size' => 2));
 104     $this->addElement('text', 'moneyformat', ts('Monetary Amount Display'));
 105     $this->addElement('text', 'moneyvalueformat', ts('Monetary Value Display'));
 106
 107     $country = array();
 108     CRM_Core_PseudoConstant::populate($country, 'CRM_Core_DAO_Country', TRUE, 'name', 'is_active');
 109     $i18n->localizeArray($country, array('context' => 'country'));
 110     asort($country);
 111
 112     $includeCountry = &$this->addElement('advmultiselect', 'countryLimit',
 113       ts('Available Countries') . ' ', $country,
 114       array(
 115         'size' => 5,
 116         'style' => 'width:150px',
 117         'class' => 'advmultiselect',
 118       )
 119     );
 120
 121     $includeCountry->setButtonAttributes('add', array('value' => ts('Add >>')));
 122     $includeCountry->setButtonAttributes('remove', array('value' => ts('<< Remove')));
 123
 124     $includeState = &$this->addElement('advmultiselect', 'provinceLimit',
 125       ts('Available States and Provinces') . ' ', $country,
 126       array(
 127         'size' => 5,
 128         'style' => 'width:150px',
 129         'class' => 'advmultiselect',
 130       )
 131     );
 132
 133     $includeState->setButtonAttributes('add', array('value' => ts('Add >>')));
 134     $includeState->setButtonAttributes('remove', array('value' => ts('<< Remove')));
 135
 136     $this->addElement('select', 'defaultContactCountry', ts('Default Country'), array('' => ts('- select -')) + $country);
 137
 138     /***Default State/Province***/
 139     $stateCountryMap = array();
 140     $stateCountryMap[] = array(
 141       'state_province' => 'defaultContactStateProvince',
 142       'country' => 'defaultContactCountry',
 143     );
 144
 145     $countryDefault = isset($this->_submitValues['defaultContactCountry']) ? $this->_submitValues['defaultContactCountry'] : $config->defaultContactCountry;
 146
 147     if ($countryDefault) {
 148       $selectStateProvinceOptions = array('' => ts('- select -')) + CRM_Core_PseudoConstant::stateProvinceForCountry($countryDefault);
 149     }
 150     else {
 151       $selectStateProvinceOptions = array('' => ts('- select a country -'));
 152     }
 153
 154     $i18n->localizeArray($selectStateProvinceOptions, array('context' => 'state_province'));
 155     asort($selectStateProvinceOptions);
 156
 157     $this->addElement('select', 'defaultContactStateProvince', ts('Default State/Province'), $selectStateProvinceOptions);
 158
 159     // state country js
 160     CRM_Core_BAO_Address::addStateCountryMap($stateCountryMap);
 161
 162     $defaults = array();
 163     CRM_Core_BAO_Address::fixAllStateSelects($form, $defaults);
 164
 165     // we do this only to initialize currencySymbols, kinda hackish but works!
 166     $config->defaultCurrencySymbol();
 167
 168     $symbol = $config->currencySymbols;
 169     foreach ($symbol as $key => $value) {
 170       $this->_currencySymbols[$key] = "$key";
 171       if ($value) {
 172         $this->_currencySymbols[$key] .= " ($value)";
 173       }
 174     }
 175     $this->addElement('select', 'defaultCurrency', ts('Default Currency'), $this->_currencySymbols);
 176
 177     $includeCurrency = &$this->addElement('advmultiselect', 'currencyLimit',
 178       ts('Available Currencies') . ' ', $this->_currencySymbols,
 179       array(
 180         'size' => 5,
 181         'style' => 'width:150px',
 182         'class' => 'advmultiselect',
 183       )
 184     );
 185
 186     $includeCurrency->setButtonAttributes('add', array('value' => ts('Add >>')));
 187     $includeCurrency->setButtonAttributes('remove', array('value' => ts('<< Remove')));
 188
 189     $this->addElement('text', 'legacyEncoding', ts('Legacy Encoding'));
 190     $this->addElement('text', 'customTranslateFunction', ts('Custom Translate Function'));
 191     $this->addElement('text', 'fieldSeparator', ts('Import / Export Field Separator'), array('size' => 2));
 192
 193     $this->addFormRule(array('CRM_Admin_Form_Setting_Localization', 'formRule'));
 194
 195     parent::buildQuickForm();
 196   }
 197
 198   static function formRule($fields) {
 199     $errors = array();
 200     if (CRM_Utils_Array::value('monetaryThousandSeparator', $fields) ==
 201       CRM_Utils_Array::value('monetaryDecimalPoint', $fields)
 202     ) {
 203       $errors['monetaryThousandSeparator'] = ts('Thousands Separator and Decimal Delimiter can not be the same.');
 204     }
 205
 206     if (strlen($fields['monetaryThousandSeparator']) == 0) {
 207       $errors['monetaryThousandSeparator'] = ts('Thousands Separator can not be empty. You can use a space character instead.');
 208     }
 209
 210     if (strlen($fields['monetaryThousandSeparator']) > 1) {
 211       $errors['monetaryThousandSeparator'] = ts('Thousands Separator can not have more than 1 character.');
 212     }
 213
 214     if (strlen($fields['monetaryDecimalPoint']) > 1) {
 215       $errors['monetaryDecimalPoint'] = ts('Decimal Delimiter can not have more than 1 character.');
 216     }
 217
 218     if (trim($fields['customTranslateFunction']) &&
 219       !function_exists(trim($fields['customTranslateFunction']))
 220     ) {
 221       $errors['customTranslateFunction'] = ts('Please define the custom translation function first.');
 222     }
 223
 224     // CRM-7962, CRM-7713, CRM-9004
 225     if (!empty($fields['defaultContactCountry']) &&
 226       (!empty($fields['countryLimit']) &&
 227         (!in_array($fields['defaultContactCountry'], $fields['countryLimit']))
 228       )
 229     ) {
 230       $errors['defaultContactCountry'] = ts('Please select a default country that is in the list of available countries.');
 231     }
 232
 233     return empty($errors) ? TRUE : $errors;
 234   }
 235
 236   function setDefaultValues() {
 237     parent::setDefaultValues();
 238
 239     // CRM-1496
 240     // retrieve default values for currencyLimit
 241     $this->_defaults['currencyLimit'] = array_keys(CRM_Core_OptionGroup::values('currencies_enabled'));
 242
 243     // CRM-5111: unset these two unconditionally, we don’t want them to stick – ever
 244     unset($this->_defaults['makeMultilingual']);
 245     unset($this->_defaults['makeSinglelingual']);
 246     return $this->_defaults;
 247   }
 248
 249   public function postProcess() {
 250     $values = $this->exportValues();
 251
 252     // FIXME: stupid QF not submitting unchecked checkboxen…
 253     if (!isset($values['inheritLocale'])) {
 254       $values['inheritLocale'] = 0;
 255     }
 256
 257     //cache contact fields retaining localized titles
 258     //though we changed localization, so reseting cache.
 259     CRM_Core_BAO_Cache::deleteGroup('contact fields');
 260
 261     //CRM-8559, cache navigation do not respect locale if it is changed, so reseting cache.
 262     CRM_Core_BAO_Cache::deleteGroup('navigation');
 263
 264     // we do this only to initialize monetary decimal point and thousand separator
 265     $config = CRM_Core_Config::singleton();
 266
 267     // set default Currency Symbol
 268     $values['defaultCurrencySymbol'] = $config->defaultCurrencySymbol($values['defaultCurrency']);
 269
 270     // save enabled currencies and defaul currency in option group 'currencies_enabled'
 271     // CRM-1496
 272     if (empty($values['currencyLimit'])) {
 273       $values['currencyLimit'] = array($values['defaultCurrency']);
 274     }
 275     elseif (!in_array($values['defaultCurrency'],
 276         $values['currencyLimit']
 277       )) {
 278       $values['currencyLimit'][] = $values['defaultCurrency'];
 279     }
 280
 281     // sort so that when we display drop down, weights have right value
 282     sort($values['currencyLimit']);
 283
 284     // get labels for all the currencies
 285     $options = array();
 286
 287     for ($i = 0; $i < count($values['currencyLimit']); $i++) {
 288       $options[] = array(
 289         'label' => $this->_currencySymbols[$values['currencyLimit'][$i]],
 290         'value' => $values['currencyLimit'][$i],
 291         'weight' => $i + 1,
 292         'is_active' => 1,
 293         'is_default' => $values['currencyLimit'][$i] == $values['defaultCurrency'],
 294       );
 295     }
 296
 297     $dontCare = NULL;
 298     CRM_Core_OptionGroup::createAssoc('currencies_enabled',
 299       $options,
 300       $dontCare
 301     );
 302
 303     // unset currencyLimit so we dont store there
 304     unset($values['currencyLimit']);
 305
 306     // make the site multi-lang if requested
 307     if (!empty($values['makeMultilingual'])) {
 308       CRM_Core_I18n_Schema::makeMultilingual($values['lcMessages']);
 309       $values['languageLimit'][$values['lcMessages']] = 1;
 310       // make the site single-lang if requested
 311     }
 312     elseif (!empty($values['makeSinglelingual'])) {
 313       CRM_Core_I18n_Schema::makeSinglelingual($values['lcMessages']);
 314       $values['languageLimit'] = '';
 315     }
 316
 317     // add a new db locale if the requested language is not yet supported by the db
 318     if (!CRM_Utils_Array::value('makeSinglelingual', $values) and CRM_Utils_Array::value('addLanguage', $values)) {
 319       $domain = new CRM_Core_DAO_Domain();
 320       $domain->find(TRUE);
 321       if (!substr_count($domain->locales, $values['addLanguage'])) {
 322         CRM_Core_I18n_Schema::addLocale($values['addLanguage'], $values['lcMessages']);
 323       }
 324       $values['languageLimit'][$values['addLanguage']] = 1;
 325     }
 326
 327     // if we manipulated the language list, return to the localization admin screen
 328     $return = (bool)(CRM_Utils_Array::value('makeMultilingual', $values) or CRM_Utils_Array::value('addLanguage', $values));
 329
 330     // save all the settings
 331     parent::commonProcess($values);
 332
 333     if ($return) {
 334       CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/setting/localization', 'reset=1'));
 335     }
 336   }
 337 }
 338