2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
3 /*********************************************************************************
4 * SugarCRM Community Edition is a customer relationship management program developed by
5 * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
7 * This program is free software; you can redistribute it and/or modify it under
8 * the terms of the GNU Affero General Public License version 3 as published by the
9 * Free Software Foundation with the addition of the following permission added
10 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
11 * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
12 * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
14 * This program is distributed in the hope that it will be useful, but WITHOUT
15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16 * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
19 * You should have received a copy of the GNU Affero General Public License along with
20 * this program; if not, see http://www.gnu.org/licenses or write to the Free
21 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
24 * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
25 * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
27 * The interactive user interfaces in modified source and object code versions
28 * of this program must display Appropriate Legal Notices, as required under
29 * Section 5 of the GNU Affero General Public License version 3.
31 * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
32 * these Appropriate Legal Notices must retain the display of the "Powered by
33 * SugarCRM" logo. If the display of the logo is not reasonably feasible for
34 * technical reasons, the Appropriate Legal Notices must display the words
35 * "Powered by SugarCRM".
36 ********************************************************************************/
38 require_once('include/Sugar_Smarty.php');
39 require_once('include/utils/layout_utils.php');
53 * Title of the Dashlet
56 var $title = 'Generic Dashlet';
58 * true if the Dashlet has configuration options.
61 var $isConfigurable = false;
63 * true if the Dashlet is refreshable (ie charts that provide their own refresh)
66 var $isRefreshable = true;
68 * true if the Dashlet configuration options panel has the clear button
71 public $isConfigPanelClearShown = true;
73 * true if the Dashlet contains javascript
76 var $hasScript = false;
78 * Language strings, must be loaded at the Dashlet level w/ loadLanguage
83 * Time period in minutes to refresh the dashlet (0 for never)
84 * Do not refresh if $isRefreshable is set to false
86 * To support auto refresh all refreshable dashlets that override process() must call processAutoRefresh()
89 var $autoRefresh = "0";
96 public function Dashlet($id)
102 * Returns the HTML for the configure icon
104 * @return string HTML
106 public function setConfigureIcon()
108 if($this->isConfigurable) {
109 $additionalTitle = '<td nowrap width="1%" style="padding-right: 0px;"><div class="dashletToolSet"><a href="javascript:void(0)" onclick="SUGAR.mySugar.configureDashlet(\''
110 . $this->id . '\'); return false;">'
111 . SugarThemeRegistry::current()->getImage('dashlet-header-edit','title="' . translate('LBL_DASHLET_EDIT', 'Home') . '" border="0" align="absmiddle"', null,null,'.gif',translate('LBL_DASHLET_EDIT', 'Home')).'</a>'
115 $additionalTitle = '<td nowrap width="1%" style="padding-right: 0px;"><div class="dashletToolSet">';
118 return $additionalTitle;
122 * Returns the HTML for the refresh icon
124 * @return string HTML
126 public function setRefreshIcon()
128 $additionalTitle = '';
129 if($this->isRefreshable) {
130 $additionalTitle .= '<a href="javascript:void(0)" onclick="SUGAR.mySugar.retrieveDashlet(\''
131 . $this->id . '\'); return false;">'
132 . SugarThemeRegistry::current()->getImage('dashlet-header-refresh','border="0" align="absmiddle" title="' . translate('LBL_DASHLET_REFRESH', 'Home') . '"',null,null,'.gif',translate('LBL_DASHLET_REFRESH', 'Home'))
136 return $additionalTitle;
140 * Returns the HTML for the delete icon
142 * @return string HTML
144 public function setDeleteIcon()
146 global $sugar_config;
148 if (!empty($sugar_config['lock_homepage']) && $sugar_config['lock_homepage'] == true) {
149 return '</div></td></tr></table>';
151 $additionalTitle = '<a href="javascript:void(0)" onclick="SUGAR.mySugar.deleteDashlet(\''
152 . $this->id . '\'); return false;">'
153 . SugarThemeRegistry::current()->getImage('dashlet-header-close','border="0" align="absmiddle" title="' . translate('LBL_DASHLET_DELETE', 'Home') . '"',null,null,'.gif',translate('LBL_DASHLET_DELETE', 'Home'))
154 . '</a></div></td></tr></table>';
155 return $additionalTitle;
159 * @deprecated No longer needed, replaced with Dashlet::getHeader() and Dashlet::getFooter()
161 * @param string $text
162 * @return string HTML
164 public function getTitle($text = '')
170 * Called when Dashlet is displayed
172 * @param string $text text after the title
173 * @return string Header html
175 public function getHeader($text = '')
177 global $sugar_config;
179 $title = '<table width="100%" cellspacing="0" cellpadding="0" border="0"><tr><td width="99%">' . $text . '</td>';
180 $title .= $this->setConfigureIcon();
181 $title .= $this->setRefreshIcon();
182 $title .= $this->setDeleteIcon();
185 if(empty($sugar_config['lock_homepage']) || $sugar_config['lock_homepage'] == false) $str .= 'onmouseover="this.style.cursor = \'move\';" ';
186 $str .= 'id="dashlet_header_' . $this->id . '" class="hd"><div class="tl"></div><div class="hd-center">' . get_form_header($this->title, $title, false) . '</div><div class="tr"></div></div><div class="bd"><div class="ml"></div><div class="bd-center">';
192 * Called when Dashlet is displayed
194 * @return string footer HTML
196 public function getFooter()
198 $footer = '</div><div class="mr"></div></div><div class="ft"><div class="bl"></div><div class="ft-center"></div><div class="br"></div></div>';
204 * Called when Dashlet is displayed, override this
206 * @param string $text text after the title
207 * @return string title HTML
209 public function display($text = '')
215 * Called when Dashlets configuration options are called
217 public function displayOptions()
222 * Override if you need to do pre-processing before display is called
224 public function process()
229 * Processes and displays the auto refresh code for the dashlet
231 * @param int $dashletOffset
232 * @return string HTML code
234 protected function processAutoRefresh($dashletOffset = 0)
236 global $sugar_config;
238 if ( empty($dashletOffset) ) {
240 $module = $_REQUEST['module'];
241 if(isset($_REQUEST[$module.'2_'.strtoupper($this->seedBean->object_name).'_offset'])) {
242 $dashletOffset = $_REQUEST[$module.'2_'.strtoupper($this->seedBean->object_name).'_offset'];
246 if ( !$this->isRefreshable ) {
249 if ( !empty($sugar_config['dashlet_auto_refresh_min']) && $sugar_config['dashlet_auto_refresh_min'] == -1 ) {
252 $autoRefreshSS = new Sugar_Smarty();
253 $autoRefreshSS->assign('dashletOffset', $dashletOffset);
254 $autoRefreshSS->assign('dashletId', $this->id);
255 $autoRefreshSS->assign('strippedDashletId', str_replace("-","",$this->id)); //javascript doesn't like "-" in function names
256 if ( empty($this->autoRefresh) ) {
257 $this->autoRefresh = 0;
259 elseif ( !empty($sugar_config['dashlet_auto_refresh_min']) && $sugar_config['dashlet_auto_refresh_min'] > $this->autoRefresh ) {
260 $this->autoRefresh = $sugar_config['dashlet_auto_refresh_min'];
262 $autoRefreshSS->assign('dashletRefreshInterval', $this->autoRefresh * 1000);
263 $tpl = 'include/Dashlets/DashletGenericAutoRefresh.tpl';
264 if ( $_REQUEST['action'] == "DynamicAction" ) {
265 $tpl = 'include/Dashlets/DashletGenericAutoRefreshDynamic.tpl';
268 return $autoRefreshSS->fetch($tpl);
272 * Override this if your dashlet is configurable (this is called when the the configureDashlet form is shown)
273 * Filters the array for only the parameters it needs to save
275 * @param array $req the array to pull options from
276 * @return array options array
278 public function saveOptions($req)
283 * Sets the language strings
285 * @param string $dashletClassname classname of the dashlet
286 * @param string $dashletDirectory directory path of the dashlet
288 public function loadLanguage($dashletClassname, $dashletDirectory = 'modules/Home/Dashlets/')
290 global $current_language, $dashletStrings;
292 if(!isset($dashletStrings[$dashletClassname])) {
293 // load current language strings for current language, else default to english
294 if(is_file($dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php')
295 || is_file('custom/' . $dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php') ) {
296 if(is_file($dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php')) {
297 require($dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php');
299 if(is_file('custom/' . $dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php')) {
300 require('custom/' . $dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.' . $current_language . '.lang.php');
304 if(is_file($dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.en_us.lang.php')) {
305 require($dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.en_us.lang.php');
307 if(is_file('custom/' . $dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.en_us.lang.php')) {
308 require('custom/' . $dashletDirectory . $dashletClassname . '/' . $dashletClassname . '.en_us.lang.php');
313 $this->dashletStrings = $dashletStrings[$dashletClassname];
317 * Generic way to store an options array into UserPreferences
319 * @param array $optionsArray the array to save
321 public function storeOptions($optionsArray)
323 global $current_user;
325 $dashletDefs = $current_user->getPreference('dashlets', 'Home'); // load user's dashlets config
326 $dashletDefs[$this->id]['options'] = $optionsArray;
327 $current_user->setPreference('dashlets', $dashletDefs, 0, 'Home');
331 * Generic way to retrieve options array from UserPreferences
333 * @return array options array stored in UserPreferences
335 public function loadOptions()
337 global $current_user;
339 $dashletDefs = $current_user->getPreference('dashlets', 'Home'); // load user's dashlets config
340 if(isset($dashletDefs[$this->id]['options']))
341 return $dashletDefs[$this->id]['options'];
347 * Override this in the subclass. It is used to determine whether the dashlet can be displayed.
349 * @return bool indicating whether or not the current user has access to display this Dashlet.
351 public function hasAccess()
357 * Returns the available auto refresh settings you can set a dashlet to
359 * @return array options available
361 protected function getAutoRefreshOptions()
363 $options = $GLOBALS['app_list_strings']['dashlet_auto_refresh_options'];
365 if ( isset($GLOBALS['sugar_config']['dashlet_auto_refresh_min']) ) {
366 foreach ( $options as $time => $desc ) {
367 if ( $time != -1 && $time < $GLOBALS['sugar_config']['dashlet_auto_refresh_min'] ) {
368 unset($options[$time]);
377 * Returns true if the dashlet is auto refreshable
381 protected function isAutoRefreshable()
383 return $this->isRefreshable &&
384 ( isset($GLOBALS['sugar_config']['dashlet_auto_refresh_min']) ?
385 $GLOBALS['sugar_config']['dashlet_auto_refresh_min'] != -1 : true );