Author Archive

Lisa – Listeo Editor AI Assistant

Lisa is the AI assistant in Listeo Editor. Tell her what your directory is about, and she prepares the listing types, fields, forms, search filters and categories it needs. Every change is shown as a preview first, and nothing is saved until you confirm it. This article explains what Lisa can do, how to turn her on, how confirming and undoing works, what data she uses, and how to fix the most common connection problems.

 

What Lisa Can Do

Lisa needs Listeo Forms & Fields Editor 2.3.3 or newer. She reads your Listeo Editor setup and prepares changes for you:

    • Listing types. Create a new listing type with its booking type (no booking, single day, date range or tickets). It gets its own category taxonomy.
    • Listing fields. Add, edit, move and remove fields, choose whether a field shows on listing cards, and hide a field from the details section of the listing page or show it there again.
    • Add Listing form. Place fields and taxonomies on the Add Listing form, in an existing section or in a new section of their own.
  • Visibility rules. Show a field only when another field has a certain value, for example “Balcony size” only when “Has balcony” is ticked.
  • Taxonomies and terms. Create custom taxonomies, add, rename and delete terms, and link two taxonomies like Make > Model, including which model belongs to which make.
  • Search filters. Add or remove a filter for a listing field or a taxonomy on your search forms, and switch a taxonomy between a select and a chained select.
  • Answers about your setup. Ask “Why does my field not show on the listing page?” or “What can people filter by in search?”. For these she only reads your settings.

Lisa answers in the language you write in.
Some things she cannot change. For those, she tells you which Listeo Editor screen to use:

  • field icons and listing type icons and settings,
  • rules that depend on a category or another taxonomy (set them in the field’s “Where this field applies” option),
  • taxonomy display types other than select and chained select,
  • changing or deleting a taxonomy,
  • the layout of a form.

Lisa does not read your listings, their content or any user data.


Requirements

  • An administrator account. Only users who can manage options see Lisa.
  • An active Listeo license with active support. The domain of the site must be activated on the license. Staging and cloned sites can use Lisa only if their domain is activated too. When support ends, Lisa stops answering, and the rest of Listeo Editor keeps working as usual.
  • A public site on https. Local sites, IP addresses and addresses with a port number cannot connect.
  • Pretty permalinks and the standard REST API. In Settings → Permalinks, choose any option other than Plain. The REST API must be reachable at /wp-json/.
  • Outgoing connections. Your server must be able to connect to the Lisa server.

Step 1: Turn Lisa On

  1. Go to WP Admin → Listeo Editor → Overview.
  2. In the Assistant section, turn on Show Lisa.
  3. Choose how she appears: Mascot (Lisa stands in the corner of the screen and waves now and then) or Chat button (a plain round button with no character).
  4. Click Save.

Lisa shows on the Listeo Editor screens and on the category and term screens of your listing taxonomies. Click her (or the chat button) to open the chat.
On screens 1500 px wide or wider, the chat is docked on the right side of the screen. Use the dock icon in its header to switch between the docked panel and a floating window.

Handing a site over to a client? Turn off Show Lisa before you do. Hiding her also disconnects the site and removes its messages from the Lisa server. If the Lisa server cannot be reached at that moment, she stays on and you can try again.


Step 2: Read the Notice and Click Start

The first time each administrator opens the chat, Lisa shows what she sends and to whom. Nothing is sent before you click Start.
When you click Start, these go to the Purethemes server:

  • your license key, to verify it,
  • this site’s address and your server’s IP address,
  • the messages you write in the chat,
  • the rating you give an answer (helpful or not helpful),
  • the field, form and taxonomy configuration Lisa reads to answer you.

How long it is kept:

  • Your messages and Lisa’s answers are kept for 30 days. Her answers can mention the names of your fields, forms and terms.
  • The configuration she reads is deleted within 24 hours.
  • The server IP address is kept until 30 days after Lisa was last used on the site.
  • The site address and a shortened form of your license key are kept while the site is connected.
  • If Lisa is refused because of your license or support, this may be noted for 30 days so you can be contacted about renewal.

To answer you, your messages and that configuration are processed by an AI model from Anthropic, or from Google through OpenRouter, which may keep them for a limited time under their own terms (for example for abuse monitoring).
If you do not want to use Lisa, click No thanks, hide Lisa on this site. She then stays hidden for every administrator until someone turns her back on in Listeo Editor → Overview.


Step 3: Ask

Write what you need in your own words. A few examples:

  • “I’m building a directory of film locations that production crews rent for a shooting day. Set it up for me.”
  • “Add a Fuel type taxonomy to the car listings and a filter for it in the sidebar search.”
  • “Show Truck spaces only when Truck parking is checked.”
  • “Why doesn’t the Area field show on my listing pages?”

For a bigger build, such as a new kind of directory, Lisa first proposes the listing type and lists the fields, choices and filters she plans to add, so you can adjust the plan. Once the type is confirmed, she continues with the categories, fields, Add Listing form and search filters, one step at a time.
The chat shows how many messages you have left today, under the message box.


Step 4: Review and Apply


Lisa never changes anything by herself. Each change she prepares is shown as a preview card that says exactly what will be saved and where.

  • One change: click Apply change or Cancel.
  • Several changes are shown as one checklist. Untick what you do not want and click Apply selected, or click Cancel all.
  • Removals (a field, a term or a search filter) are marked “Removes” and are unticked by default, so nothing is deleted by accident.
  • Some cards show lines to check first, for example other fields whose rules use the field you remove, or Elementor pages that use it.

After you apply, click Show it to open the screen with the change, and Lisa suggests the next step.

Save your own changes first. If a Listeo Editor screen has unsaved changes, Lisa cannot apply a card until you save them or reload the page. If a list was changed with Lisa after you opened a screen, reload that screen before you save it, or the change would be overwritten.


Undo a Change

Every applied change can be undone for 7 days:

  • right on its card, with Undo (or Undo all for a checklist), or
  • in Recent changes (the clock icon in the chat header), which lists the changes Lisa made on the site.

Only the administrator who applied a change can undo it, and only while the same settings were not changed again in the meantime. When you undo a bigger build, start with the newest changes. For example, a listing type can be undone only after its fields, categories and form are gone.


Disconnect Lisa

Open Recent changes (the clock icon) and click Disconnect Lisa at the end of the list, then click again to confirm. This removes the site address, your messages and Lisa’s answers from the Lisa server, and Lisa asks for consent again the next time she is used. Message and cost counters stay, without the address. Your forms and the changes she made stay as they are.
Turning off Show Lisa in Listeo Editor → Overview also disconnects the site.


Privacy and Data

Lisa works only with the setup of your directory. This is what she needs, what is stored and where.

What Lisa never sends

  • your listings and their content,
  • your users, customers and visitors, or any of their data,
  • the name, e-mail or password of the administrator who uses the chat.

What is sent to the Purethemes server

  • your license key, to verify the license and support,
  • the site address and the server’s IP address,
  • the messages you write in the chat and the ratings you give answers,
  • the configuration Lisa reads to answer you: listing types, field, form and search form settings, and taxonomy terms.

All requests go over HTTPS, and each site has its own secret key to sign them.

What is stored on the Purethemes server, and for how long

  • Your messages, Lisa’s answers and your ratings: 30 days. Answers can mention the names of your fields, forms and terms.
  • The configuration Lisa read and the working conversation: deleted within 24 hours.
  • The server’s IP address: until 30 days after Lisa was last used on the site.
  • The site address and a shortened form of the license key: while the site is connected. The full license key is not stored in readable form.
  • Message and cost counters per day, used for the limits. After a disconnect they stay without the site address.
  • A note that Lisa was refused because of the license or support: 30 days, so we can contact you about renewal.

Who processes it
To answer you, your messages and the configuration Lisa read are processed by an AI model from Anthropic, or from Google through OpenRouter. They may keep the data for a limited time under their own terms, for example for abuse monitoring. Requests through OpenRouter go only to providers that do not collect the data for their own use.

What is stored on your site

  • the connection key of the site, and each administrator’s consent,
  • the state of the open conversation, for a short time, and the messages shown in the administrator’s browser tab,
  • proposed changes (for 1 day), applied changes kept for undo (for 7 days) and the list of the last 100 changes under Recent changes.

How to remove it

  • Disconnect Lisa (or turn off Show Lisa) removes the site address, your messages and Lisa’s answers from the Purethemes server, and the connection key and consents from your site.
  • Deleting Listeo Forms & Fields Editor from the Plugins screen disconnects the site and removes everything Lisa stored on it. Your forms, fields and taxonomies stay.

Do I need to change my site’s privacy policy? Usually not because of Lisa: she is used only by administrators and does not send any data of your users or visitors. If other people in your team use the chat, tell them what is sent, as described above. This is not legal advice.


Limits

Lisa has a daily and a monthly message limit per license. Automatic follow-ups after you apply a change count as messages too. When the monthly limit is reached, the chat says when Lisa will be back.
A conversation also has a maximum length. When the chat says “This conversation has reached its length limit”, click New conversation (the pencil icon). Your forms and applied changes stay as they are. Lisa starts a fresh conversation and reads your current setup again, so repeat in a sentence what you were working on.


Troubleshooting

  • This site could not be verified

  • Lisa says your support has ended

  • Our server could not reach the REST API of this site

  • Lisa needs pretty permalinks

  • Lisa needs a site on https / works only on a public domain

  • The site check failed because this site redirected it

  • Could not reach the Lisa server

  • Lisa asks me to click Save once on a screen

  • Lisa says a field is already in place, but I deleted it

  • Does Lisa change my site on her own?

  • Can my listing owners or editors use Lisa?

Listeo Update 2.3.3 Report

Listeo 2.3.3 brings Lisa, an AI assistant that help you handle Listeo Editor, support for the new Google Places API and a lighter wp-admin because CMB2 is not required plugin anymore.

Listeo Monetization Plus 1.6 adds free trials and a Terms of Service checkbox to Stripe checkout as well as support for Claim Listing payments. Field rules are also available for Booking Plus resources in Listeo Booking Plus 1.0.24. As always, there is a round of small fixes too.

  • Lisa, the AI assistant: describe what you need, and Lisa proposes the listing types, fields, forms and taxonomies. Nothing changes until you click.
  • Google Places API (New): for Google Cloud projects that can no longer enable the old Places API.
  • Field rules for resources: Booking Plus resource fields follow the same visibility rules as listing fields.
  • Lighter wp-admin: the listing editor and category pages no longer load the CMB2 library.
  • Stripe trials and Terms of Service consent in Listeo Monetization Plus 1.6.
  • Claim Listing payments now can use Listeo Monetization payments

Meet Lisa, your Listeo Editor assistant

Lisa, the Listeo Editor assistant, waving

Setting up a directory means not only lot of clicking but also figuring out the best structure for you data: listing types, fields, forms, taxonomies and search filters are require good amount of thinking because it’s very hard to adjust that when your directory grows. Lisa does that work with you. Tell her what your directory needs, for example “add a Fuel type taxonomy to the car listings and a filter for it”, and she shows each change as a card. You read the card and click to apply it, or skip it.

You stay in control
Lisa only proposes. Nothing on your site changes until you click a card, and an applied change can be undone for 7 days.
Taxonomies and terms
Create taxonomies, add terms and parent terms (Make > Model), and place a taxonomy on your forms.
Fields and forms
Switch a taxonomy on a form or search filter between a select and a chained select, move a field to another tab, choose what shows on listing cards and in the details list.
Search filters
Add a taxonomy filter to your search forms in one step.
“Why does my field not show?”
Ask Lisa, and she checks the field settings and rules and tells you why. For this she only reads your settings.
Tell us how she did
Rate each answer Helpful or Not helpful. Your ratings help us make Lisa better.

