include/MVC/View/SugarView.php

Show:

inherited

Classes
- \SugarView

Table of Contents

\SugarView
jump to top

Package: SugarCRM

Base Sugar view

Children: \HomeViewAdditionaldetailsretrieve; \HomeViewTour; \ViewMain; \ViewModulelabels; \ViewHome; \ViewHistory; \ViewHistory; \ViewDisplaydeployresult; \ViewModule; \ViewExportcustomizations; \ViewPortalStyleUpload; \ViewDropdowns; \ViewRelationship; \ViewPortalStyle; \Viewpackage; \ViewPortalSync; \Viewdeletepackage; \ViewDropdown; \ViewDepDropdown; \ViewResetmodule; \ModuleBuilderViewWizard; \ViewDisplaydeploy; \ViewPortalPreview; \ViewProperty; \Viewdeletemodule; \ViewModulefields; \ViewModulefield; \ViewRelationships; \ViewSchedule; \ReportsViewBuildreportmoduletree; \ImportViewStep4; \ImportView; \ImportViewError; \DocumentsViewExtdoc; \ViewWizard; \TrackersViewTrackersettings; \TeamsViewPopup; \CampaignsViewClassic; \OauthTokensViewAuthorize; \ViewQuickview; \ViewQuicklist; \ViewAdminsettings; \CalendarViewSaveSettings; \CalendarViewJson; \CalendarViewQuickEdit; \CalendarViewCreateInvitee; \CalendarViewGetGR; \CalendarViewGetGRUsers; \ConfiguratorViewFontManager; \ConfiguratorViewSugarpdfsettings; \ViewAdminwizard; \ConfiguratorViewAddFontView; \ConfiguratorViewAddFontResult; \forecast_charts; \ViewCampaignconfig; \ViewConfig; \ViewEditConvert; \ViewEditConvertLayout; \ViewConvertLead; \ViewShowDuplicates; \ViewModifyProperties; \ViewModifyMapping; \ViewConnectorSettings; \ViewStep2; \ViewModifyDisplay; \ViewModifySearch; \ContactsViewValidPortalUsername; \ContactsViewContactAddressPopup; \ContactsViewRetrieveEmail; \ContactsViewMailMergePopup; \ViewConfigureshortcutbar; \ViewBackups; \ViewViewofflineclients; \ViewLanguages; \ViewConfiguretabs; \AdministrationViewGlobalsearchsettings; \ViewConfigureAjaxUI; \AdministrationViewThemesettings; \ViewRepair; \AdministrationViewEnablewirelessmodules; \ViewEditFormula; \ViewSelectRelatedField; \ViewEditDepDropdown; \ViewFunctiondetail; \ViewRollupWizard; \ViewIndex; \ViewCfTest; \SugarWirelessView; \ViewImportvcard; \ViewMultiedit; \ViewSugarpdf; \ViewDetail; \ViewJson; \ViewSerialized; \ViewAjax; \ViewXML; \ViewFts; \ViewModulelistmenu; \ViewVcard; \ViewNoaccess; \ViewList; \ViewClassic; \ViewHtml; \ViewMetadata; \ViewPopup; \ViewEdit; \ViewFavorites; \ViewAjaxUI; \ViewImportvcardsave
Api

Properties


                 $action= ''''

The name of the current action.

Default value''Details

Type: n/a


                 $bean= 'null'

Default valuenullDetails

Type: n/a


                 $errors= 'array()'

Any errors that occured this can either be set by the view or the controller or the model

Default valuearray()Details

Type: n/a


                 $fileResources= ''

Details

Type: n/a


                 $module= ''''

The name of the current module.

Default value''Details

Type: n/a


                 $options= 'array('show_header' => true, 'show_title' => true, 'show_subpanels' => false, 'show_search' => true, 'show_footer' => true, 'show_javascript' => true, 'view_print' => false,)'

Options for what UI elements to hide/show/

Default value

array('show_header' => true, 'show_title' => true, 'show_subpanels' => false, 'show_search' => true, 'show_footer' => true, 'show_javascript' => true, 'view_print' => false,)

