This documentation assumes you are running version 2.76 of the theme. If you are running an older version, please consider updating it to 2.76. See the change log to see what the latest features are. Caution when upgrading! If you modified any theme files, they will get overwritten with the updated theme files. You have been warned!
If you have any problems or questions, please check out or make a new post on our Support Forum.
Installing this theme
You should be able to install the theme directly inside of WordPress. Go to the Themes menu on the left of wp-admin, select “Add New Themes”, and then click “upload”. Select the supplied OpenHouse theme zip file and you’re done.
However, in my personal experience, this rarely works. So I just install it manually. To install manually, you’ll need an FTP program. The Firefox (web browser) plugin FireFTP works perfectly. Unzip the supplied OpenHouse theme (it should be zipped). On the server, navigate to your Themes folder. Create a subfolder called “OpenHouse” (or something else if you wish), and then upload all the theme files to that folder.
Once uploaded, you can go to the Themes section of WordPress wp-admin and then activate the new theme.
Ok, it should be installed. Now on to the steps to get your new site functional!
IMPORTANT PATCH! (version 2.78)
The latest version on Themeforest is 2.76. But I have updated it with a couple new features:
1. Much better Theme Options screen. Totally revamped and improved.
2. The “features” section in the listing detail page. When you make a post, you check off the features from a list of features that you define ahead of time. They are then displayed automatically as 3 columns of bulleted features.
To get this update, download the 2.78 patch here: http://dl.dropbox.com/u/418387/themeforest/OpenHouse/update_v2.78.zip.
Unzip it and upload to your site, being sure to keep the EXACT same file structure.
IMPORTANT NOTE FOR PEOPLE “UPGRADING” from version 2.75 or earlier: Version 2.76 and higher includes a change in how the ‘secondary search locations’ work. You now enter info in regular “text” files, rather than “javacript” files. So if you’re upgrading, you WILL need to create new text files for your secondary search locations.
Also note, if you’re upgrading from a previous version of the theme, after updating the files, you’ll need to go to Appearance -> Theme Options, and click any of the “Save” buttons. That will refresh the site and activate any new changes.
You can skip steps 1 and 2 below by doing this, and also have some sample Property Listings and Posts to get you started. You can import the demo OpenHouse WordPress database to get started extra quickly. If you do this then your site will have all the same Posts, Pages, Property Listings, comments, etc. as the demo site. Some people have requested this, so here you go! In wp-admin, simply go to the Tools tab and click Import. Choose the WordPress option, and then select the file above that you downloaded.
If you do this then you can safely skip steps 1 and 2 below.
Step 1: Create your Blog or News categories
Assuming you want to post articles to your site, you will need to create Categories for them. You can create a category called “News” (to hold news related posts), “Blog” (for general blog type posts), or any other category name. The live demo has 2 categories called “News” and “Blog”. Feel free to have only one or the other; both are not required. You can also create sub-categories under the main categories if your posts benefit from them.
Note: DO NOT create a category for your property listings. The listings don’t use categories at all.
Step 2: Search Results Page
Create a new “Page”, using the Page Template called “Search Results”. Enter a “Title” for the post… for example “Search Results”. You can leave the content blank. Publish it.
In Appearance -> Theme Options ->General, set the “Search Results Page” to the Page that you just created.
Step 3: Create the Menus
Before doing this, please watch this nice video tutorial (will open in a new window) that explains this feature.
This theme has a main menu in the header and a smaller menu in the footer. The menus are generated using WordPress’ new “Menus” feature. In the wp-admin, under the Appearance tab, click on “Menus” to access the Menus page.
Click the “+” tab to add a menu called “Main”. This will be the main menu in the header. Click the “Save Menu” button. Click the “+” tab again to create another menu called “Footer”. Click the “Save Menu” button again.
In the Theme Locations section, set the Main Navigation Menu to be “Main”, and the Footer Navigation Menu to be “Footer”. Click the “Save” button.
Click on the “Main” tab to activate the Main menu. In the Pages and Categories sections, check all the boxes for the pages and categories that you want to add to this Main menu. You can click/drag the results to be in the exact order that you want.
Click on the “Footer” tab, and do the same thing that you did in the previous step.
Note: Whenever you add a Page or a Category, then you will need to come into this “Menus” page and add it to your Header and Footer menus. Sorry, this is not my fault… it’s a quirk from WP 3.0.
Also note: In Step 2 you added a “Search Results” page. You will not want that page in your menus. To exclude it from the menus, simply don’t add it to the menus!
Step 4: Permissions for timthumb script
This theme relies on the Timthumb.php script for taking your original large image, and repurposing it in other sizes throughout the site (like in the slideshow, thumbnails, etc.) That way you don’t need to upload more than one Portfolio or Blog image.
The /scripts folder, and scripts/cache folder must be set to a permission setting of 0777. That allows it to read and write. If it is not 0777, then the images on the site will not show up. You will need to access your site folders to change the folder permissions.
I recommend the free FireFTP plugin for Firefox. Simply log in to your server. Right-click on the folders, choose Properties, and change the number to 0777.
Step 5: Set up the Contact Form for the Listing pages
Each property detail page (Listing page) contains a contact form at the bottom, next to the Google Map. The contact form by default is a generic one that will not go to the Listing’s Agent. This step is only for creating this generic contact form. For details on setting up a contact form for each Agent, go to the Agents documentation page.
The contact form requires the Contact Form 7 plugin. Click here to get it. Once installed, go the the “Contact” section in the wp-admin (bottom left of the screen). Set up the form to your requirements, or leave it at the default. Copy the “shortcode” at the top of the screen. Now go to Appearance ->Theme Options -> Miscellaneous -> Contact Form Shortcode, and paste the code in that you copied.
Enjoy your new theme! You are now ready to post a property Listing, or blog/news post. Click here for details on adding a Listing and news/blog post.
It’s not critical at this point, but you will notice that your site does not have a logo. Go to Appearance ->Theme Options -> General, under Logo URL, give the full URL to your image. Also set the width and height of the image. If the logo isn’t positioned exactly right, you can enter values in “Logo position X” and “Logo position Y” to fine tune it’s position.
Every other setting in Theme Options isn’t critical at this point. The theme should be working… you now just need to add some content!
This theme has many great features and options. To get the most of the theme, please read the rest of the online help which is accessible directly from the “Documentation” menu above.