This documentation provides all the details you need to use the DreamSalon theme, understand how DreamSalon 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.
To use the DreamSalon 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.
- WordPress Before Install – general info before you install WordPress.
- WordPress Requirements – general info for WordPress requirements.
- WordPress Installation – general info about WordPress and installation instructions.
- WordPress Lessons – general lessons for WordPress.
To use the DreamSalon 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.
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 DreamSalon theme.
The downloaded package contains:
- dreamsalon.zip – the installable parent theme file
- dreamsalon-child.zip – the child theme (use this for all customisations)
- documentation/ – this documentation
The DreamSalon Core and DreamSalon Widgets plugins are bundled inside the theme at dreamsalon/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).
Step 1:
Log into your web server with FTP client software (e.g., FileZilla).
Step 2:
Unzip the downloaded package. Locate dreamsalon.zip inside the package and unzip it to get the dreamsalon theme folder.
Step 3:
Upload the extracted dreamsalon theme folder to wp-content/themes/ on your server.
Step 4:
Activate the theme. Go to Appearance → Themes and click Activate on DreamSalon.
Step 5 – Install bundled plugins via FTP:
The downloaded package includes a /dreamsalon/inc/tgm-plugin-activation/ folder containing the DreamSalon Core and DreamSalon 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.
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 |
|---|---|---|---|
| DreamSalon Core | Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) |
1.0 | Bundled with theme |
| DreamSalon Widgets | Bundled inside theme — auto-prompted via TGM Plugin Activation (inc/tgm-activation-plugin/) |
1.0 | Bundled with theme |
| Redux Framework | WordPress.org | 4.4.x | Free |
| WooCommerce | WordPress.org | 8.x | Free |
| Elementor | WordPress.org | 3.x | Free |
| One Click Demo Import | WordPress.org | 3.x | Free |
| Contact Form 7 | WordPress.org | 5.x | Free |
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.
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 the demo import times out or shows a white screen, try the following:
- Add
define( 'WP_MEMORY_LIMIT', '512M' );to yourwp-config.phpfile. - Ask your host to set
max_execution_timeto 300 or higher. - Re-run the import from Appearance → Import Demo Data.
- If images are missing after import, go to Tools → Import and re-run the media import.
The downloaded package is organised as follows. All custom modifications should be made in the dreamsalon-child theme — never edit the parent theme files directly, as they will be overwritten on update.
dreamsalon-package/
├── dreamsalon.zip ← Installable parent theme
├── dreamsalon-child.zip ← Installable child theme (use for all customisations)
└── documentation/ ← This documentationThe DreamSalon Core and DreamSalon Widgets plugins are bundled inside the theme at dreamsalon/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.
Never modify files inside the dreamsalon/ parent theme folder directly. Always use the dreamsalon-child theme or WordPress hooks/filters for customisations.
A child theme is required for any customisations you want to survive theme updates. The download package includes a pre-built child theme — dreamsalon-child.zip — which you should install and activate instead of modifying the parent theme directly.
Installing the Child Theme
- Go to Appearance → Themes → Add New → Upload Theme.
- Upload
dreamsalon-child.zipand click Install Now. - Click Activate. The parent DreamSalon 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
/**
* DreamSalon Child Theme functions.php
*/
add_action( 'wp_enqueue_scripts', 'dreamsalon_child_enqueue_styles' );
function dreamsalon_child_enqueue_styles() {
wp_enqueue_style(
'dreamsalon-parent-style',
get_template_directory_uri() . '/style.css'
);
wp_enqueue_style(
'dreamsalon-child-style',
get_stylesheet_uri(),
array( 'dreamsalon-parent-style' )
);
}In this theme, we have three different header styles. You can select your preferred header style by navigating to Appearance → Theme Options → Header .
To change the header style for a specific page, go to Pages → Quick Edit → Header Style and choose the option you want.
You can select the Login Page, Register Page, Forgot Password Page, and Terms & Conditions Page from the theme options.
In this theme, we have three different header styles. You can select your preferred header style by navigating to Appearance → Theme Options → Header .
To change the header style for a specific page, go to Pages → Quick Edit → Header Style and choose the option you want.
You can select the Login Page, Register Page, Forgot Password Page, and Terms & Conditions Page from the theme options.
In this theme, we have three different footer styles. You can select your preferred footer style by navigating to Appearance → Theme Options → Footer.
To change the footer style for a specific page, go to Pages → Quick Edit → Footer Style and choose the option you want.
You can also add footer menus, copyright text, and a newsletter section.
In the Dashboard, you can add or modify the "Why Book Us" icons and list. You can find this option under Services → Why Book Us.
Add the feature name, select an icon, and click the Save button.
Click the Edit button to modify an existing "Why Book Us" item.
These "Why Book Us" features are displayed on the Service Details pages.
In the Dashboard, you can add or manage staff members. This option is available under Services → Staff.
When adding a staff member, you can enter their first name, last name, username, email, category, and branch.
After creating a staff account, the user will receive an email to set or reset their password.
Create a page for the dashboard and add the [DreamSalon_dashboard] shortcode in the page content. Save the page and then assign it as the Dashboard Page under Appearance → Theme Options → Service.
User Roles & Permissions
DreamSalon uses three user roles. Each role sees a different view of the dashboard:
| Role | Dashboard Access |
|---|---|
| Administrator | Full access: manage all bookings, services, staff, branches, categories, amenities, and reports. |
| Staff | View and manage their own assigned bookings and schedule. Cannot manage other staff or global settings. |
| Customer | View their own booking history, upcoming appointments, and profile settings. |
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:
- Customer selects a service, staff member, date, and time slot.
- Customer clicks the Add to Cart button to add the appointment to the WooCommerce cart.
- Customer completes checkout using any configured payment gateway.
- 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.
This theme is compatible with WooCommerce High-Performance Order Storage (HPOS). Ensure HPOS is enabled under WooCommerce → Settings → Advanced → Features for best performance.
1. Demo content import fails or times out
This is almost always a server resource limitation. Try the following:
- Add
define( 'WP_MEMORY_LIMIT', '512M' );to yourwp-config.phpbefore the line "That's all, stop editing!". - Ask your host to increase
max_execution_timeto 300 andupload_max_filesizeto 256M. - Ensure all 7 required plugins are installed and activated before running the import.
- Re-run the import from Appearance → Import Demo Data.
- 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:
- Install a free SMTP plugin such as WP Mail SMTP.
- Configure it with your email provider's SMTP credentials (Gmail, SendGrid, Mailgun, etc.).
- Use the plugin's Test Email feature to confirm delivery.
- Check your spam folder — some hosts deliver to spam before SMTP is configured.
3. Payment is not processing / WooCommerce errors
- Confirm WooCommerce is installed and active (version 8.0 or higher).
- Go to WooCommerce → Settings → Payments and ensure at least one payment gateway is enabled and configured.
- If using Stripe, ensure your API keys are entered and the gateway is set to Live mode (not Test) for real transactions.
- 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:
- Going to Settings → Permalinks in WordPress Admin.
- Without changing any settings, click Save Changes. This flushes the rewrite rules.
- If the issue persists, confirm the correct page is assigned under Appearance → Theme Options → Service.
5. PHP memory or white screen errors
- Add
define( 'WP_DEBUG', true );anddefine( 'WP_DEBUG_LOG', true );towp-config.phpto enable logging. Check the log atwp-content/debug.log. - Increase PHP memory: add
define( 'WP_MEMORY_LIMIT', '512M' );towp-config.php. - Deactivate all non-DreamSalon plugins one by one to check for plugin conflicts.
- 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.
DreamSalon 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?
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.
| 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 |
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 SupportImportant 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.
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.
Thank You
Thank you once again for downloading DreamSalon.
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.