How to turn Lisa on

  1. Open the Assistant settings
    Go to Listeo Editor > Overview > Assistant and turn on Show Lisa. There you also choose how she appears: Mascot or Chat button.
  2. Give your consent
    Before the first chat, each administrator reads and accepts how Lisa uses your data.
  3. Ask
    Describe what you want in your own words, review the cards and apply the ones you like.

Good to know: Lisa is available to administrators only and needs a valid Listeo license. A change can be undone for 7 days by the administrator who applied it, as long as the same settings were not changed again in the meantime. If you disconnect Lisa, your site address, your messages and Lisa’s answers are removed from the Purethemes server.

Google Places API (New)

Google Cloud projects created after March 2025 are no longer enable the old Places API, so address suggestions and Google reviews did not work with a new API key. Listeo Core now has a Google Places API version setting in Listeo Core > Map Settings. Choose Places API (New) if your key only has the new API, and address suggestions (Add Listing form, search forms, wp-admin listing editor), Google reviews and the “Test API key” button use it.

  • Sites that keep Places API (Legacy), the default, do not change.
  • With the new API, Google returns the 5 most relevant reviews instead of the 5 newest. The new API has no “newest first” order, so the reviews shown can change.
  • Save the setting before you click “Test API key”, the test uses the saved version.
  • The Geocoding API is still used when you drag the map pin, so keep it enabled for your key.

Listeo POI has the same option, Places API Version, in its settings. After you switch, click Clear All Cache in Cache Management, otherwise cached places show category icons instead of photos until the cache expires.

Field rules for Booking Plus resources

Listeo 2.3 introduced field rules for listing fields. With Listeo Booking Plus 1.0.24, resource fields (rooms, cars, equipment) use them too. Open Listeo Editor > Listing Fields, choose the Fields tab of your resource type and set the rules on a field:

  • Where this field applies limits a resource field to the categories of the listing the resource belongs to. A “Sea view” field can show for apartment rentals only, for example. Outside those categories, the field is hidden in the resource form and on resource cards, and its saved value is kept.
  • Show this field when shows a field only when another field of the same resource has a certain value. “Balcony size” can appear only after the owner ticks “Has balcony”. The field appears and disappears while the form is filled, a hidden field is never required, and its value is removed when the resource is saved.

Fields without rules work exactly as before. The resource edit screen in wp-admin shows all fields and does not apply the rules.

How field rules work
Scope by category, conditions on other fields, and what happens to hidden values.
Read the guide

A lighter wp-admin

The wp-admin listing editor, the category and term pages and the ad and claim admin screens no longer use the CMB2 library that Listeo bundled for years. Listeo Core now has its own, lighter field library. The screens look the same and save the same data, but they load less code.

For developers: if your child theme or custom plugin uses CMB2 functions or hooks for Listeo meta boxes, it needs an update. Use listeo_register_meta_box() instead of new_cmb2_box(), listeo_get_meta_box() instead of cmb2_get_metabox(), and the listeo_meta_boxes_init action instead of cmb2_admin_init. Custom field types now use the listeo_meta_render_{type} action and the listeo_meta_sanitize_{type} filter. There is no compatibility layer for the old names.

Listeo Monetization Plus 1.6

Free trials for Stripe subscriptions

Recurring packages have a new Free trial (days) field (0 to 730) in Listeo Core > Listeo Subscriptions > Listing Packages > Edit package. Stripe Checkout collects the card, charges nothing today and bills when the trial ends. Each user gets the trial once per package. Pricing tables show an “N-day free trial” badge, and trial end dates show in the dashboard, My Subscriptions and the admin list.

Terms of Service checkbox

Turn on Require Terms of Service acceptance in Listeo Subscriptions > Settings (Stripe section), and buyers must accept your terms before they pay. You can write your own checkbox text with links. Stripe needs a Terms of Service URL in your Stripe Dashboard (Settings > Business > Public details).

Paid claims through Stripe

When the claim package is sold through Monetization Plus, a paid listing claim now goes through Stripe Checkout and creates a subscription, like any other package. A 100% promotion code also completes the claim. If the claimer cancels the checkout, the claim stays approved and the same pay link works again.

Also in 2.3.3

  • Faster Listing Fields screen. It opens and saves faster on sites with many fields, and large forms are no longer cut off on save by the server’s max_input_vars limit.
  • Icon picker. Choose a field icon from a searchable list instead of typing its name.
  • Header Builder. The second header row accepts any element: logo, menu, account, cart, button, search, HTML or shortcode.
  • Listeo Editor > Appearance. Listings and Single listing options are grouped into collapsible sections, with short descriptions for some options.
  • Elementor term pickers. Image Box, Taxonomy Tabs and Content Carousel search all your regions as you type, not only the first 100.
  • Change Package. A listing keeps its current package until the new package is paid, so an abandoned checkout no longer leaves it without a package.
  • Listeo PWA. The bottom navigation of the installed app shows immediately on every page after the first one in each app session, instead of waiting for a server check each time.
  • PureCustomizer retired. All theme options live in Listeo Editor > Appearance. While PureCustomizer or Kirki is still active, a notice tells you that you can deactivate it. Your settings are kept.

Fixes

  • OpenStreetMap address search froze the page when a pasted address had two spaces in a row or a space at the end.
  • Split layouts: the category slider highlighted “All” on search results instead of the searched category.
  • Statistics: listing titles showed HTML codes such as «, and the picker texts could not be translated.
  • Dark mode: headings were white on some pages outside dark mode, and in the wp-admin listing editor.
  • The login popup on cached pages no longer ends with “Session token has expired”.
  • The default submit form no longer shows “Booking prices and settings” for listing types without booking.
  • The footer could be sticky with Sticky Footer turned off on pages, posts and listings without their own footer style.
  • Booking Plus: with the full-page login style, the booking popup and its date pickers could open behind other popups.

Released in 2.3.2: Commissions and Payouts

We did not write a post for 2.3.2, so here is its main change. The Commissions screens (Balances and Payouts History) were rebuilt in the style of the Bookings screen:

  • A balances list with search, sorting and totals, and a Pay vendor screen that shows the vendor’s payment details, method, reference and an internal note.
  • Payouts History with filters and CSV export, and a details page where you can void a manual payout.
  • A new Payout notification email (Listeo Core > Emails), so the vendor knows when you paid them.
  • Commission amounts are calculated in one place, so the recorded commission, the Stripe transfer and the PayPal payout use the same amount.
  • Refunds reduce commissions in proportion to the refunded amount instead of deleting them.

How to update

  1. Download the latest package
    Get the newest Listeo files from purethemes.net/license. Make a backup of your site first.
  2. Update the theme and all plugins together
    Update the Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor at the same time, plus Listeo Booking Plus (1.0.24), Listeo POI, Listeo PWA and Listeo Monetization Plus if you use them. Because of the move away from CMB2, the theme, Listeo Core and Booking Plus must be on the new versions together. Follow How to update the theme and plugins.
  3. Clear caches
    Clear your page cache, object cache and CDN. If you switched Listeo POI to the new Places API, also clear the POI cache.

Full list of changes: Listeo changelog.

FAQ

  • Does Lisa change my site on her own?

  • Who can use Lisa?

  • Do I have to switch to the new Google Places API?

  • Why do my Google reviews look different with the new API?

  • I use a plugin built on CMB2. Will it still work?

  • Can I keep PureCustomizer or Kirki active?

Listeo Update 2.3 Report

Listeo 2.3 is the biggest update to the Listeo Editor and to search so far. We built it around a real car classifieds site, so it is ready for directories where every listing has its own specs: cars, real estate, boats, equipment, jobs. Your listing fields now know when to show up, you can create your own taxonomies without code, and search finally feels like a marketplace. Visitors can compare listings side by side, the Setup Wizard can start your site from a Car Dealers or Doctors demo, and everything is much faster on large directories.

  • Field rules: show a field only for some categories, or only when another field has a certain value.
  • Compare listings: visitors pick several listings (4 by default, up to 6) and see them in one side by side table.
  • Custom taxonomies: create Fuel, Body type or Brand in a few clicks, each with its own URL and archive pages.
  • Make > Model: link taxonomies together, so picking a make shows only its models.
  • Adaptive filters: search form adapts to what you already selected, hiding unnecessary filters and showing active counts next to each option.
  • New search elements and Search Card: button rows, “up to” and “from” selects, sliders for any numeric field, a live result count and a tabbed search widget for Elementor.
  • Faster search: range filters, rating filters and price links are many times faster on big directories.

Fields that know when to show up

A car needs Doors. A motorcycle does not. A used car needs Mileage. A new one does not. Until now, every listing of a type showed the same fields, so owners saw questions that did not apply to them and visitors saw empty rows. In Listeo 2.3 each field in Listeo Editor > Listing Fields has a Rules tab, and you decide where it applies.

How it works

  1. Limit a field to categories
    In “Where this field applies”, tick the categories that need the field, for example Doors only for Cars. Subcategories are included, and long category lists become a search box.
  2. Show it when another field matches
    In “Show this field when”, pick another field, an operator and a value, for example Mileage when Condition is Used. Combine rules with “+ AND rule”, or add alternatives with “+ OR group”.
  3. Save and test
    Open the Add Listing form. Fields appear and disappear while the owner fills it in, also in multi-step forms. A hidden field is never required.

Where the rules apply

Add Listing form
On the front end and in the wp-admin Listeo editor, live while the form is filled in.
Listing page and cards
A field that does not apply to a listing is not shown on its page or on its card.
Search filters follow the rules
A Doors filter appears once a visitor picks Cars, or right away on the Cars archive. Controlled per element with “Follow the field’s rules” (on by default).
Elementor
The “Listing Custom Field” widget and the “Listeo Custom Fields” dynamic tag respect the rules too.

A field hidden by a “Show this field when” rule loses its value when the listing is saved. A field hidden only because of its categories keeps its value. Try new rules on a test listing before you use them on live data. Full guide: Field Visibility Rules

Your own taxonomies, linked like Make > Model

Many sites fake attributes like Fuel or Brand with select fields. That works, but a select field has no archive page, no clean URL and gets slow to search on a large site. In 2.3 you can create real taxonomies in Listeo Editor > Taxonomies, with no code.

  1. Create the taxonomy
    Give it a name, a plural name, a URL base and the listing types it belongs to. Each one gets its own term archives with search and map, and can be used in Add Listing Forms and Search Forms.
  2. Link it to a parent
    Set “Parent taxonomy” to connect Model to Make, or City to Country (up to 5 levels). Assign parents on the term screen, with the “Assign parent” bulk action, or with “Import CSV”: one line per term, parent,child.
  3. Add a Chained select
    Use the new element type “Chained select (loads options by parent)” in the Add Listing Form and the search form. Visitors pick a make and see only its models. Options load on demand, so taxonomies with thousands of terms stay fast.

Custom taxonomies also support visibility rules (“Show this taxonomy when”, “Where this taxonomy applies”), and they travel with the new Export & Import of the Listeo Editor. If you delete a taxonomy, its terms are kept: add it again with the same internal name and they come back. Guide: Custom Taxonomies

Set up Make > Model step by step
Create the taxonomies, import makes and models from a CSV file and add the chained selects.
Read the guide

Search that feels like a marketplace

Visitors on classifieds sites expect quick, visual filters and they hate searches that return nothing. Listeo 2.3 adds new search form elements in Listeo Editor > Search Forms and a way to show only the options that still have results.

Buttons (pick one)
Show a select field as a row of buttons, such as Buy / Leasing or New / Used.
Select: up to / Select: from
One dropdown for a field that holds numbers, or the price, like “Price up to 20,000” or “Year from 2019”.
Sliders for any numeric field
Year, mileage, area: any field that holds numbers can be a slider now, not only the price. From/To inputs became two dropdowns with steps and units.
Result count on the button
The search button can read “Show 2,000 listings” and update with every filter. Turn on “Show the number of results on the search button” in Form Options (not available on split page forms).

