egroupware_official/home/inc/class.home_link_portlet.inc.php
Nathan Gray 5fea4ed9a5 - Use a queue to buffer property updates
- Better support for dropping application entries on Home portlet area
- Add a portlet that shows a list of entries, supports dropping into the list
2013-05-29 19:25:12 +00:00

131 lines
3.3 KiB
PHP

<?php
/**
* EGroupware - Home - A simple portlet for displaying an entry
*
* @link www.egroupware.org
* @author Nathan Gray
* @copyright (c) 2013 by Nathan Gray
* @package home
* @subpackage portlet
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @version $Id$
*/
class home_link_portlet extends home_portlet
{
/**
* Context for this portlet
*/
protected $context = array();
/**
* Title of entry
*/
protected $title = 'Link';
/**
* Construct the portlet
*
*/
public function __construct(Array &$context = array())
{
// Process dropped data into something useable
if($context['dropped_data'])
{
list($context['entry']['app'], $context['entry']['id']) = explode('::', $context['dropped_data'][0], 2);
unset($context['dropped_data']);
}
if($context['entry'])
{
$this->title = $context['entry']['title'] = egw_link::title($context['entry']['app'], $context['entry']['id']);
}
$this->context = $context;
}
/**
* Some descriptive information about the portlet, so that users can decide if
* they want it or not, and for inclusion in lists, hover text, etc.
*
* These should be already translated, no further translation will be done.
*
* @return Array with keys
* - displayName: Used in lists
* - title: Put in the portlet header
* - description: A short description of what this portlet does or displays
*/
public function get_description()
{
return array(
'displayName'=> 'Single Entry',
'title'=> $this->context['entry'] ? lang($this->context['entry']['app']) : lang('None'),
'description'=> lang('Show one entry')
);
}
/**
* Get a fragment of HTML for display
*
* @param id String unique ID, provided to the portlet so it can make sure content is
* unique, if needed.
* @return string HTML fragment for display
*/
public function get_content($id = null)
{
return $this->title;
}
/**
* Return a list of settings to customize the portlet.
*
* Settings should be in the same style as for preferences. It is OK to return an empty array
* for no customizable settings.
*
* These should be already translated, no further translation will be done.
*
* @see preferences/inc/class.preferences_settings.inc.php
* @return Array of settings. Each setting should have the following keys:
* - name: Internal reference
* - type: Widget type for editing
* - label: Human name
* - help: Description of the setting, and what it does
* - default: Default value, for when it's not set yet
*/
public function get_properties()
{
return array(
array(
'name' => 'entry',
'type' => 'link-entry',
'label' => lang('Entry'),
)
) + parent::get_properties();
}
/**
* Return a list of allowable actions for the portlet.
*
* These actions will be merged with the default porlet actions.
* We add an 'edit' action as default so double-clicking the widget
* opens the entry
*/
public function get_actions()
{
$actions = array(
'view' => array(
'icon' => 'view',
'caption' => lang('open'),
'default' => true,
'hideOnDisabled' => false,
'onExecute' => 'javaScript:app.home.open_link',
),
'edit_settings' => array(
'default' => false
)
);
$actions['view']['enabled'] = (bool)$this->context['entry'];
return $actions;
}
}