CRM/Admin/Form/Setting/Localization.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.6                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   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-2014
  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    * Build the form object
  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     $this->addChainSelect('defaultContactStateProvince', array('label' => ts('Default State/Province')));
 138
 139     // we do this only to initialize currencySymbols, kinda hackish but works!
 140     $config->defaultCurrencySymbol();
 141
 142     $symbol = $config->currencySymbols;
 143     foreach ($symbol as $key => $value) {
 144       $this->_currencySymbols[$key] = "$key";
 145       if ($value) {
 146         $this->_currencySymbols[$key] .= " ($value)";
 147       }
 148     }
 149     $this->addElement('select', 'defaultCurrency', ts('Default Currency'), $this->_currencySymbols);
 150
 151     $includeCurrency = &$this->addElement('advmultiselect', 'currencyLimit',
 152       ts('Available Currencies') . ' ', $this->_currencySymbols,
 153       array(
 154         'size' => 5,
 155         'style' => 'width:150px',
 156         'class' => 'advmultiselect',
 157       )
 158     );
 159
 160     $includeCurrency->setButtonAttributes('add', array('value' => ts('Add >>')));
 161     $includeCurrency->setButtonAttributes('remove', array('value' => ts('<< Remove')));
 162
 163     $this->addElement('text', 'legacyEncoding', ts('Legacy Encoding'));
 164     $this->addElement('text', 'customTranslateFunction', ts('Custom Translate Function'));
 165     $this->addElement('text', 'fieldSeparator', ts('Import / Export Field Separator'), array('size' => 2));
 166
 167     $this->addFormRule(array('CRM_Admin_Form_Setting_Localization', 'formRule'));
 168
 169     parent::buildQuickForm();
 170   }
 171
 172   /**
 173    * @param $fields
 174    *
 175    * @return array|bool
 176    */
 177   static function formRule($fields) {
 178     $errors = array();
 179     if (CRM_Utils_Array::value('monetaryThousandSeparator', $fields) ==
 180       CRM_Utils_Array::value('monetaryDecimalPoint', $fields)
 181     ) {
 182       $errors['monetaryThousandSeparator'] = ts('Thousands Separator and Decimal Delimiter can not be the same.');
 183     }
 184
 185     if (strlen($fields['monetaryThousandSeparator']) == 0) {
 186       $errors['monetaryThousandSeparator'] = ts('Thousands Separator can not be empty. You can use a space character instead.');
 187     }
 188
 189     if (strlen($fields['monetaryThousandSeparator']) > 1) {
 190       $errors['monetaryThousandSeparator'] = ts('Thousands Separator can not have more than 1 character.');
 191     }
 192
 193     if (strlen($fields['monetaryDecimalPoint']) > 1) {
 194       $errors['monetaryDecimalPoint'] = ts('Decimal Delimiter can not have more than 1 character.');
 195     }
 196
 197     if (trim($fields['customTranslateFunction']) &&
 198       !function_exists(trim($fields['customTranslateFunction']))
 199     ) {
 200       $errors['customTranslateFunction'] = ts('Please define the custom translation function first.');
 201     }
 202
 203     // CRM-7962, CRM-7713, CRM-9004
 204     if (!empty($fields['defaultContactCountry']) &&
 205       (!empty($fields['countryLimit']) &&
 206         (!in_array($fields['defaultContactCountry'], $fields['countryLimit']))
 207       )
 208     ) {
 209       $errors['defaultContactCountry'] = ts('Please select a default country that is in the list of available countries.');
 210     }
 211
 212     return empty($errors) ? TRUE : $errors;
 213   }
 214
 215   function setDefaultValues() {
 216     parent::setDefaultValues();
 217
 218     // CRM-1496
 219     // retrieve default values for currencyLimit
 220     $this->_defaults['currencyLimit'] = array_keys(CRM_Core_OptionGroup::values('currencies_enabled'));
 221
 222     // CRM-5111: unset these two unconditionally, we don’t want them to stick – ever
 223     unset($this->_defaults['makeMultilingual']);
 224     unset($this->_defaults['makeSinglelingual']);
 225     return $this->_defaults;
 226   }
 227
 228   public function postProcess() {
 229     $values = $this->exportValues();
 230
 231     // FIXME: stupid QF not submitting unchecked checkboxen…
 232     if (!isset($values['inheritLocale'])) {
 233       $values['inheritLocale'] = 0;
 234     }
 235
 236     //cache contact fields retaining localized titles
 237     //though we changed localization, so reseting cache.
 238     CRM_Core_BAO_Cache::deleteGroup('contact fields');
 239
 240     //CRM-8559, cache navigation do not respect locale if it is changed, so reseting cache.
 241     CRM_Core_BAO_Cache::deleteGroup('navigation');
 242
 243     // we do this only to initialize monetary decimal point and thousand separator
 244     $config = CRM_Core_Config::singleton();
 245
 246     // set default Currency Symbol
 247     $values['defaultCurrencySymbol'] = $config->defaultCurrencySymbol($values['defaultCurrency']);
 248
 249     // save enabled currencies and defaul currency in option group 'currencies_enabled'
 250     // CRM-1496
 251     if (empty($values['currencyLimit'])) {
 252       $values['currencyLimit'] = array($values['defaultCurrency']);
 253     }
 254     elseif (!in_array($values['defaultCurrency'],
 255         $values['currencyLimit']
 256       )) {
 257       $values['currencyLimit'][] = $values['defaultCurrency'];
 258     }
 259
 260     // sort so that when we display drop down, weights have right value
 261     sort($values['currencyLimit']);
 262
 263     // get labels for all the currencies
 264     $options = array();
 265
 266     for ($i = 0; $i < count($values['currencyLimit']); $i++) {
 267       $options[] = array(
 268         'label' => $this->_currencySymbols[$values['currencyLimit'][$i]],
 269         'value' => $values['currencyLimit'][$i],
 270         'weight' => $i + 1,
 271         'is_active' => 1,
 272         'is_default' => $values['currencyLimit'][$i] == $values['defaultCurrency'],
 273       );
 274     }
 275
 276     $dontCare = NULL;
 277     CRM_Core_OptionGroup::createAssoc('currencies_enabled',
 278       $options,
 279       $dontCare
 280     );
 281
 282     // unset currencyLimit so we dont store there
 283     unset($values['currencyLimit']);
 284
 285     // make the site multi-lang if requested
 286     if (!empty($values['makeMultilingual'])) {
 287       CRM_Core_I18n_Schema::makeMultilingual($values['lcMessages']);
 288       $values['languageLimit'][$values['lcMessages']] = 1;
 289       // make the site single-lang if requested
 290     }
 291     elseif (!empty($values['makeSinglelingual'])) {
 292       CRM_Core_I18n_Schema::makeSinglelingual($values['lcMessages']);
 293       $values['languageLimit'] = '';
 294     }
 295
 296     // add a new db locale if the requested language is not yet supported by the db
 297     if (!CRM_Utils_Array::value('makeSinglelingual', $values) and CRM_Utils_Array::value('addLanguage', $values)) {
 298       $domain = new CRM_Core_DAO_Domain();
 299       $domain->find(TRUE);
 300       if (!substr_count($domain->locales, $values['addLanguage'])) {
 301         CRM_Core_I18n_Schema::addLocale($values['addLanguage'], $values['lcMessages']);
 302       }
 303       $values['languageLimit'][$values['addLanguage']] = 1;
 304     }
 305
 306     // if we manipulated the language list, return to the localization admin screen
 307     $return = (bool)(CRM_Utils_Array::value('makeMultilingual', $values) or CRM_Utils_Array::value('addLanguage', $values));
 308
 309     // save all the settings
 310     parent::commonProcess($values);
 311
 312     if ($return) {
 313       CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/admin/setting/localization', 'reset=1'));
 314     }
 315   }
 316 }
 317