Adaptive filters

Turn on Listeo Core > Browse/Search Options > Search Logic & Relations > “Adaptive filters”. While visitors search, options that would return no listings are greyed out or hidden, counts such as “Diesel (12)” can be shown, and a slider can take its range from the current results. You choose the behaviour for each element in its “Adaptive filters” section (“Options without results”, “Show counts”, “Range from current results”). Counts load after the page, so they stay correct with page caching. Read more: Adaptive Search Filters and Result Counts

Search Card: tabbed search for your home page

The new Elementor widget “Search Card” puts several searches in one card. Each tab has its own search form, results page, button text and fixed values, so a car site can offer Cars, Electric, Vans and Motorcycles tabs in one hero. Fields sit in a grid with columns per device, and the search button can fill the last row, sit at its end or take its own row. Pages can also hold several search forms now, thanks to the new form_id attribute of [listeo_search_form].

Listing pages that read like a spec sheet

A car listing should read like a brochure: Make, Model, Year and Fuel together, technical data in a neat table. Listeo 2.3 gives you the tools for that, all in Listeo Editor > Listing Fields.

Taxonomies among the fields
Place a taxonomy in the field list with “Place” or “Add taxonomy”, drag it under a headline and show it as a row, as tags or in its own box.
Highlights, Table, Collapsible
Each headline has a “Section on the listing page” setting: Standard, Highlights (2 to 6 columns) or Table, open or collapsed.
Number and unit
“74,000 km” or “340 hp”: thousands separator in the site language, decimals, a unit before or after the value, and an optional label on cards.
Your own SVG icons
“Upload SVG” next to the icon picker. The icon shows in the details, section headers and cards. The font icon stays as the fallback.
Sort by any numeric field
Tick “Allow sorting by this field” and visitors can sort by Year, Mileage or Power. Listings without a value come last.
A cleaner Listeo Editor
Fields as cards with chips, search and filters, a field type picker, a side panel with tabs and a sticky save bar. Your saved forms do not change.

In Elementor, the “Listing Custom Fields” widget has a new Sections panel, and “Listing Taxonomy Checkboxes” can hide taxonomies you already placed in Listing Fields.

Compare listings side by side

Choosing between three cars or four apartments means jumping between tabs. With Compare listings, visitors click the compare button next to the bookmark heart on a card or on the listing page, and the picked listings collect in a small bar at the bottom of the screen. One click opens a table with all of them side by side: photo, price, rating, address, category and every listing field, grouped by your Listing Fields headlines.

  • Show only differences hides the rows where all listings have the same value.
  • Listings of different types can be compared, and field rules are respected (a missing value shows “-“).
  • The list stays in the browser, and for logged-in users it follows them to other devices.
  • A comparison has its own link, so it can be shared. These links are not indexed by search engines.
  • A new Elementor widget, “Listing Compare”, adds the button to your own single listing templates.

Compare is off by default. Turn it on in Listeo Core > Browse/Search Options > Compare Listings, choose how many listings can be compared (2 to 6, default 4) and pick the page in Listeo Core > Pages > Compare Page (a regular page with [listeo_compare]).

Faster on big directories

We tuned the slowest parts of search on a test site with 20,000 listings. The results are the same, only faster.

WhatBeforeAfter
Search with four number ranges, AJAX resultsabout 800 msabout 170 ms
Search with four number ranges, listings pageabout 12 sabout 180 ms
“Minimum Rating” filterabout 15 sabout 0.1 s
Listings page with a price range in the link10 to 25 sabout 0.3 s
12 listing cards28 queries and 24 database writes17 queries, no writes
Empty AJAX requestabout 380 msabout 225 ms

The biggest gain comes from the new option “Faster range filters (beta)” in Listeo Core > Browse/Search Options > Search Logic & Relations. It is on by default, also on sites that never saved the setting. It answers searches with two or more number ranges with one grouped query. If you ever need to, untick it to go back to the old query. Listings with the same sort value now always come in the same order, so no listing repeats or disappears between pages.

Also new

Export and import the whole editor setup

The Listeo Editor main page has three tabs: Overview, Export & Import and Repair Tools. Export now includes your Listing Types. Import shows a preview first, lets you pick what to import, merges lists instead of overwriting them and keeps a backup, with an “Undo last import” button. Older export files are accepted.

Saved search alerts that match the search

Alert emails now run the same search as “View all results”, so custom taxonomies, ranges and the price count. The summary in My Account > Saved Searches shows term names, prices in your currency and ranges with units.

Smaller additions

  • Order of packages to buy: sort the “Buy New Package” list by price, publish date or your own product order. Listeo Core > Packages Options > Payment & Purchase Settings.
  • Sign up and login events: “Send sign up and login events to dataLayer” (Listeo Core > Registration) sends sign_up and login to Google Tag Manager from the login popup.
  • Bulk add features: Listings > Bulk Add Categories can now add Listing Features too.
  • Mastodon and Bluesky: add a Contact field named Mastodon or Bluesky to use them as listing social links.
  • Blog layouts: Customize > Blog > Blog Options has “Blog posts style” (List, Grid 2, Grid 3) and “Single post layout”. The per-post “Post Layout” setting now works.
  • Pay on site: “Disable payments in bookings” now works through the whole booking, with the cash confirmation email and “Mark as Paid” on the ticket check.
  • Event prices on cards: Listeo Booking Plus events priced with ticket types now show their lowest ticket price on cards.

What changed for existing sites

Most of 2.3 is new options that stay off or unused until you set them up. Your existing forms and fields keep working as before. Some fixes do change what visitors see, though. Please read this list before you update a live site, and check the points that apply to you.

Each item says what changed and what to check. The full wording is in the Listeo changelog.

Search results

  • Different taxonomies are always combined with AND. A link with a category and a region now shows listings that match both, on every search path (links, saved searches, newsletters, AJAX). The setting is renamed “Default relation between selected terms of one taxonomy” and now only controls terms of one taxonomy. Each taxonomy got a “Use default” choice. Check: open your old category plus region links and compare the counts. Review Listeo Core > Browse/Search Options > Search Logic & Relations.
  • From/To filters work everywhere. Range filters such as a mileage from/to are now applied in AJAX results and in the [listings] shortcode, not only on page load. Check: AJAX results can get smaller, because they now respect the range.
  • The AJAX price filter matches the listings page. Listings whose Minimum/Maximum Price Range covers the searched range are now included. Check: AJAX result counts can grow. Sites with a single price per listing see no change.
  • Prices with separators are read correctly. “74,000”, “5 000” and “1.234.567” are read as whole numbers in price search, the map and counts (“74.000” is still 74). Check: some listings can enter or leave price results. Developers can turn this off with LISTEO_DISABLE_PRICE_NUMBER_PARSING.
  • AJAX browsing is on when the setting was never saved. “Ajax based listing browsing” defaults to Enabled, which brings live filtering, AJAX pagination and infinite scroll. Check: if you prefer page reloads, open Listeo Core > Browse/Search Options and save the setting as Disabled.

Sorting

  • Price sort: listings without a price come last instead of being left out, an empty price no longer counts as 0, a price range sorts by its low or high end, and ties show the newest first. Check: the order of price-sorted pages.
  • Highest rated: listings without a rating are included after the rated ones, and the hero slider “Top rated” can fill up with them. Check: on sites updated from old versions, run Recalculate Ratings once (Listeo Editor > Overview > Tools).
  • Featured and Verified sort: listings without the value are now included and sort as not featured or not verified. [listings orderby="verified"] and Elementor “Order by: Verified” show every listing, verified first. Check: to show only verified listings, use the “Show only verified listings” switch of the Listings widgets.

Saved searches and bookings

  • Saved search alerts run the real search. They look back at most 7 days, AI searches get no alerts and “Open now” is ignored. Check: the number of alert emails after the update.
  • “Disable payments in bookings”: requests waiting for approval no longer expire, customers get the cash confirmation email instead of a payment link, and “Instant booking requires payment first” is ignored while payments are off. Check: your booking email templates. Existing bookings keep their stored deadline.
  • Guest bookings: with “Allow user to book without being logged in” off, guests are now really refused, also when the booking settings were never saved. Check: nothing, unless you wanted guest bookings (then turn the option on).

Listing pages and fields

  • Field rules clear hidden values. Only when you add rules: a field hidden by “Show this field when” loses its value on save. Check: test rules on a staging or test listing first.
  • Custom taxonomies show only where you place them. On the listing page they appear where placed in Listing Fields, or in the checkbox list of Listeo Core > Single Listing. The Elementor “Listing Taxonomy Checkboxes” widget skips placed taxonomies by default. Check: your single listing templates after placing taxonomies.
  • “My Other Listings” toggle works now. It never worked before, so sections that owners switched off now disappear. Check: if you want them back, the changelog has an SQL recipe (back up first).
  • Package restrictions on the default layout. The pricing menu, FAQ, availability calendar and coupons now follow package feature restrictions. Check: listings on packages that exclude these sections.
  • Google ratings without a Place ID are ignored. They are removed when the listing is saved in wp-admin, not when it is viewed. Check: the ratings of imported Google listings.

Uploads, admin and security

  • SVG uploads for trusted users only. Only users who can post unfiltered HTML can upload SVG files (administrators, and editors on single sites). Listing owners can no longer upload SVG. Check: owners who used SVG logos or icons. Developers can change this with the listeo_allow_svg_upload filter.
  • Tools moved. Recalculate Ratings, Price Cache and Data Migration are no longer in the side menu. Find them in Listeo Editor > Overview > Tools. The filter listeo_fafe_hide_tools_in_menu brings the menu entries back.
  • Fix Featured covers every status. It now repairs all listings except trash, in batches of 1000. Check: the number shown is higher than before. Press the button again until it reaches 0.
  • Marketplace lock-downs. The Commissions and Payouts History screens need the manage_options capability (filter listeo_core_payouts_capability). Vendor commission fields and “Stripe Connect user ID” can be edited only by users who can edit other users. Coupons can be edited only by their creator or a shop manager. Check: shop manager access on marketplace sites.
  • Dokan: rewrite rules are refreshed once after the update. Check: your vendor dashboard URLs, including “Add new product”.

The smaller fixes

  • Maps: the “All published listings” map now shows the same listings as the result list.
  • Elementor Listings widget: a widget limited to an empty category no longer loses its limit after filtering.
  • Price links: the first AJAX search keeps the price from the link, and a From/To element with an empty step no longer breaks the page on PHP 8.
  • Listeo Editor saves: settings without an input are kept, lists are no longer saved as “Array”, and Add Listing Forms sections keep their steps, names (also in non-Latin scripts) and quotes.
  • Skipped taxonomies: a taxonomy element set to “Skipped input” no longer removes the listing’s terms.
  • Listing page: a headline near the end of the field list no longer disappears, and the “Listing Custom Fields” widget in “Custom Fields” mode shows the fields again.
  • Packages: package counts stay correct when two listings are approved at once, and listings on a fallback package stay in search (use Fix Featured to repair existing ones).
  • Bookings: custom booking fields reach the WooCommerce order for instant bookings, and pre-filled confirmation values are no longer translated.
  • Dokan: a vendor’s coupon works on that vendor’s own products, and the “Add new product” page is no longer blank.
  • Claims: the admin email for a new claim links to the claim again.
  • Uploads: WebP and AVIF images are accepted in file fields, and a long pricing menu saves on IONOS hosting.
  • Social links: TikTok links show again, and X clicks are no longer counted as TikTok.
  • Mobile: the phone country list is no longer hidden behind the login popup.
  • Theme: dropdowns inside openable search panels work, the search box of long dropdowns has the right size, the Setup Wizard imports the demo forms, listing types and menus correctly, and a bulk update in Appearance > Install Plugins no longer leaves the site stuck in maintenance mode when one plugin needs a newer PHP or WordPress version.
  • Updates from old versions: the “listeo_get_reviews_criteria()” fatal error after updating is fixed.

