HomListi WordPress Theme Documentation
We would like to thank you for choosing HomListi WordPress theme.
You need at least WordPress version 5.4.2+ installed for this theme to work properly. It is strongly recommended that you always use the latest stable version of Wordpress to ensure all known bugs and security issues are fixed. Other requirements:
- PHP version 5.6 or greater. But for maximum speed gain we recommend you to use PHP version 7.4+.
- MySQL version 5.6 or greater OR MariaDB version 10.0 or greater.
- WordPress memory limit of 128 MB or greater.
Server Requirements: https://make.wordpress.org/hosting/handbook/handbook/server-environment
1.2. What's Included
After downloading HomListi theme, the entire theme package which contains the following files:
- HomListi theme: An Installable WordPress Theme zip file.
- HomListi child-theme: A child-theme zip file and a readme.txt note about the child-theme.
- Documentation: A link to this documentation.
2. WordPress Installation
Please follow the instructions in the video to see how you can install WordPress on your hosting:
3. Upload and Activate Theme
When you are ready to install a theme, you must first upload the theme files and then activate the theme itself. The theme files can be uploaded in two ways:
3.1. Using Theme Uploader
After that you need to install and activate the following pre-packaged plugins:
- Classified Listing Pro: Required and must install plugin.
- Classified Listing Free: Required and must install plugin.
- Classified Listing Store: Optional. Install if you want store functionality.
- HomListi Core: Required and must install plugin.
- Elementor Website Builder: Required. Page builder plugin.
- RT Framework: Required and must install plugin.
- RT Demo Importer: Required if you want to import demo contents. You can deactivate it after demo is imported.
- WP Fluent Forms: Optional. Install if you want to use contact form.
- Mailchimp for WordPress: Optional. Install email marketing.
- Smash Balloon Instagram Feed: Optional. Install if you want to use instagram feed for footer.
- Review Schema pro: Optional. Install for structured data to enhance your website in Google Search Results
- Review Schema free: Optional
N.B: All plugins must be installed and activated if you want your site to look exactly like demo.
Follow the steps as instructed in the images below:
3.2. Using FTP Clients
Follow the following steps to upload your theme using FTP clients:
- Use an FTP such as FileZilla and go to your WordPress installation director.
- Navigate to /wp-content/themes/ folder and upload the theme folder there.
- Log in to your WP Admin Dashboard and open the 'Appearance / Themes' menu.
- You will now see HomListi Theme listed among the other themes. Click on activate and you’re done!
4. Importing Demo Contents
We are providing you two methods for importing demo contents: Automatic and Alternative. You can follow either one of these methods.
- Automatic (Recommended): This method will remove all your existing data, so use this method only in fresh website. This procedure will be faster because you just have to do one click and then everything will happen automatically. If you want an exact clone of demo website without doing any manual configuration after importing data then this method is appropiate for you.
- Alternative: Use this method only if:
- Automatic demo import method fails ( Only few of our customers like 5% have experienced this issue due to their hosting limits, in that case we also provide free demo importing service if you contact with us).
- You already have a working website with existing contents(eg. posts, pages etc).
4.1 Automatic Import
Want to build your site like the demo? You can do it by only one click!
** Note: Before proceeding, please remember that when you are done with the demo import, all existing settings and contents will be removed and replaced by the demo contents. So it is highly recommended that you should only do this in fresh site. **
First please make sure that HomListi Parent Theme is activated on your site.
From Admin menu, navigate to Tools -> Demo Content Install. Or alternatively, navigate to Plugins -> RT Demo Importer -> Install Demo Contents.
In this page, Click on the Install button for installing the demo.
It will take some time for importing the demo contents.
After importing demo data, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.
If you face any issue in demo installation process please check the Troubleshooting Section(18) from here
4.2 Manual Import
Here's the steps:
- First install and activate plugin One Click Demo Import. Here's the plugin link: https://wordpress.org/plugins/one-click-demo-import/
- From Admin menu, navigate to Appearance -> Import Demo Data.
- On this page, click on the "Import" button for installing any demo. It will take some
time for importing the demo contents.
- After importing demo data, please update your permalink. To update
permalink, navigate to Settings -> Permalink and then click on Save
5. Properties Setup
We are using plugin Classified Listing Pro here for Real-estate functionalities and Classified Listing Store for Members(Agency/Agent) functionalities, so you can check the plugin documentations and tutorials from the plugin website.Here's the documentation link: https://www.radiustheme.com/docs/classified-listing/
And here's a video tutorial:
5.1 Yelp Settings
To enable yelp review go to Classified Listing > Setting -> General. Then go to bottom to get Yelp section.
After enable yelp review, you will get option to add category for each property Classified Listing > Add New
After adding category to a property, you will get this in property details page
5.2 Panorama (360° Virtual Tour) Settings
To enable 360° Virtual Tour go to Classified Listing > Setting -> General. Then go to bottom to get Panorama section.
After enable virtual tour, you will get option to add image for 360° view for each property Classified Listing > Add New
After adding image to a property, you will get this in property details page
5.3 Floor Plan Settings
To enable floor plan go to Classified Listing > Setting -> General. Then go to bottom to get Floor Plan section.
After enable floor plan, you will get option to add floor feature and image for a specific floor when adding property Classified Listing > Add New
After adding floor feature to a property, you will get this in property details page
To enable WalkScore go to Appearance > Customize -> Listing Setting
5.4 Agents Setup
- At first, please login with your Administrator acount.
- Click on the My Accout button from the main site after login.
- Then navigate to the Store -> Managers from left menu bar and click Invite Button.
- Enter agent email in the input field and press Add button
- After add, Agetn will get a Invitation Request.
- Then the agent have to clcik on the invitation link from email
Please follow the below images for more details about Agents
6. Set Home and Blog Page
To set the default Home and Blog page please login to wp-admin and navigate to Dashboard > Settings > Reading
7. Customize Menu
To customize the menu please login to wp-admin and navigate toAppearance > Menus and follow the following steps:
7.1 Multi Column Menu
Please follow below steps:
- First you have to use
mega-menu mega-menu-col-2classes in the parent menu item.
- Then you have to create columns. Then just nest 1 step of all columns in the parent menu to create column.
- Then again nested 2 steps all items in every colum to fill a column
Please check the screenshot for more details:
NB: If you can't see the field "CSS Classes", you have to enable it first. To do this, go to the top and follow this screenshot below:
8. Change Site Title and Favicon
To change your Site title and Favicon login to wp-admin and navigate to Dashboard > Appearance > Customize > Site Identity and follow the following steps:
9. Change Global Colors
To change all global colors login to wp-admin and navigate to Dashboard > Appearance > Customize > Color and follow the following steps:
10. Change Logo
To change the site logo login to your wp-admin and navigate to Dashboard > Appearance > Customize > General and follow the following steps:
11. Change Typography
To change the typography of your site navigate to Dashboard > Appearance > Customize > Typography
To change General Options navigate to Appearance > Customize > General
To change Header Options navigate to Appearance > Customize > Header
To change Footer Copyright Options navigate to Appearance > Customize > Footer.
12.4.1 Page Layout
To change Page Layout navigate to Appearance > Customize > Layout Settings > Pages Layout.
12.4.2 Blog Layout
To change Blog Layout navigate to Appearance > Customize > Layout Settings > Blog Layout.
12.4.3 Single Post Layout
To change Sinlge Post Layout navigate to Appearance > Customize > Layout Settings > Single Post Layout.
12.4.4 Listing Archive Layout
To change Listing Archive Layout navigate to Appearance > Customize > Layout Settings > Listing Archive Layout.
12.4.5 Listing Single Layout
To change Listing Single Layout navigate to Appearance > Customize > Layout Settings > Listing Single Layout.
12.5.1 Blog Settings
To change Blog Settings navigate to Appearance > Customize > Blog Settings.
12.5.2 Post Settings
To change Single Post Settings navigate to Appearance > Customize > Post Settings.
12.6.1 Error Page Settings
To change 404 page settings navigate to Dashboard > Appearance > Customize > Error Page.
12.6.2 Contact Info Settings
To change contact information navigate to Dashboard > Appearance > Customize > Contact Info.
12.6.3 Where is My Purchase Code?
To learn about how to find your purchase code. When you buy a product from envato you get a purchase code. visit the following link:https://help.market.envato.com/hc/en-us/articles/202822600-Where-Can-I-Find-my-Purchase-Code
13. Elementor Widgets
Elementor Page Builder has a lot of built-in widgets by default. But for your convenience we've created several custom Elementor Widgets that you can use in your website and extend website functionality. You can find them under RADIUSTHEME ELEMENTS section on Elementor edit mode.
14. Setting up Contact Form
We are using plugin WP Fluent Forms for contact functionality. You can see their documentation for better understanding.
If you don't want to go through all the troubles to check their documentation and just want to use the default contact form we provided with this theme, please at least set up the default emails in contact form settings. To do that, please follow the steps below:
Step 1: Navigate to Fluent Forms Menu, then click on any contact form settings and go to Email Notification tab. Then click on Add Notification button.
Step 2: Here you should set your own email address where you want to get notification user submitted forms. You can also check this link
Step 3: Please submit some dummy forms from Contact page to make sure that it's working properly.
15. Built-in CSS Classes (Advanced)
You can use the following built-in css classes if needed:
- primary-color: set primary color
- secondery-color: set secondery color
- bg-primary: set primary color background
- bg-secondery: set secondery color background
- rt-btn: general button style
16. Translating Theme
You can translate this theme to another language easily. You have to translate several things for your website to work properly:
- Theme: HomListi
- Plugin: HomListi Core
- Plugin: Classified Listing Pro
- Plugin: Classified Listing Store
There are many tools available for translation. But the easiest way is to use plugin "Loco Translate". Using this plugin, you can literally translate any WordPress themes or plugins if it supports translation.
--- Here's a step by step tutorial about translating any themes and plugins using "Loco Translate":
Step 1: Install and activate plugin "Loco Translate".
Step 2: Select the Theme or Plugin you want to translate from "Loco Translate" menu.
Step a: Theme Translate
Step b: Plugin Translate
Step 3: Click on New language link.
Step 4: Select your preferred language, and also select your location as "System". Then click on "Start Translating" button.
Step 5: Click on the "Sync" button for the first time. Then start translating strings like the image below.
Here's a quick video tutorial about how to use Loco Translate:
17. Updating Theme
Occationally we provide updates which includes new features and bugfixes. Updating WordPress theme is standard WordPress functionality.
Before Updating Theme:
You can use this plugin to keep the backup: https://wordpress.org/plugins/wp-theme-plugin-download/
There are few ways to update WordPress theme. You can follow any of the methods described below:
Method 1: Automatic Update by Using Envato Market Plugin
- Install and activate the "Envato Market" plugin manually. Here's the plugin zip file: http://envato.github.io/wp-envato-market/dist/envato-market.zip
- From WordPress Admin Panel, navigate to "Envato Market" menu.
- In this page, you'll find a field for insering Envato Token. Insert your Envato Token
Code from there. You can generate this code from this link: https://build.envato.com/create-token/?purchase:download=t&purchase:verify=t&purchase:list=t.
Remember, while generating the token, you have to login using the same envato id which you used to purchase theme.
- After completed the above steps successfully, Navigate to Appearance -> Themes. Here you'll see an "Update now" link beside your theme. Click on that link and your theme will be updated automatically.
Here's a quick video tutorial explaining this method:
Method 2: By Uploading zip File
- From WordPress Admin Panel, Navigate to Appearance -> Themes.
- Activate any other theme (eg. Twenty Seventeen) than the current one.
- Delete HomListi Theme.
- Now you have to upload the updated theme zip file. To do this, Navigate to Appearance -> Themes -> Add New -> Upload. Go to browse, and select the zipped theme folder. Hit "Install Now" and the theme will be uploaded and installed.
Method 3: By FTP
- Using your FTP client, navigate to "/wp-content/themes/" folder on your server and delete the "homlisti" folder from there.
- Now upload the latest non-zipped theme folder into that "/wp-content/themes/" folder .
After Updating Theme:
** After updating the theme please update all plugins which come with the theme.
18. Demo Content installation failed
This is a hosting issue. In most hostings demo installation will work fine. But some hostings block certain permissions which may cause this issue. If this happens to you, you can contact your hosting provider or alternatively send a support request to firstname.lastname@example.org and we will help you to fix this.
19. 404 Error in all pages
If you face this type of issue, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.
If you face any issue please contact us at email@example.com. We provide 15 hours real-time support for our customers.
Thank you for purchasing our theme.