Author Archive

Categories and Features

This is explanation of dynamic filter: features. This option is switchable in Listeo Core → Browse Listings → Make “features” taxonomy related to categories.
This option will make Features filter load only features terms that are assigned to selected category.

Listing categories and features can be configured in Listings → Categories or Features.

You can create separated listing features list for each category.

Radius Search

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.

If you want to enable Radius Search in your theme, you need to create another Google Maps API Key without any key or domain restrictions. This key will be used on server side geocoding and it won’t be public.

How to get Google API Key?

Once you created new API Key, paste it to Listeo Core → Map Settings → Gooogle Maps API key for server side geocoding

In Listeo Core click “Test your API key” below key input field to make sure it is working correctly.


How to verify if Geocoding is working?

Make sure you key is properly created (not restricted to domain and all APIs enabled). Open following link and add your API key at the end of URL: https://maps.google.com/maps/api/geocode/json?address=%22New%20York%22&key=ADD_YOUR_API_KEY_HERE

 

Commissions and Wallet

How booking payments work in Listeo

Each booking is tracked and stored in WordPress Dashboard → Commissions, where you can manage bookings and orders and know how much you have to transfer back to listing owner. Payouts has to be made manually, an exception is Stripe Split Payment payout method:

Related article – Stripe Split Payments: https://docs.purethemes.net/listeo/knowledge-base/stripe-split-payments-support//

As an site administrator you can take fee for each booking service.

For an example: if the owner of a listing with an apartment booking service set a  fixed price of $50 for each day and you set 10% fee for booking service you will get $5 and pay rest ($45) to the vendor.

You can set commissions rate in Dashboard → Listeo Core → General 


Payouts can be managed in Dashboard → Commissions.

By clicking “Make Payout” button you will be redirected to the page with unpaid orders summary. After making payout orders you will be redirected to next page with payout summary/withdrawal details. All orders will be marked as “processed” in listing owner’s “Wallet” page and his “Withdrawable Balance” counter will be reset.

You browse payouts history and check details of each payout in Commissions → Payouts History

Payment method chosen by listing owner will be visible above commissions table. Money transfer has to be done manually by the site administrator.


Vendors (listing owners) have an additional “Wallet” page in the dashboard where they can check summary of their earnings from bookings, payouts history and set payout method.

Related article – PayPal Split Payments: https://docs.purethemes.net/listeo/knowledge-base/paypal-split-payments-support/


Custom Comission

You can individually modify commission for each user by editing user details in WordPress Admin → Users

Paid Listing Packages

If you are not familiar with WooCommerce we recommend checking the official documentation first. 🙂

Configurating WooCommerce Settings
WooCommerce Core Payments Options
Shop Currency
Setting Up Taxes in WooCommerce
WooCommerce Default Pages


How to add paid listing /product listing package?

Paid packages are basically WooCommerce products. To add new paid listing package go to WordPress dashboard → Products → Add new, change the Product Type to “Listing Package“. Now you can describe package and configure it.

You can require users to buy a listing package before submitting a listing, to do this first make sure paid listings feature is enabled in Listeo Core → Packages Options → Paid listings

Except the standard Price and Discount fields, you’ll see 3 new:

  1. Listing Limit – set the number of listings user can add after buying that package. Leave empty for unlimited submissions.
  2. Listing Duration – set how long the listings are visible until they are expired
  3. Featured Listing? if this checkbox is marked, all listings added using this package will be marked with “featured” badge

How to edit existing package?

Simply navigate to WP Admin → Products, filter products by “Listing Package” and click edit.


Renewable/Subscription Support for Listing Packages

If you want to charge your user weekly/monthly/yearly for having listings active on your site, Listeo has support for WooCommerce Subscriptions plugin. After installing it, you will have new type of product “Listing Package Subscription” where you can configure how it should work on your site.


Extra Listing Package Options

The current list of options is:

  1. Booking Module –  makes setting booking options available in Listing and displays the Booking Widget in Single Listing Sidebar
  2. Reviews Module – adds option to review the listing
  3. Gallery Module – adds option to upload images to
  4. Gallery Images Limit – limits number of photos that can be uploaded to listing
  5. Social Links Module – adds option to set external social sites links
  6. Opening Hours Module – adds option to set Opening Hours and display them in the Opening Hours widget
  7. Video Module – adds option to add and display video in the listing
  8. Coupons Module – adds option to set Coupon for the listing and display it in the sidebar widget

Those options are enabled for all listings by default, so if you want to limit some or all of them, first go to Listeo Core -> Packages Options -> Check module to disable it in Submit Listing form.

