Introduction

Thank you for purchasing our product! We are very glad that you have decided on our Motive WordPress Theme.

This documentation will help you to set up and use the Motive WordPress Theme. The theme is very easy to use and we are here to guide and help you, so please read and follow the documentation, if there are some other issues you want to discuss then do not hesitate to contact us on support@teslathemes.com. This documentation is more of a reference work if you do not know what to do, or if you are not familiar to WordPress.

Please read the following very carefully as it will help you set the theme up, we have gone through the setup process multiple times and provided the best possible instructions.

We strongly recommend you to use a fresh install of WordPress and integrate your content into the pages according to the documentation. Of course, you can try to implement the theme into your current WordPress, but we will not provide in-depth support for it. The theme has specific settings that may conflict with your current setup of categories, plugins, javascript use, and more.

We wish you good luck in your work with Motive WordPress Theme, and of course we would love to see your website and what you come up with by using this theme.

The theme is very easy to use and we are here to guide and help you, so please read and follow the instructions and if you have further questions write us a email support@teslathemes.com. This documentation is more of a reference work if you do not know what to do and need a better understanding on how the template is built write us an email.

Note: You can click on small images to zoom in and then move the mouse to the position you need.

Browser and Devices support

Since Realtor is built on the Bootstrap 3 framework, it supports the same browsers as Bootstrap.

This template is responsive and should look fine on all standard mobile devices.

browsers

Note: This template was built with bootstrap 24 columns system.

Installing WordPress

To start working with Realtor you first need to have WordPress installed on your server (local,dev or production)

Step 1: Download and Extract

Download and unzip the WordPress package from Download WordPress.

Step 2: Upload

Copy the extracted contents of wordpress-ver.zip to the corresponding path of the server. Make sure WordPress has permissions to write to the folder it is located in.

Now when accessing the corresponding URL you should see the following message:

Wp first

Step 3: Edit the Configuration File

Auto Mode: After clicking on "Create a configuration file" then "Let's Go" you will get the configuration page:

Establishing a connection

If the information is correct and everything works fine you will receive:

Successful

If it's successful then skip the "Manual Mode" if not, follow the instructions bellow.

Manual Mode: You can either rename the file wp-config-sample.php to wp-config.php on your local machine or on you server (you'll still need to tell WordPress your database information).

Open wp-config.php with a txt editor and enter your database information under the section labeled:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wordpress');

/** MySQL database username */
define('DB_USER', 'root');

/** MySQL database password */
define('DB_PASSWORD', 'root');

/** MySQL hostname */
define('DB_HOST', 'localhost');

/** Database Charset to use in creating database tables. */
define('DB_CHARSET', 'utf8');

/** The Database Collate type. Don't change this if in doubt. */
define('DB_COLLATE', '');

After the information is edited upload the file to the server.

Step 4: Site name and login data

If it's all sparky then you click Run the Install and fill all the lines shown bellow:

Login Information

This being the last step you will see a success message.

Success

Click Log in and now you can proceed to you site. Now you can go to installing your Motive WordPress Theme.

Installing Theme

To install the Realtor WordPress Theme you will need WordPress v3.6 or newer.

Option A

Follow the steps and upload the Theme's installation zip file through the WordPress admin backend:

  1. Download the theme archive, Realtor.zip
  2. Unzip the theme archive
  3. Find the installation file, Realtor.installation.zip
  4. Go to your WP admin – Appearance – Themes – Add New – Upload Theme – Choose file
  5. Upload the Realtor.installation.zip file.

upload

Then, when prompted activate the theme.

Note: If you can't get passed the file upload limit and/or if you get an error message mentioning exhausted memory size or something in those lines, you could try to increase that limit by adding to the "wp-config.php" the following line of code:

define('WP_MEMORY_LIMIT', '64M');

Option B

Uploading directly to the Server:

  1. Download the theme archive, Realtor.zip
  2. Unzip the theme archive
  3. Find the installation folder, Realtor
  4. Connect to your server via FTP or any other way that will allow you to explore and upload files directly.
  5. Navigate to your WP Installation Folder/wp-content/themes/
  6. Upload the Realtor folder here.

If everything went well in Option A or B, the theme should appear under Appearance → Themes like shown below:

cover

Then, when prompted activate the theme. Or go to Appearance->Themes and press the Activate button next to the theme.

Now you are ready to customize your theme.

Blog & Front Pages

Create a page that will serve as homepage - In WordPress admin panel under Pages → Add New, name it for example "Front Page Default".

Create a page that will serve as the archive page of blog posts - In WordPress admin panel under Pages → Add New, name it for example "Blog". Make sure that the permalink slug is "blog" only. Also, select "Default Template" as the template used by the page.

Set the front page to display as a static page: - Go to Settings → Reading → A static page (select below) → Front page: → Choose your page from the drop-down menu.

Choose your posts page from the drop-down menu. It should be the "Blog" page we have just created.

Your page should look something like:

home page

Tesla Framework

FW tour

All our themes are powered by Tesla Framework ( Tesla Framework Tour ), a powerful administration tool that comprises all our great features and allows you to easily customize the look and functionality of your theme, without advanced knowledge of programming. It gives you the possibility to customize and manage your theme settings from a dedicated area within your WordPress Admin. Tesla Framework works smoothly, is intuitive and easy to use, once you install one of our themes you will be able to personalize its logo, site background and color, SEO options, social media networks and more; all from one place.

Our Framework is in continuous development and improvement process, we are working hard to provide you an easy administration tool, and we're guided by the latest UX trends and new technologies.

To personalize your theme you need to follow the instructions below.

Note: Options will vary from theme to theme depending on their features.

General Settings

Use these settings to customize the logo,favicon and to insert custom css.

General Options

Site Colors

Use these settings to change available theme colors and background image.

Site colors

Typography

Use these settings to change available theme typography (fonts and colors).

Typography

SEO & Socials

Choose what social share platforms to be used on single post pages and in footer/header. Also you can insert a tracking code that will be appended in the body of your website.

SEO Social

Contact Info

These options tweak your Contact page template and your Contact widget.

Contact Info

The options left blank will not appear.

Additional Options

This section of the framework differs the most from theme to theme. Most of the settings have descriptions or are pretty self explanatory, so please try to play with them before asking for support :) .