This release also includes security hardening in Listeo Core and the Listeo theme, covering the front-end Coupons page, the booking confirmation page, vendor commission and payout settings, and SVG files. We recommend updating all sites.

How to update

  1. Download the latest package
    Get the newest Listeo files from purethemes.net/license. Make a backup of your site first.
  2. Update the theme and all plugins together
    Update the Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor at the same time, plus Listeo Booking Plus and Listeo PWA if you use them. Many 2.3 features need all of them, and the new search elements and section layouts need the theme for their styles. Follow How to update the theme and plugins.
  3. Clear caches and check
    Clear your page cache, object cache and CDN. On sites updated from old versions, run Recalculate Ratings once (Listeo Editor > Overview > Tools). Then go through “What changed for existing sites” above.

Child themes: if your child theme overrides Listeo Core templates, compare them with the new versions. Two need changes:

  • templates/account/coupon-submit.php: add <?php wp_nonce_field( 'listeo_core_coupon_form', 'listeo_coupon_nonce' ); ?> inside the form, otherwise saving coupons stops working.
  • templates/account/saved-searches.php: the summary is now plain text, so print it with esc_html(), as the core template does.

Full list of changes: Listeo changelog.

FAQ

  • Do my existing forms and fields change after the update?

  • Why do I see more results with the AJAX price filter?

  • Where did Recalculate Ratings go?

  • Can listing owners still upload SVG files?

  • Do I need adaptive filters for the result count on the search button?

  • Should I turn off Faster range filters (beta)?

Related Taxonomies Chained Select

Related taxonomies link two lists so that one depends on the other: pick a Make and the Model list shows only that make’s models. You link the taxonomies once in Listeo Editor → Taxonomies, assign parents to the terms (one by one, in bulk or from a CSV file), then use the Chained select element in your Add Listing and search forms. Options load on demand, so a list with thousands of models stays fast.

Before You Start

You need Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor 2.3 or newer. Update them together. You also need at least one custom taxonomy for the child list. If you have not created one yet, read Custom Taxonomies first. Nothing changes on your site until you set a parent taxonomy.


How It Works

You keep two separate, flat taxonomies, for example Make (lt_make) and Model (lt_model). Then:

  • The Model taxonomy gets Make as its parent taxonomy.
  • Each model term gets its parent make or makes. A4 belongs to Audi, Transit to Ford.
  • A Chained select for Model in a form shows only the models of the make chosen in the same form.

When to use it

  • Make → Model → Generation for vehicles.
  • Country → City, or Region → City, when regions are not enough.
  • Brand → Product line, Course → Module, any list where the second choice depends on the first.

Parent taxonomy or Hierarchical? The Hierarchical switch lets terms of one taxonomy have parent terms, like Vehicles → Cars. A parent taxonomy links two different taxonomies. Use a parent taxonomy when both lists deserve their own filter, term pages and search element, like Make and Model.

Rules of the relation:

  • The child must be a custom taxonomy (lt_...). The parent can be any listing taxonomy: another custom taxonomy, Categories, a listing type’s categories, Regions or Features.
  • A chain can have up to 5 levels in total, for example Make → Model → Generation.
  • A term can have several parents. A city named Springfield can belong to several states.
  • A term with no parent is offered under every parent.


Step 1: Set the Parent Taxonomy

  1. Go to WP Admin → Listeo Editor → Taxonomies.
  2. Open the child taxonomy, for example Model, or create it.
  3. In the Relation block, choose the Parent taxonomy, for example Make (lt_make). The list is grouped into Custom taxonomies, Categories and Other taxonomies.
  4. Click Update Taxonomy.

The parent’s edit screen now lists the child under Used as parent by.


Step 2: Assign Parent Terms

There are three ways. Use the one that fits the size of your list.

One term at a time

  1. Go to WP Admin → Listings → Categories and click Manage Terms on the Models card.
  2. Add or edit a term. Use the Parent Make field: type to search and pick one or more makes.
  3. Save the term. Leave the field empty to offer the term under all makes.

The terms list gets a column with the parents of each term. A term without a parent shows Any. Above the list you can filter by parent, or click Without parentto find terms that still need one.

In bulk

  1. On the terms screen, check the terms, for example all BMW models.
  2. In Bulk actions, choose Assign parent. A picker appears: choose one or more parent terms.
  3. Click Apply.

Remove parent works the same way. Leave the picker empty to remove every parent from the checked terms.

From a CSV file

Best for long lists, for example every make and model of a car market.

  1. On the terms screen of the child taxonomy, click Import CSV. The window Import Models from CSV opens.
  2. Choose a CSV file, or paste the lines in Or paste lines.
  3. Check The first line is a header if your file starts with column names.
  4. Check Create missing Makes if the file contains makes that do not exist yet. Without it, lines with an unknown make are skipped.
  5. Click Start import. You can click Stop at any time.

The file format is one line per term, parent first:

Make,Model
Audi,A4
Audi,A6
BMW,3 Series
BMW,X5
Ford,Focus
Ford,Transit
  • Terms are matched by name or slug. Missing child terms are always created. Missing parents are created only with Create missing … checked.
  • Comma, semicolon or tab separated files all work.
  • If the parent taxonomy has its own parent, a line can have three values: Make,Model,Generation on the Generation screen.
  • Running the same file again adds nothing twice.
  • A term without a parent is offered under every parent. Once it gets a parent, it is offered only there.
  • The file can be up to 5 MB. Split larger files.
  • Save the file as CSV UTF-8. If Listeo cannot read some characters, it asks you to save the file again in that format.

At the end you see how many terms were created, how many links were added, which were already linked and which lines were skipped, with the reason for each line.


Step 3: Add a Chained Select to the Add Listing Form

  1. Go to WP Admin → Listeo Editor → Add Listing Forms and open the form of the listing type.
  2. Add the parent taxonomy (Make) with any taxonomy field type, for example Select taxonomy.
  3. Add the child taxonomy (Model) and set its field type to Chained select (loads options by parent). This type is offered only for taxonomy elements.
  4. Put the parent before the child.
  5. Click Save Changes.

In the form, Model stays locked (“Choose the previous option first”) until a make is chosen. Changing the make clears the model and loads the new list. When the listing is saved, a model that does not belong to the chosen make is rejected with a message such as “Model does not match the selected Make.”

Warnings in the editor

The editor checks chained selects and shows a warning when something will not work well. These are warnings only, you can still save:

  • The form has no element for the parent taxonomy, so the chained select offers all models.
  • The parent is on a later step of a multi-step form. Move it to the same or an earlier step.
  • The parent’s section is not in any step, so the parent is never shown.
  • The parent is a Hidden input, so the child may stay locked.
  • The element uses Chained select, but its taxonomy has no parent taxonomy. It then works like a plain taxonomy select.

Multi-step forms A required chained select that waits for a parent on another step no longer blocks the form. Listeo points the owner to the step with the parent instead.


Step 4: Add a Chained Select to a Search Form

  1. Go to WP Admin → Listeo Editor → Search Forms and open a form.
  2. Add Make from Available Elements → Taxonomies.
  3. Add Model. A taxonomy with a parent starts as Chained select (loads options by parent). Check the Type in its side panel.
  4. Click Save Changes.

In search, a model that does not belong to the selected make is ignored, so an old link such as ?tax-lt_make=audi&tax-lt_model=x5 still shows Audi results. With Adaptive filters on, the chained select can also grey out models without results and show counts such as “A4 (12)”. See Adaptive Search Filters and Result Counts .


Combining With Visibility Rules

Related taxonomies work with visibility rules . Example: show Make and Model only for Cars and Motorcycles with Where this taxonomy applies. If the parent element is hidden by a rule, the child works on its own and offers all its terms.


Limitations

  • On a Model term page (for example /model/a4/), adding a make that does not match in the address returns no results.
  • Polylang: the chained select does not switch the language of the options it loads. WPML is supported.
  • Only custom taxonomies can be the child of a relation.
  • Terms are not part of Listeo Editor → Export & Import. Use the CSV import on the other site.


FAQ and Troubleshooting

  • The Model list shows every model, not only the chosen make's

  • The Model list stays locked

  • The import skipped many lines

  • Can a model belong to two makes?

  • Does this work with thousands of terms?

  • Can I link Regions to a custom City taxonomy?


Related Articles

  • Custom Taxonomies
  • Field Visibility Rules
  • Adaptive Search Filters and Result Counts
  • Search Form Elements Reference
  • Add Listing Form Editor


For Developers

  • The parent taxonomy is the parent key of the definition in the option listeo_custom_taxonomies.
  • Parent terms are stored in the term meta _listeo_parent_terms of the child term, one row per parent term ID.
  • The logic lives in Listeo_Core_Taxonomy_Relations, for example parent_taxonomy( $taxonomy ) and filter_belonging( $ids, $parent_ids, $parent_taxonomy ).
  • listeo_core_child_terms_args ( $args, $taxonomy, $parent_ids ): the get_terms() arguments of one level of a chained select.

Public endpoint

The chained select loads its options from a public GET request. It has no nonce, so it works behind page caches, and browsers may cache answers for 300 seconds.

GET /wp-admin/admin-ajax.php?action=listeo_core_child_terms
    &taxonomy=lt_model
    &parent_slugs=audi,bmw      (or &parents=12,13 with term IDs)
    &search=a                   (optional)
    &limit=200&offset=0         (optional, at most 200 per page)
    &lang=de                    (optional, WPML)

{"terms":[{"id":1,"slug":"a4","name":"A4"}],"more":false}

It answers only for public listing taxonomies that have a parent taxonomy or are custom taxonomies.

Fields Visibility Rules

Field visibility rules let a Listing Field show only where it makes sense. You can limit a field to some categories (Doors only for Cars) and show or hide it based on another field (Battery capacity only when Fuel is Electric, Mileage only when Condition is Used). The same rules apply in the Add Listing form, on the listing page, on listing cards, in Elementor single listing widgets and in search forms.

Before You Start

You need Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor 2.3 or newer. Update them together. Nothing changes on your site until you add a rule. Fields without rules are saved and shown exactly as before.

Important A field hidden by a Show this field when or Hide this field when rule loses its stored value when the listing is saved. Test new rules on a test listing before you rely on them on live data. See What happens to hidden values below.


What Field Visibility Rules Do

One listing type often covers different kinds of items. A classifieds site may sell cars, motorcycles and phones under the same Classifieds type. Without rules, every owner sees every field, so a phone seller is asked for the number of doors. A rule has two parts. You can use one or both:

  • Where this field applies (scope): the field exists only for listings in the categories you check. Example: Doors only for Cars.
  • Show this field when (conditions): the field is shown or hidden depending on the value of another field or taxonomy. Example: Battery capacity only when Fuel is Electric.

When both are set, the field must be in one of the checked categories and its conditions must match. When to use it

  • Multi-category directories and classifieds (cars, real estate, jobs, equipment) where fields differ by category.
  • Follow-up questions: show “Mileage” only for used items, “Pet fee” only when “Pets allowed” is checked.
  • Shorter forms: owners see only the fields that apply to their listing.


Where to Find It

  1. Go to WP Admin → Listeo Editor → Listing Fields.
  2. Open the tab of the listing type you want to edit, for example Classifieds Fields.
  3. Click a field. Its settings open in a side panel with the tabs General, Display, Form input and Rules.
  4. Open the Rules tab. It has two sections: Show this field when and Where this field applies.