Details

Type: n/a


                 $responseTime= ''

Details

Type: n/a


                 $ss= 'null'

Sugar_Smarty. This is useful if you have a view and a subview you can share the same smarty object.

Default valuenullDetails

Type: n/a


                 $suppressDisplayErrors= 'false'

Set to true if you do not want to display errors from SugarView::displayErrors(); instead they will be returned

Default valuefalseDetails

Type: n/a


                 $type= 'null'

Default valuenullDetails

Type: n/a


                 $view_object_map= 'array()'

This array is meant to hold an objects/data that we would like to pass between the controller and the view. The bean will automatically be set for us, but this is meant to hold anything else.

Default valuearray()Details

Type: n/a

Methods

SugarView(
           $bean
              =
              null,  $view_object_map
              =
              array()
          )
        
        :
          void

Constructor which will peform the setup.

Parameters

Name	Type	Description
$bean
$view_object_map

_buildModuleList(
          
          )
        
        :
          void

_calculateFooterMetrics(
          
          )
        
        :
          void

_checkModule(
          
          )
        
        :
          void

Checks to see if the module name passed is valid; dies if it is not

_displayJavascript(
          
          )
        
        :
          void

Called from process(). This method will display the correct javascript.

_displayLoginJS(
          
          )
        
        :
          void

_displaySubPanels(
          
          )
        
        :
          void

Called from process(). This method will display subpanels.

_getModLanguageJS(
          
          )
        
        :
          void

_getModuleTab(
          
          )
        
        :
          void

Returns the module name which should be highlighted in the module menu

_getModuleTitleListParam(
          bool $browserTitle
              =
              false
          )
        
        :
          string

Returns the portion of the array that will represent the listview in the breadcrumb

Parameters

Name	Type	Description
$browserTitle	bool	true if the returned string is being used for the browser title, meaning there should be no HTML in the string

Returns

Type	Description
string

_getModuleTitleParams(
          bool $browserTitle
              =
              false
          )
        
        :
          array

Returns an array composing of the breadcrumbs to use for the module title

Parameters

Name	Type	Description
$browserTitle	bool	true if the returned string is being used for the browser title, meaning there should be no HTML in the string

Returns

Type	Description
array

_getOption(
          string $option, bool $default
              =
              false
          )
        
        :
          bool

private method used in process() to determine the value of a passed in option

Parameters

Name	Type	Description
$option	string	option - the option that we want to know the valye of
$default	bool	default - what the default value should be if we do not find the option

Returns

Type	Description
bool	- the value of the option

_getStatistics(
          
          )
        
        :
          void

_initSmarty(
          
          )
        
        :
          void

_track(
          
          )
        
        :
          void

track Private function to track information about the view request

_trackView(
          
          )
        
        :
          void

trackView

checkPostMaxSizeError(
          
          )
        
        :
          boolean

Determines whether the state of the post global array indicates there was an error uploading a file that exceeds the post_max_size setting. Such an error can be detected if: 1. The Server['REQUEST_METHOD'] will still point to POST 2. POST and FILES global arrays will be returned empty despite the request method This also results in a redirect to the home page (due to lack of module and action in POST)

Returns

Type	Description
boolean	indicating true or false

display(
          
          )
        
        :
          void

[OVERRIDE] - This method is meant to overidden in a subclass. This method will handle the actual display logic of the view.

displayErrors(
          
          )
        
        :
          void

This method will display the errors on the page.

displayFooter(
          
          )
        
        :
          void

Called from process(). This method will display the footer on the page.

displayHeader(
           $retModTabs
              =
              false
          )
        
        :
          void

Displays the header on section of the page; basically everything before the content

Parameters

Name	Type	Description
$retModTabs

fetchTemplate(
          \$file $file
          )
        
        :
          \$content

fetchTemplate

This function wraps the call to the fetch function of the Smarty variable for the view

Parameters

Name	Type	Description
$file	\$file	String path of the file to fetch

