Documentation

  • Home
  • Documentation
Truelysell Banner

Introduction

This documentation provides all the details you need to use the Truelysell theme, understand how Truelysell 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 Truelysell 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 Truelysell 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: IE8+, Firefox, Safari, Opera, Chrome
  • 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 Truelysell theme.

The downloaded package contains:

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

The Truelysell Core and Truelysell Widgets plugins are bundled inside the theme at truelysell/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 truelysell.zip inside the package and unzip it to get the truelysell theme folder.

Step 3:

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

Step 4:

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

Step 5 – Install bundled plugins via FTP:

The downloaded package includes a /truelysell/inc/tgm-plugin-activation/ folder containing the Truelysell Core and Truelysell 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 “truelysell.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
Truelysell Core Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 2.0.0 Bundled with theme
Truelysell Elementor Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.8.8 Bundled with theme
Truelysell - Forms & Fields Editor Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.0 Bundled with theme
Order auto complete for WooCommerce Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.0 Bundled with theme
Simple Shortcode Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) 1.0 Bundled with theme
Redux Framework WordPress.org 4.5.11 Free
WooCommerce WordPress.org 10.6.1 Free
Elementor WordPress.org 4.0.4 Free
One Click Demo Import WordPress.org 3.4.1 Free
Contact Form 7 WordPress.org 6.1.5 Free
One Click Demo Import plugin activation screen Truelysell 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 truelysell-child theme — never edit the parent theme files directly, as they will be overwritten on update.

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

The Truelysell Core and Truelysell Widgets plugins are bundled inside the theme at truelysell/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 truelysell/ parent theme folder directly. Always use the truelysell-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 — truelysell-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 truelysell-child.zip and click Install Now.
  3. Click Activate. The parent Truelysell 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
/**
 * Truelysell Child Theme functions.php
 */
add_action( 'wp_enqueue_scripts', 'truelysell_child_enqueue_styles' );
function truelysell_child_enqueue_styles() {
    wp_enqueue_style(
        'truelysell-parent-style',
        get_template_directory_uri() . '/style.css'
    );
    wp_enqueue_style(
        'truelysell-child-style',
        get_stylesheet_uri(),
        array( 'truelysell-parent-style' )
    );
}

Color Change

You can change the site's color scheme by navigating to Appearance → Customize → Colors section.

From here, you can set the Background Color, Primary Color, Primary Hover Color, and Secondary Color to match your brand.

You can also customize the Breadcrumb Color, Text Color, and Link Color to style your site perfectly.

Hero Section

You can add or edit the Hero Section by clicking Edit with Elementor from the front-end toolbar.

Click on the Truelysell Hero 1 widget to edit the Title, Sub-Title, and upload up to 4 shape images for the hero layout.

Once done, click Update to save and apply the changes to your homepage.

Meta Fields

Admin Commission

Admin can manage service payment splits through the Commissions section in the WordPress dashboard.

The Users Balances table displays each user's User ID, User Name, Balance to Pay, and Orders Counter.

Admin can process payments to service providers by clicking the Make Payout button against each user's record.

Bookings

Admin can view and manage all service bookings from the Booking → Manage Bookings section.

You can filter bookings by Listing, Client, and Owner to find specific records quickly.

Each booking displays the Client, Owner, Listing, Start Date, End Date, Type, and Price for easy management.

Services Settings

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

You can filter listings by Date and Category, and add new services using the Add New button.

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

Truelysell Core options

Truelysell Core is the core plugin that powers servcies and booking functionalities. You’ll find all the settings in Dashboard --> Truelysell Core

General Setting

This Field is responsible for changing currency symbols and currency positions and services sorting options and more.

You can manage the admin commission here you will set the admin commission fees.

Services Submit Settings

Admin can manage service submission settings from Truelysell Options → Submit Service section.

You can enable Admin Approval for new services, Admin Approval for editing services, and set up Email Notifications for new services waiting for approval.

You can also configure the Service Duration, Image Upload Limit, and Maximum Image Size for service listings from this section.

Single Service Settings

Admin can manage single service settings from Truelysell Options → Single Service section.

You can set the Default Gallery Type to control how images are displayed on the single service page.

You can also enable Allow Providers to Add Reviews and toggle the Disable Reviews on Services option based on your preference.

Service Search Options

Admin can manage service search settings from Truelysell Options → Browse/Search Options section.

You can enable or disable the Ajax Based Service Browsing to control how search results are loaded on the services page.

Once configured, click Save Changes to apply the search settings to your site.

Registration Settings

Admin can manage registration settings from Truelysell Options → Registration section.

You can configure options like Forced Front End Login, Login/Registration Form Type, Default Role, and Auto Login after Registration from this section.

You can also set the redirect pages for Provider and Customer after registration or login to control the user flow on your site.

Paypal Payout Settings

Admin can configure PayPal payout settings from Truelysell Options → PayPal Payout section.

You can activate the payout feature, select Live or Sandbox environment, and enter the PayPal Client ID and Client Secret for processing payments.

You can also customize the Email Subject, Email Message, and Transaction Note that are sent to service providers upon receiving their payout.

Pages Settings

Admin can manage all page assignments from Truelysell Options → Pages section.

You can assign pages for Dashboard, Messages, Bookings, My Services, Wallet, Payout, Reviews, and Bookmarks from this section.

You can also configure pages for Login, Register, Lost Password, Reset Password, and My Notifications to control the user flow on your site.

Email Settings

Admin can manage all email settings from Truelysell Options → Emails section.

You can set the From Name, From Email, and upload a Logo for Emails to customize the outgoing email appearance.

You can also configure email notifications for Registration, Service Booking, and Payment Received to keep users and admins informed automatically.

Add Service Section

Service providers can add a new service from the Dashboard → Add Service section on the frontend.

They need to fill in the Service Title, Category, Pricing, Description, Video, Phone, and set their Availability slots for each day of the week.

They can also set the Location, upload multiple Gallery Images, and add FAQ entries before clicking Submit to publish the service.

Staff Module

By using this section we can enable/disable staff module.

Theme Page Options

By using this section we can add the new page add shartcodes into content area.

Note : Page Template is must be Dashboard.

Add Staff

By using this section we can add the new staff which is listed on add service section to book the service by user

List Staff

By using this section we can list all the staff added into add section.

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.

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.

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-truelysell 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

Truelysell 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/
GLightbox https://biati-digital.github.io/glightbox/
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 Truelysell.
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