Chapter 5 MyLists Widgets

5.1 User Lists Widget

The User Lists widget can display lists that users created, similar to the User Lists page. When published on the listing detail pages, the widget can show lists that include the currently viewed listing.

To publish the widget, go to Appearance -> Widgets in WP Dashboard, find (MyLists) User Lists widget and drag it to one of the widget positions.

The widget comes with many parameters:

Order - Choose how the lists will be sorted.

In detail view - Choose what will be shown when the widget is displayed on the listing detail page.

Display List Description

Trim Description (# words) - Choose the number of list description words that will be shown.

When no results - What will happen when there are no user lists to show.

Theme suffix - Allows you to create a custom suffixed user lists widget theme file.

Show Last Listing Thumbnail - Displays the main media of the last listing added to the list.

Thumbnail Position - Choose the thumbnail position in relation to the rest of the list content.

Thumbnail Type - Choose Scale or Crop mode for thumbnails.

Size (WIDTHxHEIGHT) - Enter thumbnail dimensions in WIDTHxHEIGHT format.

Positioning of Pagination - Choose the position of slider arrows when the widget has multiple slider pages.

Page Transition - Choose the transition type for the slider pagination (Horizontal sliding | Vertical sliding | Fade effect).

Enable Slideshow - If enabled, the widget will automatically advance slider pages.

Slideshow Interval (sec.) - Time between pages in seconds.

Max. number of results - Total number of results that will be displayed.

Results per page - How many results will be displayed per slider page. If you enter the same number as for Max. number of results, then the widget slider will be disabled and all results will be displayed at once.

Columns - Choose how many results per row to show.

Show numbers - Adds numbers before each result.

5.2 Site Lists Widget

The Site Lists widget can be used only on the listing detail pages and its purpose is to show how many users added the currently viewed listing to default site lists created by the site administrator.

Example of the widget output on the listing detail page:

To publish the widget, go to Appearance -> Widgets in WP Dashboard, find (MyLists) Site Lists widget and drag it to one of the widget positions.

Widget parameters:

When no results - What will happen when there are no User Lists to show.

Theme suffix - Allows you to create a custom suffixed User Lists Module theme file.