AgentPress

Thank you for choosing the AgentPress child theme. Before you get started, please refer to the documentation provided here for Installing a child theme. You may also want to have the demo opened so you know how it should be set up.

In this tutorial you will find:

How to Create Taxonomies
How to Create Listing Terms
How to Create a Property Listing
How to Configure the Home Widget Areas
How to Configure the Slider
How to Configure the Property Search Box
How to Setup the Header and Menus
How to Configure the Blog Page and Primary Sidebar Widgets
How to Configure the Footer Widgets and Disclaimer
Modifications and Customization

If you have any trouble, please fill out the contact form and we will be happy to help you.

This theme has a special home page template that requires widgets to be dragged into place. Until the widgets are configured, the most recent posts will be on the home page.

While we have provided demo content, it is important to note that plugins must be installed and taxonomies created before the import can take place. We have included below when it is appropriate to import the demo content.

Download the Plugins

You will need the following plugins:

AgentPress Listings
jQuery Lightbox For Native Galleries
dsIDXpress IDX Plugin
Genesis eNews Extended newsletter widget
Genesis Slider
Social Profiles widget

Go to Plugins -> Add New and search for each plugin name. Click Install and Activate for each one listed.

Once you have the AgentPress Listings plugin activated, you should see a link called “Listings” in the sidebar of your WordPress dashboard. This is where you will be able to manage your listings.

Back to Top

How to Create Taxonomies

Setup your property “categories” by clicking the Register Taxonomies link. On the AgentPress demo examples of these would include Property Status, Property Type, Property Price, Property Location and Property Bedrooms. After you create each listing taxonomy, it will show up as a link in the Listings menu in the sidebar.

Note: It is very important to use only lowercase letters for the ID when registering your taxonomies, as shown in the image below.

Here’s an example of the AgentPress Demo taxonomies screen:

AgentPress Listing Taxonomies

You can see we used the following:
status
types
bedroom
price
location

Back to Top

How to Create Listing Terms

Once you have your taxonomies setup, you should create the “terms” for each taxonomy. Click on the taxonomy link in your sidebar to add your terms. Examples of these would be For Sale, Sold Properties and Under Contract which would fall under the Property Status taxonomy.

Here’s an example of the AgentPress Demo terms screen:

AgentPress Listing Terms

Do the same for each Listing Taxonomy. We used the following terms for each:

status – For Sale, Sold Properties, Under Contract
types – Condominium, Single Family Home, Town Home
bedroom – 2 bedrooms, 3 bedrooms, 4 bedrooms, 5+ bedrooms
price – $100K-$250K, $250-$500k, $500k-$750k, $750K and up
location – Arlington Heights Barrington Hoffman Estates Mount ProspectPalatine Schaumburg

If you wish to use different taxonomies here, type those instead.

If you wish to import the demo content, you may do so now. This will give you all the posts, pages, listings, menus and comments we have on the demo site.

Back to Top

How to Create a Property Listing

Since you’ve already setup your listing taxonomies and terms, click the Add New link that is under the Listings menu in the sidebar of your WordPress dashboard. You’ll see a screen that is similar to the Add Post or Add Page screens.

Once you are there, it’s time to give your listing a title and start entering content. Typically you’d want your listing title to be the address of the property since that is what will be indexed by search engines. An example of this might be 1333 North Park Avenue.

Upload Property Photos

As you can see from the sample property, there is a photo of the house at the top of the content. You can upload a photo through the WordPress Add Media button just above the text editor. After you upload your photo, you’re given the option to add the photo to the listing.

When uploading multiple photos, choose the image you wish to feature in the slider and upload that image first, or click to mark it as the Featured Image.

Fill out the Property Details

Just below the text editor on the edit listing screen you will see a box called Property Details. Fill out the information in the box, and then you can click “send to text editor” button and it will insert a shortcode into your listing content.

To manually add the shortcode into your listing, copy and paste [property_details] and place it wherever you want the property details box to appear on your listing.

Here’s an example of how the Property Details box looks like on a listing:

AgentPress Property Details

Show Maps and Videos

You will also notice inside the Property Details box that you have the option to place map code and video code. This gives you the ability to show a map of your property listing as well as a video if you’d like. Fill out the boxes in the same way as you did the property details above.

To manually add the property map shortcode into your listing, copy and paste [ property_map ] and place it wherever you want the property map to appear on your listing. You can use [ property_video ] for the shortcode to display the property video.

Additional Photos

If you want to have a place on your property listing for a gallery of photos, you can easily do that by uploading all of the photos in the same way you did the photo of the house as mentioned above.

Once you have uploaded the photos, you have the option to “Insert Gallery” which will automatically generate and place the shortcode into the text editor. To manually add the property map shortcode into your listing, copy and paste [ gallery columns=”5″ size=”featured” link=”file” ] and place it wherever you want the additional photos to appear.

If you would like your additional photos to open up in a lightbox, then you will need to download and install the jQuery Lightbox For Native Galleries plugin. While this plugin is no longer being updated, it is the best of it’s type and does continue to work as intended.

