Class ChannelConfig

    • Field Detail

      • CHANNEL_SUPPORTED_LOCALES_PROPERTY_NAME

        public static final String CHANNEL_SUPPORTED_LOCALES_PROPERTY_NAME
        Channel acceptable locales property name.
        Since:
        8.1.0
        See Also:
        Constant Field Values
      • CHANNEL_DETECT_USER_FROM_BROWSER_LOCALES_PROPERTY_NAME

        public static final String CHANNEL_DETECT_USER_FROM_BROWSER_LOCALES_PROPERTY_NAME
        Channel use browser locale property name.
        Since:
        8.1.0
        See Also:
        Constant Field Values
      • CHANNEL_DEFAULT_LOCALE_PROPERTY_NAME

        public static final String CHANNEL_DEFAULT_LOCALE_PROPERTY_NAME
        Channel default locale property name.
        Since:
        8.1.0
        See Also:
        Constant Field Values
      • CHANNEL_TYPE_LUMISADMIN

        public static final int CHANNEL_TYPE_LUMISADMIN
        See Also:
        Constant Field Values
      • FRIENDLY_PATH_TYPE_CHANNEL_NAME

        public static final int FRIENDLY_PATH_TYPE_CHANNEL_NAME
        The friendly path is generated using the parent channel's path and appending this channel's name
        See Also:
        Constant Field Values
      • FRIENDLY_PATH_TYPE_USER_DEFINED

        public static final int FRIENDLY_PATH_TYPE_USER_DEFINED
        The friendly path is user defined.
        See Also:
        Constant Field Values
      • FRIENDLY_PATH_TYPE_INHERIT

        public static final int FRIENDLY_PATH_TYPE_INHERIT
        The friendly path is the same as this channel's parent friendly path.
        See Also:
        Constant Field Values
    • Constructor Detail

      • ChannelConfig

        public ChannelConfig()
    • Method Detail

      • getLayoutFilePath

        public String getLayoutFilePath()
        Returns the path for the layout file for use by this channel.

        The layout file is inherited to child elements and from parent.

        If getLayoutPagesType() is not PageConfig.PAGE_LAYOUT_TYPE_LAYOUT_FILE (or inherited it), this method will return null since no layout file is to be used.

        Returns:
        layoutFile the path for the layout file, relative to the <lumisdata>/def directory, possibly inherited from parent channel; or null if no layout file is to be used.
        Since:
        5.6.0
        See Also:
        getLayoutPagesType(), setLayoutFilePath(String)
      • setLayoutFilePath

        public void setLayoutFilePath​(String layoutFile)
        Sets the path for the layout file.

        The path must be relative to the <lumisdata>/def directory, or null for inheriting the value from the parent channel.

        The layout file is inherited to child elements.

        The layout file property is applicable only if getLayoutPagesType() is PageConfig.PAGE_LAYOUT_TYPE_LAYOUT_FILE or inherited this value.

        Parameters:
        layoutFile - the path relative to the <lumisdata>/def directory, or null for inheriting the value from the parent channel.
        Since:
        5.6.0
        See Also:
        setLayoutPagesType(int)
      • getId

        public String getId()
        Returns:
        Returns the channelId.
      • setId

        public void setId​(String id)
        Parameters:
        id - The channelId to set.
      • getDescription

        public String getDescription()
        Returns:
        Returns the description.
      • setDescription

        public void setDescription​(String description)
        Parameters:
        description - The description to set.
      • getName

        public String getName()
        Returns:
        Returns the name.
      • setName

        public void setName​(String name)
        Parameters:
        name - The name to set.
      • isHidden

        public boolean isHidden()
        Returns:
        Returns the hidden.
      • setHidden

        public void setHidden​(boolean hidden)
        Parameters:
        hidden - The hidden to set.
      • isInheritStylesheet

        public boolean isInheritStylesheet()
        Returns:
        true if the Stylesheet was inherited and false otherwise.
      • isInheritMetaTags

        public boolean isInheritMetaTags()
        Returns:
        true if the Meta-Tags is inherited and false otherwise.
      • setInheritStylesheet

        public void setInheritStylesheet​(boolean inheritStylesheet)
        Parameters:
        inheritStylesheet -
      • setInheritMetaTags

        public void setInheritMetaTags​(boolean inheritMetaTags)
        Parameters:
        inheritMetaTags -
      • isInheritProtocol

        @Deprecated
        public boolean isInheritProtocol()
        Deprecated.
        since 4.0.11. This property is acquired via the getProtocol() method.
        Returns:
        Returns the inheritProtocol.
      • setInheritProtocol

        @Deprecated
        public void setInheritProtocol​(boolean inheritProtocol)
        Deprecated.
        since 4.0.11. This property is set via the #setProtocol() method.
        Parameters:
        inheritProtocol - The inheritProtocol to set.
      • isTemplate

        public boolean isTemplate()
        Returns:
        Returns the isTemplate.
      • setTemplate

        public void setTemplate​(boolean isTemplate)
        Parameters:
        isTemplate - The isTemplate to set.
      • getPageTemplateId

        public String getPageTemplateId()
        Returns:
        Returns the pageTemplateId.
      • setPageTemplateId

        public void setPageTemplateId​(String pageTemplateId)
        Parameters:
        pageTemplateId - The pageTemplateId to set.
      • getParentId

        public String getParentId()
        Returns:
        Returns the parentId.
      • setParentId

        public void setParentId​(String parentId)
        Parameters:
        parentId - The parentId to set.
      • getPosition

        public int getPosition()
        Returns:
        Returns the position.
      • setPosition

        public void setPosition​(int position)
        Parameters:
        position - The position to set.
      • getProtocol

        public int getProtocol()
        Returns:
        Returns the protocol.
      • setProtocol

        public void setProtocol​(int protocol)
        Parameters:
        protocol - The protocol to set.
      • getType

        public int getType()
        Returns:
        Returns the type.
      • setType

        public void setType​(int type)
        Parameters:
        type - The type to set.
      • getAccessControlListId

        public String getAccessControlListId()
        Returns:
        Returns the accessControlListId.
      • setAccessControlListId

        public void setAccessControlListId​(String accessControlListId)
        Parameters:
        accessControlListId - The accessControlListId to set.
      • setPropertyBagId

        protected void setPropertyBagId​(String propertyBagId)
        Sets the property bag identifier.

        This method should be used only for non-persisted channel, because this property value may not be changed.

        Parameters:
        propertyBagId - The propertyBagId to set.
        Since:
        5.0.0
      • getCenterPages

        public int getCenterPages()
        Returns:
        Returns the centerPages.
      • setCenterPages

        public void setCenterPages​(int centerPages)
        Parameters:
        centerPages - The centerPages to set.
      • getLayoutPagesType

        public int getLayoutPagesType()
        Returns the layout format for pages.
        Returns:
        The layout format for pages.
      • setLayoutPagesType

        public void setLayoutPagesType​(int layoutPagesType)
        Sets the layout format for pages.
        Parameters:
        layoutPagesType - one of the valid page layout formats The layout format to set for pages.
      • setLayoutPagesTypeInternal

        protected void setLayoutPagesTypeInternal​(int layoutPagesType)
        Sets the layout format for pages.
        Parameters:
        layoutPagesType - one of the valid page layout formats The layout format to set for pages.
      • getCachePages

        public int getCachePages()
        Returns:
        Returns the cachePages.
      • setCachePages

        public void setCachePages​(int cachePages)
        Parameters:
        cachePages - The cachePages to set.
      • hasLocalGroups

        public boolean hasLocalGroups()
        Returns:
        Returns the localGroups.
      • setLocalGroups

        public void setLocalGroups​(boolean localGroups)
        Parameters:
        localGroups - The localGroups to set.
      • getLocalGroupPrefix

        public String getLocalGroupPrefix()
        Returns:
        Returns the localGroupPrefix.
      • setLocalGroupPrefix

        public void setLocalGroupPrefix​(String localGroupPrefix)
        Parameters:
        localGroupPrefix - The localGroupPrefix to set.
      • getTemplateLocalGroupPrefix

        public String getTemplateLocalGroupPrefix()
        Returns the template local group prefix. This attribute specifies the pattern used when applying a channel template.
        Returns:
        the template local group prefix.
        Since:
        4.0.6
      • setTemplateLocalGroupPrefix

        public void setTemplateLocalGroupPrefix​(String templateLocalGroupPrefix)
        Sets the template local group prefix.
        Parameters:
        templateLocalGroupPrefix - the value to set.
        Since:
        4.0.6
        See Also:
        getTemplateLocalGroupPrefix()
      • getFriendlyPathType

        public int getFriendlyPathType()
      • setFriendlyPathType

        public void setFriendlyPathType​(int friendlyPathType)
      • getFriendlyPathUserDefined

        public String getFriendlyPathUserDefined()
      • setFriendlyPathUserDefined

        public void setFriendlyPathUserDefined​(String friendlyPathUserDefined)
      • setFriendlyId

        public void setFriendlyId​(String friendlyId)
        Sets the channel's friendly identifier. This value must be unique among the channels contained in the same channel this channel is contained.
        Parameters:
        friendlyId - the channel's friendly identifier.
        Since:
        6.0.0
      • setAutoGeneratedFriendlyId

        public void setAutoGeneratedFriendlyId()
        Generates a new friendly identifier and sets it as the friendly identifier of this channel. The friendly identifier is generated based on this channel's current name.

        This method requires an active transaction.

        Since:
        6.0.0
        See Also:
        setFriendlyId(String)
      • getFriendlyId

        public String getFriendlyId()
        Returns the channel's friendly identifier.
        Returns:
        the channel's friendly identifier.
        Since:
        6.0.0
      • setAutomaticFriendlyId

        public void setAutomaticFriendlyId​(boolean automaticFriendlyId)
        Indicates whether the channel is going to use automatic generated friendly identifier or not.
        Parameters:
        automaticFriendlyId - indicates whether the channel is going to use automatic generated friendly identifier or not.
        Since:
        6.0.0
      • isAutomaticFriendlyId

        public boolean isAutomaticFriendlyId()
        Returns whether the channel is going to use automatic generated friendly identifier or not.
        Returns:
        whether the channel is going to use automatic generated friendly identifier or not.
        Since:
        6.0.0
      • getParentTemplateId

        public String getParentTemplateId()
      • setParentTemplateId

        public void setParentTemplateId​(String parentTemplateId)
      • isInheritPageTemplate

        public boolean isInheritPageTemplate()
      • setInheritPageTemplate

        public void setInheritPageTemplate​(boolean inheritPageTemplate)
      • getPageRuntimeDataProviderType

        @Deprecated
        public int getPageRuntimeDataProviderType()
        Deprecated.
        Since 5.0.0 replaced by getPageWebResourceDataProviderType().
        Returns the page runtime data provider type. The possible values are {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_INHERIT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_DEFAULT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_CONTENT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_CUSTOM}
        Returns:
        the runtime data provider type.
        Since:
        4.2.0
      • setPageRuntimeDataProviderType

        @Deprecated
        public void setPageRuntimeDataProviderType​(int runtimeDataProviderType)
        Deprecated.
        Sets the page runtime data provider type. The possible values are {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_INHERIT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_DEFAULT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_CONTENT} or {@value #PageConfig.PAGE_RUNTIME_DATA_PROVIDER_TYPE_CUSTOM}
        Parameters:
        runtimeDataProviderType - the runtime data provider type.
        Since:
        4.2.0
      • getPageRuntimeDataProviderClassName

        @Deprecated
        public String getPageRuntimeDataProviderClassName()
        Deprecated.
        Returns the class name for the page runtime data provider. This value should only be used if the runtime data provider type is
        Returns:
        the runtime data provider class name
        Since:
        4.2.0
      • setPageRuntimeDataProviderClassName

        @Deprecated
        public void setPageRuntimeDataProviderClassName​(String runtimeDataProviderClassName)
        Deprecated.
        Sets the runtime data provider class name.
        Parameters:
        runtimeDataProviderClassName - the class name to be set.
        Since:
        4.2.0
      • getPageWebResourceDataProviderClassName

        public String getPageWebResourceDataProviderClassName()
        Returns the class name for the page web resource data provider.

        This value should only be used if the page web resource data provider type is PageConfig.PAGE_WEB_RESOURCE_DATA_PROVIDER_TYPE_CUSTOM

        Returns:
        the runtime data provider class name
        Since:
        5.0.0
      • setPageWebResourceDataProviderClassName

        public void setPageWebResourceDataProviderClassName​(String providerClassName)
        Sets the page web resource provider class name.
        Parameters:
        providerClassName - the class name to be set.
        Since:
        5.0.0
      • getFriendlyURLPattern

        public String getFriendlyURLPattern()
        Returns the friendly URL pattern specific for this channel (non-inheritable).
        Returns:
        the friendlyURLPattern the pattern, or null if it is not set for this channel.
        Since:
        5.0.0
      • setFriendlyURLPattern

        public void setFriendlyURLPattern​(String friendlyURLPattern)
        Sets the friendly URL pattern specific for this channel (non-inheritable).
        Parameters:
        friendlyURLPattern - the pattern.
        Since:
        5.0.0
      • isFriendlyURLPatternEnabled

        public boolean isFriendlyURLPatternEnabled()
        Returns if the friendly URL pattern specific for this channel (non-inheritable) is enabled.
        Returns:
        true if enabled, false if disabled.
        Since:
        5.0.0
      • isIgnoreOnExportImport

        public boolean isIgnoreOnExportImport()
        Returns whether this channel will be ignored on export and import.
        Returns:
        whether this channel will be ignored on export and import.
        Since:
        8.0.0
      • setIgnoreOnExportImport

        public void setIgnoreOnExportImport​(boolean ignoreOnExportImport)
        Sets whether this channel will be ignored on export and import.
        Parameters:
        ignoreOnExportImport - indicates whether this channel will be ignored on export and import.
        Since:
        8.0.0
      • setFriendlyURLPatternEnabled

        public void setFriendlyURLPatternEnabled​(boolean friendlyURLPatternEnabled)
        Sets if the friendly URL pattern specific for this channel (non-inheritable) is enabled.
        Parameters:
        friendlyURLPatternEnabled - true to enable, false to disable.
        Since:
        5.0.0
      • mayUseFriendlyId

        protected boolean mayUseFriendlyId​(String friendlyId)
                                    throws PortalException
        Description copied from class: StructureElement
        Indicates if the element may use the given friendly identifier.
        Specified by:
        mayUseFriendlyId in class StructureElement
        Parameters:
        friendlyId - the friendly identifier.
        Returns:
        true if the element may use the given friendly identifier, false otherwise.
        Throws:
        PortalException
      • getFriendlyIdMaxLength

        protected int getFriendlyIdMaxLength()
        Description copied from class: StructureElement
        Returns the maximum length of friendly identifier.
        Overrides:
        getFriendlyIdMaxLength in class StructureElement
        Returns:
        the maximum length of friendly identifier.
      • getProject

        public IProject getProject()
                            throws PortalException
        Returns the project this channel belongs to (if any).

        This method may require a current transaction.

        Returns:
        the project or null if this channel does not belong to any project or is not persisted.
        Throws:
        PortalException
        Since:
        12.5.0
      • getDefaultLocale

        public Locale getDefaultLocale()
                                throws PortalException
        Returns the default locale of this channel.
        If this channel does not define a default locale, it will be inherited from parent channel recursively. If no default locale could be found until reach the root channel, some registered locale will be returned.
        If the inheritance is to be ignored, consider using getDefaultLocaleLocal() instead.
        If a default locale was found but it doesn't exist in LumisPortal global locales, some of global locales will be returned, instead.
        Returns:
        the default locale of this channel.
        Throws:
        PortalException
        Since:
        8.1.0
      • getDefaultLocaleLocal

        public Locale getDefaultLocaleLocal()
                                     throws PortalException
        Returns the default locale of this channel.
        If this channel does not define a default locale, null will be returned. If inheritance is to be considered, consider using getDefaultLocale() instead.
        If a default locale was found but it doesn't exist in LumisPortal global locales, null will be returned, instead.
        Returns:
        the default locale of this channel.
        Throws:
        PortalException
        Since:
        8.1.0
      • setDefaultLocale

        public void setDefaultLocale​(Locale defaultLocale)
                              throws PortalException
        Sets the default locale of this channel.
        Parameters:
        defaultLocale - the default locale of this channel. Use null to indicate it should be inherited.
        Throws:
        PortalException
        Since:
        8.1.0
      • isUseBrowserAcceptedLanguages

        public boolean isUseBrowserAcceptedLanguages()
        Returns whether browser's accepted languages are to be used when setting user's locale.
        If this channel does not define this property, it will be searched until a parent that defines it could be found or the root channel is reached. If the root channel is reached and none of the parents defines this property, true will be used as fallback.
        If the inheritance should be ignored, consider using isUseBrowserAcceptedLanguagesLocal() instead.
        Returns:
        whether browser's accepted languages are to be used when setting user's locale.
        Since:
        8.1.0
      • isUseBrowserAcceptedLanguagesLocal

        public Boolean isUseBrowserAcceptedLanguagesLocal()
        Returns whether browser's accepted languages are to be used when setting user's locale.
        If this channel does not define this property, null will be returned.
        If the inheritance should not be ignored, consider using isUseBrowserAcceptedLanguages() instead.
        Returns:
        whether browser's accepted languages are to be used when setting user's locale.
        Since:
        8.1.0
      • setUseBrowserAcceptedLanguages

        public void setUseBrowserAcceptedLanguages​(Boolean useBrowserAcceptedLanguages)
        Sets whether browser's accepted languages are to be used when setting user's locale.
        Parameters:
        useBrowserAcceptedLanguages - whether browser's accepted languages are to be used when setting user's locale. Use null to indicate it should be inherited.
        Since:
        8.1.0