Note: Fields left blank will not apear.

Additional Options

Export/Import Options

To clear, export, import options for the settings explained above, go to WP Admin -> Tesla Theme -> Export/Import Options.

Warning ! We recommend that you carefully read all of the information, below, before using any of the features of Export/Import Options. It is highly recommended that you perform a backup of your theme by using the Export Options button, and then saving the file to a safe location, before proceeding with any of the other options located here. If you use the built in Export Options feature to create a backup, Tesla Themes Support can assist with any issues that you may encounter. If you use a third party backup product, i.e., plugin, you will need to contact the plugin vendor for assistance.

Export/Import Options

Clear Options: Restores all the inputs to default values. You will lose all customization made in the theme options tabs.“USE WITH CAUTION.”

Import Demo Options: Imports the options predefined by our developers as seen on demo page.

Note: Importing demo options will not make your website look entirely as on our demo. You still need to import demo content and use specific plugins and widgets if theme requires so.

Export Options: Saves the current options to a file. This file can be later used to import options as described below. Useful when migrating to a new server.

Import Options: Loads options from an earlier exported file.

Warning ! Importing or clearing options will erase your theme current settings from Tesla Theme page . Make sure you make a backup first by "Exporting Options".

Import Demo Content

To import the content that is used on our demo page, go to WP Admin -> Tesla Theme -> Import Demo.

Import Demo

Warning ! Importing Demo Content will add posts and media files to your WordPress database. It is not recommended to do it if you already have your own content. If you have already created your own content in this theme and still want to import the demo content, then It would be better if you back up your data before importing the demo content.

You may encounter an error(s) due to permissions or to duplicate content. If the final message is green and successful just ignore them. If it fails or takes longer than 15 min to load please contact our support team and send your WordPress login, as well as any FTP login.

Theme Updates

WordPress will check for updates each hour and our themes will be displayed on the WP's updates page automatically.

Your Tesla Theme will have updates made available from time to time and you should update your theme when you see that an update is available. Tesla Themes highly recommends that BEFORE you make any customizations to your theme, you FIRST create a Child Theme. A Child Theme inherits all functionality from the Parent Theme (i.e., the theme that you have purchased from Tesla Themes). If you are an experienced user of WordPress and already know how to create a child theme, please do so before customization, and then do all customization on the child theme (i.e., custom css, modification of .php files, etc.) If you are a beginner, or have never created a child theme, then please refer to the WordPress Codex for more information: Child Theme and for instructions on how to manually crate a child theme.

Warning ! You will lose all the customizations made in the parent theme if you make this update. Make sure that you work with Child Theme to keep the customizations during updates. For the sake of clarity: all Tesla Themes are Parent Themes. Although you can customize this Parent Theme directly, you must always bear in mind that when Motive theme updates are made available, and you choose to update your theme, most or all of your theme customizations will be lost!

To check for updates manually go to WP Admin -> Tesla Theme and at the top click on the Check Updates button. If an update is available, the newest version will be displayed and the "Go to updates page" button will appear, clicking on it will lead you to the WordPress' updates page.

Theme Updates

