1: <?php
 2: /*****************************************************************************************
 3:  * X2Engine Open Source Edition is a customer relationship management program developed by
 4:  * X2Engine, Inc. Copyright (C) 2011-2016 X2Engine Inc.
 5:  * 
 6:  * This program 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 X2ENGINE, X2ENGINE DISCLAIMS THE WARRANTY
11:  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
12:  * 
13:  * This program 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 X2Engine, Inc. P.O. Box 66752, Scotts Valley,
24:  * California 95067, USA. or at email address [email protected].
25:  * 
26:  * The interactive user interfaces in modified source and object code 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 "Powered by
32:  * X2Engine" logo. If the display of the logo is not reasonably feasible for
33:  * technical reasons, the Appropriate Legal Notices must display the words
34:  * "Powered by X2Engine".
35:  *****************************************************************************************/
36: 
37: /**
38:  * X2FlowAction that adds, removes or clears all tags on a record
39:  *
40:  * @package application.components.x2flow.actions
41:  */
42: class X2FlowRecordTag extends X2FlowAction {
43:     public $title = 'Add or Remove Tags';
44:     public $info = 'Enter a comma-separated list of tags to add to the record';
45: 
46:     public function paramRules() {
47:         $tagActions = array(
48:             'add' => Yii::t('studio','Add'),
49:             'remove' => Yii::t('studio','Remove'),
50:             'clear' => Yii::t('studio','Clear All'),
51:         );
52:         return array_merge (parent::paramRules (), array (
53:             'title' => Yii::t('studio',$this->title),
54:             'info' => Yii::t('studio',$this->info),
55:             'modelRequired' => 1,
56:             'options' => array(
57:                 array(
58:                     'name'=>'tags',
59:                     'label'=>Yii::t('studio','Tags'),
60:                     'type'=>'tags',
61:                     'optional'=>true
62:                 ),
63:                 array('name'=>'action','label'=>Yii::t('studio','Action'),'type'=>'dropdown','options'=>$tagActions),
64:             )));
65:     }
66: 
67:     public function execute(&$params) {
68:         $tags = $this->parseOption('tags',$params);
69: 
70:         $retVal = null;
71:         $model = $params['model'];
72:         switch($this->parseOption('action',$params)) {
73:             case 'add':
74:                 $retVal = $model->addTags($tags);
75:                 break;
76:             case 'remove':
77:                 $retVal = $model->removeTags($tags);
78:                 break;
79:             case 'clear':
80:                 $retVal = $model->clearTags();
81:                 break;
82:         }
83:         if ($retVal) {
84:             if(is_subclass_of ($model,'X2Model')) {
85:                 return array (
86:                     true,
87:                     Yii::t('studio', 'View updated record: ').$model->getLink ()
88:                 );
89:             } else {
90:                 return array (true, "");
91:             }
92:         } else {
93:             return array (false, "");
94:         }
95:     }
96: }
97: