Package org.ametys.plugins.workspaces

Class AbstractWorkspaceModule

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.workspaces.AbstractWorkspaceModule

All Implemented Interfaces:

Comparable<WorkspaceModule>, WorkspaceModule, LogEnabled, PluginAware, Contextualizable, Serviceable

Direct Known Subclasses:

AboutWorkspaceModule, AlertWorkspaceModule, CalendarWorkspaceModule, DocumentWorkspaceModule, MembersWorkspaceModule, MiniSiteWorkspaceModule, NewsWorkspaceModule, TasksWorkspaceModule, ThreadWorkspaceModule, WallContentModule

public abstract class AbstractWorkspaceModule
extends AbstractLogEnabled
implements WorkspaceModule, Serviceable, Contextualizable, PluginAware

Abstract class for WorkspaceModule implementation

Field Summary

Fields

Modifier and Type	Field	Description
protected Context	_context	The avalon context
protected CurrentUserProvider	_currentUserProvider	The current user provider.
protected I18nUtils	_i18nUtils	The i18n utils.
protected WorkspaceModuleExtensionPoint	_modulesEP	The modules extension point
protected ObservationManager	_observationManager	Observer manager.
protected PageDAO	_pageDAO	The page DAO
protected String	_pluginName	The plugin name
protected ProjectManager	_projectManager	Project manager
protected ProjectRightHelper	_projectRightHelper	Project right helper
protected AmetysObjectResolver	_resolver	Ametys resolver
protected RightManager	_rightManager	The rights manager
protected ServiceExtensionPoint	_serviceEP	The services handler
protected SkinsManager	_skinsManager	The skins manager.
protected UserHelper	_userHelper	The users manager
protected UserManager	_userManager	User manager

Fields inherited from interface org.ametys.plugins.workspaces.project.modules.WorkspaceModule

ORDER_ABOUT, ORDER_ALERTS, ORDER_CALENDAR, ORDER_DOCUMENTS, ORDER_MEMBERS, ORDER_MINISITE, ORDER_NEWS, ORDER_TASKS, ORDER_THREADS, ORDER_WALLCONTENT

Constructor Summary

Constructors

Constructor	Description
AbstractWorkspaceModule()

Method Summary

Modifier and Type	Method	Description
protected ModifiablePage	_createModulePage(Project project, Sitemap sitemap, String name, I18nizableText pageTitle, String skinTemplate)	Create a new page if not already exists
protected void	_deleteEvents(Project project)	Delete all events related to this module
protected void	_deletePages(Project project)	Delete the module pages and their related contents
protected <A extends AmetysObject> A	_getAmetysObject(ModifiableTraversableAmetysObject parent, String name, String type, boolean create)	Utility method to get or create an ametys object
protected String	_getDefaultXslt(String serviceId)	Get the default value of the XSLT parameter of the given service.
protected List<Page>	_getModulePages(Project project)	Get the module pages
protected void	_internalActivateModule(Project project, Map<String,Object> additionalValues)	Internal process when module is activated
protected void	_internalDeactivateModule(Project project)	Internal process when module is deactivated
protected void	_internalDeleteData(Project project)	Internal process to delete data
protected void	_setPagesVisibility(Project project, boolean visible)	Change the visibility of module pages if needed
void	activateModule(Project project, Map<String,Object> additionalValues)	Activate the module for the project, creating the module pages
void	contextualize(Context context)
void	deactivateModule(Project project)	Deactivate a module
void	deleteData(Project project)	Delete a module and all related data (pages, events, resources, ...)
protected abstract String	getModulePageName()	Returns the module page's name
protected String	getModulePageTemplate()	Returns the template to use for module's page.
protected abstract I18nizableText	getModulePageTitle()	Returns the module page's title as i18n
String	getModuleUrl(Project project)	Get the URL of the first module's page
protected abstract void	initializeModulePage(ModifiablePage modulePage)	Initialize the module page
void	initializeSitemap(Project project, Sitemap sitemap)	Initialize the sitemap for the module
void	service(ServiceManager manager)
void	setPluginInfo(String pluginName, String featureName, String id)	Sets the plugin info relative to the current component. Note : The feature name may be null if the targeted component in declared at plugin level.

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ametys.plugins.workspaces.project.modules.WorkspaceModule

compareTo, getAllowedEventTypes, getId, getModuleDescription, getModuleName, getModuleRoot, getModuleTitle, getOrder, isUnactivatedByDefault

Field Detail

_projectManager

protected ProjectManager _projectManager

Project manager

_projectRightHelper

protected ProjectRightHelper _projectRightHelper

Project right helper

_userManager

protected UserManager _userManager

User manager

_resolver

protected AmetysObjectResolver _resolver

Ametys resolver

_rightManager

protected RightManager _rightManager

The rights manager

_observationManager

protected ObservationManager _observationManager

Observer manager.

_currentUserProvider

protected CurrentUserProvider _currentUserProvider

The current user provider.

_userHelper

protected UserHelper _userHelper

The users manager

_i18nUtils

protected I18nUtils _i18nUtils

The i18n utils.

_skinsManager

protected SkinsManager _skinsManager

The skins manager.

_pageDAO

protected PageDAO _pageDAO

The page DAO

_context

protected Context _context

The avalon context

_pluginName

protected String _pluginName

The plugin name

_serviceEP

protected ServiceExtensionPoint _serviceEP

The services handler

_modulesEP

protected WorkspaceModuleExtensionPoint _modulesEP

The modules extension point

Constructor Detail

AbstractWorkspaceModule

public AbstractWorkspaceModule()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

Description copied from interface: PluginAware

Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.

Specified by:

setPluginInfo in interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

deleteData

public void deleteData(Project project)

Description copied from interface: WorkspaceModule

Delete a module and all related data (pages, events, resources, ...)

Specified by:

deleteData in interface WorkspaceModule

Parameters:

project - The project

deactivateModule

public void deactivateModule(Project project)

Description copied from interface: WorkspaceModule

Deactivate a module

Specified by:

deactivateModule in interface WorkspaceModule

Parameters:

project - The project

activateModule

public void activateModule(Project project,
                           Map<String,Object> additionalValues)

Description copied from interface: WorkspaceModule

Activate the module for the project, creating the module pages

Specified by:

activateModule in interface WorkspaceModule

Parameters:

project - The project

additionalValues - A list of optional additional values. Accepted values are : description, mailingList, inscriptionStatus, defaultProfile, tags, categoryTags, keywords and language

initializeSitemap

public void initializeSitemap(Project project,
                              Sitemap sitemap)

Description copied from interface: WorkspaceModule

Initialize the sitemap for the module

Specified by:

initializeSitemap in interface WorkspaceModule

Parameters:

project - The project of the module

sitemap - The sitemap

getModuleUrl

public String getModuleUrl(Project project)

Description copied from interface: WorkspaceModule

Get the URL of the first module's page

Specified by:

getModuleUrl in interface WorkspaceModule

Parameters:

project - The project

Returns:

the module url

_createModulePage

protected ModifiablePage _createModulePage(Project project,
                                           Sitemap sitemap,
                                           String name,
                                           I18nizableText pageTitle,
                                           String skinTemplate)

Create a new page if not already exists

Parameters:

project - The module project

sitemap - The sitemap where the page will be created

name - The page's name

pageTitle - The page's title as i18nizable text

skinTemplate - The template from the skin to apply on the page

Returns:

the created page or null if page already exists

_setPagesVisibility

protected void _setPagesVisibility(Project project,
                                   boolean visible)

Change the visibility of module pages if needed

Parameters:

project - The project

visible - visible true to set pages as visible, false otherwise

_deletePages

protected void _deletePages(Project project)

Delete the module pages and their related contents

Parameters:

project - The project

_getModulePages

protected List<Page> _getModulePages(Project project)

Get the module pages

Parameters:

project - the project

Returns:

the module pages

_deleteEvents

protected void _deleteEvents(Project project)

Delete all events related to this module

Parameters:

project - The project

_getDefaultXslt

protected String _getDefaultXslt(String serviceId)

Get the default value of the XSLT parameter of the given service.

Parameters:

serviceId - the service ID.

Returns:

the default XSLT parameter value.

getModulePageName

protected abstract String getModulePageName()

Returns the module page's name

Returns:

The module page's name

getModulePageTitle

protected abstract I18nizableText getModulePageTitle()

Returns the module page's title as i18n

Returns:

The module page's title

getModulePageTemplate

protected String getModulePageTemplate()

Returns the template to use for module's page. Can be null if the page should be a node page

Returns:

The template

initializeModulePage

protected abstract void initializeModulePage(ModifiablePage modulePage)

Initialize the module page

Parameters:

modulePage - The module page

_internalDeactivateModule

protected void _internalDeactivateModule(Project project)

Internal process when module is deactivated

Parameters:

project - The project

_internalDeleteData

protected void _internalDeleteData(Project project)

Internal process to delete data

Parameters:

project - The project

_internalActivateModule

protected void _internalActivateModule(Project project,
                                       Map<String,Object> additionalValues)

Internal process when module is activated

Parameters:

project - The project

additionalValues - A list of optional additional values. Accepted values are : description, mailingList, inscriptionStatus, defaultProfile, tags, categoryTags, keywords and language

_getAmetysObject

protected <A extends AmetysObject> A _getAmetysObject(ModifiableTraversableAmetysObject parent,
                                                      String name,
                                                      String type,
                                                      boolean create)
                                               throws AmetysRepositoryException

Utility method to get or create an ametys object

Type Parameters:

A - A sub class of AmetysObject

Parameters:

parent - The parent object

name - The ametys object name

type - The ametys object type

create - True to create the object if it does not exist

Returns:

ametys object

Throws:

AmetysRepositoryException - if an repository error occurs