Introduction

This documentation is last updated on 07 July 2014.

Thank you for purchasing Real Homes WordPress Theme . If you have any question that is beyond the scope of this documentation, Please feel free to create a support ticket using Our Support Site.

Disclaimer:
We offer limited support for theme customers. We only provide support for our themes and their core features. We cannot guarantee our themes will work properly with all third party plugins and server environments. If you plan on adding numerous plugins to this theme then please note, We cannot facilitate support for any conflicts that might arise with this theme's default functionality. The Real Homes WordPress theme is presented as it is.


Themeforest Item Purchase Code to Signup on Support Site

Please visit this knowledge base article to learn about how to get item purchase code from themeforest to signup on our support site.


Updating WordPress Theme

If this is a theme update and you want to apply it on your existing installation then please visit this knowledge base article to learn about a better way to update your theme


If you like this theme, Please support us by rating this theme with 5 stars (How to rate?)      

Install Theme

In start you must have a working version of WordPress already installed. For information in regard to installing the WordPress CMS, please see the WordPress Codex Installing WordPress

Once you have a working of version of WordPress, you need to download All Files and Documentation from themeforest and extract the downloaded zip to get various files including realhomes.zip.

Install Theme Via WordPress Dashboard

  1. Go to 'Appearance > Themes' section
  2. Click 'Add New' and select the 'Upload Theme' option
  3. Choose the realhomes.zip file and press 'Install Now'
  4. Once the theme is uploaded you need to activate it.

if you face any problem during upload through dashboard, please upload the theme using FTP as guided below.

Install Theme Via FTP

  1. Access your hosting server using an ftp client like FileZilla
  2. Go to the 'wp-content/themes' folder of your WordPress installation
  3. Extract the realhomes.zip file and put the realhomes folder in 'wp-content/themes/' folder
  4. Go to 'WordPress Dashboard > Appearance > Themes' section to activate the theme

Install Child Theme

It is better to use child theme as if you need to modify anything you modify in child theme only. This way you can easily update your parent theme whenever new update becomes available on themeforest. You can read more about child theme from here.

To install child theme, you need to upload the realhomes-child.zip and activate it in the same way as you uploaded and activated the parent theme's realhomes.zip.

Import XML for Demo Contents

Look for Import XML folder in unzipped package downloaded from themeforest and use the XML within it.
Go to the WordPress Admin > Tools > Import and click WordPress as displayed in image below.



At 1st time you need to install WordPress importer plugin



Once installed you need to activate the plugin and run the importer.



Select the XML file from Import XML folder in unzipped package that you have downloaded from themeforest.



After importing XML file.

  1. Assign posts to an existing author.
  2. Mark the checkbox to download and import file attachments
  3. Click 'Submit' button



After that is done, you will have bunch of posts, pages, properties and other contents as on the theme demo.



Next step is to configure menu.

Configure Menus

Navigate to Appearance > Menus and use the Already Imported Menu from XML and assign it to theme location "Main Menu" from Menu Settings section below menu. After that save the menu. As pointed in screenshot below.



Create Home Page

In case of imported XML the home page is already created and you do not need to follow this section.

To set up the Home page you need to create a new page,

Go to Pages > Add New. You can give this page a title "Home" yet you do not need to include any contents for now.

Select the “Home Template” template from the Page Attributes section, as displayed in screen shot below and click “Publish”.



Create News Page

In case of imported XML the news page is already created and you do not need to follow this section.

To set up the News page you need to create a new page,

Go to Pages > Add New. You can give this page a title "News" yet you do not need to include any contents for now.

Select the “Default Template” template from the Page Attributes section, as displayed in screen shot below and click “Publish”.



Configure Reading Settings

I am assuming that you have imported the XML successfully and you have home page and news page available for use. If this is not the case then simply create a new page using Home Template and name it as Home after that create another page using default template and name it as News.

To configure reading settings you need to visit WordPress Admin > Settings > Reading and choose that front page displays as static page. Then select Home as Front Page and News as Posts Page. As, displayed in screen shot below.



Configure Header

Navigate to Appearance > Theme Options > Header, you can configure following things from there.

  1. Upload your website logo image
  2. Upload your website favicon
  3. Enable social icons and provide related links
  4. Provide email address to display in header
  5. Provide phone number to display in header
  6. Add any tracking code like Google Analytics



Configure Slider

You can feed slider contents from following sources

  1. Properties Custom Post Type - It will attach properties to your slides ( Very easy to use )
  2. Revolution Slider - You can add text,images, buttons and videos the way you want. ( Little difficult to use but awesome results )
  3. Slides Custom Post Type - You can attach a simple image to your slide with related text data ( easy to use with results similar to properties based slider )

1. Properties Based Slider

Visit the Theme Options and choose "Display Slider Based on Properties Custom Post Type" as displayed in screenshot below.



If you want to include a property in homepage slider, Then you need to edit that property and there is a metabox field in property edit page titled "Add in Homepage slider". Select Yes and provide slider image as required by Slider Image field below it.




2. Revolution Slider

Look for the folder name Plugins/Revolution Slider in unzipped package downloaded from themeforest.net. This folder will contain revolution slider's plugin zip, documentation and demo slider import zip. You need to go to Plugins > Add New in your WordPress admin side and upload the revslider.zip as displayed in image below




Once installed, you need to activate the plugin as displayed in screen-shot below.



Once activated you need to visit Revolution Slider in left sidebar and click import slider as displayed in screen-shot below. You need to choose the realhomes.zip file from Plugins/Revolution Slider/Import Zip folder.





After import you will have a demo slider available for use.



Now, you can use that slider alias in theme options and select the related settings, As displayed in image below




3. Slides Custom Post Type Based Slider

To display slider based on slides custom post type, You need to add new slides as displayed in screenshot below.



After adding slides, you need to visit the Theme Options and choose the "Display Slider Based on Slides Custom Post Type" as displayed in screenshot below.



Display Google Map on Homepage

Adding google map on homepage is super simple as properties already have their locations stored in database. So, you just need to enable the feature from theme options as displayed in image below.



Display Image Banner on Homepage

Please visit the theme options and choose to "Display Simple Image Based Banner"



After that you can provide the banner image for overall site from Theme Options > Header Styles as displayed in screen shot below.



OR you can provide the banner image for homepage only by editing homepage and using Top Banner Area Settings meta box, as displayed in screen shot below.



Configure Property Search Form

You need to configure permalinks settings from Basic Setup Menu before moving with this section.

Follow the steps below to configure the search functionality.
1. Create a Property Search Page Using Property Search Template ( In case of Imported XML the page is already created ).



2. Copy the URL of Property Search Page and use it in Theme Options >> Home Search >> Search Page URL As displayed in screen shot below.



After that you will have a property search form displayed on homepage. Now, you can also use the RealHomes - Advance Search Widget in sidebar as that widget uses the same configurations.

Slogan on Homepage

Navigate to Appearance > Theme Options > Home Others, there you can provide the slogan title and text in related options.



Save the theme options after adding the information.

Properties on Homepage

Navigate to Appearance > Theme Options > Home Others, there you can filter and sort the properties that you want to display on homepage..



Save the theme options after making the changes.

News Posts on Homepage

Navigate to Appearance > Theme Options > Home Others, There you can configure the news posts related settings for homepage..



Save the theme options after making the changes.

Add News Post

Go to WordPress Admin > Posts > Add New
  1. Provide the post title



  2. Select the related post format



    Post Formats and Related Meta Boxes:
    This theme supports various post formats. So, when you select a post format look out for related meta boxes that will appear after your selection. You need to fill out those meta boxes with related information, so that your post can appear in best possible design.

  3. Provide the post contents



  4. Add or select the related category



  5. Add or select the related tags



  6. Provide the featured image. The image should have minimum width of 830px and minimum height of 323px. The bigger size images will be cropped automatically.



  7. Publish the post once it is ready.

Add Agent

Go to WordPress Admin > Agents > Add New
  1. Provide the agent name



  2. Provide the agent description



  3. Provide the featured image. The image should have minimum width of 210px and minimum height of 210px. The bigger size images will be cropped automatically.



  4. Provide the agent related information



  5. Publish the agent post once it is ready.

Add Property

