All Data Structures Functions Variables Pages
MessageTranslation.php
1 <?php
2  /*********************************************************************************
3  * Zurmo is a customer relationship management program developed by
4  * Zurmo, Inc. Copyright (C) 2017 Zurmo Inc.
5  *
6  * Zurmo is free software; you can redistribute it and/or modify it under
7  * the terms of the GNU Affero General Public License version 3 as published by the
8  * Free Software Foundation with the addition of the following permission added
9  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
10  * IN WHICH THE COPYRIGHT IS OWNED BY ZURMO, ZURMO DISCLAIMS THE WARRANTY
11  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
12  *
13  * Zurmo is distributed in the hope that it will be useful, but WITHOUT
14  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
15  * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
16  * details.
17  *
18  * You should have received a copy of the GNU Affero General Public License along with
19  * this program; if not, see http://www.gnu.org/licenses or write to the Free
20  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21  * 02110-1301 USA.
22  *
23  * You can contact Zurmo, Inc. with a mailing address at 27 North Wacker Drive
24  * Suite 370 Chicago, IL 60606. or at email address contact@zurmo.com.
25  *
26  * The interactive user interfaces in original and modified versions
27  * of this program must display Appropriate Legal Notices, as required under
28  * Section 5 of the GNU Affero General Public License version 3.
29  *
30  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
31  * these Appropriate Legal Notices must retain the display of the Zurmo
32  * logo and Zurmo copyright notice. If the display of the logo is not reasonably
33  * feasible for technical reasons, the Appropriate Legal Notices must display the words
34  * "Copyright Zurmo Inc. 2017. All rights reserved".
35  ********************************************************************************/
36 
38  {
39  public static function getDefaultMetadata()
40  {
41  $metadata = parent::getDefaultMetadata();
42  $metadata[__CLASS__] = array(
43  'members' => array(
44  'translation',
45  'language',
46  ),
47  'relations' => array(
48  'messagesource' => array(static::HAS_ONE, 'MessageSource', static::OWNED),
49  ),
50  'rules' => array(
51  array('translation', 'required'),
52  array('translation', 'type', 'type' => 'blob'),
53  array('language', 'required'),
54  array('language', 'type', 'type' => 'string'),
55  array('language', 'length', 'min' => 1, 'max' => 16),
56  ),
57  'elements' => array(
58  'messagesource' => 'MessageSource',
59  ),
60  'indexes' => array(
61  'sourceLanguageTranslation' => array(
62  'members' => array('messagesource_id', 'language', 'translation(767)'),
63  'unique' => true,
64  )
65  ),
66  );
67  return $metadata;
68  }
69 
78  public static function getBySourceIdAndLangCode($sourceId, $languageCode, $modelClassName = null)
79  {
80  assert('intval($sourceId) && $sourceId > 0');
81  assert('!empty($languageCode)');
82  assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
83  if ($modelClassName === null)
84  {
85  $modelClassName = get_called_class();
86  }
87  $tableName = $modelClassName::getTableName();
88  $bean = ZurmoRedBean::findOne(
89  $tableName,
90  ' messagesource_id = :sourceId AND language = :languageCode',
91  array(
92  ':sourceId' => $sourceId,
93  ':languageCode' => $languageCode
94  )
95  );
96  assert('$bean === false || $bean instanceof RedBean_OODBBean');
97  if (!is_object($bean))
98  {
99  throw new NotFoundException();
100  }
101  return self::makeModel($bean, $modelClassName);
102  }
103 
113  public static function addNewTranslation($languageCode, $sourceModel, $translation)
114  {
115  assert('is_string($languageCode) && !empty($languageCode)');
116  assert('$sourceModel instanceof MessageSource');
117  assert('is_string($translation) && !empty($translation)');
118  $model = new MessageTranslation();
119  $model->language = $languageCode;
120  $model->messagesource = $sourceModel;
121  $model->translation = $translation;
122  if (!$model->save())
123  {
124  throw new FailedToSaveModelException();
125  }
126 
127  return $model;
128  }
129 
137  public function updateTranslation($translation)
138  {
139  assert('!empty($translation)');
140  $this->translation = $translation;
141  if (!$this->save())
142  {
143  throw new FailedToSaveModelException();
144  }
145 
146  return $this;
147  }
148  }
149 ?>
updateTranslation($translation)
static getBySourceIdAndLangCode($sourceId, $languageCode, $modelClassName=null)
static addNewTranslation($languageCode, $sourceModel, $translation)
save($runValidation=true, array $attributeNames=null)
Generated on Tue Jun 2 2020 07:10:26