After you change a rule, click Save Changes in the save bar. Changes in the side panel are kept until you save. Fields with rules show a short summary in the list, for example “Shown on Cars listings only.” or “Hidden when Fuel is Petrol.” Use the With rules filter above the list to see only those fields.

Note The Rules tab is on listing type tabs, Contact Fields, Locations Fields and Hidden Custom Fields. On the category tabs ({Category} Fields, fields that belong to one category), only Show this field when is offered, because those fields already belong to one category.


Step 1: Limit a Field to Some Categories

Example: Doors should only be asked for cars.

  1. Open the Doors field and go to the Rules tab.
  2. Under Where this field applies, check Cars.
  3. Click Save Changes.

Good to know:

  • Leave the list empty to show the field for every category.
  • Subcategories count. If you check Vehicles, the field also applies to Vehicles → Cars and Vehicles → Vans.
  • Translations count (WPML). A translated category matches its original.
  • On a listing type tab you see the main Categories list and, if the type has its own category taxonomy, that list too. When you check terms in both lists, the listing must match both.
  • Each list has a Filter box. With more than 150 categories, the list turns into a search: type at least 2 letters to find a category. Selected categories are shown as chips you can remove.


Step 2: Show or Hide a Field Based on Another Field

Example: Battery capacity should appear only for electric cars.

  1. Open the Battery capacity field and go to the Rules tab.
  2. Under Show this field when, keep the Action on Show this field when. Choose Hide this field when if it is easier to describe when the field should go away.
  3. Click + AND rule to add the first rule.
  4. Pick the field (or taxonomy) the rule reads, for example Fuel.
  5. Pick an operator, for example has any of, and the value Electric.
  6. Click Save Changes.

Leave the section empty to always show the field.

AND rules and OR groups

  • + AND rule adds a rule to the same group. All rules in a group must match.
  • + OR group adds a new group. One matching group is enough.

Example: show Mileage when Condition is Used, OR when Condition is Demo AND Year is less than 2025. That is two groups: the first has one rule, the second has two.

Operators

The operators you can pick depend on the type of the field the rule reads:

Field the rule reads Operators
Text, Textarea is, is not, contains, greater than, at least, less than, at most, is empty, is not empty
Select (one choice) is, is not, is any of, is none of, is empty, is not empty
Multi Select, Multi Checkbox has any of, has none of, is empty, is not empty
Checkbox is checked, is not checked
A taxonomy (categories, features, regions, custom taxonomies) has any of, has none of, is empty, is not empty
Other field types (date, file, repeatable) is empty, is not empty
  • For “is any of”, “is none of”, “has any of” and “has none of” you can pick several values.
  • “greater than”, “at least”, “less than” and “at most” compare numbers. They work when the other field holds a plain number such as 2019 or 74000. A value written with a thousands separator, such as 74,000, is not read as a number and the rule does not match.
  • A taxonomy with more than 300 terms gets a text box instead of a checklist: type the term slugs, separated with commas.

Which fields a rule can read

  • Fields on the same tab.
  • On a listing type tab, also the fields of Contact Fields, Locations Fields and Hidden Custom Fields. They are listed in their own groups in the field picker.
  • On Contact Fields, Locations Fields or Hidden Custom Fields, only the other two of these tabs. A field of one listing type would be empty for every other type.
  • Any listing taxonomy, listed under Taxonomies: categories, features, regions and your custom taxonomies .

Rules can depend on each other. If Battery capacity is hidden, a field whose rule reads Battery capacity sees it as empty.


Example: a Car Classifieds Setup

Field Where this field applies Show this field when
Doors Cars (empty)
Engine capacity Cars, Motorcycles Fuel has none of Electric
Battery capacity Cars Fuel has any of Electric, Hybrid
Mileage Vehicles (with all subcategories) Condition is Used
Warranty until (empty) Condition is New

In this example Fuel is a custom taxonomy and Condition is a Select field.


Where the Rules Apply

Place What happens
Add Listing form (front end) and the Listeo listing editor in wp-admin (Listings → Edit) Fields appear and disappear live while the owner fills the form, also in multi-step forms. A hidden field is never required, so it never blocks the form. The server checks the rules again on save.
Listing page and preview Hidden fields are left out of the details. Old values of fields outside their categories are not shown.
Listing cards Fields set to show on cards follow the same rules.
Elementor The Listing Custom Fields widget, the Listing Custom Field widget and the Listeo Custom Fieldsdynamic tag show nothing for a field hidden on that listing.
Search forms A filter for the field follows the same rules. See the next section.


Search Filters Follow the Rules

When a Listing Field with rules is used as a search filter, the filter follows the field’s rules:

  • A filter limited to some categories appears only after the visitor picks one of those categories, or automatically on that category’s archive page. With no category chosen, it stays hidden.
  • A Show this field when rule works inside the search form. Example: the Battery capacity filter appears after the visitor picks Electric in the Fuel filter. The filter the rule reads must be in the same search form.
  • A hidden filter is not sent with the search and is not stored in saved searches.

You can turn this off for one filter:

  1. Go to WP Admin → Listeo Editor → Search Forms and open the form.
  2. Click the element to open its side panel.
  3. In the Visibility section, uncheck Follow the field’s rules. It is checked by default.
  4. Click Save Changes.

Note If several listing types use the same field key with different rules (or one of them has no rules), the search filter does not inherit the rules. Hiding it would hide a filter that works for the other types. A filter for a custom taxonomy follows the rules set on the taxonomy itself .

The rules only hide filters in the browser. They do not remove listings from the results.

What Happens to Hidden Values

What changed for existing sites

Nothing changes until you add rules. Once you do, values are handled differently depending on why a field is hidden:

Hidden by On save
Where this field applies(category) The field is skipped. Its stored value is kept, but not shown. If the listing moves back to a matching category, the value is visible again.
Show this field when / Hide this field when The stored value is removed when the listing is saved from the Add Listing form or the Listeo listing editor. For a custom taxonomy, its terms are removed from the listing.

Example: a car is first listed as Used with a mileage of 40,000 km. The owner changes Condition to New and saves. Mileage is hidden by its rule, so the 40,000 km value is deleted. Switching back to Used shows an empty Mileage field.

Warning Adding a condition to a field that already has data on many listings does not change anything right away. Each listing loses the value the next time it is saved with the condition not matching. Check your rules on a staging site or on a test listing first.


Limitations

  • The classifieds price in the listing sidebar and on cards always shows. It ignores rules.
  • The WordPress editor screen (the WordPress editor row action in Listings) shows every field and does not apply rules. Saving there never clears values.
  • Polylang: translated categories are not matched to their originals. WPML is supported.
  • Roles and packages: rules cannot depend on the user role or the listing package yet.
  • Not covered: structured data (JSON-LD), the AI search index, the social links block, Listeo Booking Plus resource cards, imports and converters, and the MCP connector’s meta writes. These read or write fields without the rules.
  • Search results: rules hide filters, they do not filter listings.


FAQ and Troubleshooting

  • I added a rule, but the field still shows in the Add Listing form

  • The field shows on the listing page but not in the form

  • A search filter never appears

  • Values disappeared from my listings

  • Can a rule read a field from another listing type?

  • Do rules travel with Export & Import?


Related Articles

  • Custom Taxonomies : create taxonomies such as Fuel or Body type, and use them in rules.
  • Related Taxonomies and Chained Select : Make → Model.
  • Adaptive Search Filters and Result Counts .
  • Search Form Elements Reference .
  • Conditional fields and displaying them on listing page: category-specific fields and headlines.


For Developers

Rules are stored on the field definition in the Listing Fields options (keys scope and conditions). The evaluator is Listeo_Core_Field_Rules in Listeo Core.

PHP filters and actions

  • listeo_core_field_rules_hidden ( $hidden, $rules_by_key, $selected_terms, $context ): the fields hidden by rules, as meta_key => 'scope'|'conditions'. Add or remove keys to change the result.
  • listeo_core_field_rules_cleared (action, $listing_id, $keys): fired after the values of condition-hidden fields were removed on save.
  • listeo_core_submit_fields ( $fields, $listing_type, $listing_id ): the submit form fields, after Listeo Core built them.
  • listeo_core_search_filter_rules ( $rules, $element, $key ): the rules of one search filter.
  • listeo_core_search_rules_library_map ( $map, $definitions ): the field rules search filters inherit, by key.
  • listeo_fafe_field_rules_config ( $config, $context ): the operators and labels of the rules UI in Listeo Editor.

Helpers

  • listeo_core_is_field_hidden_for_listing( $key, $post_id = 0 ): true when a field is hidden on a listing by its rules. Use it in custom templates that print a single field.
  • listeo_core_get_rule_hidden_field_keys( $post_id ): every hidden field of a listing, as meta_key => 'scope'|'conditions'.
// Print a field only when its rules allow it.
$key = '_battery_capacity';
if ( ! listeo_core_is_field_hidden_for_listing( $key, get_the_ID() ) ) {
    echo esc_html( get_post_meta( get_the_ID(), $key, true ) );
}

JavaScript

  • listeo:field-rules-applied (document event): fired after the Add Listing form applied the rules. The handler receives the hidden keys.
  • listeo:term-fields-loaded (document event): fired after the category fields were loaded by AJAX in the Add Listing form. Trigger it yourself after you inject fields, so the rules run again.
  • Field wrappers carry data-field-key and data-field-type, search filter wrappers carry data-filter-key. A hidden field wrapper gets the class listeo-field-hidden, a hidden search filter listeo-filter-hidden.

Custom Taxonomies

Custom taxonomies let you create your own ways to group listings, such as Fuel, Body type, Brand or Make, without writing code. Each taxonomy gets its own term pages with search and map, can be used in Add Listing Forms and Search Forms, and can be shown on the listing page wherever you place it. You create them in Listeo Editor → Taxonomies.

Before You Start

You need Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor 2.3 or newer. Update them together


What Custom Taxonomies Do

Listeo comes with Categories, Features and Regions. Many sites need more: a car site wants Fuel, Body type and Transmission, a real estate site wants Property type and Heating. Until now you had to fake these with Select fields. A taxonomy is often the better choice:

Select field (Listing Fields) Custom taxonomy
Own page per value No Yes, for example /fuel/electric/, with search and map
Values managed as terms Options typed in the field Terms with name, slug, description and icon, like categories
Linked to another list (Make → Model) No Yes, with a parent taxonomy
Search filter Yes Yes, as select, checkboxes, drilldown or chained select
Good for Numbers and free text (Year, Mileage, Power) Things visitors browse by (Fuel, Make, Body type)

A simple rule: if a visitor would want a page that lists “all electric cars”, make it a taxonomy. If the value is a number or unique per listing, keep it a field.


Where to Find It

Go to WP Admin → Listeo Editor → Taxonomies. The All Taxonomies tab lists your custom taxonomies with their Name, Internal name, URL base, Listing types, Parent taxonomy and number of Terms.

The terms of each taxonomy are managed in WP Admin → Listings → Categories, in the Custom Taxonomies section. Click Manage Terms on a taxonomy card.


Step 1: Create a Taxonomy

  1. Go to Listeo Editor → Taxonomies and click Add New Taxonomy (or + Add taxonomy in the tab bar).
  2. Fill in the form (see the table below).
  3. Click Create Taxonomy.

You see “Taxonomy created. You can now add its terms and place it in Add Listing Forms and Search Forms.”