The modules you will check there will be now removed from Submit Listing Form and from Single Listing view, and will be only available if the Listing Package used to submit listing has those options.

To enable those elements in Listing Package, edit the WooCommerce Product and check with checkbox which elements this package allows.

How to make pricing package featured?

 


Listing Package Manager

You can review and modify packages already purchased by your website users in Listeo Editor → Packages Manager.

there you can enable/disable package options or add new packages for users


Payment Gateways

Setting up WooCommerce Payment Gateways

Add Listing Form Editor

With our drag & drop editor fields can be easily added, renamed or re-arranged for each listing type. You can also create specific field for each listing type to show additional data, for example rooms in apartments, additional services informations, etc.

You will find drag&drop editor in Listeo Editor → Add Listing Form

If you’d like to add custom field you need to create such Custom Field in WP Admin → Listeo Editor → Listings Fields.

Available Custom Fields:
1. Input
2. Dropdown Select
3. Dropdown Multi Select
4. Upload Field
5. Checkbox
6. Multi Checkbox
7. Date Time
8. Textarea

Search Forms Editor / Search Filters

Listeo features drag and drop filters forms editor. You can easily add new, rename or re-arrange fields. Go to Listeo Editor → Search Forms and choose search form which you would like to customize.


On the right, you’ll find searchable elements that you can drag to the left where you’d like them displayed. With our editor you’ve endless possibilities – you can for example switch a default dropdown to a multi-select and choose between default filter placement or a dropdown filter (e.g., price filter). In “Search on Half Map,” you can adjust the field’s width as well.

  1. Home Search Form Default – form used on homepage as seen there:
    https://listeo.pro/
  2. Home Search Form Boxed – airbnb search form style as seen there:
    https://listeo.pro/home-5/
  3. Sidebar Search – the default sidebar search as seen there:
    https://listeo.pro/list-with-sidebar/
  4. Search on Half Map Layout – form used on half-screen layouts as seen there:
    https://listeo.pro/half-list/
  5. Search in Header – form used in header:
    https://listeo.pro/home-2/



Custom Search Forms for Elementor Block

You can create multiple search forms on a single page, or if needed, you can have different homepages or landing pages, each with its own unique search form in Elementor block.


Search Form Shortcode

Alternatively you can use shortcode to display custom search form. For example we created “Test Form” for which shortcode will be [listeo_search_form source=”test-form”]

How does search by location works?

There are two ways the ‘location’ field in search can work. The presence of Google Maps API key for server side geocoding in Listeo Core determines which one is used.

  1. If the API key is added the address typed in ‘location’ field is geocoded to latitude and longitude and all properties that are in the selected radius of that point are returned in search results. The radius  value can be set by default in Listeo Core options (it’s 50km by default). Related articles: Radius search → 
  2. If there’s no API key added the search is strictly text based, the text typed by user is compared to the content of property, property title, and every custom field attached to property to find matching results.

Why do I get “Failed to import” message when importing demo content?

While importing demo content you might get a list of messages started with ” Failed to import xxx” – that is quite common and in most cases nothing to worry about.

This message will display for ” media” – the theme you’ve bought doesn’t included the images used in Theme Preview – those are stock images which cannot be redistributed – so we cannot allow you as end user to get them with the xml file, that’s why they are not imported and replaced with generic gray placeholder images.

The same message might happen for some post types or post attributes. For example if the demo of theme includes shop functionality, it’s added via WooCommerce. If you don’t have WooCommerce installed prior to importing demo content (because you don’t need it or you didn’t want it yet) – your WordPress simply doesn’t know there could by custom post type named “product” – so it won’t be able to import the products from demo XML, and the import tool with show each of the product as a “Failed to import“.

Setting Up Listeo Core

“Listeo Core” is the core plugin that powers listings and booking functionalities. You’ll find all the settings in Dashboard → Listeo Core.

All options are clearly described so we won’t be doing the same here. Go ahead and play with it on your website. 😉 

Listeo Core → General Settings

