Build a custom content from custom fields and/or categories for the list items

By default, the plugin displays the posts excerpt or content in the list items description, however, you can specify what to display as the content by building your custom content structure from custom fields and/or taxonomies/categories. To build your custom content, do the following:

  1. Edit a map
  2. Open the widget “List & Filter Settings”.
  3. Click on the menu “List items settings”.
  4. Scroll down to the field “List item description”. In this field, create your content structure by providing the custom fields names and/or the taxonomies/categories to use. You must put each new element (custom field, taxonomy, separator) you add in the content between brackets. Below is the list of all elements you can use:
    • Custom field: The custom field name. To add a custom field, enter its name like in this example: [custom_field_name].
    • Taxonomy slug: The slug/name of the taxonomy/category. This will get the taxonomy term of each item/post displayed in the list. Identify the taxonomy by entering its slug like in this example: [tax:TAXONOMY_SLUG]. Unlike the custom fields, to indentify the presence of a taxonomy in your content structure, you must follow the first bracket by the term tax=. The abbreviation tax refers to the word taxonomy and the signe = refers to “is/equal”.
    • Separator: An element to use to separate between each element in the content. It could be a line break, a word, a slash, a comma, a dash or else. To identify a separator in your content structure, you need to put it between brackets, but unlike the custom field, the first bracket must be followed by the term s=. The letter s refers to the word “separator” and the signe = refers to “is/equal”. Here’s a usage example: [s=,]. In this example, the separator is a comma (,). Here’s another example that uses the separator to add a line break [s=br].
    • Empty space: To add an empty space between two elements in the content, simply add [-] anywhere you want to add a space.
    • Label/static text/title: To add a label/title/static text, use the term t=. The letter t refers to the word “title”. Here’s a usage example: [t=Your Label].
    • Excerpt/Content: You can add the original post excerpt or content to your custom structure. To do that, use the term (content) followed by a semi colon (;), then, the maximum number of letters (including empty spaces!) to display from the excerpt/content. Here’s a usage example: [content;100]. This example will display the first 100 letters from the original post excerpt/content.
    • Finally, to specify the size of your custom content, use the term l which refers to the word length. Here’s a usage example: [l=100].  In this example, we specify the size of the content to 100 letters (including empty spaces!). Note that the lenght must be the last element to add to the content structure! To display the whole content, simply don’t specify a lenght!

Let’s summarize all the above in an example.

Name: Jhon smith↵
Age: 29 | Sexe: Male↵
About: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna …

[t=Name: ][user_name][s=br][t=Age: ][user_age][-][s=|][-][t=Sexe: ][tax=gender][s=br][t=About: ][content;100][l=400]

*Make sure there’s no empty spaces between ][

In the same context