Author Archive

Registration / Login Page

To enable user registration on your page, please first enable it in your WordPress: Settings → General → Membership – and check the “Anyone can register” option.

Once you enabled registration on your website create you can configure registration page in  Listeo Core → Registration

You can enable there privacy policy checkbox, reCAPTCHA and configure other features.

To configure Google reCAPTCHA you have to create reCAPTCHA v2 API key (not v1 or v2 😉 ) there www.google.com/recaptcha/admin 

Social Login

If you want to use Social Login we integrated Listeo with WordPress Social Login plugin

How to enable social login?

https://wordpress.org/plugins/wordpress-social-login/

Categories and Features

This is explanation of ‘Dynamic Features’ option, This option is switchable in Listeo Core -> Browse Listings -> Make “features” taxonomy related to categories.
This option will make Features filter load only features terms that are assigned to selected category/ies.

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

You can configure global categories (user who adds listing will see them in submission form no matter what listing type he selected) or create custom categories for each listing type (different categories for events, different for services etc.).

You can create separated listing features list for each category.

Radius Search

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

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

How to get Google API Key?

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

How to verify if Geocoding is working?

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

 

Search Results Layout

Listeo features many variations of search results page layout. You can configure it in Appearance → Customize → Listings List Options under Listing Archive General Layout option.

Available Layouts

  1. List Layout
    1. List Layout + Sidebar
    2. Full-Width List Layout + Search Bar on Top
    3. Full-Width List Layout + Map on Top
  2. Grid Layout
    1. Grid Style 1 + Sidebar
    2. Grid Style 2 + Sidebar
    3. Full-Width Grid Layout + Search Bar on Top
    4. Full-Width Grid Layout + Map on Top
  3. Half Screen Map

    1. List Layout
    2. Grid Layout 1
    3. Grid Layout 2

Commissions and Wallet

How booking payments work in Listeo

Because there’s no easy way to set payment methods per user in WooCommerce, you as site admin are the only user that can do that so you are receiving payments for the Booking Requests paid by guests. Each order is tracked and stored in WordPress Dashboard → Commissions, where you will now how much you have to transfer back to listing owner.

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

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

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

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

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

Payouts can be managed in Dashboard → Commissions.

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

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

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

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

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

Paid Listing Packages

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

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

How to add product package?

Listeo has monetization functionality. It’s using WooCommerce to give you opportunity to be able to earn money. You can require users to buy a listing package before submitting a listing.

To create packages install and configure WooCommerce on your WordPress (it’s already done if you’ve used our Setup Wizard)

In Products → Add new, change the Product Type to “Listing Package“. Now you can describe package and configure it.

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

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

Renewable/Subscription Support for Listing Packages

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

Extra Listing Package Options

Since version 1.6 we’ve added option to limit some of the listing functionality/elements and enable them using packages.

The current list of options is:

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

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

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

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

How to make pricing package featured?

Listing Package Manager

If you want to edit/add/manage listing packages sold on your site, you can edit them in Listeo Editor -> Packages Manager

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

Add Listing Form Editor

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

You will find drag&drop editor in Listeo Editor → Add Listing Form
and fields customizer in Listeo Editor → Fields

Data from newly created custom fields will be displayed in listing overview. Those fields will be also available in search forms editor so you will be able to create search form filters for your custom fields.

Search Forms Editor

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

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

On the right side you have searchable elements and you have to drag them to the left side where you want to display them.

For example you can change default select dropdown to multi select as seen on sample below (Events, Other categories). You can also choose between default filter placement and filter in dropdown (price filter in sample below). In “Search on Half Map” you can additonaly set the width of field.

How does search by location works?

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

If the API key is added (and configured properly – it can’t be restricted) the address typed in ‘location’ field is geocoded to latitude and longitude and all properties that are in the selected radius of that point are returned in search results. The radius  value can be set by default in Listeo Core options (it’s 50km by default).

The search function creates a debug file named geocode.txt in your wp-content folder – if you think the geolocation doesn’t work or results are incorrect, please first check this file for any messages from API

If there’s no API key added the search is strictly text based, the text typed by user is compared to the content of property, property title, and every custom field attached to property to find matching results.

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

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

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

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