Go to WordPress Admin > Properties > Add New
  1. Provide the property title



  2. Add property description



  3. Provide the property gallery images if any



  4. Provide the property featured image (it is a must)



  5. Provide the property related information like price, area, beds, baths, garages and others



  6. Provide the property address and drag the google map pointer to right position.



  7. If your property has any video then provide the video URL and related image



  8. If you want to add this property into featured properties then mark this property as featured.



  9. If you want to add this property in homepage slider then you need to select Yes for Add in Homepage slider field and provide slider image as required by Slider Image field below it.



  10. Select the type of information that you want to display in agent's box.



    1. None will hide the agent's information box.
    2. Author profile information will display the Author( user who added the property ) information.
      You can configure your user information from Users > Your Profile.

      You can also modify the author from Author meta box on property edit page.
    3. Display agent's information will display the selected agent's information. You can add the agent from Agents > Add New
  11. Provide the additional details if any



  12. Select or Add the property features



  13. Select or Add the property type



  14. Select or Add the property location



  15. Select or Add the property status



  16. If this property is a sub/child property then select the parent property.



  17. Publish the property post once it is ready.

Add Properties Listing Page

Note: If you have imported the demo contents XML then this page is already created.

Go to WordPress Admin > Pages > Add New
  1. Provide the page title


  2. Select the appropriate page template for properties listing.
    There are 3 templates for properties listing page.
    1. Property Listing Template
    2. Property Grid Listing Template
    3. Map Based Property Listing Template



  3. Provide the top banner related information



  4. Publish the page once it is ready.
  5. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus



Add Agents Page

Note: If you have imported the demo contents XML then this page is already created.

Go to WordPress Admin > Pages > Add New
  1. Provide the page title



  2. Select the Agent Listing Template from page attributes.



  3. Provide the top banner related information



  4. Publish the page once it is ready.
  5. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus



Add Full Width Page

Note: If you have imported the demo contents XML then this page is already created.

Go to WordPress Admin > Pages > Add New
  1. Provide the page title



  2. Select the Full Width Template from page attributes.



  3. Provide the page contents



  4. Provide the top banner related information



  5. Publish the page once it is ready.
  6. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus

Add Contact Us Page

Note: If you have imported the demo contents XML then this page is already created.

Go to WordPress Admin > Pages > Add New
  1. Provide the page title



  2. Select the Contact Template as template from page attributes.



  3. Provide the top banner related information



  4. Publish the page once it is ready.
  5. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus



  6. Next step is to configure Contact related theme options from Appearance > Theme Options > Contact.

Configure Related Theme Options

Go to WordPress Admin > Appearance > Theme Options > Contact



There you can configure following things.
  1. Google Map for Contact Us page
  2. Contact details to display on Contact Us page
  3. Contact form heading and target email address to receive contact messages.

1. Configure Google Map on Contact Page

If you want to display google map on contact page then you need to enable it from theme options as displayed in screen shot below. You need to provide your location's coordinates to display it in google map. You can find your location's latitude and longitude from itouchmap.com/latlong.html. You also need to provide the appropriate zoom level value as displayed in screen shot below.




2. Contact details to display

To display your contact details you can use the theme options displayed in screen shot below.





3. Contact form heading and target email address

You can provide contact form heading and target email address to receive contact message in theme options displayed in screen shot below.



Save the theme options after making the changes and test the front end of contact page.


Set Up Login & Register Page

To allow user registration, You need to allow registration from Settings > General as displayed in screen shot below. Otherwise you will only have login form on Login & Registration page.



Important: From version 1.6 the theme automatically provides modal dialog for Login and Register. So you do not need to follow further details of this section.

Note: If you have imported the demo contents XML then Login & Register page is already created. But you still need to configure related theme options as guided near the end of this section.

To add Login & Register page, Go to WordPress Admin > Pages > Add New

  1. Provide the page title



  2. Select the Login & Register Template from page attributes.



  3. Provide the top banner related information



  4. Publish the page once it is ready.

Now you need to go to Appearance > Theme Options > Members



and copy then paste the Login & Register page URL in related theme option field. As displayed in the screen shot below. If you want to use header navigation for user login and register then you can also enable that navigation from here.



That's it your Login & Register page is ready for use.

Set Up Submit Property Page

Note: If you have imported the demo contents XML then Submit Property page is already created. But you still need to configure related theme options as guided near the end of this section.

To add Submit Property page, Go to WordPress Admin > Pages > Add New

  1. Provide the page title



  2. Select the Submit Property Template from page attributes.



  3. Publish the page once it is ready.

Now you need to go to Appearance > Theme Options > Members



and copy then paste the Submit Property page URL in related theme option field. As displayed in the screen shot below. You can also change the message that will be displayed to user after property submit and you can also specify a target email address that will receive the notice when any user submits a property.