Returns

Type	Description
\$content	String content from resulting Smarty fetch operation on template

getBreadCrumbSymbol(
          
          )
        
        :
          string

Returns the correct breadcrumb symbol according to theme's directionality setting

Returns

Type	Description
string

getBrowserTitle(
          
          )
        
        :
          string

Returns the string which will be shown in the browser's title; defaults to using the same breadcrumb as in the module title

Returns

Type	Description
string

getCustomFilePathIfExists(
          \$file $file
          )
        
        :
          \$file

getCustomFilePathIfExists

This function wraps a call to get_custom_file_if_exists from include/utils.php

Parameters

Name	Type	Description
$file	\$file	String of filename to check

Returns

Type	Description
\$file	String of filename including custom directory if found

getFavicon(
          
          )
        
        :
          array

Retrieves favicon corresponding to currently requested module

Returns

Type	Description
array

getHelpText(
          \$module $module
          )
        
        :
          \$theTitle

getHelpText

This is a protected function that returns the help text portion. It is called from getModuleTitle.

Parameters

Name	Type	Description
$module	\$module	String the formatted module name

Returns

Type	Description
\$theTitle	String the HTML for the help text

getJavascriptValidation(
          
          )
        
        :
          void

static

Get JS validation code for views

getMenu(
          \$module $module
              =
              null
          )
        
        :
          array

Loads the module shortcuts menu

Parameters

Name	Type	Description
$module	\$module	string optional, can specify module to retrieve menu for if not the current one

Returns

Type	Description
array	module menu

getMetaDataFile(
          
          )
        
        :
          string

Return the metadata file that will be used by this view.

Returns

Type	Description
string	File location of the metadata file.

getModuleMenuHTML(
          
          )
        
        :
          void

getModuleTitle(
          bool $show_help
              =
              true
          )
        
        :
          \HTML

Return the "breadcrumbs" to display at the top of the page

Parameters

Name	Type	Description
$show_help	bool	optional, true if we show the help links

Returns

Type	Description
\HTML	string containing breadcrumb title

getModuleTitleIconPath(
           $module
          )
        
        :
          void

Parameters

Name	Type	Description
$module

getSugarConfigJS(
          
          )
        
        :
          array

Fetch config values to be put into an array for JavaScript

Returns

Type	Description
array

includeClassicFile(
          string $file
          )
        
        :
          void

If the view is classic then this method will include the file and setup any global variables.

Parameters

Name	Type	Description
$file	string

init(
           $bean
              =
              null,  $view_object_map
              =
              array()
          )
        
        :
          void

Parameters

Name	Type	Description
$bean
$view_object_map

logMemoryStatistics(
          \$newline $newline
              =
              '
'
          )
        
        :
          \$message

logMemoryStatistics

This function returns a string message containing the memory statistics as well as writes to the memory_usage.log file the memory statistics for the SugarView invocation.

Parameters

Name	Type	Description
$newline	\$newline	String of newline character to use (defaults to )

Returns

Type	Description
\$message	String formatted message about memory statistics

preDisplay(
          
          )
        
        :
          void

[OVERRIDE] - This method is meant to overidden in a subclass. The purpose of this method is to allow a view to do some preprocessing before the display method is called. This becomes useful when you have a view defined at the application level and then within a module have a sub-view that extends from this application level view. The application level view can do the setup in preDisplay() that is common to itself and any subviews and then the subview can just override display(). If it so desires, can also override preDisplay().

prepareConfigVarForJs(
          string $key, string $value
          )
        
        :
          string

Utility method to convert sugar_config values into a JS acceptable format.

Parameters

Name	Type	Description
$key	string	Config Variable Name
$value	string	Config Variable Value

Returns

Type	Description
string

process(
          
          )
        
        :
          void

This method will be called from the controller and is not meant to be overridden.

renderJavascript(
          
          )
        
        :
          void

include/MVC/View/SugarView.php

\SugarViewjump to top

Properties

Methods

\SugarView
jump to top