Setting What it does
Name Singular, for example “Fuel”.
Plural Name For example “Fuels”. Used as the menu and form label.
Internal name Starts with lt_, for example lt_fuel. Lowercase letters, numbers and underscores, at most 32 characters, and it cannot end with _category. It is stored with every term and used in form element names and search addresses (tax-lt_fuel). It cannot be changed after creation.
URL base The first part of the term page address. With fuel, the Electric term page is yoursite.com/fuel/electric/. It must not be used by another taxonomy, post type, page or Listeo address.
Hierarchical On: terms can have parent terms inside the same taxonomy, like categories. Off: a flat list, like tags. This is not the same as a parent taxonomy (Make → Model), see Step 5.
URL Base Translations Shown when the site has more than one language (WPML, Polylang, TranslatePress or several WordPress languages). Leave a language empty to use the URL base above.
Listing types The taxonomy is offered in the Add Listing Forms of the checked types. Leave all unchecked to use it for every type.
Column in the admin listings list Adds a column with the terms to Listings in wp-admin.
Parent taxonomy In the Relation block. Links this taxonomy to another one, so its options depend on what is chosen there. See Step 5.
Visibility Rules Show this taxonomy when and Where this taxonomy applies. See Step 6.

Tip Choose the internal name carefully, for example lt_fuel or lt_body_type. You can rename the taxonomy (Name, Plural Name) and change its URL base later, but never its internal name.


Step 2: Add Terms

  1. Go to WP Admin → Listings → Categories.
  2. In the Custom Taxonomies section, click Manage Terms on the Fuels card.
  3. Add the terms, for example Petrol, Diesel, Electric, Hybrid, LPG.

The term screen is the standard WordPress one, with the same icon settings as categories. A term icon is used when the taxonomy is shown as a row, tags or a box on the listing page.


Step 3: Add It to Your Forms

Add Listing Forms

  1. Go to WP Admin → Listeo Editor → Add Listing Forms and open the form of the listing type.
  2. In a section, click Add new field and pick the taxonomy (for example Fuels).
  3. Choose a field type, for example Select taxonomy or Taxonomy checkboxes.
  4. Click Save Changes.

The taxonomy is offered only in the forms of the listing types set in Listing types. If a form still uses it for another type, the editor shows a warning: the form neither shows nor saves it there.

Search Forms

  1. Go to WP Admin → Listeo Editor → Search Forms and open a form.
  2. In Available Elements → Taxonomies, click the taxonomy to add it.
  3. Open the element and pick its Type: Checkboxes in column, Checkboxes in row, Select Taxonomy, Drilldown Taxonomy or Chained select.
  4. Click Save Changes.

The search sends the selected terms as tax-lt_fuel. See the Search Form Elements Reference for every element type.


Step 4: Show It on the Listing Page

A new custom taxonomy is not shown on the listing page automatically. You choose where it goes:

  • Among the fields (recommended). Go to Listeo Editor → Listing Fields and open the listing type tab. The box Taxonomies you can add to this list shows each taxonomy that is not placed yet and where it shows now (Now: in its usual place, Now: checkbox list (Single settings) or Now: not shown). Click Place, or use Add taxonomy. Drag it under a headline and save.
  • As a checkbox list. Go to Listeo Core → Single Listing and select it in Show taxonomies as list of checkboxes on single template.

A placed taxonomy has these options in its side panel:

  • On the listing page show as: Row in the details list, Tags or Own box (as before).
  • Show on listing cards, and Show the label on cards.
  • Remove from list: the taxonomy leaves the details. A custom taxonomy is then shown only in the checkbox list of the Single Listing settings, if you selected it there.

A car can then read “Basics: Make, Model, Year, Fuel” in one section instead of a separate box per taxonomy. More layout options are in the Listing Details Layout article .

Elementor The Listing Taxonomy Checkboxes widget has the switch Hide taxonomies placed in Listing Fields, on by default, so a placed taxonomy is not shown twice.


Step 5 (optional): Link It to a Parent Taxonomy

Use Parent taxonomy when the options of this taxonomy depend on another one: Make → Model, Country → City. With a parent set, the Chained select element shows only the models of the chosen make. This has its own article: Related Taxonomies and Chained Select .


Step 6 (optional): Visibility Rules

A taxonomy can have the same rules as a Listing Field:

  • Where this taxonomy applies: only for some categories, for example Fuel only for Cars and Motorcycles. Subcategories count.
  • Show this taxonomy when (or Hide this taxonomy when): depending on another field or taxonomy.

The rules apply in the Add Listing Form, in search forms and on the listing page. The lists in the rules follow the listing types you saved, so save the taxonomy once after changing Listing types. Field rules can also read a taxonomy. Example: a Battery capacity field with the rule “Fuel has any of Electric”. The operators for a taxonomy are has any of, has none of, is empty and is not empty. Details are in Field Visibility Rules .

Warning When a taxonomy is hidden by a Show this taxonomy when rule, its terms are removed from the listing on save. A taxonomy hidden only by Where this taxonomy applies keeps its terms.


Deleting and Restoring a Taxonomy

Open the taxonomy and click Delete. Only the definition is removed:

  • The terms stay in the database.
  • Forms that use it stop showing it.
  • If other taxonomies use it as their parent, their terms are kept, but their options no longer load by parent until you choose another parent.

To bring it back, add a taxonomy with the same internal name. The terms come back with it.


Moving Taxonomies to Another Site

Custom taxonomies are part of Listeo Editor → Export & Import, in the Taxonomies group. The export contains the definitions (names, URL bases, listing types, parent, rules), not the terms. Add the terms on the new site, or use the CSV import for related taxonomies . The import checks every definition first. An entry whose URL base is already used on the target site is skipped and listed in the preview.


Limitations

  • Listing types are enforced in the front-end Add Listing form only. The WordPress editor screen and the REST API still accept terms for any type.
  • URL base translations are used for the current language only.
  • WPML: translated terms with a different slug do not match visibility rules.
  • A custom taxonomy is not shown on the listing page until you place it (Step 4).
  • Terms are not included in Export & Import.


FAQ and Troubleshooting

  • The Taxonomies screen says nothing can be saved

  • The term page returns a 404 error

  • I added terms, but the taxonomy is not on the listing page

  • The taxonomy is missing from the Add Listing Form editor

  • Should I convert my existing Select fields into taxonomies?

  • Can I change the internal name?


Related Articles

  • Related Taxonomies and Chained Select
  • Field Visibility Rules
  • Adaptive Search Filters and Result Counts
  • Unlimited Listing Types


For Developers

  • Definitions are stored in the option listeo_custom_taxonomies, keyed by internal name. Read them with Listeo_Core_Custom_Taxonomies::get_all() or Listeo_Core_Custom_Taxonomies::get( 'lt_fuel' ).
  • The taxonomies are registered on init for the listing post type, public and with show_in_rest.
  • listeo_core_custom_taxonomy_args ( $args, $name, $definition ): the register_taxonomy() arguments.
  • listeo_core_custom_taxonomy_rewrite_slug ( $slug, $name, $definition ): the URL base in the current language.
  • listeo_core_custom_taxonomy_reserved_names ( $names ): internal names that cannot be used.
  • listeo_core_listing_taxonomies ( $taxonomies ): the taxonomies whose term pages use the listings archive. Custom taxonomies are added here.
  • In URLs and search forms a custom taxonomy is tax-{internal name}, for example ?tax-lt_fuel=electric.

Adaptive Search Filters

Adaptive filters make your search forms react to the current search. Options that would return no listings are greyed out or hidden, options can show how many listings they match, such as “Diesel (12)”, and sliders can take their range from the current results. The search button can also read “Show 2,000 listings”. You turn the feature on once in Listeo Core → Browse/Search Options, then choose the behaviour for each filter in Listeo Editor → Search Forms.

Before You Start

You need Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor 2.3 or newer. Update them together. Adaptive filters are off by default. Nothing changes in your search forms until you turn them on.


What Adaptive Filters Do

Without adaptive filters, a visitor can combine filters that match nothing and only finds out on the empty results page. With adaptive filters enabled:

  • Empty options are disabled or hidden. After choosing Make = Honda, the Condition option “New” is greyed out if no new Honda is listed.
  • Counts (optional) show next to each option, for example “Electric (8)”.
  • Slider range (optional): a Price or Mileage slider uses the lowest and highest value of the listings found.
  • Result count on the search button (optional): “Show 245 listings”, updated while the visitor picks filters.

The selected option is never disabled or hidden, so a visitor can always undo a choice. For a single-choice filter, or a multiple-choice filter whose options are combined with OR, the counts ignore that filter’s own choice. After choosing Honda, the other makes keep their counts, so the visitor can switch to another make. When several options of one filter are combined with AND, the counts include the filter’s own choice, because each extra option narrows the results.

When to use it

  • Classifieds and marketplaces with many filters (make, model, fuel, condition, body type).
  • Any site where visitors often end up on “No listings found”.


Step 1: Turn On Adaptive Filters

  1. Go to WP Admin → Listeo Core → Browse/Search Options.
  2. In the Search Logic & Relations block, check Adaptive filters.
  3. Save the settings.

From now on, every option filter in your search forms disables its empty options. That is the default behaviour. Counts and slider ranges stay off until you turn them on per filter in Step 2.

Note Counts follow the search logic in the same block. Different taxonomies (for example category and region) are always combined with AND. Default relation between selected terms of one taxonomy and the per-taxonomy {Taxonomy} search logical relation settings decide how several terms of one taxonomy are combined.


Step 2: Choose the Behaviour of Each Filter

  1. Go to WP Admin → Listeo Editor → Search Forms and open a form.
  2. Click a filter to open its side panel.
  3. Set the options in the Adaptive filters section (see the table).
  4. Click Save Changes.
Setting Choices What it does
Options without results Use default, Disable, Hide, Show What happens to options that would return no listings. Disable greys them out, Hide removes them from the list, Show leaves them as they are. Use default means Disable.
Show counts On / off (default off) Shows the number of matching listings next to each option.
Range from current results On / off (default off), sliders only The slider minimum and maximum follow the listings found by the current search.

Which filters support it

Element Disable / hide / counts Range from results
Taxonomies: Checkboxes in column, Checkboxes in row, Select Taxonomy, Chained select Yes No
Listing Fields with options: select, multi select, checkboxes, Buttons (pick one) Yes No
Slider (price or any number field) No Yes
Drilldown Taxonomy, From/To inputs, Select: up to, Select: from, text and keyword inputs, location, dates No No

The settings show only for elements they apply to. More about each element type is in the Search Form Elements Reference .

Tip Start with Disable everywhere and Show counts only on the filters people use most (Make, Fuel, Body type). Counts on every filter make the form busy. Use Hide for long checkbox lists, so only useful options remain.


Step 3 (optional): Show the Number of Results on the Search Button

  1. In Listeo Editor → Search Forms, open the form.
  2. In Form Options, check Results count on search button.
  3. Click Save Changes.

The button reads, for example, “Show 2,000 listings” and follows the selected filters. When nothing matches it reads “No listings found”.

  • It needs Adaptive filters (Step 1). Without it the button keeps its normal text.
  • It works on forms with a search button: fullwidth and boxed forms, and sidebar forms when AJAX browsing is off. The split page form (Search on Half Map Layout) does not have this option.
  • In a shortcode you can turn it on or off per form: [listeo_search_form source="search_on_home_page" count_button="on"].


Page Caching and Performance

  • Counts load after the page. The page itself is not changed, and the browser asks for the counts separately. Adaptive filters therefore stay correct when your pages are cached by a caching plugin or your host.
  • With AJAX browsing, the counts arrive together with the new results, so there is no extra request.
  • Nothing is written to the database. If your site has a persistent object cache (Redis, Memcached), Listeo uses it.
  • Large result sets: when a search matches more than 5,000 listings, Listeo shows the overall counts of the taxonomy terms and does not grey out or hide anything. The button reads “Show 5,000+ listings”. Narrow the search and the exact counts come back.