That's it your Submit Property page is ready for use.

Set Up My Properties Page

Note: If you have imported the demo contents XML then My Properties page is already created. But you still need to configure related theme options as guided near the end of this section.

To add Submit Property page, Go to WordPress Admin > Pages > Add New

  1. Provide the page title



  2. Select the My Properties Template from page attributes.



  3. Publish the page once it is ready.

Now you need to go to Appearance > Theme Options > Members



Now, copy then paste the My Properties page URL in related theme option field. As displayed in the screen shot below.



That's it your My Properties page is ready for use.

Set Up Favorites Page

To add Favorite Properties page, Go to WordPress Admin > Pages > Add New

  1. Provide the page title



  2. Select the Favorite Properties from page attributes.



  3. Publish the page once it is ready.
  4. Now you need to go to Appearance > Theme Options > Members



  5. Now, copy then paste the Favorites page URL in related theme option field. As displayed in the screen shot below.



That's it your Favorites page is ready for use.

How to set up Twitter Widget

Latest tweets widget uses Display Tweets Plugin.

  1. Install the Display Tweets Plugin plugin.
  2. Now, you need the twitter App's consumer key, consumer secret, access token and access token secret for twitter authentication.
    To get all these keys, You need to register a new twitter app from following url
    After registering app and generating access token you will have api keys and access token as displayed below



    API Key is basically consumer key and API secret is consumer secret.



  3. After installing and activating the plugin, Go to Settings > Twitter Feed and use the keys that you just got from twitter app.
    Save the settings after configuring the keys and related options.



  4. Now go to Appearance > Widgets and look for Tweets widget.



  5. Use that tweets widget in a footer column. Provide it a title and save the widget settings.



  6. Now check out the front end of your site and you will have a twitter widget working for your site.



Property Types Widget

  1. Go to Appearance > Widgets and look for RealHomes - Property Types widget.



  2. Use that widget in a sidebar and provide its title.



  3. Now check out the front end of your site and you will have the Property Types widget working.



Advance Search Widget

  1. Go to Appearance > Widgets and look for RealHomes - Advance Search widget.



  2. Use that widget in a sidebar and provide its title.



  3. Now check out the front end of your site and you will have the Advance Search widget working for your site.



dsIDXpress IDX Plugin

You can include IDX contents to your site. The easiest way to get started is to use the dsIDXpress IDX Plugin.

  1. First you have to register a trial account at www.diversesolutions.com and get an activation key.
  2. After that you have to install dsIDXpress (http://wordpress.org/plugins/dsidxpress/) and activate it using activation key you got from registering with divers solutions website. Related screen shot is given below.



  3. After activation you can access your IDX listing using following URL format www.yourwebsite.com/idx/
  4. After activation you have to set General settings for IDX as displayed in screen shot below.



  5. Now, You can use dsIDX widgets in sidebars. We have a special template for dsIDX where you can place dsIDX widgets in related sidebar.



  6. Note: The easiest way to access IDX listing Page is, http://www.yoursitename.com/idx
    You can add IDX Listing Page in menu as displayed in screen shot below.



dsIDXpress Search Widget on Homepage

Follow the steps below to use the dsIDXpress search widget on homepage.
1. Go to Appearance >> Widgets

2. Look for the widget area named Home Search Area and put IDX Search widget with in it.



3. After that visit the homepage and you wil have the dsIDXpress search widget in place of Real Homes default search form.



Shortcodes

1st List Style

Shortcode Example

Output Example



2nd List Style

Shortcode Example

Output Example



3rd List Style

Shortcode Example

Output Example



4th List Style

Shortcode Example

Output Example



Buttons

Shortcode Example

Output Example



Messages

Shortcode Example

Output Example



Translating The Theme

This theme is translation ready.
  1. For translation to only one language please visit This Knowledge Base Article
  2. For translation to multiple languages you can use WPML Plugin

How to Modify Styles

There are various options available to modify styles in this theme.
  1. Theme Options - Go to 'Appearance > Theme Options' for various styles related sections.
  2. Quick CSS - Go to 'Appearance > Theme Options > Styling > Quick CSS' to write some short css.
  3. Custom CSS in Child Theme - 'child-custom.css' file is provided in child theme to add major css changes.



  4. Custom CSS in Parent Theme - if you are not using child theme then 'css/custom.css' file is provided in parent theme to add major css changes.