Author Archive

Radius Search

How Radius Search Works?

How it works? If someone types keyword/location field, and  select a distance value, the address will be geocoded to latitude and longitude and all properties that are in the selected radius of that point are returned in search results.

The radius search is effective and improves accuracy especially for cities.


How to enable?

You can use either Google API or Geoapify:

  1. Using Google API – you need to create Google Maps API Key restricted to your server IP: How to get Google API Key?
  2. Using Geoapify API: https://www.geoapify.com/geocoding-api/

Once you created new API Key, paste it to Listeo Core → Map Settings → Server-side Geocoding & Radius Search


Alternative to Radius – Viewport Search

Check article about new filtering method, Viewport Search – When viewport search is enabled, Listeo uses these bounding box coordinates to find all listings within that rectangular area.

Viewport Search

When to Use Each Mode?

Use Viewport Mode:

  • When users commonly search for broad locations (states, countries, continents)

Use Radius Mode:

  • Sites focused on local/neighborhood search
  • “Near me” functionality is important
  • Users expect circular search areas
  • Listings are concentrated in specific cities

Multi-Criteria Ratings

You can configure multi-criteria ratings in Dashboard → Listeo Editor. Tooltips are optional, but it’s good practice to provide a short description for each criterion.

Criteria can be customized per listing type or even per taxonomy term. This works hierarchically: taxonomy term criteria have the highest priority, followed by listing-type criteria, and finally global criteria as the default.

Reviews Criteria editor in Listeo

 

 


Troubleshooting

If you can’t see “Add Review” form please check following steps:

  1. Make sure social links are not limited for specific listing package in Listeo Core → Packages Options. Maybe you made reviews to be enabled only in specific package but you did not turn it on in that package: https://docs.purethemes.net/listeo/knowledge-base/paid-listings/#extra-options
  2. Confirm that reviews are not disabled in Listeo Core → Submit Listing → Disable reviews on listings
  3. If you try to add review from owner account, you need to enable Listeo Core → Single Listing → Allow owners to add reviews because by default owners can’t add reviews, only guests can
  4. Ensure you enabled Settings → Discussion → Allow people to submit comments on new posts
  5. Classified listing type cannot be reviewed.
  6. Lastly, if you are trying to add review for your own listing (as an admin) – you can’t.

Adding custom field to booking confirmation form

If you would like to add custom fields to booking confirmation page you can do this in Listeo Editor. In this guide we added “tax id” and “age certify” checkbox.

Navigate to Listeo Editor → Booking Fields choose to which listing type you’d like to add custom fields and add them by clicking green button “add field”. You can choose field type to be checkbox, upload file, input field, select dropdown, multi-select or textarea.

 

Once added, fields will be visible in booking confirmation field and data from these field will be shown for guest and owner in their dashboard.

Conditional fields and displaying them on listing page

You can create custom fields, group and display them in listing overview for each category. Those fields will be also available in search forms editor so you will be able to create search form filters for your custom fields.


Add custom fields

Go to Listeo Editor → Listing Fields. Fields can be added for a whole listing type, in the tabs under Listing Type Fields, or for one category only with + Add term fields (such fields appear in the Add Listing form after the owner picks that category). Click Add field, pick a type, enter a Field name (the meta key is made from it) and click Add Field. Its settings open in a side panel.

Available field types:
1. Text (short text, a number or a link)
2. Textarea
3. Select (one option from a dropdown)
4. Multi Select
5. Checkbox (a single yes or no)
6. Multi Checkbox (several options, all visible)
7. Date time
8. File upload
9. Repeatable (rows of sub fields, like a price list)

The side panel of a field has four tabs: General (name, type, icon, options), Display (Required, Show on front card, Add to search form, Width and, for text fields, Number and unit and sorting), Form input (default value, placeholder, CSS class) and Rules.

Use Add headline to start a group, then drag fields under it. Each headline becomes a titled box on the listing page, and its group can be collapsed in the list to keep long lists short.

 

Fields are shown automatically in the Add Listing form. For category fields, they appear after the owner selects the category.


Show a field only for some categories or answers

Since Listeo 2.3 every field has a Rules tab:

  • Where this field applies: tick the categories the field is for, for example Doors only for Cars. Subcategories count too. Leave it empty to use the field for every category.
  • Show this field when: show or hide the field depending on another field, for example Mileage only when Condition is Used.

The rules work in the Add Listing form (while it is filled in), on the listing page, on listing cards and in search filters. A summary is shown on the field’s card in the list, for example “Shown on Cars listings only.”

A field hidden by a “Show this field when” rule loses its stored value when the listing is saved. A field outside its categories keeps its value. Test new rules on one listing first.

Full guide: Fields Visibility Rules.


Showing custom field on single listing page

No action needed, fields will be automatically displayed

You can change how each group looks. Open a headline, go to Display → Section on the listing page and pick a Layout:

  • Standard: the classic details box with round icons (shown above).
  • Highlights: key facts in a row, icon, bold value and the label under it. Set the number of Columns (2 to 6).
  • Table: one row per field, label on one side and value on the other.

Collapsible (Off / Open by default / Collapsed by default) lets visitors fold the group by clicking its headline.

More display options on each field:

  • Number and unit (Display tab of text fields): thousands separator, decimals and a unit before or after the value, for example “74,000 km”. Leave the separator off for years and codes.
  • Upload SVG next to the icon picker: your own SVG icon instead of a font icon. Only users who can post unfiltered HTML (administrators) can upload SVG files.
  • Taxonomies among the fields: with Place in the box “Taxonomies you can add to this list”, a taxonomy such as Make or Fuel is shown inside a group, as a row, as tags or in its own box.

Showing custom field on listing card

Open the field and tick Show on front card on the Display tab. The field is shown on listing cards with a tooltip on hover. Fields shown on cards have a Card chip in the list, and the On card filter at the top of the list shows them all.

To show the label as well (for example “Mileage: 74,000 km” instead of “74,000 km”), tick Show the label on cards under Number and unit (text fields only).

 

 

How to use mapbox custom map styles?

First go to your mapbox account, access studio and find style URL / access token

Due to the specific requirements of the Leaflet maps script used by Listeo, a particular URL format for the mapbox map style is necessary.

Next, go to Listeo Core and paste “Access token” into “MapBox Access Token” field.

Then extract username and token from “Style URL” :

mapbox://styles/purethemes/cm046dmnx00gm01ph73rr5rp5

and paste into following URL which should be applied into “MapBox Studio Style URL” field.

https://api.mapbox.com/styles/v1/USERNAME/TOKEN/tiles/{z}/{x}/{y}@2x?access_token=

an example or correct URL:

https://api.mapbox.com/styles/v1/purethemes/cm046dmnx00gm01ph73rr5rp5/tiles/{z}/{x}/{y}@2x?access_token=

 

 

How to create custom / static page with listings in Elementor

If you would like to create custom page with specific category listings or type here’s quick guide. Start with creating new page and selecting page layout and sidebar.

First select page template in WordPress editor. If you need map/slideable filter set Template to Listings With Map – Split Page.


Then click “Edit with elementor”

Add “Listings” widget

Configure listings layout

And add some filters e.g. you can display only listings from service listing type and specific category etc.


Custom Search Form

You can add on such page custom search form aswell

Search Forms Editor / Search Filters

How to enable external booking?

External Booking is an ption that adds a Book Now button that redirect to 3rd party website. To enable this feature simply add the field for that to listing submission form using Listeo Editor → Submit Form, find ‘External Booking link’ field.


Then add Listeo External Booking widget to single listing page:

If host will specify external booking URL in his listing “Book Now” button will redirect users to external booking page