Section: Carousel

---

By default, the plugin displays the posts excerpt or content in the carousel 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 “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Scroll down to the field “Items 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 carousel. 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 ][

---

To add ellipses (…) at the end of the carousel items content, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Select the option “Yes” in the field “Show ellipses”.

---

When you use the carousel items title as link, you may want to open the link in a new page. To choose how to open the carousel items links, do the following:

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

---

You can use the carousel items title as link to that item’s signle post or details page. To set the carousel items title as a link, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Select the option “Yes” in the field “Title as link”.
5. In the field “Post URL”, choose how to open the link.

---

By default, the plugin displays the posts title in the carousel items, however, you can specify what to display in the carousel 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 “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Scroll down to the field “Items 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 ][

---

The change the text displayed in the items link, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Modify the text in the field “”More” Button text”.

---

The carousel items can be displayed in a horizontal view and/or a vertical view. To set the display view of the items in the crousel, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Carousel items settings”.
4. Choose a view option in the field “Items view”.

---

When you click on and/or hover over an item in the carousel, this will drag the map to that item’s location/position. You can change the zoom of the map when displaying the location of an item on the map by doing the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Carousel settings”.
4. Select a zoom level in the field “Map zoom”.