“WP Pro Real Estate 6” Documentation by “Chris Robinson (contempoinc)” v1.6.7

“WP Pro Real Estate 6”

Created: 1/21/2014
By: Chris Robinson (contempoinc)
Support: http://support.contempographicdesign.com

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please open a ticket on the support site here.

You can also view my ThemeForest profile here, visit my theme and stock art preview site here, or follow me on Twitter here.

Table of Contents

Installation - top

Please follow the installation initial instructions below.

  1. Unzip the final zip file; you should now have a final download folder.
  2. Do NOT upload the final download folder. Open up the final download folder.
  3. Browse the contents and find the realestate-6.zip file.
  4. Unzip and upload ONLY the theme folder to your "wp-content/themes" folder.
    • Optional: If you do not wish to manually upload the theme only folder to your "themes" folder, there is an option. You can upload the Lofty.zip via the WordPress themes admin panel by selecting "add new" and clicking "upload".
  5. Login to your Wordpress admin and navigate to Appearance > Themes > locate "WP Pro Real Estate 6" and activate it.
  6. Once activated you will be redirected to the Options panel, where you can configure the theme. Make sure to throughly go through each panel and famalirize yourself with everything, there are a bunch of options to configure.

Importing the Dummy Data

If this is a new installation and you would like some dummy content I've included an XML file with all the content from the theme demo.

  1. Go to Tools
  2. Click Import > Select Wordpress
  3. Click Browse > Find the supplied "wpprorealestate6.wordpress.2014-01-21.xml" located within the main folder > Multi Demo XML
  4. Click Upload file and import
  5. That's it!

Homepage Setup

  1. Create a page > name it Home > apply the Home page template > Publish
  2. Settings > Reading > Front Page Displays > Set to the Home page you just created > Save
  3. Now go into Admin > WP Pro Real Estate 6 Options > Enable/Disable and orgainize the blocks you want
  4. Save Settings
  5. And you're good to go!

Choosing your Theme Mode

  1. Go into Admin > WP Pro Real Estate 6 Options > General > Multi-Listing or Single Listing Mode? > choose your mode
  2. If you've chosen Multi move on to the Homepage tab, see step 3 above
  3. If you've chosen Single > go into Tools > Import > Upload > navigate to the main folder you unzipped from Themeforest > Single Demo XML > wpprorealestate6.wordpress.2015-05-26.xml > Import the demo data
  4. The single mode will display the latest listing added with the status of Featured
  5. That's all there is to it!


Homepage Setup: - top

Listings Search Field Manager

Here you can add/remove/sort fields for the advanced search area.

Layout Manager

There's no wrong or right way to setup your homepage, a countless number of possible setups are available.


If you've enabled the slider you can add slides/content by scrolling further down and finding the Slides manager section on the Homepage panel

Adding & Managing Listings - top

Custom Taxonomies and Usage: - top

You'll notice the theme makes heavy use of Taxonomies for the Listings, each of these are detailed out below:

Uploading Listing & Blog Post Images: - top

You'll use Appearance > Menus to build out your navigation. What you can do is use the Advanced search area and select one or mulitple taxonomies to search on and that URL that is generated you can use to build a Custom Link for your navigation.

For instance:

More on the Menus screen can be found here: http://codex.wordpress.org/Appearance_Menus_Screen

Managing Agent/User Information - top

Front End Listings Submission System - top

Please see dsIDXpress Getting Started Guide for all the information you need to start using the plugin on your site.

If you want to enable pretty permalinks, I highly suggest you use this custom structure /%year%/%monthnum%/%postname%/

I've also included the ability to change the Category, Tag and Author base slugs. For instance you can change the default http://example.com/author/username to http://example.com/agents/username when using the Author Base field under Settings > Permalinks > Optional.

Custom Widgets - top

This theme comes chock full of custom widgets, FIFTEEN to be exact!

WPML top

This theme is WPML compatible, the plugin makes it easy to translate your website into multiple languages. The “String Translation module” is included with the "Multilingual CMS package" and will allow you to translate any strings not included inside posts, pages or taxonomies. It’s very easy to use and is located at WPML > String Translation.

Below is the link to the guide on the WPML website which goes into greater detail. I would strongly recommend you check it out.

Get WPML Here View Documentation

Once installed and configured the lang switcher in the header will automatically appear, based on the languages you've set.

Translation top

Need to translate the theme into another language? No problem, it's fully localized and translation ready. Follow the simple steps below:

With a Plugin (Recommended)

Easiest way is to use a plugin like WPML above, everything is done through your WordPress admin and its simple as 1, 2, 3!

Manually with POEdit

This is the more labor intensive way, it requires downloading third-party software, making file edits offline and uploading via FTP using a program like FileZilla. I'd recommend using the plugin method above.

