3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
39 class CRM_Core_BAO_WordReplacement
extends CRM_Core_DAO_WordReplacement
{
41 function __construct() {
42 parent
::__construct();
45 * Takes a bunch of params that are needed to match certain criteria and
46 * retrieves the relevant objects.
48 * @param array $params (reference ) an assoc array of name/value pairs
49 * @param array $defaults (reference ) an assoc array to hold the flattened values
51 * @return object CRM_Core_DAO_WordRepalcement object
56 static function retrieve(&$params, &$defaults) {
57 return CRM_Core_DAO
::commonRetrieve('CRM_Core_DAO_WordRepalcement', $params, $defaults);
63 * @return null|object CRM_Core_BAO_WordRepalcement
67 static function getWordReplacement($reset = NULL) {
68 static $wordReplacement = NULL;
69 if (!$wordReplacement ||
$reset) {
70 $wordReplacement = new CRM_Core_BAO_WordRepalcement();
71 $wordReplacement->id
= CRM_Core_Config
::wordReplacementID();
72 if (!$wordReplacement->find(TRUE)) {
73 CRM_Core_Error
::fatal();
76 return $wordReplacement;
81 * Save the values of a WordReplacement
83 * @return WordReplacement array
86 static function edit(&$params, &$id) {
87 $wordReplacement = new CRM_Core_DAO_WordReplacement();
88 $wordReplacement->id
= $id;
89 $wordReplacement->copyValues($params);
90 $wordReplacement->save();
91 if (!isset($params['options']) || CRM_Utils_Array
::value('wp-rebuild', $params['options'], TRUE)) {
94 return $wordReplacement;
98 * Create a new WordReplacement
100 * @return WordReplacement array
103 static function create($params) {
104 if(array_key_exists("domain_id",$params) === FALSE) {
105 $params["domain_id"] = CRM_Core_Config
::domainID();
107 $wordReplacement = new CRM_Core_DAO_WordReplacement();
108 $wordReplacement->copyValues($params);
109 $wordReplacement->save();
110 if (!isset($params['options']) || CRM_Utils_Array
::value('wp-rebuild', $params['options'], TRUE)) {
113 return $wordReplacement;
119 * @param int $id WordReplacement id
124 static function del($id) {
125 $dao = new CRM_Core_DAO_WordReplacement();
128 if (!isset($params['options']) || CRM_Utils_Array
::value('wp-rebuild', $params['options'], TRUE)) {
135 * Get all word-replacements in the form of an array
137 * @param int $id domain ID
139 * @see civicrm_domain.locale_custom_strings
141 public static function getAllAsConfigArray($id) {
142 $query = "SELECT find_word,replace_word FROM civicrm_word_replacement WHERE is_active = 1 AND domain_id = ".CRM_Utils_Type
::escape($id, 'Integer');
143 $dao = CRM_Core_DAO
::executeQuery($query);
144 $wordReplacement = array();
146 while ($dao->fetch()) {
147 $wordReplacement[$dao->find_word
] = $dao->replace_word
;
150 $overrides['enabled']['wildcardMatch'] = $wordReplacement;
152 $config = CRM_Core_Config
::singleton();
153 $domain = new CRM_Core_DAO_Domain();
156 if ($domain->locales
&& $config->localeCustomStrings
) {
158 $addReplacements = $config->localeCustomStrings
;
159 $addReplacements[$config->lcMessages
] = $overrides;
160 $stringOverride = $addReplacements;
163 // for single language
164 $stringOverride = array($config->lcMessages
=> $overrides);
167 return $stringOverride;
173 static function rebuild() {
174 $id = CRM_Core_Config
::domainID();
175 $stringOverride = self
::getAllAsConfigArray($id);
176 $params = array('locale_custom_strings' => serialize($stringOverride));
177 $wordReplacementSettings = CRM_Core_BAO_Domain
::edit($params, $id);
179 if ($wordReplacementSettings) {
180 CRM_Core_Config
::singleton()->localeCustomStrings
= $stringOverride;
183 CRM_Core_BAO_Navigation
::resetNavigation();
184 // Clear js string cache
185 CRM_Core_Resources
::singleton()->flushStrings();
194 * Get all the word-replacements stored in config-arrays
195 * and convert them to params for the WordReplacement.create API.
197 * Note: This function is duplicated in CRM_Core_BAO_WordReplacement and
198 * CRM_Upgrade_Incremental_php_FourFour to ensure that the incremental upgrade
199 * step behaves consistently even as the BAO evolves in future versions.
200 * However, if there's a bug in here prior to 4.4.0, we should apply the
201 * bugfix in both places.
203 * @param bool $rebuildEach whether to perform rebuild after each individual API call
204 * @return array Each item is $params for WordReplacement.create
205 * @see CRM_Core_BAO_WordReplacement::convertConfigArraysToAPIParams
207 static function getConfigArraysAsAPIParams($rebuildEach) {
208 $wordReplacementCreateParams = array();
210 $result = civicrm_api3('domain', 'get', array(
211 'return' => array('locale_custom_strings'),
213 if (!empty($result["values"])) {
214 foreach ($result["values"] as $value) {
216 $params["is_active"] = TRUE;
217 $params["domain_id"] = $value["id"];
218 $params["options"] = array('wp-rebuild' => $rebuildEach);
219 // unserialize word match string
220 $localeCustomArray = unserialize($value["locale_custom_strings"]);
221 if (!empty($localeCustomArray)) {
222 $wordMatchArray = array();
223 foreach ($localeCustomArray as $localCustomData) {
224 $wordMatchArray = $localCustomData["enabled"]["wildcardMatch"];
227 if (!empty($wordMatchArray)) {
228 foreach ($wordMatchArray as $word => $replace) {
229 $params["find_word"] = $word;
230 $params["replace_word"] = $replace;
231 $wordReplacementCreateParams[] = $params;
237 return $wordReplacementCreateParams;
241 * Get all the word-replacements stored in config-arrays
242 * and write them out as records in civicrm_word_replacement.
244 * Note: This function is duplicated in CRM_Core_BAO_WordReplacement and
245 * CRM_Upgrade_Incremental_php_FourFour to ensure that the incremental upgrade
246 * step behaves consistently even as the BAO evolves in future versions.
247 * However, if there's a bug in here prior to 4.4.0, we should apply the
248 * bugfix in both places.
250 public static function rebuildWordReplacementTable() {
251 civicrm_api3('word_replacement', 'replace', array(
252 'options' => array('match' => array('domain_id', 'find_word')),
253 'values' => self
::getConfigArraysAsAPIParams(FALSE),
255 CRM_Core_BAO_WordReplacement
::rebuild();