Here’s an example of how the Additional Photos looks like on a listing:

AgentPress Additional Photos

Back to Top

How to Configure the Home Widget Areas

Please refer to our widget diagram as needed.

How to Display a Featured Blog Section

You’ll notice on the AgentPress demo we have displayed a “From the Blog” section.

AgentPress From the Blog

If you would like to display a featured blog section on your homepage, follow these steps:

Create Blog Posts

Create some blog posts within your WordPress dashboard, where you upload an image that will be used to represent the blog post. This image will be the featured image on archive pages and on the home page. Feel free to add as much content to the post as you wish.

Click to view a sample Blog Post

Add Featured Posts to the Widget Area

Once you have created a number of blog posts, go to the Appearance > Widgets screen in your WordPress dashboard and add a Genesis – Featured Posts widget to the Featured Bottom Left widget area on the right hand side of your screen.

To configure each widget, you can choose the options as you see below:

AgentPress Featured Blog Widget

How to Display a Welcome Message

You’ll notice on the AgentPress demo we have displayed a “Welcome” message.

AgentPress Welcome Message

To display this on your homepage, follow these steps:

Add Welcome Text to the Widget Area

Go to the Appearance > Widgets screen in your WordPress dashboard and add a text widget to the Welcome widget area on the right hand side of your screen.

To configure the widget, you can choose the options as you see below:

AgentPress Welcome Widgets

This is the HTML we used in the text widget.

<a href="http://demo.studiopress.com/agentpress/how-much-is-my-home-worth"><img src="http://demo.studiopress.com/agentpress/files/2011/10/call-to-action-blue.jpg" alt="AgentPress Call to Action" /></a>

You can change this to whatever you like.

How to Display the Featured Listings

On the AgentPress demo we have displayed a “Featured Listings” section.

AgentPress Featured Listings

To display featured listings on your homepage, follow these steps:

Create a Property Listing

If you haven’t already, you’ll need to create some property listings. While doing that, you can enter content, add photos, fill out property details and include media such as videos and maps. You can also use the demo content for this.

Click to view a sample Property Listing

Add Featured Listings to the Widget Area

Once you have created a number of property listings, go to the Appearance -> Widgets screen in your WordPress dashboard and add a AgentPress – Featured Listings widget to the Properties widget area on the right hand side of your screen.

To configure each widget as we did, choose the options as you see below:

AgentPress Listings Widgets

How to Display the Communities Section

On the AgentPress demo we have displayed a “Communities” section.

AgentPress Communities Section

To display this on your homepage, follow these steps:

Create a Community Page

Create a page within your WordPress dashboard, where you upload an image that will be used to represent the community. Feel free to add as much content to the page as you wish.

Click to view a sample Community page

Add Communities to the Widget Area

Once you have created a number of community pages, go to the Appearance > Widgets screen in your WordPress dashboard and add a Genesis – Featured Page widget to the Communities widget area on the right hand side of your screen.

To configure each widget, choose the options as you see below:

AgentPress Communities Widgets

Back to Top

How to Configure the Slider

You’ll notice on the AgentPress demo we have displayed a “Featured Slider” section.

AgentPress Featured Slider

If you would like to display a featured slider on your homepage, follow these steps:

Create Property Listings

If you haven’t already, you’ll need to create some property listings. While doing that, you can enter content, add photos, fill out property details and include media such as videos and maps. Upload the slider images after the slider settings have been saved.

Click to view a sample Property Listing

Add Slider to the Widget Area

The first thing you need to do is install the Genesis Slider plugin so go to the Plugins > Add New screen in your WordPress dashboard. In the searchbox, enter Genesis Slider, follow the auto-install directions and the activate the plugin once it’s installed.

Go to the Appearance > Widgets screen in your WordPress dashboard and add a Genesis – Slider widget to the Slider widget area on the right hand side of your screen.

Go to the Genesis > Slider Settings page in your dashboard and configure the settings. You can choose the options as you see below:

AgentPress Slider Settings

Back to Top

How to Configure the Property Search Box

You’ll notice on the AgentPress demo we have displayed a “Property Search Box” section.

AgentPress Property Search

If you would like to display a property search box on your homepage, simply follow these steps:

Add Listing Search Widget to the Widget Areas

Once you have created a number of property listings, go to the Appearance > Widgets screen in your WordPress dashboard and add a AgentPress – Listing Search widget to the Top Search widget area on the right hand side of your screen, as well as the Property Search widget area. The Property Search widget area is next to the slider. The Top Search widget area is at the top of internal pages.

To configure each widget, you can choose the options as you see below:

AgentPress Search Settings

The search widget has settings to include specific criteria to search by. These are based on the taxonomies you have created previously.

Back to Top

How to Setup the Header and Menus

If you have imported the demo content, the menus will have been created for you, but you may need to assign them to the theme locations.

Click Genesis -> Theme Settings.
Navigation Settings -> Secondary Navigation:
Tick Enable Fancy Dropdowns?
Click Save Settings button.

