org.opencms.workplace
Class CmsFrameset

java.lang.Object
  org.opencms.workplace.CmsWorkplace
      org.opencms.workplace.CmsFrameset

public class CmsFrameset

extends CmsWorkplace

Provides methods for building the main framesets of the OpenCms Workplace.

The following files use this class:

• /views/top.html
• /views/top_foot.html
• /views/top_head.html

Since:

6.0.0

Version:

$Revision: 1.84 $

Author:

Alexander Kandzior

Field Summary

static String[]	FRAMES The names of the supported frames.
static List	FRAMES_LIST The names of the supported frames in a list.
static String	JSP_WORKPLACE_URI Path to the JSP workplace frame loader file.
static String	PARAM_WP_FRAME The request parameter for the selection of the frame.
static String	PARAM_WP_PROJECT The request parameter for the workplace project selection.
static String	PARAM_WP_SITE The request parameter for the workplace site selection.
static String	PARAM_WP_START The request parameter for the workplace start selection.
static String	PARAM_WP_VIEW The request parameter for the workplace view selection.

Fields inherited from class org.opencms.workplace.CmsWorkplace

DEBUG, DEFAULT_LANGUAGE, DEFAULT_LOCALE, DIALOG_PATH_COMMON, FILE_DIALOG_CLOSE, FILE_DIALOG_SCREEN_CONFIRM, FILE_DIALOG_SCREEN_ERROR, FILE_DIALOG_SCREEN_ERRORPAGE, FILE_DIALOG_SCREEN_WAIT, FILE_EXPLORER_FILELIST, FILE_REPORT_OUTPUT, HTML_END, HTML_START, PATH_DIALOGS, PATH_WORKPLACE, REQUEST_ATTRIBUTE_MULTIPART, REQUEST_ATTRIBUTE_RELOADTREE, RFS_PATH_RESOURCES, SESSION_WORKPLACE_CLASS, TEMP_FILE_PREFIX, VFS_DIR_DEFAULTBODIES, VFS_DIR_TEMPLATES, VFS_PATH_GALLERIES, VFS_PATH_LOCALES, VFS_PATH_MODULES, VFS_PATH_RESOURCES, VFS_PATH_SYSTEM, VFS_PATH_VIEWS, VFS_PATH_WORKPLACE

Constructor Summary

CmsFrameset(CmsJspActionElement jsp)
Public constructor.

Method Summary

String	buildContextMenues() Builds the Javascript for the Workplace context menus.
String	getBroadcastMessage() Returns the javascript code for the broadcast message alert in the foot of the workplace.
int	getExplorerSettings() Returns the file settings for the Workplace explorer view.
String	getGroupSelect(String htmlAttributes) Returns a html select box filled with groups of the current user.
String	getLoginAddress() Returns the remote ip address of the current user.
String	getLoginTime() Returns the last login time of the current user in localized format.
String	getProjectSelect(String htmlAttributes, String htmlWidth) Returns a html select box filled with the current users accessible projects.
String	getSiteSelect(String htmlAttributes) Returns a html select box filled with the current users accessible sites.
String	getStartupUri() Returns the startup URI for display in the main body frame, this can eihter be the user default view, or (if set) a sepcific startup resource.
String	getViewSelect(String htmlAttributes) Returns a html select box filled with the views accessible by the current user.
String	getWorkplaceReloadUri() Returns the reload URI for the OpenCms workplace.
protected void	initWorkplaceRequestValues(CmsWorkplaceSettings settings, HttpServletRequest request) Analyzes the request for workplace parameters and adjusts the workplace settings accordingly.
boolean	isPublishEnabled() Returns true if the user has publish permissions for the current project.
boolean	isReloadRequired() Returns true if a reload of the main body frame is required.
boolean	isSyncEnabled() Returns true if the user has enabled synchronization.
boolean	showSiteSelector() Indicates if the site selector should be shown in the top frame depending on the count of accessible sites.
protected void	topFrameReload(CmsWorkplaceSettings settings) Performs certain clear cache actions if the top frame is reloaded.

Methods inherited from class org.opencms.workplace.CmsWorkplace

addMessages, allParamsAsHidden, allParamsAsRequest, allParamValues, bodyEnd, bodyStart, bodyStart, buildSelect, buildSelect, button, button, buttonBar, buttonBar, buttonBarHorizontalLine, buttonBarLabel, buttonBarLabel, buttonBarLine, buttonBarLineSpacer, buttonBarSeparator, buttonBarSpacer, buttonBarStartTab, calendarIncludes, calendarIncludes, calendarInit, calendarInit, checkLock, checkLock, decodeParamValue, fillParamValues, getBroadcastMessageString, getCalendarDate, getCalendarJavaDateFormat, getCalendarLocalizedTime, getCms, getEncoding, getExplorerFileListFullUri, getFrameSource, getJsp, getLocale, getMacroResolver, getMessages, getMultiPartFileItems, getParameterMap, getResourceUri, getResourceUri, getSession, getSettings, getSkinUri, getStyleUri, getStyleUri, getStyleUri, htmlEnd, htmlStart, initMessages, initUserSettings, initWorkplaceMembers, initWorkplaceSettings, isForwarded, isHelpEnabled, isSubElement, key, key, key, nullToEmpty, pageBody, pageHtml, pageHtmlStyle, paramsAsHidden, paramsAsHidden, paramsAsParameterMap, paramsAsRequest, paramValues, resolveMacros, sendCmsRedirect, setForwarded, shortKey, switchToCurrentProject, switchToTempProject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FRAMES