Limitations

  • Searches that are not counted on page load: location and radius searches, Open now, AI search, and keyword searches when Keywords search mode(Listeo Core → Browse/Search Options) is set to Fibo Search or Search WP compatibility. Counting them would repeat a paid lookup (geocoding, AI, an external search engine). When the page loads with such a search, or when a form that is not on a results page (for example a home page form) holds one, the options stay as they are and the search button keeps its normal text. On a results page with AJAX browsing on, the counts come back with the next AJAX results, for example as soon as the visitor changes a filter, because that request already ran the lookup.
  • Drilldown taxonomies and From/To inputs have no counts.
  • Older listings that store a multi-value field as one comma-separated or serialized value are not counted correctly.
  • When one search combines more than three filters with their own selection, some filters show counts only and do not disable options.
  • Elementor Listings widget: a search form on the same page that drives the widget’s results with AJAX browsing gets counts like on the listings page. The counts include the category, region, feature and listing type the widget is limited to. Other widget settings that the AJAX search does not receive are not in the counts either.
  • In the Elementor Search Card widget, the counts of a tab load when the tab is first shown.
  • Plugins that replace the listing results (for example ElasticPress or SearchWP integrations) are not consulted. Counts follow Listeo’s own database query.


FAQ and Troubleshooting

  • Counts do not show at all

  • Options are not greyed out, but counts are shown

  • The search button does not show the number of results

  • A count looks wrong

  • Does this slow down my site?

  • Will my existing search forms change after the update?


Related Articles

  • Search Form Elements Reference
  • Related Taxonomies and Chained Select
  • Custom Taxonomies
  • Field Visibility Rules : hide whole filters until they apply.
  • Search Forms Editor / Search Filters


For Developers

The logic lives in Listeo_Core_Search_Facets. The global switch is the option listeo_adaptive_filters ('on'). The element settings are stored as facet_empty, facet_counts and facet_range on the search form element.

PHP filters

  • listeo_core_adaptive_filters_enabled ( $enabled ): force the feature on or off.
  • listeo_core_facets_threshold ( $threshold, $descriptors ): the number of results above which overall counts are used (default 5000).
  • listeo_core_facets_max_disjunctive ( $budget ): how many filters with their own selection get exact counts per request (default 3).
  • listeo_core_facet_meta_keys and listeo_core_facet_range_keys: the field keys that may be counted. Only keys of choice and slider elements of saved search forms are allowed by default, because the endpoint is public.
  • listeo_core_facets_request_off ( $off, $request ): return true to skip counts for a request.
  • listeo_core_search_facets ( $facets ): the computed response.
  • listeo_core_search_count_button_label ( $label, $total, $capped ): the search button text.

Endpoint and JavaScript

  • Page load counts: POST to admin-ajax.php with action=listeo_core_search_facets, the serialized form and listeo_facets. Public and read-only, no nonce. The AJAX search (listeo_get_listings) returns the same data in its facets key.
  • Response: { mode: "results" | "global" | "off", total, taxonomies, meta, ranges, partial }.
  • window.listeoSearchFacets.refresh( form ): load and apply the counts of a form now, for example after you show a hidden form.
  • window.listeoSearchFacets.watch( form ): start the search button count of a form added after page load.
  • window.listeoSearchFacets.last( form ): the last counts applied to a form.
  • Filter wrappers carry data-facet, data-facet-empty, data-facet-counts and data-facet-range. Options disabled by adaptive filters carry data-listeo-facet-disabled="1".

Listeo Update 2.2.4 Report

Listeo 2.2.4 is out, together with a big update to Listeo Monetization Plus. The headline is Banner Ads: a new way to earn money from your directory by selling ad space directly to local businesses. On the Listeo side, you get a calendar view for bookings, a custom region URL base, lighter gallery uploads and a round of map and security fixes.

  • Banner Ads: sell ad space on your directory, with a self-serve booking page and WooCommerce payments.
  • Bookings calendar: see every booking by month, week or agenda in wp-admin.
  • Region base: replace /region/ in your URLs with your own word.
  • Lighter uploads: photos are scaled down in the browser before they are uploaded.
  • Fixes: maps, date search, listing descriptions and security hardening.

Banner Ads: sell ad space on your directory

Your directory already has the audience that local businesses want to reach. Banner Ads, a new module in Listeo Monetization Plus, lets them buy that visibility without emailing you or waiting for an invoice.

How it works

  1. You create zones
    A zone is a place on your site with a size and a price per day. Put one between search results, in the search sidebar, on single listing pages, above the header, above the footer, or anywhere with a shortcode, widget or Elementor widget.
  2. Advertisers book them
    The Advertise page walks them through three steps: pick a spot, choose dates on a live availability calendar, and upload a banner that is cropped to the right size in the browser. They see the total price, including long-campaign discounts, and pay through your regular WooCommerce checkout.
  3. You approve
    Paid banners wait for your review (or switch on automatic approval). Approve them, or reject with a reason that is emailed to the advertiser so they can fix and resend.

What else is included

A dashboard for you
Impressions, clicks, CTR, sales, zone occupancy for the next 30 days and your top banners.
My Ads for advertisers
Advertisers track impressions, clicks and CTR, edit their banner and book the same spot again from their Listeo dashboard.
Category and region targeting
Sell a zone separately per category or region, so a restaurant can book the banner on restaurant searches only (set the zone capacity to 1 to make it exclusive).
No empty spots
When nothing is booked, a zone can show your own house banners or a code snippet such as AdSense.
Works with page caching
Banners rotate on cached pages, and WP Rocket, LiteSpeed Cache, W3 Total Cache and WP Super Cache are cleared automatically when banners change.
Honest tracking
An impression counts only when at least half of the banner is visible for one second. Bots are ignored, and visitor IP addresses are never saved with your statistics.
Any WooCommerce gateway
Advertisers pay through your checkout with any gateway, bank transfer included. Dates are held while they pay.
Nine emails
Every step is covered, from payment received to “your banner ends soon”, and every email is editable.

Banner Ads is off by default. Turn it on in Listeo Core > Banner Ads > Settings, create your first zone, and add the Advertise page to your menu or footer so advertisers can find it. Step-by-step setup: Banner Ads guide.

Subscriptions no longer just expire

Also new in Monetization Plus: when a listing subscription lapses (cancelled, paused or unpaid), live listings can move to a fallback package, for example a Free plan, instead of disappearing from your directory. When the subscriber renews, the listings move back to the paid plan.

Set the fallback package on the listing package product in Listeo Core. This applies to the “Listings stay live while the subscription is active” mode. Listings beyond the fallback package’s limit expire as before.

Listeo Monetization Plus
Banner Ads, subscriptions and more ways to earn from your directory.
Get Monetization Plus

What’s new in Listeo 2.2.4

Calendar view for bookings
Listings > Bookings has a new Calendar tab with month, week and agenda views, the same filters as the list, and shaded owner-blocked days when one listing is selected.
Your own region URL base
Replace /region/ with your own word in Settings > Permalinks > Region base. Permalink changes now take effect after a single save.
Lighter, safer gallery uploads
Photos are scaled to 2560 px in the browser before upload, fewer image sizes are created, and failed uploads are clearly marked.
Map fixes
Fresh OpenStreetMap tiles, a reliable all-listings map with location radius, individual markers with clustering off, and a better “Find my location”.

Calendar view for bookings

The Calendar tab loads up to 500 bookings at a time, hides cancelled and expired bookings unless you pick that status in the filter, and clicking a booking opens its details. The booking list filters also work again: they no longer end on “Sorry, you are not allowed to access this page”.

Your own region URL base

Not every directory is in English. Leave the new field empty to keep your current /region/ URLs. A base that collides with another Listeo base is refused with a notice.

Lighter, safer gallery uploads

Smaller uploads mean fewer timeouts on shared hosting, and scaled photos are sent without camera metadata such as GPS position. Adjust the size in Listeo Core > Submit Listing, or set it to 0 to upload originals. The form waits until every image has finished uploading.

Map fixes

  • Tiles: OpenStreetMap tiles load from the current tile server.
  • Location radius: the all-listings map keeps working after a visitor shares their location with a search radius.
  • Clustering off: the all-listings map shows individual markers (very dense areas still group until you zoom in).
  • Find my location: with OpenStreetMap it keeps your zoom level and no longer moves another listing’s marker, and with Google Maps the results now refresh.

Other improvements

  • Promotions: “Listeo Ads” is now called Promotions everywhere in the interface. Only the wording changed, your settings and data stay the same.
  • Admin menu: Listeo Core settings are grouped into Settings, Tools, Add-ons and Licenses.
  • Date search: date range search reads day-first dates with month names correctly (for example “25 декабря 2026”).
  • Descriptions: listing descriptions keep their paragraph breaks after editing in both the block editor and the dashboard.
  • Bulk updates: updating plugins from Appearance > Install Plugins no longer stops with an error when one plugin needs a newer PHP or WordPress version.

Security

This release includes security hardening in Listeo Core and Listeo Forms & Fields Editor, covering the bookings admin screen, gallery uploads, permalink settings and the form builder. We recommend updating all sites.

How to update

  1. Download the latest package
    Get the newest Listeo files from purethemes.net/license.
  2. Update the theme and plugins together
    Update the Listeo theme, Listeo Core, Forms & Fields Editor and Listeo Elementor, since some fixes need both. Follow How to update the theme and plugins.
  3. Update Monetization Plus and clear your cache
    If you use Listeo Monetization Plus, update it as well to get Banner Ads. Then clear your site cache.

Full list of changes: Listeo changelog.

FAQ

  • Do I need Listeo Monetization Plus for Banner Ads?

  • Which payment methods can advertisers use?

  • Will Banner Ads change my site right after the update?

  • Does the Promotions rename change my existing promoted listings?

  • I use a page cache. Will banners still rotate?

Banner Ads

Banner Ads lets you sell banner space on your directory. You create zones (places on the site with a size and a price per day), advertisers book dates and pay through WooCommerce, and you approve their banners before they go live. This article walks through enabling the module, creating zones, selling them, moderating banners and testing the full flow.

What Banner Ads Does

Banner Ads is bundled with the Listeo Monetization Plus plugin. It needs WooCommerce, and Listeo theme and Listeo Core 2.2.3 or newer.

You can use it in three ways, and mix them freely:

  • Self-serve sales. Advertisers pick a spot and dates on the Advertise page, upload their banner, pay through WooCommerce and follow their results on My Ads.
  • Banners you add yourself. For deals made outside the site, add the banner in wp-admin and set its dates.
  • House banners and ad code. When nothing is booked, a zone can show your own promo banners or a code snippet (for example AdSense) instead of staying empty.

Image banners count impressions and clicks, and you see the results per zone and per banner on the Banner Ads dashboard.


Where to Find It

Go to WP Admin → Listeo Core → Banner Ads. You’ll find five tabs:

  • Dashboard: impressions, clicks, CTR and sales for the last 7, 30 or 90 days, how full each zone is over the next 30 days, and your top banners.
  • Zones: the places on your site where banners show.
  • Banners: every banner with its zone, dates, status and results. Banners bought on the Advertise page wait here for your review.
  • Emails: the messages sent to advertisers and to you.
  • Settings: the on/off switch, sponsored label, link attributes, pages, checkout and upload rules.

A red number next to the menu item shows how many banners are waiting for review.


Step 1: Turn It On

Banner Ads is off by default.

  1. Open Banner Ads → Settings.
  2. Under Enable Banner Ads, switch on Show banners.
  3. Check the Label. It defaults to Sponsored and is shown with every banner, house banners and ad code included. Many countries require paid content to be marked, so we recommend keeping it.
  4. Save.

When the plugin is activated, Banner Ads also creates two pages for you:

Page Shortcode What it’s for
Advertise With Us [lpba_advertise] Where advertisers choose a spot and dates, upload their banner and go to checkout.
My Ads [lpba_my_ads] The advertiser’s list of banners with results, payment and edit options. It uses the dashboard page template.