1. Download and install PoEdit.

We need PoEdit to translate a theme. Its a free software and its available for Mac, Windows and Linux. Download PoEdit from this page.

2. Create a new catalog (the local language file)

Now PoEdit will ask you to name the file. Its very important to name the file correctly. The naming convention for these files is languageCode_countryCode. The language code must be in lower case while the country code should be in upper case. So, if you are translating the theme for UK English, the file name will be en_UK. Similarly, for translation to french, it will be fr_FR and so on. You can find a list of language codes at this page and country codes here.

3. Translate the Theme

This is the step where we will actually translate the theme. After Step 2 above, you'll see the standard interface of PoEdit where the left panel contain the strings in the original language and the right panel containing the translations. The right panel will be empty as we haven't started the translation yet.

Start translating each string one by one. Click on the first string and press Tab button. This will take you to the translation box in the bottom. Type the translation here. Your change will reflect immediately in the right panel. Once you are done with this string, press Enter and move on to the second string. Repeat this procedure until all the strings are translated. After the translation is done, save the file.

Then open wp-config.php located in the root of your WordPress installation and change line 72 to reflect your new language file.

4. Upload The Files To Your Server

When you save the catalog file in Step 3 above, PoEdit will create two files, a .po file and a .mo file. Upload both these files to the languages directory of your theme. Also upload wp-config.php to the root of your WordPress installation and you'll be good to go.

Custom Shortcodes - top

This theme comes loaded with a bunch of custom shortcodes, all to make your life oh so much easier. What are shortcodes? They're are simple macro codes to be used in WordPress post content. There's no need for any HTML knowledge!

Using shortcodes has never been easier, launch the visual shortcode generator by clicking the red button with the S on it within the post editor bar.

CSS - top

Main Stylesheet - style.css

This file contains the styling table of contents, outlining the different files included and where each styles are coming from.

If you would like to edit a specific section of the site, simply find the appropriate label in the CSS file, and then scroll down until you find the appropriate style that needs to be edited.

Other Stylesheets Included

JavaScript - top

This theme imports six Javascript files.

  1. base.js - This is the main JS file it controls a few different things, its well commented for easy customization.
  2. ct.mobile.menu.js - Used for mobile menu select, this one doesn't require any editing.
  3. foresight.min.js - Used for retina displays, this one doesn't require any editing.
  4. infobubble.js - Used for map infobubbles, this one doesn't require any editing.
  5. jquery.fitvids.js - Used for fluid width video embeds, this one doesn't require any editing.
  6. jquery.flexslider.min.js - This is the main FlexSlider file, this one doesn't require any editing.
  7. jquery.prettyPhoto.js - This is the main PrettyPhoto file, this one doesn't require any editing.
  8. jquery.validationEngine.js - The form validation is handled by this file, this one doesn't require any editing.
  9. mapping.js - This controls all the advanced mapping functions for the theme, wouldn't recommend editing this one unless you're a JavaScript wiz.
  10. markerwithlabel.js - This is a Google Maps plugin allowing custom marker labels, this one doesn't require any editing.
  11. respond-min.js - A fast & lightweight polyfill for min/max-width CSS3 Media Queries (for IE 6-8, and more), doesn't require any editing.
  12. retina.js - Used for retina displays, this one doesn't require any editing.

PSD Files - top

This is a responsive design so no layout PSDs are included, but if you'd like to say mock up a new template I'd recommend screenshoting the live site then opening that in your favorite editor say Photoshop then making your edits by cutting and slicing.

The single PSD that is included is for the listing map pin, located in the PSD folder from the main download.

Child Theme Generator top

With WP Pro Real Estate 6 you can create child theme in a couple clicks! No fussing about with creating files, folders, FTP, etc…

Why Use a Child Theme?

There are a few reasons why you would want to use a child theme:

How to Create a Child Theme

  1. Go into your WordPress Admin
  2. Appearance > Create Child Theme
  3. Fill in the Name & Description
  4. Click Create Child
  5. Happy Editing!

Find any CSS property, Quickly & Easily

A theme can contains thousands of CSS properties, a super quick and easy way to find what controls what is using your browsers built-in developer tools. Once you learn how to leverage this you'll be saying "How did I ever get along without this in the past!".

  1. Open your site in your favorite browser, like Google Chrome ;)
  2. Find the element the you'd like to modify
  3. Right click > Inspect Element
  4. You'll notice a new pane open in the bottom of your browser window
  5. One with Source Code and the other CSS
  6. That's it!

More resources on Using Child Themes

Support - top

Please see the Support Site.

FAQ - top

Please see the Knowledgebase on the support site.

Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.

Chris Robinson

Go To Table of Contents