Author Archive

Changing “add listing” button URL

In your child theme functions.php file add this code.

add_filter('listeo_submit_page', 'listeo_submit_page_change');
function listeo_submit_page_change($submit_page)
{
	$submit_page = 99; // where 99 is the page id you want to use	
	return $submit_page;
}

QR Code Verification System

Allow listing owners to verify visitor tickets using their smartphones. By scanning a QR code, owners can quickly confirm ticket authenticity directly from their dashboard, making event entry more efficient.

QR verification system works with all booking methods

How to set it?

If you don’t have QR scanner in dashboard, please create new static page, set Page Template of that page to “Dashboard Page“, and in page content add shortcode [listeo_qr_check]. Publish that page and go to wp-admin -> Listeo Core -> Pages and find “Ticket/Booking Verification Page” option and choose the page you just created.

How it works?

After booking, guests can download a ticket with a QR code from their dashboard. He can print it or open on his smartphone.

To verify ticket validity, the listing owner needs to access a scanner in their dashboard, usable on any device with a camera. If a customer selects cash payment, the ticket will show as ‘unpaid’ until settled, allowing owners to track payment status with ease.

Once the ticket is scanned, the owner will see a prompt with ticket details. In the example below, the ticket is valid but was previously scanned

How to remove bookmarks functionality?

If you would like to remove bookmarks functionality:

  1. Add this custom CSS snippet in Customize → Additional CSS: 
    .like-icon, 
.like-button, 
#bookmarks-counter, 
.like-button-notlogged {display: none !important; }

  2.  Disable bookmarks page in Listeo Core → Pages

Ad Manager Guide

Overview

The Ad Manager allows users to pay for prominent placement of their listings on your homepage, top of search results, or sidebar. They can set their desired budget and target specific categories.

Below is a step-by-step guide to setting up and managing ad campaigns.

Configuration

  1. Ad Campaign Settings
    Navigate to Listeo Core → Ad Campaigns to configure your ad prices and settings.
  2. Campaign Product
    In the “Campaign Product” option, you must select a WooCommerce product to handle payments for ad campaigns.
    If no product appears in the list, go to WordPress Dashboard → Products, create a new product, name it, and set the Product Type to “Listeo Ad Campaign.” Publish the product.
    Return to Listeo Core → Ad Campaigns, select the newly created product, and set your ad prices.
    Note: For Pay Per View campaigns, the price is set per 1,000 views.
  3. Ad Campaigns Management Page
    In Listeo Core → Pages, set the Ad Campaigns Manage Page. This page must contain the [listeo_ads] shortcode and should use the Dashboard Page template.

Submit Ad Campaign

In the front-end user dashboard, users can create new ads by clicking the “Create New Campaign” button on the Ad Campaign page. The form is divided into three sections:

  1. Campaign Details
    Select the listing you want to promote.
    Set your budget and choose a campaign type: Pay Per View or Pay Per Click.
    Optionally, set a Start Date for the campaign. If not set, the campaign will start as soon as the ad order is paid for and marked as Completed.
  2. Campaign Filters
    Select if the ad should only appear for a specific category or region.Optionally, limit the ad display by radius (you must have the Radius Search configured in Listeo Core → Map Options).Ads can also be limited to logged-in users only.
  3. Ad Placement
    Choose where the ad will appear:

    1. Home Section (in any home section)
    2. Search Results Section (on top of search results)
    3. Sidebar (you need to add Listeo Ads widget in Appearance > Widgets to the sidebar where you want to display ads)

Checkout and Activation

After submitting the form, the user is redirected to the checkout page to complete the payment. Once the order status is set to Completed, the ad will become active.

Ad Display

The promoted listing will appear in the positions configured in the ad, such as at the top of search results or in the chosen placement areas. Promoted listings will be marked with “Ad” tag.

License activation rules


According to Envato’s License Terms, each license you purchase allows you to create one unique end product. For example, a website theme like Listeo can be customized to create one specific website. If you want to create a second website from the same theme, you’ll need to purchase another license.

Click For more informations

You can activate the Listeo License on one domain, but as we understand how web development works and it’s crucial to have a test/dev/staging website, these domains below can be activated without any restriction. Just need a valid license key.

  • localhost
  • *.dev
  • *.test
  • *.local
  • local.*
  • *.staging
  • staging.*
  • *.example
  • *.invalid
  • *.dev.css (DesktopServer)
  • *.myftpupload.com (GoDaddy)
  • *.cloudwaysapps.com (Cloudways)
  • *.wpsandbox.pro (WPSandbox)
  • *.ngrok.io (tunneling)

 

If you want to change your main domain, you can deactivate license in Listeo Core -> License -> Deactivate (you need to have access to website that license is active on)

 

Adding custom fields to registration form

Please keep in mind that there are settings in Listeo Core → Registration regarding the form, this instruction below is only for custom fields.

If you would like to change names or Owner/Guest role, use this method: How to change some texts/words?

Step 1

First you have to create custom fields. Go to Listeo Editor → User Fields. There are two tabs for Guest and Owner as you can set those fields separately for each role.

For this guide purpose we will add VAT Number field.

Click the green button Add field, type a name and click OK, you will see box with new field and options for that field. You can switch Type of this field to dropdown, radio, checkbox or even file upload field.

Fields you will create are automatically added to My profile page in Listeo Dashboard.

Step 2

When you are ready click Save Changes and  go to Listeo Editor → Registration Fields. Here you will see the field you’ve just created in the Available Fields section in the right side, you can simply drag&drop it to the fields area, and save.