public static final String[] FRAMES

The names of the supported frames.

FRAMES_LIST

public static final List FRAMES_LIST

The names of the supported frames in a list.

PARAM_WP_FRAME

public static final String PARAM_WP_FRAME

The request parameter for the selection of the frame.

See Also:

Constant Field Values

PARAM_WP_PROJECT

public static final String PARAM_WP_PROJECT

The request parameter for the workplace project selection.

See Also:

Constant Field Values

PARAM_WP_SITE

public static final String PARAM_WP_SITE

The request parameter for the workplace site selection.

See Also:

Constant Field Values

PARAM_WP_START

public static final String PARAM_WP_START

The request parameter for the workplace start selection.

See Also:

Constant Field Values

PARAM_WP_VIEW

public static final String PARAM_WP_VIEW

The request parameter for the workplace view selection.

See Also:

Constant Field Values

JSP_WORKPLACE_URI

public static final String JSP_WORKPLACE_URI

Path to the JSP workplace frame loader file.

See Also:

Constant Field Values

Constructor Detail

CmsFrameset

public CmsFrameset(CmsJspActionElement jsp)

Public constructor.

Parameters:

jsp - an initialized JSP action element

Method Detail

buildContextMenues

public String buildContextMenues()

Builds the Javascript for the Workplace context menus.

Returns:

the Javascript for the Workplace context menus

getBroadcastMessage

public String getBroadcastMessage()

Returns the javascript code for the broadcast message alert in the foot of the workplace.

Returns:

javascript code showing an alert box when the foot load

getExplorerSettings

public int getExplorerSettings()

Returns the file settings for the Workplace explorer view.

Returns:

the file settings for the Workplace explorer view

getGroupSelect

public String getGroupSelect(String htmlAttributes)

Returns a html select box filled with groups of the current user.

Parameters:

htmlAttributes - attributes that will be inserted into the generated html

Returns:

a html select box filled with groups of the current user

getLoginAddress

public String getLoginAddress()

Returns the remote ip address of the current user.

Returns:

the remote ip address of the current user

getLoginTime

public String getLoginTime()

Returns the last login time of the current user in localized format.

Returns:

the last login time of the current user in localized format

getProjectSelect

public String getProjectSelect(String htmlAttributes,
                               String htmlWidth)

Returns a html select box filled with the current users accessible projects.

Parameters:

htmlAttributes - attributes that will be inserted into the generated html

htmlWidth - additional "width" html attributes

Returns:

a html select box filled with the current users accessible projects

getSiteSelect

public String getSiteSelect(String htmlAttributes)

Returns a html select box filled with the current users accessible sites.

Parameters:

htmlAttributes - attributes that will be inserted into the generated html

Returns:

a html select box filled with the current users accessible sites

getStartupUri

public String getStartupUri()

Returns the startup URI for display in the main body frame, this can eihter be the user default view, or (if set) a sepcific startup resource.

Returns:

the startup URI for display in the main body frame

getViewSelect

public String getViewSelect(String htmlAttributes)

Returns a html select box filled with the views accessible by the current user.

Parameters:

htmlAttributes - attributes that will be inserted into the generated html

Returns:

a html select box filled with the views accessible by the current user

getWorkplaceReloadUri

public String getWorkplaceReloadUri()

Returns the reload URI for the OpenCms workplace.

Returns:

the reload URI for the OpenCms workplace

isPublishEnabled

public boolean isPublishEnabled()

Returns true if the user has publish permissions for the current project.

Returns:

true if the user has publish permissions for the current project

isReloadRequired

public boolean isReloadRequired()

Returns true if a reload of the main body frame is required.

This value is modified with the select options (project, site or view) in the head frame of the Workplace. If a user changes one of these select values, the head frame is posted "against itself". The posted values will be processed by this class, causing the internal Workplace settings to change. After these settings have been changed, a reload of the main body frame is required in order to update it with the new values. A JavaScript in the Workplace head frame will be executed in this case.

Returns:

true if a reload of the main body frame is required

isSyncEnabled

public boolean isSyncEnabled()

Returns true if the user has enabled synchronization.

Returns:

true if the user has enabled synchronization

showSiteSelector

public boolean showSiteSelector()

Indicates if the site selector should be shown in the top frame depending on the count of accessible sites.

Returns:

true if site selector should be shown, otherwise false

initWorkplaceRequestValues

protected void initWorkplaceRequestValues(CmsWorkplaceSettings settings,
                                          HttpServletRequest request)

Description copied from class: CmsWorkplace

Analyzes the request for workplace parameters and adjusts the workplace settings accordingly.

Specified by:

initWorkplaceRequestValues in class CmsWorkplace

Parameters:

settings - the workplace settings

request - the current request

See Also:

CmsWorkplace.initWorkplaceRequestValues(org.opencms.workplace.CmsWorkplaceSettings, javax.servlet.http.HttpServletRequest)

topFrameReload

protected void topFrameReload(CmsWorkplaceSettings settings)

Performs certain clear cache actions if the top frame is reloaded.

Parameters:

settings - the current users workplace settings