Author Archive

Default gallery style on listing page

There are 3 gallery styles available on single listing page however slider above listing content works only if there are more than 3 images added by listing owner. It’s made intentionally because gallery on top with 1-3 photos would looks bad. 🙂


Grid gallery


Slider in listing content


Full-width slider above content

What are diffrences between “Guest” and “Owner” user roles?

Guest Account

This user role allows to make bookings, send private messages to other users and review listings.


Owner Account

This user role allows to add listings and booking services and manage them. Owners can’t review other listings.

Disabling User Roles

You can disable user roles in Listeo Core → Registration and by setting default user tole to subscriber in General → Settings

Looking to rename the roles? Check this method – How to change some texts/words?


Allowing updating user roles

Guests can upgrade to an Owner account in his dashboard but first you need to enable this feature in Listeo Core → Registration → Allow user to change his role in My Account page

Automatic Email & SMS Notifications

Listeo features automatic email and SMS notifications about following actions:

  1. Welcome Email (email that new users receives after registration)
  2. Listing Published (confirmation that listing has been published)
  3. New Listing (confirmation that listing has been submitted)
  4. Expired listing (reminder about expiring listing)
  5. Expiring listing in next 5 days (reminder about expiring listing)
  6. Booking confirmation to user (confirmation to the user that his booking request has been sent)
  7. New booking request notification to owner (notification about new booking request to owner)
  8. Free booking confirmation to user (confirmation to the user that his free booking request has been approved)
  9. Booking approved – payment needed email to user (cconfirmation to the user that his booking request has been approved and it’s waiting for payment)
  10. Booking paid by user email to owner (notification to owner that user paid for booking)

You can customize content of those emails in Dashboard → Listeo Core → Emails

You can also use following variables in message content:

  1. {user_name} – guest or owner username
  2. {payment_url} – link to the checkout page
  3. {expiration} – time when payment link will expire
  4. {listing_name} – listing name
  5. {dates} – booked dates
  6. {details} – amount of ordered tickets or guests

Email template preview:

Theme Visual Options

Visual theme options are available customizer. Click “Customize” button in WordPress top bar to access settings.
You can also access it from WordPress admin dashboard: Appearance → Customize → Site Identity

Browse through options on the left and adjust them to your needs:


Appearance → Customize → Header

Header Settings
Setting Description Options
Header with Search Form Globally enable the Header with Search Form for all pages. Enable / Disable
Sticky Header Globally enable the sticky header for all pages. Enable / Disable
Display Cart in Header Display the shopping cart in the header. Enable / Disable
Display “My Account” Button in Header Display the “My Account” button in the header. Enable / Disable
Display “Add Listing” Button in Header Display the “Add Listing” button in the header. Enable / Disable
Full Width Header Enable a full-width header layout. Enable / Disable
Side Menu Social Icons

This setting applies to the Header with Search Form and side-moving menu or mobile menu.

Social Icon Slot Description
Icon 1 Configure the first social media icon.
Icon 2 Configure the second social media icon.
Icon 3 Configure the third social media icon.
Icon 4 Configure the fourth social media icon.
“Add New” Social Icon Add an additional social media icon.


Appearance → Customize → Listing List Options

Archive Page Related Options
Setting Description Options Default
Listings Per Page Number of listings displayed per page. N/A 6
Author Archive Listings Per Page Number of listings displayed per page on author archives. N/A 3
Show Archive Title Display the archive title above listings. Enable / Disable N/A
Listings Archive Title Title displayed for the archive. N/A Listings
Listings Archive Subtitle Subtitle displayed for the archive. N/A Latest Listings
Choose Rating Display Style Style for displaying ratings. Stars / Numerical Stars
Choose Price Filter Tag Icon Icon for currency representation. N/A Tag
Map Listing Marker Style Marker style for maps. With Icons N/A
Listings Archive General Layout Layout for the archive page. Split Map/Content N/A
Listings Content Layout Content layout for archives. List List
Sidebar Side Applies if the layout includes a sidebar. N/A N/A
Default Background Image for Listings
Setting Description Options Default
Default Background Image Set a background image if no listing images are provided. No image selected / Select image No image selected
Top Buttons
Setting Description Options Default
Show Additional Buttons Before Listings Display extra buttons above listings. Enable / Disable N/A
Top Buttons Configuration Configure buttons like List/Grid (works with Ajax), Features Panel Filter, Radius Slider, and Orderby Dropdown. N/A N/A
Sort By Options
Setting Description Options Default
Sort By Options Sorting options available for listings. Highest Rated, Most Reviewed, Newest Listings, Oldest Listings, Alphabetically, Featured, Most Views, Verified, Upcoming Event, Random


Appearance → Customize → Typography

Body Font
Setting Description Default/Example Value
Font Family Choose the font family for the body text. Raleway
Font Variant Set the font variant. Regular
Font Size Set the font size. 15px
Font Color Choose the font color. Not specified
Text Align Set the text alignment. Left
Text Transform Apply text transformation styles. None
Line Height Define the line height. 27px
Letter Spacing Adjust the space between letters. 0
Headings (H1..H6) Font
Setting Description Default/Example Value
Font Family Choose the font family for headings (H1–H6). Raleway
Font Variant Set the font variant for headings. 500
Menu Font
Setting Description Default/Example Value
Font Family Choose the font family for menu text. Raleway
Font Variant Set the font variant for the menu text. Regular
Font Size Set the font size for menu items. 16px
Font Color Choose the font color for menu items. Not specified
Text Align Set the text alignment for menu text. Left
Text Transform Apply text transformation styles. None
Line Height Define the line height for menu items. Not specified

Appearance → Customize → Footer Options

Setting Description Options / Default
Copyrights Text Set the text or media for the footer copyright section. Default: ©. All Rights Reserved.
Footer Widgets Layout The total width of the footer is 16 columns. Configure the layout by assigning columns to widget areas. Example Layout: 5
Footer Style Choose the overall style for the footer. Options: Light / Dark
Social Icons: Icon 1 Configure the first social media icon. N/A
Social Icons: Icon 2 Configure the second social media icon. N/A
Social Icons: Icon 3 Configure the third social media icon. N/A
Social Icons: Icon 4 Configure the fourth social media icon. N/A
“Add New” Social Icon Add an additional social media icon to the footer. N

Appearance → Customize → Site Identity

Site Title and Tagline
Setting Description Default
Site Title The title of your website. Listeo
Tagline A short description or tagline for your site. Directory & Listings WP Theme
Logo Settings
Setting Description Actions/Default
Logo Image Upload the main logo for your website. Upload / Remove / Change File
Transparent Header / Dashboard Logo Image Upload a logo for the transparent header or user dashboard. Upload / Remove / Change File
Alternative Header Sticky Logo Image Upload a logo to be used in the sticky header. Upload / Remove / Change File
Logo Max Height Set the maximum height of the logo in pixels. 38px
Sticky Header Logo Width Set the width of the sticky header logo in pixels. 120px
Menu Margins
Setting Description Default
Menu Top Margin Adjust the top margin of the menu (in px). 0px
Menu Bottom Margin Adjust the bottom margin of the menu (in px). 0px
Site Icon (Favicon)
Setting Description Preview / Notes
Site Icon The icon displayed in browser tabs, bookmark bars, and WordPress mobile apps. It must be square and at least 512×512 pixels. File Name: cropped-Untitled-1-2.png
App Icon Preview: The current image has no alternative text.
Actions Manage your site icon. Upload / Remove / Change Image

Appearance → Customize → Colors

Setting Description Options / Default
Enable Dark Mode Color Enable or disable dark mode for the site. Options: Enable / Disable
Listeo Dashboard Color Scheme Choose the color scheme for the dashboard. Options: Dark / Light
Select Main Theme Color Choose the primary color used for the theme. Options: Select Color
Enable Custom Header Colors Enable or disable custom colors for the header. Options: Enable / Disable
Enable Custom Colors for Mobile Menu Enable or disable custom colors specifically for the mobile menu. Options: Enable / Disable
Enable Custom Footer Colors Enable or disable custom colors for the footer. Options: Enable / Disable

Coming Soon Page

If you would like to use “Coming Soon” page first you have to create a page in Pages → Add New with “Coming Soon” template in “Page Attributes”.

Then you have to set “Coming Soon” page as a homepage in Settings → Reading

To make sign-up form working you need to create sign-up form at mailchimp and paste action URL and hidden input ID: https://mailchimp.com/help/host-your-own-signup-forms/

To configure the coming soon sign up form, login to you https://mailchimp.com account and go to Campaigns -> Create Campaign -> Signup Form -> Embedded form, choose your audience and click Begin. You will be presented with configuration screen where’s a bunch of code in the Copy/Paste Section.
I’ve marked on screenshot below the parts you need to extract to put in Page Settings in Listeo

