“WP Pro Real Estate 3” Documentation by “Chris Robinson (contempoinc)” v1.3.3
“WP Pro Real Estate 3”
MafiaShare.net
Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form 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
- Homepage Setup
- Custom Taxonomies and Usage
- Uploading Listing & Blog Post Images
- Building Out Your Navigation
- Using Permalinks
- Custom Widgets
- Translation
- Custom Shortcodes
- CSS
- JavaScript
- PSD
- FAQ
A) Installation - top
Please follow the installation initial instructions below, and I've also created seven screencasts covering everything you need to get started.
- Unzip the final zip file; you should now have a final download folder.
- Do NOT upload the final download folder. Open up the final download folder.
- Browse the contents and find the realestate_3 theme folder.
- 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 zip up the theme folder (remember, ONLY the theme folder) and upload it via the WordPress themes admin panel by selecting "add new" and clicking "upload".
- Login to your Wordpress admin and navigate to Appearance > Themes > locate "WP Pro Real Estate 3" and activate it.
- 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.
- 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.
- Go to Tools
- Click Import > Select Wordpress
- Click Browse > Find the supplied "wpprorealestate3.wordpress.2012-03-13.xml" located within the main folder
- Click Upload file and import
- That's it!
B) Homepage Setup: - top
There's no wrong or right way to setup your homepage, a countless number of possible setups are available.
- Featured Map and Listings block - Activated by default, either one can be toggle on/off independently.
- Call To Action - Activated by default, can be toggle on/off.
- Homepage Widget Area - Any number of widgets can be added here, I've used the Text and Listings widgets in the demo site.
- Homepage Sidebar - Same as above any number of widgets can be added here as well, I've used the Brokers Info, Agent Info, Follow Us and Latest Posts widgets in the demo site.
C) 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:
-
Property Type: Can be anything you wish and as many as you like, in the demo I've only used two Condo/Townhome & Single Family Home.
- Commercial, Land or Lot: Any listing given this type will remove the "bed, bath & on" sitewide.
- Beds: Number of beds, can be any amount you like.
- Baths: Number of baths, can be any amount you like.
- Status: Can be anything you wish and have as many as you like, in the demo you'll notice I've used a few. Although there are some that are necessary to add for certain functions.
- Featured: Any listing given this status will appear in the homepage area and large map.
- For Rent: Any listing given this status will add "Rental" text in front of the price.
- Reduced: Any listing given this status will add a red "Reduced" flag over the image across the site.
- Sold: Any listing given this status will add an orange "Sold" flag over the image across the site.
- Open House: Any listing given this status will add a green "Open House" flag over the image across the site.
- Available: Any listing given this status will add a green "Available" flag over the image across the site.
- City: City the listing is located in, used for mapping.
- State: State the listing is located in, used for mapping.
- Zipcode: Zipcode the listing is located in, used for mapping.
- Additional Features: Can be anything you like, and as many as you like. Some I've used in the demo: Concierge, Forced air heat, Family room is 20×12, Single story, etc…
D) Uploading Listing & Blog Post Images: - top
- Listings: No messing around with copy/pasting URL's for images, this theme makes it so easy to add unlimited photos to your listings:
- Open up a listing
- Click the image icon next Upload/Insert
- Click Select Files
- Select all your files you wish to upload
- Once uploaded, click Save all Changes at the bottom
- That's it! You can close the window, click Publish or Update and view your listing.
- Now if you would like to select a different first image or re-order the other images for the slider:
- Open up a listing
- Click the image icon next Upload/Insert
- Click the Gallery tab
- Now you can click and drag your images around to sort them, the first image in the list will always be your main image.
- Blog: Blog postings work the same way as above however they only support one main image.
E) Building Out Your Navigation - 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:
- For Sale & San Diego:
http://yourdomain.com/?ct_city=san-diego&ct_status=for-sale&property-search=true
- For Rent
http://yourdomain.com/?ct_status=for-rent&property-search=true
- 1 Car Garage
http://yourdomain.com/?ct_additional_features=1-car-garage&property-search=true
- 3 Beds
http://yourdomain.com/?ct_beds=3&property-search=true
More on the Menus screen can be found here: http://codex.wordpress.org/Appearance_Menus_Screen
F) Using Permalinks - top
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.
This theme comes chock full of custom widgets, FIFTEEN to be exact!
- Adspace - Use this widget to add any type of Ad as a widget.
- Agent Info - Use this widget to display your listing agent information, can only be used in the Listing Single sidebar as it relies on listing information for content.
- Agents Other Listings - Display your agents other listings, can only be used in the Listing Single sidebar as it relies on listing information to function properly.
- Blog Author Info - Use this widget to tell your audience a little bit about your company and all the awesome things you do! Optional Gravatar, and Read More link.
- Broker Info - Use this widget to display your brokers information.
- Contact Info - Use this widget to display your contact information.
- Flickr - Use this widget to populate photos from a Flickr ID.
- Follow Us - Use this widget to show your social profiles.
- Latest Posts - Use this widget to display your latest posts.
- Listings - Use this widget to display your listings from any taxonomy and tag combo.
- Listings Agent Contact - Display an agent contact form. Can only be used in the Listing Single sidebar as it relies on listing information for content.
- Listings Search - Use this widget to display the advanced listings search form.
- Search - Use this widget to display the blog search form.
- Tabs - Use this widget to display Latest Posts, Recent comments and a Tag cloud.
- Twitter - Use this widget to display your latest tweets.
H) Translation - top
Need to translate the theme into another language? No problem, it's fully localized and translation ready. Follow the simple steps below:
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)
- Start PoEdit and click on the File menu and select the option New catalog from POT file.
- This will open the file dialog box. Go to the languages folder of the theme. Select All Files from the file dialog box, and open the en_US.po file in the languages folder.
- Now PoEdit will ask you for various configuration options. The most important thing here is to choose the correct country and language you are translating to.
- In the remaining fields of the configuration window, fill the required information or just leave them empty.
- Now click on the Paths tab and change the path variable to the place where your theme files are located.
- Then press OK.
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.
I) Custom Shortcodes - top
This theme comes loaded with 22 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, they can all be used directly from the Post Editor toolbar using the quick insert buttons.
- Content shortcodes and instructions can be found here
- Layout shortcodes and instructions can be found here
J) 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.
- 1. Base (css/base.css)
- 1.1 Reset
- 1.2 General
- 1.3 Typography
- 1.4 Margins & Padding
- 1.5 Links
- 1.6 Lists
- 1.7 Images & Video
- 1.8 Buttons
- 1.9 Tabs
- 1.10 Forms
- 1.11 Tables
- 1.12 Notifications
- 1.13 Widgets
- 1.14 Misc
- 2. Framework (css/framework.css)
- 2.1 Base 960 Grid
- 2.2 Tablet (Portrait)
- 2.3 Mobile (Portrait)
- 2.4 Mobile (Landscape)
- 2.5 Clearing
- 3. Layout (css/layout.css)
- 3.1 Site Styles
- 3.2 Page Styles
- 3.3 Media Queries
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
- css/comments.css - styles for comments.
- css/ct-dropdowns.css - styles for the main navigation.
- css/flexslider.css - styles for FlexSlider, recommend leaving this file alone.
- css/post-print.css - styles for printing posts.
- css/prettyPhoto.css - styles for PrettyPhoto, recommend leaving this file alone.
- css/validationEngine.jquery.css - form validation styles, recommend leaving this file alone.
K) JavaScript - top
This theme imports six Javascript files.
- core.js - This is the main JS file it controls a few different things, its well commented for easy customization.
- jquery.fitvids.js - Used for fluid width video embeds, this one doesn't require any editing.
- jquery.flexslider.min.js - This is the main FlexSlider file, this one doesn't require any editing.
- jquery.prettyPhoto.js - This is the main PrettyPhoto file, this one doesn't require any editing.
- jquery.touchdown.min.js - Converts lists of links (`<ol>` or `<ul>`) to dropdown lists (`<select>`) for mobile devices, this one doesn't require any editing.
- jquery.validationEngine.js - The form validation is handled by this file, this one doesn't require any editing.
- mapping.js - This controls all the advanced mapping functions for the theme, wouldn't recommend editing this one unless you're a JavaScript wiz.
- markerwithlabel.js - This is a Google Maps plugin allowing custom marker labels, this one doesn't require any editing.
- tabs.js - Simple tabs script.
L) PSD Files - top
This is a responsive design so no 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.
M) FAQ - top
Q: The map on the homepage isn't loading it just keeps spinning.
A: Make sure you tag at least one listing with Featured under the Status taxonomy and you'll be good to go.
Q: My request more info widget and contact page aren't working?
A: Make sure in WP Real Estate 3 Options > Contact > Success that your message is restricted to one line, meaning there's no line breaks. Otherwise this will break the validation/processing script.
Q: I get a "Broken Theme/Stylesheet Missing WordPress" error when uploading or activating?
A common issue that can occur with users new to installing WordPress themes is a "Broken theme and/or stylesheets missing" error message being displayed when trying to upload or activate the theme.
This error message does not mean that the theme you have purchased is broken, it simply means it has been uploaded incorrectly.
Luckily, there is a very easy fix: http://wiki.envato.com/buying/support-buying/solving-broken-theme-issues/
Q: My images aren't showing up?
- You need to give your realestate_3 > img_resize > cache folder full permissions. In most cases this is "777" but it may vary depending on where you are hosted. If 777 does not work, try 755. It is recommended that you contact your host about what permissions to use if you are not sure. Settings permissions is also known as CHMODing, and can be done using most FTP programs and hosting control panels.
- Make sure you have GD library installed on your server, comes by default wtih any running PHP 4.3+
- Some servers may have mod_security settings that will stop the script from working. You should always contact your host if you are having problems to make sure they do not have settings enabled that would stop the script from working.
Q: Having trouble with pagination on your Agents page with custom permalinks enabled?
A: Try disabling all plugins and change permalink settings back to default, then change permalinks back to your custom structure.
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