That way this field will be now added to your registration form. You can change the label or set a new icon for that field.

SMS Notification & OTP verification

Listeo SMS Notification plugins add capabilities to your registration process that can enhance the security and user experience of your application. It also allows you to send notification to users about upcoming bookings, expiring listings or new bookings or reviews.This guide walks you through the steps to configure it.

Step 1: Sign Up for Twilio

  1. Create a Twilio Account: Go to the Twilio website and sign up for an account if you don’t already have one.
  2. Verify Your Email and Phone Number: Complete the verification process for your email and phone number.
  3. Get Twilio API Credentials: Once your account is set up, navigate to the Console Dashboard to find your Account SID and Auth Token. These credentials are required to authenticate API requests.
  4. Copy those information to Listeo Core -> SMS Settings -> Providers, there are settings for Twilio Account SID, Twilio Auth Token and Twilio phone number
  5. And that’s all, now you can turn on which SMS you want to send and configure their content

If you want to test it first without actually spending money on Twilio, you can enable Debug Mode in Listeo Core -> SMS Settings, with that enabled you will see the messages sent in Listeo Core -> View Debug log

To enable debugging mode, add the following line to the wp-config.php file in your WordPress installation directory:

define('WP_DEBUG', true);
define( 'WP_DEBUG_DISPLAY', false );
define('WP_DEBUG_LOG', true);

Shortcodes

[login_form]

  1. [listeo_login_form]
  2. [listeo_login]
  3. [listeo_registration]

[listings]

The [listings] shortcode is used to display listings on a page. It has several attributes that you can use to customize the output. Here’s a brief documentation for each attribute:

  1. style: Determines the style of the listings. Can be ‘list’, ‘grid’, or ‘grid-compact’. Default is ‘list’.
  2. layout_switch: If set to ‘on’, it allows users to switch between different layout styles. Default is ‘off’.
  3. list_top_buttons: Determines which buttons to display at the top of the listings. Options are ‘filters’, ‘order’, ‘layout’, and ‘radius’. You can use a pipe ‘|’ to separate multiple options. Default is ‘filters|order|layout|radius’.
  4. per_page: The number of listings to display per page. Default is the value of ‘listeo_listings_per_page’ option, or 10 if that option is not set.
  5. orderby: Determines how to sort the listings. Default is empty.
  6. order: Determines the order of the listings. Can be ‘ASC’ for ascending order or ‘DESC’ for descending order. Default is empty.
  7. keyword: A keyword to filter the listings. Default is empty.
  8. location: A location to filter the listings. Default is empty.
  9. tax-listing_category: Provide a slug of category you want to display, you can set more than one, separate it by coma.
  10. tax-region: Provide a slug of region you want to display, you can set more than one, separate it by coma.
  11. tax-service_category: Provide a slug of service category you want to display, you can set more than one, separate it by coma. The same works for event_category, rental_category, etc
  12. search_radius: The radius to use for location-based searches. Default is empty.
  13. radius_type: The unit of measurement for the search radius. Default is empty.
  14. featured: If set to ‘true’, only featured listings are shown. If set to ‘false’, featured listings are hidden. If null, both featured and non-featured listings are shown. Default is null.
  15. custom_class: A custom CSS class to add to the listings. Default is empty.
  16. grid_columns: The number of columns to use in grid style. Default is ‘2’.
  17. in_rows: Determines whether to display the listings in rows. Default is empty.
  18. ajax_browsing: If set to ‘on’, enables AJAX browsing for the listings. Default is the value of ‘listeo_ajax_browsing’ option.
  19. from_vs: This attribute is used internally and should not be set manually.

Here’s an example of how to use the shortcode with some of these attributes:

[listeo_search_form]

The [listeo_search_form] shortcode is used to display a search form on a page. This form allows users to search through listings. Here’s a brief documentation for how to use this shortcode based on the output_search_form function:

The [listeo_search_form] shortcode accepts several attributes:

  1. source: Determines the source of the search form. Can be ‘sidebar’, ‘home’, or ‘split’. Default is ‘sidebar’. You can define custom sources by creating new forms in Listeo Editor -> SearchForms
  2. wrap_with_form: If set to ‘yes’, the search form is wrapped with a <form> tag. Default is ‘yes’.
  3. custom_class: A custom CSS class to add to the search form. Default is empty.
  4. action: The action attribute for the form. Default is empty.
  5. more_trigger: If set to ‘yes’, a button for additional features is displayed. Default is ‘yes’.
  6. more_text_open: The text for the ‘open’ state of the additional features button. Default is ‘Additional Features’.
  7. more_text_close: The text for the ‘close’ state of the additional features button. Default is ‘Additional Features’.
  8. more_custom_class: A custom CSS class to add to the additional features button. Default is ‘margin-bottom-10 margin-top-30’.
  9. more_trigger_style: The style of the additional features button. Default is ‘relative’.
  10. ajax_browsing: If set to ‘on’, enables AJAX browsing for the search form. Default is the value of ‘listeo_ajax_browsing’ option.
  11. dynamic_filters: If set to ‘on’, enables dynamic filters for the search form. Default is ‘off’ if ‘listeo_dynamic_features’ option is not set to ‘on’.
  12. dynamic_taxonomies: If set to ‘on’, enables dynamic taxonomies for the search form. Default is ‘off’ if ‘listeo_dynamic_taxonomies’ option is not set to ‘on’.

Here’s an example of how to use the shortcode with some of these attributes: