Section: List items settings

---

To show or hide the button that, when clicked, it displays the related marker of a list item on the map, do the following:

1. Edit a map
2. Open the widget “List & filter Settings”.
3. Click on the menu “List items settings”.
4. Select an option in the field “Button Visibilty”.

---

When you use the list items title and/or image as link to the single post/page, you may want to open the link in a new page. To choose how to open the list items links, do the following:

1. Edit a map
2. Open the widget “List & filter Settings”.
3. Click on the menu “List items settings”.
4. Choose an option in the field “Post URL”.

---

To set the list items image as a link to the single post/page, do the following:

1. Edit a map
2. Open the widget “List & Filter Settings”.
3. Click on the menu “List items settings”.
4. Select the option “Yes” in the field “Image as link”.

---

To set the list items title as a link to the single post/page, do the following:

1. Edit a map
2. Open the widget “List & Filter Settings”.
3. Click on the menu “List items settings”.
4. Select the option “Yes” in the field “Title as link”.

---

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 ][

---

By default, the plugin displays the posts title in the list items, however, you can specify what to display in the list items by building your custom title structure from custom fields. To build your custom title, 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 Title”. In this field, create your title structure by providing the custom fields names to use. You must put each new element (custom field, separator) you add in the title 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].
   • Separator: An element to use to separate between each element in the title. It could be a word, a slash, a comma, a dash or else. To identify a separator in your title 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 as a label [s=My Field: ].
   • Empty space: To add an empty space between two elements in the title, simply add [-] anywhere you want to add a space.
   • Finally, to specify the size of your custom title, 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 title to 100 letters (including empty spaces!). Note that the lenght must be the last element to add to the title structure! To display the whole title, simply don’t specify a lenght!

Let’s summarize all the above in two examples.

Name: Jhon smith | Age: 29 | Sexe: M

[s=Name: ][user_name][-][s=|][-][s=Age: ][user_age][-][s=|][-][s=Sexe: ][user_sexe]

Open House, 3 Baths, 2 Beds, 14 Tottenham Court Road, London …

[property_type][s=,][-][property_beds][-][s=Baths, ][property_beds][-][s=Beds, ][property_address][l=60]

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

---

To activate the option that allows scrolling to an item on the list when the user clicks on its related marker on the map, do the following:

1. Edit a map
2. Open the widget “List & Filter Settings”.
3. Click on the menu “List items settings”.
4. Select the option “Yes” in the field “Scroll to list item”.