Click Appearance -> Menus.
Click Primary Navigation tab.
In the top left of the Menus screen, under Theme Locations, select the Primary Navigation option from the drop-down under Primary Navigation Menu. This will assign the menu to the position above the slider. Also select the Secondary Navigation option from the drop-down under Secondary Navigation Menu. This will assign the secondary nav to the top of the homepage. Click Save Menu.

Drag the Social Profiles Widget widget to the Header Right widget area.

If a URL to that particular social media site is excluded, the icon will not appear. To display the links as shown in the demo, add the following links:

Code:
RSS: yourdomainhere.com/?feed=rss2
Facebook: facebook.com/youryusernamehere
Twitter: twitter.com/#!/yourusernamehere
Linkedin: www.linkedin.com/in/yourlinkedinnamehere
Select an icon size of 24px.
Save and Close the widget.

Drag a Text widget to the Header Right widget area above the Social Icons plugin. Leave the Title empty and check the box to add paragraph tags.

Upload a header under Appearance -> Header if you wish to change the header image.

Back to Top

How to Configure the Blog Page and Primary Sidebar Widgets

Create a Page called blog. This creates the right /blog/ permalink. Of course, you are free to use a differently named page, such as news.

On the right side of the page, in the Edit Page window, click the drop-down for Page Templates.

Select the Blog Page template and publish. Place this page on your menu. Now you will have a page off the home page that shows all your blog posts in chronological order.

Primary sidebar

For the email newsletter section:
Click on Appearance -> Widgets.
Drag the Genesis – eNews extended widget to the Featured Bottom Right widget area. Fill in the details for your specific newsletter service.

For the testimonials section:

Drag a Text widget under the Genesis – eNews and Updates plugin in the Featured Bottom Right widget area. Fill in your title. We used the following HTML in the text widget.

<div class="testimonials">
This is a sample testimonial from one of the realtor's clients. They've really been a pleasure to work with.<br>
<strong>~ Anthony, Hoffman Estates</strong>
</div>
<div class="testimonials">
This is a sample testimonial from one of the realtor's clients. They've really been a pleasure to work with. I highly recommend this agent.<br>
<strong>~ Madeline, Inverness</strong>
</div>

Back to Top

How to Configure the Footer Widgets and Disclaimer

To setup the Search Communities Footer
Click Appearance -> Widgets.
Drag a Custom Menu widget to the Footer 1 widget area, select the Homes For sale menu created by importing the demo content. You can also create your own menu.

For the Footer 2 widget area, we dragged a Recent Posts widget in place.

For Footer 3, we used the User Profile widget. This will show the same user on all pages. It is not tied to the user who authored the listings.

For Footer 4, we used the Simple Social Icons widget, and below that a text widget with contact details typed in.

To setup the Disclaimer text, drag a Text widget to the Disclaimer widget area and fill in your Disclaimer text of your choosing.

If you need to edit the footer details, please see our code snippets for the footer.

Back to Top

See this community tutorial to modify the listings to show by price.

How to Modify the Property Details Section

Many folks have expressed interest in modifying some of the fields that are being shown in the property details section. Currently, that section looks like this:

AgentPress Property Details

If you would like to modify the property details section, by adding elements or simply renaming a few fields, open up the functions.php file inside AgentPress 2.0 and look for the following code:

add_filter( 'agentpress_property_details', 'agentpress_property_details_filter' );
/**
 * Filter the property details array for property listings
 *
 */
function agentpress_property_details_filter( $details ) {
	
	$details['col1'] = array( 
	    __( 'Price:', 'apl' ) => '_listing_price', 
	    __( 'Address:', 'apl' ) => '_listing_address', 
	    __( 'City:', 'apl' ) => '_listing_city', 
	    __( 'State:', 'apl' ) => '_listing_state', 
	    __( 'ZIP:', 'apl' ) => '_listing_zip' 
	);
	$details['col2'] = array( 
	    __( 'MLS #:', 'apl' ) => '_listing_mls', 
	    __( 'Square Feet:', 'apl' ) => '_listing_sqft', 
	    __( 'Bedrooms:', 'apl' ) => '_listing_bedrooms', 
	    __( 'Bathrooms:', 'apl' ) => '_listing_bathrooms', 
	    __( 'Basement:', 'apl' ) => '_listing_basement' 
	);
	
	return $details;
	
}

All you need to do is rename the label and custom field key like this:

__( 'County:', 'apl' ) => '_listing_county',

Or you can add new labels and custom field keys like this:

	$details['col1'] = array( 
	    __( 'Price:', 'apl' ) => '_listing_price', 
	    __( 'Address:', 'apl' ) => '_listing_address', 
	    __( 'City:', 'apl' ) => '_listing_city', 
	    __( 'State:', 'apl' ) => '_listing_state', 
	    __( 'ZIP:', 'apl' ) => '_listing_zip'
	    __( 'County:', 'apl' ) => '_listing_county', 
	);

Back to Top

Congratulations! You are now ready to begin adding content and personal touches to your new Agentpress and Genesis powered website. If you run into any problems along the way or have questions, please fill out the contact form and let us know how we can help.