Setting Options/Details
Clock Format 12H or 24H
Date Format Separator Hyphen (-), Slash (/), Dot (.)
Add Timezone for iCal Files Ensure timezone in WordPress Settings → General is set to a city, not UTC.
Commission Rate Set the commission percentage for bookings.
Currency Settings * Choose a currency: Select from the list.<br>* Custom Currency Symbol: Specify a custom symbol if not listed.<br>* Currency Position: Before or After
Decimal Places for Prices Set the precision for price decimal places. Default: 2.
Calendar View Language Set the language for the calendar. Default: English (en).
Default Sort Order for Listings Newest, Highest Rated, Oldest, Most Viewed, Featured, Most Views, Verified, Alphabetically
Region in Listing Permalinks Enable to prepend property links with regions. After enabling, go to Settings → Permalinks and click Save Changes.
Owner Contact Information Visibility Always Show, Only registered users
Expire Listing After Event Date Enable to automatically expire listings after the event date.
Payout Options PayPal (if PayPal Payouts is active, this option replaces it), Bank Transfer<br>(Stripe configuration is managed in the Stripe Connect tab.)
Statistics Module Options * Enable Statistics Mode: Track visits and add a dashboard chart.<br>* Data to Track: Unique visits (uses cookies), Booking form clicks, Contact form clicks<br>* Hide Chart in Dashboard: Check to hide the chart.

 

Listeo Core → Map Settings

Setting Options/Details
Restrict Search Results to One Country Enter the country symbol (e.g., uk). Leave blank to search worldwide. (Works only with Google Maps)
Enable Map Bounds Search Search listings within the current map view.
Listings Map Center Point Enter latitude and longitude separated by a comma (e.g., -34.397,150.644). Default: 40.757662,-73.974741.
Autofit All Markers on Map Disable to manually set the map’s zoom level.
Automatically Locate Users on Page Load Requires HTTPS. Uses HTML5 geolocation.
Zoom Level for Listings Map Enter a number between 020. Works only when autofit is disabled. Default: 16.
Zoom Level for Single Listing Map Enter a number between 020.
Maps Provider OpenStreetMap, Google Maps (requires API key), MapBox (requires API key), Bing (requires API key), ThunderForest (requires API key), HERE (requires API key), None
Address Suggestion Provider OpenStreetMap, Google Maps (requires API key and Google Maps as Maps Provider), Disable Address Suggestion
API Keys and Tokens * Google Maps API Key: Generate a Google Maps API key.
* MapBox Access Token: Generate an access token.
Radius Search Settings * Enable Search by Radius: Requires a Google Maps API key for geocoding.
* Server-Side Geocoding Provider: Geoapify, Google Maps API Key for Server-Side Geocoding, Geoapify API Key
* Radius Slider Default State: Choose whether the radius slider is enabled by default.
* Radius Search Unit: km
* Default Radius Search Value: Set a default radius. Default: 50.

Listeo Core → Submit Listing

Setting Options/Details
Supported Listing Types Service, Rental, Event, Classifieds (Select supported types. Deselecting all defaults to Service.)
Service Type Icon Set an icon.
Rental Type Icon Set an icon.
Event Type Icon Set an icon.
Classifieds Type Icon Set an icon.
Disable Bookings Module Enable to disable bookings.
Admin Approval Required for New Listings Yes / No
Admin Approval Required for Editing Listings Yes / No
Notify Admin by Email About New Listing Waiting for Approval Yes / No
Listing Duration Default: 30 (Set to 0 for no expiration)
Listing Images Upload Limit Default: 10
Listing Image Maximum Size (in MB) Default: 2
Submit Listing Map Center Point Default: 40.757662,-73.974741 (Latitude and longitude separated by comma)

 

Listeo Core → Package Options

Setting Options/Details
Paid Listings On or Off
Allow Packages to Only Be Purchased Once Per Client Select packages that can be bought only once
Skip Package Selection if User Already Has a Package If a user has an active package, the “choose package” step will be skipped.
Check Module to Disable It in Submit Listing Form Booking Module, Reviews Module, Gallery Module, Pricing Menu Module, Social Links Module, Opening Hours Module, Video Module, Coupons Module (Select modules to disable)
Show Extra Package Options Automatically in Pricing Table Enable to display additional package options automatically.

 

Listeo Core → Single Listing Page Settings

Setting Options/Details
Default Gallery Type Grid Gallery
Show Full Calendar on Single Listing Yes / No
Single Listing Full Calendar Content Type Show all booked days and times.
Enable Google Reviews Yes / No
Set Language for Google Reviews Default: ENGLISH
How Many Days Should the Reviews Be Cached For Default: 1
Show Google Reviews Rating on Listing if There Are No Listeo Reviews Enable to show Google Reviews rating as a fallback.
Reviews Settings * Allow owners to add reviews<br>* Allow reviewing only to users who made a booking<br>* Disable “Add Photos” option in the review form<br>* Disable reviews on listings
Address and Taxonomy Settings
Hide Real Address on Listings and Lists Enable to hide the real address.
Show Taxonomies as List of Checkboxes on Single Template Categories, Events Categories, Service Categories, Rentals Categories, Classifieds Categories, Features, Regions (Select taxonomies to display as a list)
Related Listings Section
Show Related Listings Section Configure the related listing section.
Which Taxonomy Should Be Used to Relate Listings Categories, Events Categories, Service Categories, Rentals Categories, Classifieds Categories, Features, Regions (Select taxonomies to use)
Show Only Related Listings from Current Author Enable to limit related listings to the same author.
Related Listings Grid Style Compact

 

