Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleCreate a Display Pattern

How to create a Display Pattern?

The display pattern editor will help administrators create simple display patterns. The Click edit to open the display pattern editor is opened when you click on edit in any of the Detail, List, Name, or Thumbnail display patterns.

  1. Open

your desired schema and go to "Display pattern"
  1. schemas.

  2. Edit the schema.

  3. Find the

fields on the right
  1. display pattern, and on hover, open the editor with the pen icon.

  2. Click

on
  1. a field to add it to the Display Pattern

  2. The preview is directly adapted.

  3. Save your Display Pattern.

schemas_update-display-pattern.mp4

The Picturepark adds values are just added without any further formatting, so you will formatting. You get one block of text from all values of the selected fields, e.g., TitelDescriptionDateTagbox. Each field code is a Liquid Syntax Tag (if not an empty statement) containing a Liquid Syntax Object (the metadata field to use) – see Liquid Syntax for details.

You can add HTML and CSS for styling your Display Pattern. 

Filter by label (Content by label)
showLabelsfalse
max50
cqllabel = "display-pattern" and label = "html" and space = "SOL"
Expand
titleUse Display Pattern Editor

How to use the Display Pattern Editor?

Image RemovedImage Added
    The
    1. In the Monaco editor

    where
    1. , you

    write 
    1. write the Liquid Syntax

     to create your
    1. (base for Display Pattern).

    2. The search and paging to find a specific item you want to see in the preview. To find a specific content item search for the content's id which is shown in the content detail view URL bar e.g. id:cb20faba4e3342d9a9f83191deeec115

    3. The preview

    - which
    1. will give you a preview of the Display Pattern (you must have at least one content item filled out with the values in the Display Pattern for a preview to display).

    The
    1. You can add fields of the

    Schema can easily be added to the current Display Pattern
    1. schema easily by clicking on them. Each field will be added with a liquid tag checking if the field is not empty and the liquid object which is the field.

    2. Layers

    1. are only necessary for the Virtual Type Display Pattern

    where the
    1. . The fields will be the virtual type fields and additional metadata fields from layers will be available in this section.

    2. Languages

    - which allows
    1. allow you to add a different Display Pattern per Metadata language. If you only

    add
    1. update the default language this will be used in all other languages, the values are always translated if translations are available.

      1. Hint: Adding languages makes only sense if you use static text in the Display Pattern which then not be translated.

    2. The JSON preview shows the detailed data structure of the current item you are previewing and all the available objects you have for the Display Pattern.

      1. You can use this for debugging or to check which fields are available for usage.

      2. In contentSchemaId – you find data – where you find all metadata you can use e.g. the title which is translated into en only.

        Image Modified
Expand
titleSolution: Optimized Code Example

Solution: Optimized Code Example

To improve your code for performance and handling, you can follow this example.

Include Page
SOL:Coding Advice: Push Tags in Display Pattern
SOL:Coding Advice: Push Tags in Display Pattern
Expand
titleView a Display Pattern

Picturepark uses Display Patterns in different areas, usually to construct nicer summaries instead of plain IDs. Check Display Pattern Types for details.

Info

Picturepark shows Display Pattern only for ID-based filters e.g. a filter on the tagbox _refid uses the name pattern of the connected list, but a filter on a field value of that list e.g. product name will show the name.

Expand
titleUpdate a Display Pattern

How to update your Display Pattern?

Find your desired Display Pattern in the settings and select editschema in edit mode, hover to edit the display pattern.

  1. Find the individual field values (1)

    1. {if} {{data.layer.field | liquid filter }} {endif}

  2. Add spaces and special characters or line breaks using HTML <br>

  3. Validate your edits in the preview

You can add HTML and CSS for styling your Display Pattern.

Filter by label (Content by label)
showLabelsfalse
max50
cqllabel = "display-pattern" and label = "html" and space = "SOL"

Re-Render after Display Pattern Update

After changing an existing Display Pattern, you will find a badge on settings in the main menu. Go there and follow the red badge.

  1. Open settings

  2. Open status

  3. Open outdated Display Pattern.

  4. Re-Render

Please be aware that this will start a rerendering of Picturepark re-renders all display values and which may affect the performance of the system. Consider rerendering only after you First, finish your edits, work with the preview in the Display Pattern editor for quick validation of your editsand start re-rendering when you complete your work.

Expand
titleDelete a Display Pattern

How to delete a Display Pattern?

To delete the Display Pattern, you must provide at least a space. The Display Pattern cannot be empty. For a better overview, you should provide a dash or pipe instead of a space.

  1. Open your desired schema and edit the desired Display Pattern

  2. Remove everything in the editor on the left

  3. Add a space, dash, or pipe (whatever you prefer)

  4. Save your Display Pattern

Re-Render after Display Pattern

Update

Deletion

After changing an existing Display Pattern, you will find a badge on settings must re-index which is shown in the status panel at the top position in the schema detail view. It is also indicated with a badge on schemas in the main menu. Go there and follow the red badge.

  1. Open settings

  2. Open status

  3. Open outdated Display Pattern.

  4. Re-Render

Please be aware that this will start a rerendering of Picturepark re-renders all display values and , which may affect the performance of the system. Consider rerendering only after you First, finish your edits, work with the preview in the Display Pattern editor for quick validation of your editsand start re-rendering when you complete your work.

Expand
titleLimitations

Limitations

  • For security reasons, we do not allow resolve Javascript to be resolved.

  • When you update metadata or content, the Display Patterns are updated each time Content is saved. For this reason, users will not . You don't see Display Patterns change while viewing Contentcontent.

  • Display patterns are not inherited by ChildrenChildren do not inherit display patterns from their parents. For example, you cannot set display patterns for all file types on FileMetadata. The display patterns that you do set here will take hold for any content that is a File Type content but does not belong to AudioMetadata, DocumentMetadata, ImageMetadata, VideoMetadata e.g. for a .css file.

  • Display patterns do not take permissions into account. They are pre-calculated and are not bound to user permissions. Display Patterns should therefore be optimized for your general audience and not the super admin.

  • Please avoid using Picturepark icons in HTML or CSS. Currently, material design icons are treated as fontfonts, so any CSS font styling works for icons too (e.g. color or size).  Icons will be replaced in one of the next releases which will break all icon implementations. 

  • Picturepark does not support HTML and CSS rendering is not supported for all in Display Patterns e.g. in the list views the HTML will be not interpreted and displayed as text. 

...