Dashboard Document Wizard Plugin Configuration

Configuration

The Dashboard Document Wizard plugin can be added to your project and configured using Hippo's setup application.

Prerequisites:

• Bloomreach Experience Manager project with setup application.
• At least one document type (to create a wizard for).

Instructions:

1. Using Hippo's setup application, add Document Wizard to your project.
   
    
2. Rebuild and  restart your project.
    
3. In the setup application find Document Wizard under Installed features and choose Configure.
   
    
4. Enter or choose the following configuration parameters:

   Shortcut name	Name of JCR node in which the configuration of the wizard will be stored (child node of  /hippo:configuration/hippo:frontend/cms/cms-dashshortcuts). Doesn't matter to the UI.
   Shortcut display name	Label for the dashboard shortcut that will open the wizard dialog.
   Document name label	Label for the document name form field in the wizard dialog.
   Select target folder	Folder in which the new document will be created.
   Document type	Type of the new document.
   Document query name	(Optional) By default the  new-document query is used to create the document. If you want to override that default, you can specify it as follows. You can use the query to inject values from the wizard dialog into the new document. See the  value injection page.
   Type	Wizard type ('date' or 'list'). When set to 'date', the document is created in a folder structure following the  /yyyy/mm format. E.g. if the date is December 16, 2015, the document is created in the folder  /2015/12. When set to 'list', the document is created in a folder with the name based on the chosen value. Please note: the key of the choosen value will be used as the name of the folder.
   Date label	(Only for type 'date') Label for the date form field in the wizard dialog.
   Value list document	(Only for type 'list') Location of the document containing the values for the list.
   List label	(Only for type 'list') Label for the list field in the wizard dialog.

   
    
    
5. Click on Add document wizard to documents.

Log in to the CMS to see a new shortcut to the new wizard on the dashboard.

Localization

Each wizard has its configuration stored in a child node of  /hippo:configuration/hippo:frontend/cms/cms-dashshortcuts, e.g.  /hippo:configuration/hippo:frontend/cms/cms-dashshortcuts/news.

The labels (as configured using the setup application) are stored in a child node of the configuration node, e.g.  /hippo:configuration/hippo:frontend/cms/cms-dashshortcuts/news/en for the locale 'en'.

Each label is stored in a String property, e.g.

/hippo:configuration/hippo:frontend/cms/cms-dashshortcuts:
  /news:
    jcr:primaryType: frontend:plugin
    /en:
      jcr:primaryType: frontend:pluginconfig
      shortcut-link-label: New news document
      name-label: New news document
      date-label: Document date

For each additional locale to be supported, copy the node 'en' to a new sibling node names after the locale (e.g. 'nl' or 'fr') and adjust the labels, e.g.

/hippo:configuration/hippo:frontend/cms/cms-dashshortcuts:
  /news:
    jcr:primaryType: frontend:plugin
    /en:
      jcr:primaryType: frontend:pluginconfig
      shortcut-link-label: New news document
      name-label: New news document
      date-label: Document date
    /nl:
      jcr:primaryType: frontend:pluginconfig
      shortcut-link-label: Nieuw nieuwsdocument
      name-label: Nieuw nieuwsdocument
      date-label: Documentdatum