include/Dashlets/Dashlet.php

Show:

inherited

Classes
- \Dashlet

Table of Contents

\Dashlet
jump to top

Package: SugarCRM

Basic Dashlet

Children: \InvadersDashlet; \iFrameDashlet; \SugarNewsDashlet; \JotPadDashlet; \ChartsDashlet; \RSSDashlet; \MyClosedOpportunitiesDashlet; \TopCampaignsDashlet; \CalendarDashlet; \DashletGenericChart; \DashletGeneric
Api

Properties

int
                 $autoRefresh= '"0"'

Time period in minutes to refresh the dashlet (0 for never) Do not refresh if $isRefreshable is set to false

To support auto refresh all refreshable dashlets that override process() must call processAutoRefresh()

Default value"0"Details

Type: int

array
                 $dashletStrings= ''

Language strings, must be loaded at the Dashlet level w/ loadLanguage

Details

Type: array

bool
                 $hasScript= 'false'

true if the Dashlet contains javascript

Default valuefalseDetails

Type: bool

\guid
                 $id= ''

Id of the Dashlet

Details

Type: \guid

bool
                 $isConfigPanelClearShown= 'true'

true if the Dashlet configuration options panel has the clear button

Default valuetrueDetails

Type: bool

bool
                 $isConfigurable= 'false'

true if the Dashlet has configuration options.

Default valuefalseDetails

Type: bool

bool
                 $isRefreshable= 'true'

true if the Dashlet is refreshable (ie charts that provide their own refresh)

Default valuetrueDetails

Type: bool

string
                 $title= ''Generic Dashlet''

Title of the Dashlet

Default value'Generic Dashlet'Details

Type: string

Methods

Dashlet(
           $id
          )
        
        :
          void

Constructor

Parameters

Name	Type	Description
$id

display(
          string $text
              =
              ''
          )
        
        :
          string

Called when Dashlet is displayed, override this

Parameters

Name	Type	Description
$text	string	text after the title

Returns

Type	Description
string	title HTML

displayOptions(
          
          )
        
        :
          void

Called when Dashlets configuration options are called

getAutoRefreshOptions(
          
          )
        
        :
          array

Returns the available auto refresh settings you can set a dashlet to

Returns

Type	Description
array	options available

getFooter(
          
          )
        
        :
          string

Called when Dashlet is displayed

Returns

Type	Description
string	footer HTML

getHeader(
          string $text
              =
              ''
          )
        
        :
          string

Called when Dashlet is displayed

Parameters

Name	Type	Description
$text	string	text after the title

Returns

Type	Description
string	Header html

getTitle(
          string $text
              =
              ''
          )
        
        :
          string

Parameters

Name	Type	Description
$text	string

Returns

Type	Description
string	HTML

Details

Deprecated: No longer needed, replaced with Dashlet::getHeader() and Dashlet::getFooter()

hasAccess(
          
          )
        
        :
          bool

Override this in the subclass. It is used to determine whether the dashlet can be displayed.

Returns

Type	Description
bool	indicating whether or not the current user has access to display this Dashlet.

isAutoRefreshable(
          
          )
        
        :
          bool

Returns true if the dashlet is auto refreshable

Returns

Type	Description
bool

loadLanguage(
          string $dashletClassname, string $dashletDirectory
              =
              'modules/Home/Dashlets/'
          )
        
        :
          void

Sets the language strings

Parameters

Name	Type	Description
$dashletClassname	string	classname of the dashlet
$dashletDirectory	string	directory path of the dashlet

loadOptions(
          
          )
        
        :
          array

Generic way to retrieve options array from UserPreferences

Returns

Type	Description
array	options array stored in UserPreferences

process(
          
          )
        
        :
          void

Override if you need to do pre-processing before display is called

processAutoRefresh(
          int $dashletOffset
              =
              0
          )
        
        :
          string

Processes and displays the auto refresh code for the dashlet

Parameters

Name	Type	Description
$dashletOffset	int

Returns

Type	Description
string	HTML code

saveOptions(
          array $req
          )
        
        :
          array

Override this if your dashlet is configurable (this is called when the the configureDashlet form is shown) Filters the array for only the parameters it needs to save

Parameters

Name	Type	Description
$req	array	the array to pull options from

Returns

Type	Description
array	options array

setConfigureIcon(
          
          )
        
        :
          string

Returns the HTML for the configure icon

Returns

Type	Description
string	HTML

setDeleteIcon(
          
          )
        
        :
          string

Returns the HTML for the delete icon

Returns

Type	Description
string	HTML

setRefreshIcon(
          
          )
        
        :
          string

Returns the HTML for the refresh icon

Returns

Type	Description
string	HTML

storeOptions(
          array $optionsArray
          )
        
        :
          void

Generic way to store an options array into UserPreferences

Parameters

Name	Type	Description
$optionsArray	array	the array to save

include/Dashlets/Dashlet.php

\Dashletjump to top

Properties

Methods

\Dashlet
jump to top