Note: Click on View Changelog before updating to see what has been added or changed.

Select the checkbox next to the Tesla Theme and then click on Update Themes

Theme Updates 2

If you get any errors during this process please be sure that WP has permission to write in /wp-content folder.

Contact Form Builder

This feature is not available on all themes.

Tesla Contact Form Builder is meant to give the user as much customizability of the structure and appearance of your contact forms in the theme as the layout permits.

To create a contact form, go to the Forms menu and begin customizing the default form that has already been created.

Be sure to fill in the: ID;
Receiver Email: The email address where you want the form data to be sent.
Location: Specify exactly where you want the Contact Form to appear, or leave blank if you wish to use the form with a shortcode or in a widget.

Form Builder

Below you will find an example of form

Form Builder Form

The form will appear automatically in the predefined Location that was chosen in the builder or you can use [tesla_form id="..."] shortcode to display form in custom location

Custom Posts & Shortcodes

Custom Posts

To ease the process of creating a website our TeslaFramework combines Theme Options, Custom Posts, Shortcodes and Templates.

Most of the custom posts are linked with a shortcode that you can use on any page. Some will need a specific page template to be called on. Others have their own placement and will be used as content for static locations.

The best way to understand and start working with our custom posts and shortcodes is to Import Demo Content and modify it.

Next we will explain each custom post. Its parameters and limitations of use. Don't be afraid to experiment.

Note: In the following screens, the colors from WP Admin match the generated content on the frontend.

Properties

To create it , go to WP Admin -> Properties -> Add New or from frond-end My Profile -> Submit Property

Properties

Property Taxonomy

Taxonomy "Features"

You have to add all your properties features, in WP Admin -> Properties -> Features, because registered agent can not create features, so there must be default available features.

Properties Features

Taxonomy "Status"

You have to add all your properties statuses ex. "For Rent", "For Sale" in WP Admin -> Properties -> Status, because registered agent can not create status to a property, so there must be default available statuses.

Properties Status

Taxonomy "Category"

You have to add all your properties categories ex. "Appartment", "House" in WP Admin -> Properties -> Categories, because registered agent can not create category to a property, so there must be default available categories, also you have to upload a category icon, to use it on map

Properties Category

Properties Category

Also, property can be submitted from front-end ,in the My Profile page, which you will have to setup, click here to view how to setup profile page.

Properties Front

This custom post in combination with [tt_property] shortcode will output your portfolio items:

Shortcode uses the following attributes:

title="...": provide a section title. Default "none"
nr="...": pick a number of portfolio items to be displayed. Default "all"
description="...": pick a description for properties section. Default "none"

