Admincentral module

Content management Bundled: Community edition

Edition

CE

License

MLA, GPL

Issues

ADMINCTR

Maven site

ADMINCTR

Latest

6.3.4

The Admincentral module is used to configure the layout and availability of apps in the App launcher.

Installing with Maven

Maven is the easiest way to install the module. Add the following to your bundle:

<dependency>
  <groupId>info.magnolia.admincentral</groupId>
  <artifactId>magnolia-admincentral</artifactId>
  <version>6.3.4</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.admincentral</groupId>
  <artifactId>magnolia-global-search-integration</artifactId>
  <version>6.3.4</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>.

  • The UI Admincentral is a different module. Its groupId is info.magnolia.ui, and its artifactId is magnolia-ui-admincentral.

  • In Magnolia 6.4, the configuration for the Global Search (formerly the Find Bar) is in the periscope-core module.

Properties to configure the App launcher layout.

Property Description

favouriteAppConfiguration

Configuration for favorite applications.

Example:

favouriteAppConfiguration:
  maxApps: 12
  favouriteApps:
    - pages-app

     favouriteApps

optional (type: List)

List of favorite application names.

     maxApps

optional (type: int)

Maximum number of favorite apps allowed.

layout

Configuration for layout settings.

     defaultGroup

optional (type: String)

Default group name for apps.

     hiddenApps

optional (type: List)

List of apps to hide.

     groups

optional (type: List)

List of group configurations.

Example:

layout:
  groups:
    - name: content
      apps:
        - name: pages-app
        - name: dam
    - name: marketing
      apps:
        - name: analytics
        - name: campaigns
    - name: admin
      apps:
        - name: security-app
      permissions:
        groups:
          - developers

         name

required (type: String)

Name of the group.

         label

optional (type: String)

Display label for the group.

         apps

optional (type: List)

List of app configurations within the group.

             name

required (type: String)

Name of the app within the group.

         permissions

optional (type: Object)

Permission settings for the group.

             groups

optional (type: List)

List of groups with access permissions.

     rows

optional (type: List)

List of row configurations.

Example:

laayout:
  rows:
    - name: one
      cssClass: editor
      groups:
        content: content
        marketing: marketing
    - name: two
      cssClass: editor
      groups:
        - personalisation

         name

required (type: String)

Name of the row.

         displayed

optional (type: boolean)

Indicates whether the row is displayed (default: true).

         cssClass

optional (type: String)

CSS class to apply to the row.

         groups

optional (type: List or Map)

List or map of groups to include in the row.

Example configuration:

/admincentral/config.yaml
favouriteAppConfiguration:
  maxApps: 12
  favouriteApps:
    - pages-app

layout:
  defaultGroup: custom
  hiddenApps:
    dam-chooser: dam-chooser
    preview: preview
    assets: assets
    categories: categories
    notifications: notifications
    tasks-app: tasks-app
    personas: personas
    tourCategories: tourCategories
    pages: pages
    segmentation: segmentation
    ecommerce-category-chooser: ecommerce-category-chooser
    ecommerce-connection-chooser: ecommerce-connection-chooser
    ecommerce-product-chooser: ecommerce-product-chooser
  groups:
    - name: content
      apps:
        - name: pages-app
        - name: dam
        - name: stories
        - name: tours
    - name: marketing
      apps:
        - name: analytics
        - name: campaigns
        - name: marketing-tags
        - name: abn-testing
    - name: personalisation
      apps:
        - name: personas-app
        - name: segmentation-app
        - name: preview-app
    - name: categorisation
      apps:
        - name: content-tags
        - name: categories-app
    - name: translation
      apps:
        - name: pages-translation
    - name: development
      apps:
        - name: jcr-browser-app
        - name: backup
        - name: mail
        - name: cacheTools
        - name: logTools
        - name: publishing
        - name: tools
        - name: jcr-tools
        - name: pages-translation
        - name: messages
        - name: groovy
        - name: sample
        - name: graphql
        - name: restclient
        - name: resources
        - name: site
        - name: configuration
        - name: definitions-app
      permissions:
        groups:
          - developers
    - name: admin
      apps:
        - name: security-app
        - name: password-manager
        - name: visitors
        - name: cookies
        - name: about
        - name: ecommerce
        - name: rssAggregator
      permissions:
        groups:
          - developers
    - name: custom
      apps: []
  rows:
    - name: one
      cssClass: editor
      groups:
        content: content
        marketing: marketing
    - name: two
      cssClass: editor
      groups:
        - personalisation
        - categorisation
        - translation
    - name: three
      cssClass: editor
      groups:
        - custom
    - name: four
      cssClass: developer
      groups:
        - development
        - admin

Global password policy validation

The Admincentral module provides global password policy validation for all password fields via the ValidatingPasswordFieldDefinition class. This validation is configured in the ui-framework-core module and enforces password strength requirements across the system.

The default password policy requires:

  • Minimum 12 characters in length

  • At least one uppercase English letter

  • At least one lowercase English letter

  • At least one digit

  • At least one special character from the set: #?!@$%^&*-

This policy is automatically applied to password fields in the Security app and any other location where password validation is needed.

Configure the password policy pattern

You can customize the password policy by decorating the ui-framework-core module configuration. The pattern property uses a regular expression to define password requirements.

To modify the password policy, create a decoration file in your module:

ui-framework-core/config.yaml
...
  info.magnolia.ui.field.ValidatingPasswordFieldDefinition$BcryptedPasswordFieldDefinition:
    policy:
      class: info.magnolia.ui.field.RegexpValidatorDefinition
      # Password policy regular expression below:
      ## Password has a minimum of 12 characters in length. Adjust it by modifying {12,}
      ## At least one uppercase English letter. You can remove this condition by removing (?=.*?[A-Z])
      ## At least one lowercase English letter. You can remove this condition by removing (?=.*?[a-z])
      ## At least one digit. You can remove this condition by removing (?=.*?[0-9])
      ## At least one special character. You can remove this condition by removing (?=.*?[#?!@$%^&*-])
      pattern: ^(?=.*?[A-Z])(?=.*?[a-z])(?=.*?[0-9])(?=.*?[#?!@$%^&*-]).{12,}$

You can customize the pattern by:

  • Changing the minimum length by modifying {12,} to your desired number

  • Removing character type requirements by deleting the corresponding (?=.*?[…​]) groups

  • Adding additional special characters to the character set [#?!@$%^&*-]

For more details about password field configuration, see Password field.

Related topics
Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules