Documentation

  • Home
  • Documentation
Listee Banner

Introduction

This documentation provides all the details you need to use the Listee theme, understand how Listee is structured, and perform the most common tasks. If you require further assistance on topics not covered in this documentation, please contact us via our support forum.

We assume that you already have WordPress installed and ready to use. If you do not, please see the WordPress Instructions section below to help you get started.

WordPress Instructions

To use the Listee theme, you need WordPress 6.4 or higher, PHP 8.0 or higher, and MySQL 5.6 or higher. Apart from the necessary WordPress requirements, the following server configuration settings are recommended to ensure the theme works properly.

Requirement

To use the Listee WP theme, you need WordPress 6.4 or higher, PHP 8.0 or higher, and MySQL 5.6 or higher. This theme has been tested on PHP 8.0, 8.1, and 8.2. PHP 7.x is not supported. In addition to the necessary WordPress requirements, the following server configuration settings are recommended to ensure the theme works properly.

  • WordPress – Version 6.4 or higher (tested up to 6.7)
  • PHP – Version 8.0 or higher (PHP 8.2 recommended)
  • MySQL – Version 5.6 or higher ( OR MariaDB version 10.1 or higher)
  • memory_limit – 512M or higher
  • max_execution_time – 300 or higher
  • upload_max_filesize – 256M or higher

If you are not sure about your current server configuration, you can use the following guide to adjust the settings as needed. Changing server requirements. We still recommend contacting your hosting provider for assistance with these changes.

Features

  • Creative Design
  • Fully Responsive
  • W3C Validated Code
  • Bootstrap 5.x used
  • Compatible Browsers: Chrome (latest), Firefox (latest), Safari (latest), Edge (latest), Opera (latest). Internet Explorer is ot supported
  • Font Awesome icons
  • Feather icons
  • Easy to Customize

Installation Guide

We assume that your WordPress website is already set up. The next step is to install the theme. To get started, download the full package from your Envato / ThemeForest Downloads page and locate the Listee theme.

The downloaded package contains:

  • listee.zip – the installable parent theme file
  • listee-child.zip – the child theme (use this for all customisations)
  • documentation/ – this documentation
How bundled plugins work

The Listee Core and Listee Widgets plugins are bundled inside the theme at listee/inc/tgm-activation-plugin/. They are registered and installed automatically via the TGM Plugin Activation library. You do not need to upload these plugins manually — WordPress will prompt you to install them as required plugins immediately after you activate the theme.

There are two ways to install the theme in your WordPress environment:

FTP Client:

You can use an FTP client (e.g., FileZilla) to upload the theme and plugins directly to your server.

Through WordPress Admin:

You can install it directly using the WordPress theme upload interface (recommended for most users).

FTP Installation

Step 1:

Log into your web server with FTP client software (e.g., FileZilla).

Step 2:

Unzip the downloaded package. Locate listee.zip inside the package and unzip it to get the listee theme folder.

Step 3:

Upload the extracted listee theme folder to wp-content/themes/ on your server.

Step 4:

Activate the theme. Go to Appearance → Themes and click Activate on Listee.

Step 5 – Install bundled plugins via FTP:

The downloaded package includes a /listee/inc/tgm-plugin-activation/ folder containing the Listee Core and Listee Widgets plugin ZIPs. Unzip each and upload the extracted plugin folders to wp-content/plugins/. Then activate each plugin via Plugins → Installed Plugins in WordPress Admin.

WordPress Installation

Step 1:

Navigate to Appearance > Themes

Step 2:

Click Install Themes and hit the upload button.

Step 3:

Navigate to find the “listee.zip” file on your system and click “Install Now”

Step 4:

Activate the newly installed theme. Go to Appearance > Themes and activate it.

Demo Content

Before you start importing the demo content, make sure you have installed all the required plugins so that the demo content imports properly. Install and activate each plugin one at a time in the order listed below.

Note: Install & Activate plugins one by one in the order shown.

Plugin Name Source Version Tested Free / Premium
Listee Core Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.2.0 Bundled with theme
Listee Form Field Editor Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.2.0 Bundled with theme
Listee Elementor Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.2.0 Bundled with theme
Listee Shortcode Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.0 Bundled with theme
WooCommerce WordPress.org 10.6.1 Free
Elementor WordPress.org 3.35.9 Free
One Click Demo Import WordPress.org 3.4.0 Free
Contact Form 7 WordPress.org 6.1.5 Free
One Click Demo Import plugin activation screen Listee demo import screen

To import the demo, go to Appearance → Import Demo Data. Click Import Demo Data, then click the Import Demo button and wait a few minutes for the process to complete.

Important

After importing the demo content, go to Elementor → Settings → Features Tab → Inline Font Icons and change the setting from DEFAULT to INACTIVE. This is required for icons to render correctly.

If Import Fails

If the demo import times out or shows a white screen, try the following:

  1. Add define( 'WP_MEMORY_LIMIT', '512M' ); to your wp-config.php file.
  2. Ask your host to set max_execution_time to 300 or higher.
  3. Re-run the import from Appearance → Import Demo Data.
  4. If images are missing after import, go to Tools → Import and re-run the media import.

Theme File Structure

The downloaded package is organised as follows. All custom modifications should be made in the listee-child theme — never edit the parent theme files directly, as they will be overwritten on update.

listee-package/
├── listee.zip            ← Installable parent theme
├── listee-child.zip      ← Installable child theme (use for all customisations)
└── documentation/            ← This documentation
Bundled plugins

The Listee Core and Listee Widgets plugins are bundled inside the theme at listee/inc/tgm-activation-plugin/. There is no separate plugins folder in the download package. After you activate the theme, WordPress will automatically display a prompt to install these required plugins via the TGM Plugin Activation library.

Important

Never modify files inside the listee/ parent theme folder directly. Always use the listee-child theme or WordPress hooks/filters for customisations.

Child Theme

A child theme is required for any customisations you want to survive theme updates. The download package includes a pre-built child theme — listee-child.zip — which you should install and activate instead of modifying the parent theme directly.

Installing the Child Theme
  1. Go to Appearance → Themes → Add New → Upload Theme.
  2. Upload listee-child.zip and click Install Now.
  3. Click Activate. The parent Listee theme must also be installed (but does not need to be active).
Child Theme functions.php — Minimum Setup

The child theme's functions.php correctly enqueues the parent theme styles. The essential code is:

<?php
/**
 * Listee Child Theme functions.php
 */
add_action( 'wp_enqueue_scripts', 'listee_child_enqueue_styles' );
function listee_child_enqueue_styles() {
    wp_enqueue_style(
        'listee-parent-style',
        get_template_directory_uri() . '/style.css'
    );
    wp_enqueue_style(
        'listee-child-style',
        get_stylesheet_uri(),
        array( 'listee-parent-style' )
    );
}

Logo Change

You can change the website logo by navigating to Appearance → Theme Options → General Settings.

Under the Logo for the Main Website field, click Upload to add your new logo and Remove to delete the existing one.

Once done, click Save Changes to apply the logo update to your site.

Login

Admin can view and manage login options from the Theme Options → Login section.

You can assign the Login Page by selecting the page that holds the [listee_login] shortcode.

You can also customize the Login Heading Screen Text and the Paragraph displayed on the login page to match your site's branding.

Register

Admin can manage registration options from the Theme Options → Register section.

You can assign the Register Page, set the Default Role for new users, and toggle the Hide Username Field in the registration form.

You can also customize the Register Heading Screen Text and the Paragraph displayed on the register page to match your site's branding.

Forgot Password

Admin can manage forgot password options from the Theme Options → Forgot Password section.

You can assign the Forgot Password Page and Reset Password Page by selecting the pages that hold their respective shortcodes.

You can also customize the Forgot Password Heading Text and the Paragraph displayed on the forgot password page to guide users through the reset process.

Pages Settings

Admin can manage all page assignments from the Theme Options → Page Links section.

You can assign pages for Dashboard, My Profile, Add Listing, My Listings, My Favourites, and My Messages by selecting pages that hold their respective shortcodes.

You can also assign pages for My Reviews and Terms and Conditions to complete the user navigation flow on your site.

Services Settings

Admin can view and manage all services from the Services → All Services section.

You can filter services by Date and Category to find specific listings quickly, and add new ones using the Add Listing button.

Each service displays the Title, Author, Type, Address, Posted Date, and Expires date for easy management.

Service Add Form

Admin can manage the listing form fields from the Listee Editor → Add Listing Form section.

The form is organized into sections including Basic Information, Price Information, Location Information, Contact Information, Social Information, and Media Information.

You can add new fields to each section using the Add New Field button, add new sections using Add New Section, and click Save Changes to apply all updates to the listing form.

Language Module

You can manage the wordpress language settings.

Step 1 : Please install Loco Translate Click here

Step 2 : Translate your theme

Step 3 : Translate your theme required plugins same like theme

Note : Please refer the right side image for your reference

RTL

RTL to change Right to left.

To enable RTL mode go to Settings → General → Site Language and select your preferred right-to-left language from the dropdown.

Once the language is set, the site layout will automatically switch to Right to Left direction.

WooCommerce Payments

WooCommerce Version: This theme requires WooCommerce 8.0 or higher. All booking appointments are processed as WooCommerce cart items, allowing you to use any WooCommerce-compatible payment gateway.

How the Integration Works: When a customer completes the booking flow and clicks Add to Cart, the appointment details are attached to a WooCommerce cart item. The customer then proceeds through the standard WooCommerce checkout. On payment confirmation, the booking status is automatically updated to Confirmed and notification emails are dispatched.

Appointment Booking Process:

  1. Customer selects a service, staff member, date, and time slot.
  2. Customer clicks the Add to Cart button to add the appointment to the WooCommerce cart.
  3. Customer completes checkout using any configured payment gateway.
  4. On successful payment, the booking is confirmed and both the customer and staff receive a notification email.

Payment gateways can be configured under WooCommerce → Settings → Payments. Commonly used gateways:

  • PayPal Standard – general information on PayPal payment setup.
  • Stripe – general information on Stripe payment setup.
  • Razorpay – general information on Razorpay payment setup.
Note

This theme is compatible with WooCommerce High-Performance Order Storage (HPOS). Ensure HPOS is enabled under WooCommerce → Settings → Advanced → Features for best performance.

Troubleshooting

1. Demo content import fails or times out

This is almost always a server resource limitation. Try the following:

  1. Add define( 'WP_MEMORY_LIMIT', '512M' ); to your wp-config.php before the line "That's all, stop editing!".
  2. Ask your host to increase max_execution_time to 300 and upload_max_filesize to 256M.
  3. Ensure all 7 required plugins are installed and activated before running the import.
  4. Re-run the import from Appearance → Import Demo Data.
  5. If images are missing after import, go to Tools → Import → WordPress and re-run the WordPress importer choosing to download and import attachments.
2. Booking confirmation emails are not being sent

WordPress uses PHP's mail() function by default, which many hosts block. To fix this:

  1. Install a free SMTP plugin such as WP Mail SMTP.
  2. Configure it with your email provider's SMTP credentials (Gmail, SendGrid, Mailgun, etc.).
  3. Use the plugin's Test Email feature to confirm delivery.
  4. Check your spam folder — some hosts deliver to spam before SMTP is configured.
3. Payment is not processing / WooCommerce errors
  1. Confirm WooCommerce is installed and active (version 8.0 or higher).
  2. Go to WooCommerce → Settings → Payments and ensure at least one payment gateway is enabled and configured.
  3. If using Stripe, ensure your API keys are entered and the gateway is set to Live mode (not Test) for real transactions.
  4. Check WooCommerce → Status → Logs for error messages related to payment failures.
4. Booking or Dashboard pages return a 404 error

This is almost always a permalink issue. Fix it by:

  1. Going to Settings → Permalinks in WordPress Admin.
  2. Without changing any settings, click Save Changes. This flushes the rewrite rules.
  3. If the issue persists, confirm the correct page is assigned under Appearance → Theme Options → Service.
5. PHP memory or white screen errors
  1. Add define( 'WP_DEBUG', true ); and define( 'WP_DEBUG_LOG', true ); to wp-config.php to enable logging. Check the log at wp-content/debug.log.
  2. Increase PHP memory: add define( 'WP_MEMORY_LIMIT', '512M' ); to wp-config.php.
  3. Deactivate all non-listee plugins one by one to check for plugin conflicts.
  4. Switch temporarily to a default WordPress theme (e.g., Twenty Twenty-Four) to rule out theme-level conflicts.
6. Elementor icons not rendering correctly after demo import

Go to Elementor → Settings → Features Tab → Inline Font Icons and change the setting from DEFAULT to INACTIVE. This must be done after every demo import.

License

Listee is developed by Dreams Technologies and is available under both Envato Extended & Regular License options.

Regular License

Usage by either yourself or a single client is permitted for a single end product, provided that end users are not subject to any charges.

Extended License

For use by you or one client in a single end product for which end users may be charged.

What are the main differences between the Regular License and the Extended License?

Note

If you operate as a freelancer or agency, you have the option to acquire the Extended License, which permits you to utilize the item across multiple projects on behalf of your clients.

Credits

NAME URL
Bootstrap https://getbootstrap.com/docs/
jQuery https://jquery.com/
Fontawesome https://fontawesome.com/
Select2 https://github.com/select2/select2
Date Timepicker https://cdnjs.com/libraries/jquery-datetimepicker
Google Fonts https://fonts.google.com/
Fancy Box http://fancybox.net/
Moment JS https://momentjs.com/
theia-sticky-sidebar https://github.com/WeCodePixels/theia-sticky-sidebar
Range-Slider https://ionicframework.com/docs/api/range

Support

Need Support?

If this documentation does not address your questions, please feel free to contact us via email at support@dreamstechnologies.com

Reach the team at GMT+5:30. Typical reply within 12–24 hours on weekdays — rarely up to 48 hrs during holidays. Support is available to verified buyers for template-related issues.

Contact Support

Important Note : We strive to offer top-notch support, but it's only available to verified buyers and for template-related issues such as bugs and errors. Custom changes and third-party module setups are not covered.

Custom Work

Do you need a customized application for your business?

If you need a customized application for your business depends on your specific requirements and goals, Please contact us. Customization can be the key to success, ensuring your project perfectly aligns with your unique goals and requirements.

Don't Miss Out on the Benefits of Customization!

Unlock the potential of your project. It's time to ensure your project isn't another cookie-cutter solution but truly unique and effective one.

Discover how customization can make a difference in your project's success. Let's create a solution that's as unique as your vision!

We'll tailor the application to meet your specific needs and preferences.

We will upload your website to the server and ensure it is live.

Book an Appointment Get a Free Quote
thanks

Thank You

Thank you once again for downloading Listee.
We hope you're enjoying your experience, and we kindly request that you take a moment to share your valuable review and rating with us.

Review Link