Listeo Core → Booking

Setting Options/Details
Allow Users to Book Without Logging In Users will be registered as “guest.”
Remove Guests Option from Booking Widgets Guest picker will be removed.
Remove Coupons Option from Booking Widgets and Confirmation Hides the coupon feature.
Allow Owners to Make Bookings Enable owners to book their own listings.
Count Last Day of Date Range in Rental Bookings Enable to include the check-out day in price calculation.
Booking Form Requirements First Name, Last Name, Email, Phone (Required fields)
Disable Payments in Bookings Bookings will have prices, but payments won’t be handled. Disable the Wallet page in Listeo Core → Pages.
Disable Extra Services Type Option One-time fee, Multiply by guests, Multiply by days, Multiply by guests & days (Select services to disable)
Require Payment for Instant Booking Confirmation Users must pay immediately.
Add a 15-Minute Lock After Booking Prevents immediate re-booking of the same listing.
Show Expired Bookings in Dashboard Adds an “Expired” subpage to the owner’s dashboard.
Set Booking Expiration for Unpaid Bookings Default: 48 hours. Set to 0 to disable.
Show Host/Guest Contact Information Only for Paid Bookings Contact details will be hidden for pending bookings.
Ticket Options
Enable Ticket Option Adds downloadable/printable tickets.
Ticket Terms and Conditions Specify text to be displayed on the ticket.
Development Settings
Fix Slot Issues Enable if slots are not displaying correctly.

Listeo Core → Browse/Search Options

Setting Options/Details
Browse/Search Options (Ajax-Based Listing Browsing) Enable or Disable
Make “Features” Taxonomy Related to Categories Enable or Disable
Make “Listing Type” Taxonomy Related to Categories Enable or Disable
Restrict Location Search Only to Address Field Enable or Disable
Keyword Search Options
Select How Searching by Text Will Work Search above and all custom meta fields
Keywords Search Mode Approximate Match
For Taxonomy Search as Default Use Logical Relation AND or OR
Categories Search Logical Relation AND or OR
Events Categories Search Logical Relation AND or OR
Service Categories Search Logical Relation AND or OR
Rentals Categories Search Logical Relation AND or OR
Classifieds Categories Search Logical Relation AND or OR
Features Search Logical Relation AND or OR
Regions Search Logical Relation AND or OR

Listeo Core → Registration

Setting Options/Details
Enable Forced Front End Login & Password Reset On or OFF (Test carefully to avoid redirect loops)
Skip Additional Login/Registration Security Check Yes / No
Login/Registration Form Type 1: Ajax form in a popup, 2: Separated page
Automatically Login User After Successful Registration Yes / No
Enable Privacy Policy Link in Registration Form Set Privacy page in Settings → Privacy.
Enable reCAPTCHA on Registration Form Requires API keys.
Enable reCAPTCHA on Reviews Form Requires API keys.
reCAPTCHA Version V2 checkbox
Set Default Role for Registration Form Default: Guest (If hidden, set in Settings → General → New User Default Role)
Hide Role Field in Registration Form If hidden, set default role in Settings → General → New User Default Role.
Hide Username Field in Registration Form Username generated from email (part before @).
If Username Is Hidden Use Full Email as User Login
Display First and Last Name Fields in Registration Form Adds optional input fields.
Make First and Last Name Fields Required
Add Password Pickup Field to Registration Form Enable to add a password field.
Add Additional Password Strength Requirement Password should be at least 8 characters long and include at least one uppercase letter, one number, and one special character.
Allow User to Change Role in “My Account” Page Works only for owners and guests.
Redirect Settings * Owner Redirect After Registration to Page:<br>* Owner Redirect After Login to Page:<br>* Guest Redirect After Registration to Page:<br>* Guest Redirect After Login to Page: (Works only with static page login form)
Require Terms and Conditions Approval in Registration Form
Terms and Conditions Page
Privacy Policy

Listeo Core → Ad Campaigns

Setting Options/Details
Campaign Product Create a new product and set its type to Listeo Ad Campaign. (Status: –Disabled–)
Ad Campaigns Type Price per click, Price per view
Ad Campaigns Placement Home Page section, Search results, Sidebar widget (Deselecting all defaults to Search results)
Ad Campaigns Price for Home Page Price per click: 0.4
Ad Campaigns Price for Search Price per click: 0.5
Ad Campaigns Price for Sidebar Price per click: 0.6
Ad Campaigns Price for Home Page per 1k Views Price per 1000 views: 0.10
Ad Campaigns Price for Search per 1k Views Price per 1000 views: 0.12
Ad Campaigns Price for Sidebar per 1k Views Price per 1000 views: 0.06

Listeo Core → Claim Listing Options

Setting Options/Details
Disable Claims button on all listings
Enable Paid Claims option Adds package selection for claims.
Skip approval for claims Claims automatically approved after payment.
Allow registration in Claim Listing popup Users can claim without login, registration during claim process.
Add File Upload option to claim listing form Users can upload a file for verification.
Exclude packages from claim selection All, Basic, Extended, Professional (Select packages to exclude)
Claim notification for admin Notify admin about new claim requests (email).
Claim listing approved notification email subject Available tags: {user_mail}, {user_name}, {first_name}, {last_name}, {listing_name}, {listing_url}, {payment_url}, {site_name}, {site_url} (Default: New claim request)

How to speed up your website? 🚀

In this article, we will share useful WordPress speed optimization tips to boost WordPress performance and speed up your website.


Results achieved with WP Rocket caching plugin and Rocket.net hosting


The Basics

  1. Decent hosting
    No matter how much effort you put into optimizing your website, most of its success depends on the quality of your hosting. Even with a high-end VPS  your WordPress site might still not be as fast as you’d expect because website speed depends on several factors beyond just server resources.
    We recommend Rocket.net or Cloudways for resource demanding websites
  2. Caching plugin + lazy loading images 
    Free performance plugins you might try: WP Optimize or LiteSpeed Cache + Lazy Load
    Performance plugin that we tested and recommend: WP Rocket
  3. Cloudflare is a must-have; reducing load times by delivering cached content from servers closest to the user
  4. Don’t fix yourself on Google Page Speed Insights. The Google PageSpeed Insights score isn’t always a real reflection of a website’s actual speed because it mainly evaluates theoretical performance based on a set of lab metrics, not real-world user experience.
    Instead check your website performance at GTmetrix.com or SpeedVitals.com

Use this link to buy WP Rocket at 20% OFF (valid on all plans):
https://wp-rocket.me/?ref=7c2218f3 


WP Rocket Recommended Settings

  1. File Optimization
    ✅ Minify CSS files
    🟨 Optimize CSS delivery (if you notice any errors on your website after having activated this setting you should deactivate it as gains are not worth having visual glitches)
    ✅ Minify JavaScript Files
    🟨 Combine JavaScript files (you can enable it, but check that JavaScript still works properly afterward).
    🟨 Load JavaScript deferred (you can test however in some cases could cause issues with scripts)
  2. Media
    ✅ Enable LazyLoad for images
    ✅ Enable LazyLoad for CSS background images
    ✅ Enable LazyLoad for iframes and videos
    ✅ Add missing image dimensions
  3. Preload
    ✅ Activate Preloading
    🟨 Enable link preloading (you can enable it but this could be demanding on server because it downloads a page each time when a user hovers over the link)
  4. Advanced Rules
    ✅ Cache Lifespan set to 10 hours (or less if you experience issues with logging in via popup, if it still happens from time to time we suggest enabling “Skip additional login/registration security check” option in Listeo Core → Registration)
    🟨 Never cached URLs (use only if you notice the booking calendar shows incorrect availability)

    /listing/(.*)

    ✅ Never Cache Cookies:

    listeo_rental_enddate
    listeo_rental_startdate 
    listeo_rental_picker_enddate
    listeo_rental_picker_startdate
  5. Database
    You can use every feature there to keep database clean
  6. CDN 
    Not needed if your hosting already has CDN.
  7. Hearbeat
    ✅Control hearbeat and set to “reduce activity”
  8. Image Optimization
    You can use Imagify from WP Rocket or EWW Image Optimizer

WP Rocket works with all hosting providers however, certain hosts (like SiteGround – you should disable File-Based Caching in their plugin) include their own caching plugins and you’ll need to adjust these built-in caching settings for optimal compatibility with WP Rocket.


Advanced Tweaks

If you want to get the most out of your website in terms of speed, we highly recommend carefully reading this article:

Speed Up Your Slow WordPress Site In 21 Steps: The Only Tutorial You Need To Pass Core Web Vitals Totally Revamped For 2025