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.

The values are just added schemas_update-display-pattern.mp4

Picturepark adds values 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 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).

    4. You can add fields of the 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.

    5. Layers are only necessary for the Virtual Type Display Pattern. The fields will be the virtual type fields and additional metadata fields from layers will be available in this section.

    6. Languages allow you to add a different Display Pattern per Metadata language. If you only 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.

    7. 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
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

Picturepark re-renders all display values which may affect the performance of the system. First, finish your edits, work with the preview in the editor for quick validation and 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 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

Picturepark re-renders all display values, which may affect the performance of the system. First, finish your edits, work with the preview in the editor for quick validation and start re-rendering when you complete your work.

Expand
titleLimitations

Limitations

  • For security reasons, we do not resolve Javascript.

  • When you update metadata or content, the Display Patterns are updated. You don't see Display Patterns change while viewing content.

  • Children 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. 

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

...