The section below was generated by following shortcode[tt_property title='Recent Listed' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam nec viverra erat. Aenean elit tellus mattis quis maximus et malesuada congue velit' nr='4']

Property 1

Shortcode TT Properties

This shortcode is used to display all listed properties, the section below was generated by following shortcode:
[tt_properties]

tt-property-list


Shortcode TT Popular Properties

shortcode uses the following attributes:

title="...": insert title section. Default "none"
description="...": insert title description. Default "none"
category="...": insert default properties category. Default "all"
type="...": insert section type 1 or 2. Default "none"
nr="...": insert number of properties to be displayed. Default "12"

The section below was generated by following shortcode
[tt_property_popular title='Most viewed' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam nec viverra erat. Aenean elit tellus mattis quis maximus et malesuada congue velit' nr='8' category='for-sale']

tt property popular


The section below was generated by following shortcode
[tt_property_popular title='Most viewed' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam nec viverra erat. Aenean elit tellus mattis quis maximus et malesuada congue velit' type='2' nr='12']

tt property popular

Shortcode Map

Shortcode [tt_map_filters] is used to display map with all properties.

title="...": pick a title for map section. Default "all"
description="...": pick a description for map section. Default "all"

The section below was generated by following shortcode[tt_map_filters title='Search' description='Where are you looking?'].

Shortcode Map


Shortcode Latest Blog

[latest_blog]

shortcode uses the following attributes:

title="...": insert title for shortcode. Default "none"
description="...": insert description for shortcode. Default "none"
btn_title="...": insert button title for button below the shortcode description.
btn_url="...": insert button url for button below the shortcode description.
nr="...": insert number of posts to show. Default "2"
category="...": insert category slug if you want to show posts from specific category. Default "all"
bg_img="...": insert background image url. Default "none".
bg_color="...": insert background color in hex. Default "none".

The section below was generated by following shortcode
[latest_blog nr='2' bg_img='http://teslathemes.com/../img/blog-section-bg-2.jpg' title='From blog' description='Curabitur fermentum lacus nulla, a mattis arcu rutrum id. Nunc ac feugiat purus, at tempus quam. Aliquam sed turpis commodo, volutpat quam quis, posuere est' btn_url='http://teslathemes.com/../blog/' btn_title='View more posts']

Latest Blog

Shortcode TT Agents

[tt_agents]

shortcode uses the following attributes:

title="...": insert title for shortcode. Default "none"
description="...": insert description for shortcode. Default "none"
featured_agent="...": insert featured agent username. Default "none"
type="...": insert here type of this shortcode, you can insert "1" or "2". Default "1"

The section below was generated by following shortcode
[tt_agents title='Our agents' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam nec viverra erat. Aenean elit tellus mattis quis maximus et malesuada congue velit' featured_agent='ramin-ramin' type="1"]

TT Agents

The section below was generated by following shortcode
[tt_agents title='Our agents' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam nec viverra erat. Aenean elit tellus mattis quis maximus et malesuada congue velit' type='2']

TT Agents 2

Shortcode TT Offer

[tt_offer]

shortcode uses the following attributes:

title="...": insert offer title for. Default "required"
description="...": insert offer description. Default "required"
url="...": insert offer url. Default "required"
icon="...": insert offer icon, you can check available icons here. Default "none"

The section below was generated by following shortcode
[tt_offer icon='icon-home4' title='Hot Offer' description='Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis viverra venenatis nisl, et venenatis nulla tincidunt non. Nulla sed dui est. Viverra venenatis nisl, et venenatis nulla tincidunt non.' url='http://teslathemes.com/.../property/grand-hotel-house/']

TT offer

Shortcode TT Accordion

The shortcodes:

The two shortcodes that are added are:[tt_accordion]...[/tt_accordion]

shortcode uses the following attributes:
title="...": insert title for shortcode. Default "none"
description="...": insert description for shortcode. Default "none"

and [tt_accordion_item ...]

shortcode uses the following attributes:
title="...": insert title for shortcode. Default "none"
description="...": insert description for shortcode. Default "none"

The section below was generated by following shortcode
[tt_accordion title='Features' description='additional services'][tt_accordion_item title='Vivamus ac nulla lacus' description='Duis vel eros mi. Nunc eu sem dolor. Nulla venenatis, augue at rhoncus tincidunt, nisi dolor fringilla nibh'][tt_accordion_item title='Vivamus ac nulla lacus' description='Duis vel eros mi. Nunc eu sem dolor. Nulla venenatis, augue at rhoncus tincidunt, nisi dolor fringilla nibh'][tt_accordion_item title='Vivamus ac nulla lacus' description='Duis vel eros mi. Nunc eu sem dolor. Nulla venenatis, augue at rhoncus tincidunt, nisi dolor fringilla nibh'][/tt_accordion]

Accordion

Page Templates

Templates

Create a new page from one of the built in WordPress templates This is a great feature that lets you quickly, with only two clicks, create the exact layout that you want for your new page. When adding a new page you can choose from templates below:

  • Default Template

  • Clean Layout Page (used for creating page with different sections)

  • User Profile Page

Note: Some page templates may require additional configuration from custom posts and theme options pages.

Page and Post Settings

You can set the following settings for page or blog post as shown above:

  • To choose the Sidebar Position. Options: 'No sidebar','Left sidebar','Right sidebar'

    Sidebar Position

  • To choose the Header Menu Style. Options: 'Sticky','No Sticky'

    Header Type

My Profile Setup

If you want that on your site to register different agents and to post properties, you have to make some settings, please read instructions below.

1. Go To WP Admin -> Settings -> General, find "Membership" & "New user default role" settings and make changes as in image below.

User settings

now users can register on your website, with default role "agent".

2. Go To WP Admin -> Pages -> Add New, enter page title "My Profile" or otherwise, then go in right sidebar and choose Template "User Profile" for this page.

User Page

3. Go To WP Admin -> Appearance -> Menus, create New Menu and then follow instructions from image below.

User Menu

User Front-end Menu

4. If you want to make social login available then Go To WP Admin -> Realtor -> SEO and Socials, read instructions from image below to setup your social login.

Social Login

Widgets

Realtor has 8 custom widgets:

  • [Realtor] Property Summary [Single] (this widget is used only in single property page for building single property page sidebars)
  • [Realtor] Property Map [Single](this widget is used only in single property page for building single property page sidebars)
  • [Realtor] Similar Properties [Single](this widget is used only in single property page for building single property page sidebars)
  • [Realtor] Property Agent [Single](this widget is used only in single property page for building single property page sidebars)
  • [Realtor] Popular Properties
  • [Realtor] Contact Box
  • [Realtor] Latest Properties
  • [Realtor] About
Note: Some Widgets may require additional configuration from custom posts and theme options pages.