You can assign different pages in Settings → Pages. Each page must contain its shortcode.

Add the Advertise page to your menu or footer so advertisers can find it. The My Ads item appears in the user dashboard menu automatically once a user has a banner.


Step 2: Create a Zone


A zone is one place on the site with one banner size. Go to Banner Ads → Zones and click Add zone.

Place

  • Zone name: advertisers see it on the Advertise page, so make it descriptive, for example “Search results top”.
  • Location: where the zone shows. Each option has a small sketch of the page.
Location Where it shows
Search results Above the results, below the results, in the sidebar (top), or between listings (every N). The in-feed option shows the banner as one more card in the results grid, after every N listings, counted across pages and AJAX filtering. Sponsored listing cards do not count.
Single listing Sidebar (top or bottom), after the description, after the Overview section (below Features), or after the location (before reviews).
Whole site Top of the page above the header, or above the footer.
Manual Nowhere automatically. You place it yourself with the shortcode, the widget or the Elementor widget (see Step 3).

Size

Pick a Format: 728 × 90 Leaderboard, 970 × 250 Billboard, 300 × 250 Medium Rectangle, 300 × 600 Half Page, 320 × 50 Mobile Banner, 320 × 100 Large Mobile Banner, or Custom size. Advertisers upload images in these proportions, and the upload tool crops them to fit.

Display

Setting What it does
Banners at the same time 1 makes the zone exclusive: one banner per day. With more, banners booked for the same days rotate on each page view.
Targeting None (everywhere the zone shows), Category or Region. With targeting, each category or region has its own calendar, so you can sell the same spot to a different advertiser per category. A targeted banner takes priority over banners shown everywhere.
When nothing is booked Show nothing, House banners of this zone, or Code (e.g. AdSense). Fallback code can only be edited by administrators.

Selling

Switch on Sell this zone to offer it on the Advertise page, then set:

  • Price per day. A zone is offered only when it is for sale and has a price above zero.
  • Earliest start (days from today), Shortest booking and Longest booking.
  • Long booking discounts (optional): up to three tiers, for example “From 30 days take off 10%”. The best matching discount applies.

Leave Sell this zone off for zones you want to fill only with banners you add yourself.

Click Create zone. The zone card shows its shortcode, how many of the next 30 days are booked, and Pause / Edit buttons.

Pausing a zone hides it and all its banners, paid ones too, and removes it from the Advertise page. Bookings stay, but the paid days keep running. A zone that has banners (including banners in the trash) cannot be deleted; pause it instead.


Step 3: Place Manual Zones

Zones with an automatic location need nothing more. For a Manual zone, use one of these:

  • Shortcode: [lpba_zone id="123"]. Copy it from the zone card.
  • Widget: Listeo Banner Zone in Appearance → Widgets.
  • Elementor: the Banner Zone widget.

To keep in-feed banners out of a particular listings list, use [listings banners="no"], or switch off Banners between listings in the Elementor Listings widget.


Step 4: Set Up Selling

Open Banner Ads → Settings and review the Selling and Image uploads sections:

Setting Default What it does
Approve paid banners automatically Off Paid banners go live without your review. This also applies when advertisers change the image or link of an approved banner. Not recommended: check images and links first.
Allow WooCommerce coupons Off Lets coupons apply to banner purchases.
Reserve the dates during checkout 30 minutes How long the chosen days are held while the advertiser pays. Once an online order is placed, the reservation is extended to twice this time.
Reserve the dates for offline payments 3 days How long an order paid by bank transfer, cheque or cash on delivery keeps its days.
Remind before the end 3 days When to send the “ends soon” email. 0 turns it off.
Advertising terms None Choose a page and advertisers must accept it before paying.
Maximum file size 300 KB Largest banner image after cropping. Animated GIFs must fit this limit as uploaded.
Allowed difference in proportions 2% How far an uploaded image may differ from the zone’s proportions. In practice this matters for animated GIFs, because other images are cropped exactly.

Under Links, banner links always get rel="sponsored". You can also add nofollow and open links in a new tab (both on by default).


How Buying Works

For Advertisers

Any logged-in user can book a banner. Guests see the spots and are asked to log in or create an account. The Advertise page has three steps:

  1. Spot: choose a zone. Each card shows the size, the shortest booking, the price per day and any long-campaign discount. If the zone uses targeting, the advertiser can also choose a category or region, or keep “Everywhere this spot shows”.
  2. Dates: pick a range on the calendar, which shows booked days, or use a ready-made length.
  3. Your Banner: upload an image, crop it to the spot in the browser, and add the link and optional alt text. JPG, PNG and WebP are cropped and compressed automatically. Animated GIFs are not cropped, so they must already have the right proportions and size.

The Your campaign sidebar shows a live preview and the total. Continue to payment holds the dates and sends the advertiser to the WooCommerce checkout.

Behind the Scenes

All banner purchases go through one hidden WooCommerce product called Banner placement, created automatically. It cannot be bought directly, and you only need to edit it to change its tax class. The price is calculated on the server from the zone, the dates and the discount.

  • Order placed: the held days become a reservation, longer for offline payments.
  • Order paid: the banner moves to Pending review (or straight to Scheduled/Active with automatic approval). Orders that contain only banners are completed automatically.
  • Cash on delivery: the banner is activated only when you mark the order Completed.
  • Order cancelled or refunded: the days are released and the banner is cancelled. Partial refunds don’t change the banner.
  • No order placed in time (or the banner was removed from the cart): the banner becomes Abandoned (not paid) and its days are released.
  • Order placed but not paid in time (for example a bank transfer that never arrives): the days are released when the reservation runs out. The banner stays Waiting for payment until you cancel the order.

Tax follows the tax settings of your WooCommerce store and the tax class of the Banner placement product (Standard by default). To change it, edit the product in Products; it is hidden from the shop but listed there.


Step 5: Review and Approve Banners


Paid banners wait in Banner Ads → Banners with the status Pending review, and you get an email.

  1. Use the Pending review filter at the top of the list.
  2. Check the image and the link (open the banner with Edit to see it in full).
  3. Click Approve in the banner’s row. In the banner editor, set Status to Approved (runs on its dates) and save instead. The banner becomes Scheduled or, if its first day has come, Active.

To reject, open the banner, set Status to Rejected and fill in Reason (sent to the advertiser). The advertiser gets an email and can change the image or link on My Ads and send it again.

Rejecting a banner does not refund the order. If you won’t run the banner, refund the order in WooCommerce, which also releases the days.

The list also has bulk actions (Approve, Pause, Resume, Move to trash) and filters by zone, type and advertiser.

Banner Statuses

Status Meaning
Waiting for payment Booked on the Advertise page, not paid yet. The days are held until the reservation time runs out.
Pending review Paid, or changed by the advertiser, and waiting for you.
Scheduled Approved, its first day hasn’t come yet.
Active Showing on the site.
Paused Stopped by you. Resume it from the list.
Expired Its last day has passed.
Rejected / Cancelled Not running. Their days are released.
Abandoned (not paid) No order was placed in time. Deleted automatically 30 days after the booking was started.


Adding Banners Yourself

Click Add banner in the Banners tab. Choose the image (or HTML / code, administrators only), link, zone and one of two types:

  • Paid banner (runs on its dates): for deals made outside the site. It books the zone’s days like a purchase. If the zone is already full on some days, the banner is still saved with a warning and rotates with the others. You can assign it to a user so it appears on their My Ads page, where they can also change its image and link.
  • House banner (fills the zone when nothing is booked): your own promo, with no dates. It shows only when the zone’s When nothing is booked option is set to house banners and no paid banner is running.

Emails go only to advertisers who bought on the Advertise page. Banners you add yourself never email the assigned user.


My Ads (Advertiser Dashboard)

Advertisers see all their banners on My Ads, with dates, status, impressions, clicks, CTR and price. From there they can:

    dzr

  • Pay now or Cancel a booking that isn’t paid yet.
  • Edit banner: replace the image, re-crop it, or change the link and alt text.
  • Book again: start a new booking for the same spot. For a running or scheduled banner, the new dates start the day after the current ones end.

After an advertiser changes an approved banner, it goes back to Pending review and stops showing until you approve the changes, while its paid days keep running. The advertiser sees this warning before saving. With automatic approval on, changes go live right away.


Emails

In Banner Ads → Emails, each message can be switched off and its subject and text changed. Leave a field empty to use the default text, which is translated (into the advertiser’s language for advertiser emails, and the site language for yours).

To the advertiser To you
Payment received, Banner approved, Banner rejected, Banner is live, Ending soon, Banner ended (with results) Banner to review, New sale (auto-approved), Paid over capacity

Available tags: {advertiser_name} {zone} {dates} {end_date} {price} {banner_url} {reason} {impressions} {clicks} {ctr} {my_ads_url} {renew_url} {review_url} {site_name} {contact_email}

Set Send the emails for you to if admin emails should go somewhere other than the site admin address.


Statistics and Caching

  • An impression counts when at least half of the banner is visible for one second. HTML / code banners and fallback code (AdSense) are not counted.
  • A click counts once per visitor and banner every 30 minutes. Bots are ignored, and no IP addresses are stored.
  • Banners work with page caching: the page carries all eligible banners and the visitor’s browser picks one, so rotation and dates stay correct on cached pages. Banner and zone changes clear the cache of WP Rocket, LiteSpeed Cache, W3 Total Cache and WP Super Cache.
  • Banner markup and images uploaded on the Advertise page avoid typical ad-related names, which helps them get past many ad blockers. Third-party ad code such as AdSense will still be blocked.

If you use Delay JavaScript execution in WP Rocket (or a similar option in another plugin), exclude the inline script lpz. Otherwise banners don’t rotate and impressions aren’t counted until the visitor interacts with the page.


Step 6: Test It

  1. Create a zone with a price, switch on Sell this zone, and make sure Show banners is on.
  2. Log in as a regular user (not an admin) and open the Advertise page. Choose the zone, dates and an image, then click Continue to payment.
  3. Pay with a test gateway (or bank transfer, then mark the order Completed).
  4. As admin, open Banner Ads → Banners, find the banner in Pending review and approve it.
  5. Visit a page where the zone shows on one of the booked days. Confirm the banner appears with its label, and that clicking it opens the advertiser’s link.
  6. As the advertiser, open My Ads and confirm the banner, its status and its results are listed.


FAQ

  • Do I need WooCommerce?

  • Can I sell banners without letting advertisers book them online?

  • Can more than one banner share a zone?

  • Can I charge different prices per category?

  • What happens when I change a zone's price?

  • Can I show AdSense when no banner is booked?

  • Are there limits for advertisers?

  • Are statistics kept when a banner is deleted?


Troubleshooting

  • The Advertise page shows the shortcode as text

  • A zone isn't offered on the Advertise page

  • A paid banner isn't showing

  • A banner says it needs new dates

  • Impressions stay at zero

  • The 'Above the footer' zone doesn't appear


For Developers

  • Templates can be overridden by copying advertise.php, my-ads.php or creative-fields.php to a listeo-banner-ads/ folder in your child theme.
  • Useful filters: lpba_render_locations (add or remove locations), lpba_price (booking price), lpba_eligible_banners (banners shown in a zone), lpba_length_presets (ready-made booking lengths), lpba_offline_payment_methods, lpba_advertiser_can_edit_creative, lpba_email_subject / lpba_email_body.
  • Useful actions: lpba_banner_status_changed, lpba_order_fulfilled, lpba_notify.
  • For a page cache that isn’t cleared automatically, add your purge function with the lpba_purge_cache filter.
  • To remove all zones, banners and statistics when the plugin is deleted, switch on Delete data on uninstall in Settings (off by default).