Claim Listing

What is Claim Listing feature?

The claim listing feature in Listeo allows users to claim ownership of existing listings on your directory website. This feature enhances user engagement and ensures the accuracy of the directory information by allowing listing owners to manage and update their listings, and also allows you to monetize it as you can enable paid claims and integrate it with Listing Packages

You will find settings in Listeo Core → Claim Listings Options

Available options:

  1. Enable Paid Claims option – adds package option so any user that claims the listing has to pay first for package to get it
  2. Allow registration in Claim Listing popup – by default packages are for logged in users, but if you want to allow anyone to claim the package, enable that option, it will add registration fields (based on Listeo Core -> Registration) to your claim form and new users will be registered during the claim process
  3. Add File Upload option to claim listing form – if you need your users to upload additional document to verify ownership enable that option, then the uploaded file will be attached to claim request
  4. Exclude packages from claim selection –  by selecting any of those items you will exclude them from Claim package option, in case you maybe don’t want to claim listings with free packages etc.

There’s also long list of option for emails, as each action regarding the claim status etc can sent email notification, so be sure to check those settings in Listeo Core → Claim Listings Options

Each listing shows Claim button in the sidebar that opens a popup with form.


How it Works

  1. Claim Submission: Users can submit a claim for ownership of a listing by providing necessary details such as their contact information, proof of ownership, and any additional supporting documents.
  2. Verification Process: Upon receiving a claim submission, site administrators or moderators review the provided information to verify the legitimacy of the claim.
  3. Approval or Rejection: Based on the verification process, the claim is either approved or rejected. If approved, the user gains ownership of the listing and can manage it accordingly. If rejected, the user is notified with a reason for rejection.

In WordPress Dashboard → Claims you will see a list of all claims submitted for your listings

By opening any of those in admin you will see details about the claim:

you will have to take action for such request by changing it status:

By default, all new claims come with the status “pending”.

You can change it to Approved, Rejected, or Completed:

  1. Approved – Setting the status as Approved will generate a WooCommerce Order for the package and assign the listing to that package. The user will be notified by email about the new payment with a link to it. By paying for that order, they will automatically claim the listings. The system will assign the new package to their account and transfer the ownership of the claimed listings. (The WooCommerce Order status has to be set as Completed). Listings will be set as “verified”.
  2. Completed – In case you don’t use Paid Claims, or don’t want the user to pay via the website, you can set it directly as Completed. This will also automatically change the ownership of the listing to the new user. Listings will be set as “verified”.
  3. Rejected –This will notify the user about their claim being rejected. You can delete the claim after that.

Make sure to enable and configure emails for all those actions in Listeo Core → Claim Listings


Manual Verification

Site administrator can manually verify listing by editing listing from the site admin account and ticking “Verified Listing” checkbox.

If necessary you can change listing ownership (assign listing to another user) with using “Quick Edit”:

 

Contact Form

Listeo uses  Contact form 7 plugin for contact form, and it’s recommended one. After installing this pugin go to Contact → Add new (or edit current one) and in Form field paste what’s below:

<div class="row">
<div class="col-md-6">
<div>[text* name placeholder "Your Name"]</div>
</div>
<div class="col-md-6">
<div>[email* email placeholder "Email Address"]</div>
</div>
<div class="col-md-12">

<div>[text* subject placeholder "Subject"]</div>
</div>
</div>

<div>[textarea* id:comments textarea-69 placeholder "Message"]</div>
[submit "Send"]

Than at the top of page you’ll see shortcode, for example  (it will have different ID on your website):

[contact-form-7 id="123" title="Contact Form"]

Use it on a page you want to have contact form.


Office address and location

You can configure it by adding or editing “map address box” element in WP Bakery Page Builder.

 

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 or hCaptcha and configure other features.

To configure Google reCAPTCHA
Go there www.google.com/recaptcha/admin 

To configure hCaptcha API key:​
1.  Signup or login on the hCaptcha Dashboard
2. Go to the Sites tab in the dashboard and create a new sitekey.
3. Go to the Settings tab in the dashboard and generate your secret key by clicking Generate New Secret


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/


Shortcodes

You can use following shortcodes to display login/register form in different palces

  1. [listeo_login_form] – displays both login and register in a tabs
  2. [listeo_login] – only login form
  3. [listeo_registration] – only register forms


Redirecting to custom login page

Redirecting to custom login page unlogged users