Posted on by Giri

Whoop Theme – Overview

Introduction

Do you ever wanted to have your own website like Yelp?  Don’t worry.. We have got you covered. GeoDirectory’s Whoop theme makes your GeoDirectory powered site look like a yelp clone as close as possible. Sounds cool eh..? Alright.. Its time to get our hands dirty. This documentation assumes that you have a fresh WordPress installation. Let’s get started.

Prerequisites

Before installing our theme, lets install its dependencies.

  1. GeoDirectory (Required)
    1. GeoDirectory Events (Optional)
    2. GeoDirectory Lists (Optional)
      1. Posts 2 Posts (Required for GeoDirectory Lists)
  2. BuddyPress (Optional)
    1. BuddyPress Integration ( Required )
    2. BuddyPress Follow (Optional)
    3. BuddyPress Compliments (Optional)
    4. Invite Anyone (Optional)
  3. bbPress (Optional)

IMPORTANT

If used with GD + BBpress + BuddyPress and possibly several add-ons, this is no tool for a shared hosting or the average VPS. Having a Directory, Forum and Social Network requires resources so make sure to use at least a High End VPS or a beefier Dedicated Server.

Permalinks Configuration

Navigate to Settings > Permalinks > Common Settings. Make sure Post name is selected.

GeoDirectory Installation

  1. Navigate to Plugins > Add New
  2. Search for GeoDirectory – Ultimate Business Directory
  3. Install it
  4. GeoDirectory needs at least one location in order to work. So Set a default location first by following this tutorial. ( Tip: If you need multi locations, check our MultiLocations addon )
  5. You must set GeoDirectory Pages.  Navigate to Geodirectory > Permalinks > Geodirectory Pages and set the pages
  6. gdpages

GeoDirectory Events Installation

  1. Visit wpgeodirectory.com ( Buy a subscription if Required )
  2. Navigate to My Account > Downloads ( Login if Required )
  3. Download Geodir Event Manager zip file.
  4. Go to your WordPress site dashboard, Navigate to  Plugins > Add New > Upload Plugin
  5. Browse and Upload the zip file you downloaded from wpgeodirectory.com
  6. Activate the plugin.

GeoDirectory Lists Installation

  1. Visit wpgeodirectory.com ( Buy a subscription if Required )
  2. Navigate to My Account > Downloads ( Login if Required )
  3. Download Geodir List Manager zip file.
  4. Go to your WordPress site dashboard, Navigate to  Plugins > Add New > Upload Plugin
  5. Browse and Upload the zip file you downloaded from wpgeodirectory.com
  6. Activate the plugin.

Posts 2 Posts Installation

  1. Navigate to Plugins > Add New
  2. Search for Posts 2 Posts
  3. Install it

BuddyPress Installation

  1. Navigate to Plugins > Add New
  2. Search for BuddyPress
  3. Install it
  4. After BuddyPress activation, navigate to Settings > BuddyPress and Enable the following components.
    1. Friend Connections
    2. Private Messaging

    buddypress

    buddy-components

    If BuddyPress pages not working, reset your Permalinks.

    To reset your permalinks,

    1. Navigate to Settings > Permalinks > Common Settings. 
    2. Select Default option and then save your settings.
    3. Now select Post name option and then save your settings again.

BuddyPress Integration Installation

  1. Visit wpgeodirectory.com ( Buy a subscription if Required )
  2. Navigate to My Account > Downloads ( Login if Required )
  3. Download Geodir Buddypress Integration zip file.
  4. Go to your WordPress site dashboard, Navigate to  Plugins > Add New > Upload Plugin
  5. Browse and Upload the zip file you downloaded from wpgeodirectory.com
  6. Activate the plugin.

BuddyPress Follow Installation

  1. Navigate to Plugins > Add New
  2. Search for BuddyPress Follow
  3. Install it

BuddyPress Compliments Installation

  1. Navigate to Plugins > Add New
  2. Search for BuddyPress Compliments
  3. Install it

Invite Anyone Installation

  1. Navigate to Plugins > Add New
  2. Search for Invite Anyone
  3. Install it

bbPress Installation

  1. Navigate to Plugins > Add New
  2. Search for bbPress
  3. Install it

Heads Up!

If you are planning to use BuddyPress, please install it first before installing whoop theme, since whoop creates some BuddyPress custom fields while theme activation. If you don’t do that, you may have to deactivate and activate the theme again and when you do that, your widget settings might get lost.

Theme Installation

Please follow this tutorial to install the theme.

Menus

Whoop has 2 menu locations.

The Main Menu

Footer Links

footer-links

For each menu location, please create a menu and assign to the location by following this tutorial.

Basic Configuration

Lets make sure we have some basic settings in order to make our theme work properly.

  1. Would you like to add Add listing ( Ex. Add Hotel ) and View Listing ( Ex. Hotels ) links to the Main Menu? If Yes Navigate to Geodirectory > Design > Navigation > Show geodirectory navigation in selected menu locations > Select The Main Menu

Header

If you have followed our instructions correctly so far, then your current header might look similar to this screenshot.

header-view

Upload your logo

We believe, you are interested in adding your logo. If this is the case, navigate to Whoop Options  > Header Styling Options > Site Logo, then upload your logo there by clicking upload button. Recommended logo size would be 160px width and 60px height. Make sure you click Save Changes button after setting your logo.

If you refresh your home page, now the header might look like this.

Add search box

Ok Lets add the search box in header.

  1. Navigate to Appearance > Widgets
  2. Click on “GD > Search” widget. A popup will appear with a list of widget locations.
  3. Scroll to the bottom of the popup. You will see a widget location named GD Header Right. Click on it. Make sure its checked. Then click Add Widget button. Refer the following screenshot.
  4. search-widget
  5. Thats it. Now refresh your home page. Your header might look like this.

Voila. Header part completed. That wasn’t so hard. Was it?

Footer

Footer Widgets
  1. Navigate to Whoop Options > Footer Styling Options > Enable footer widget areas
  2. Select the number of footer widget you need.

In our case we selected 4. So the Footer has 4 widget locations.

footer-wid-locations

So we need 4 menu widgets for our footer.

  1. Create 4 new menus by following this tutorial  But don’t set them to any menu location.
  2. You will see a widget called Custom Menu in Appearance > Widgets section.
  3. custom-menu
  4. Add that Custom Menu widget in all 4 widget locations and select menu for each widget location.
  5. select-menu
  6. You final result might look like this.
  7. footer-widget
  8. Footer widget section completed.
Copyright Text

Most likely, you would like to change your copyright text. If this is the case Navigate to Whoop Options > Footer Styling Options > Copyright Text

In that textarea field, clear everything and then enter your new copyright text. You can copy and paste the following text and alter as you prefer.

Copyright © 2004–2015 Whoop Inc. Whoop, Whoop logo, Whoop burst and related marks are registered trademarks of Whoop.

The result might look like this.

copyright-text

Footer Links

If you assign any menu to Footer Links menu location, then it will be displayed on the right side of copyright area.

Add some listings

Navigate to Places > Add New to add some listings. Please add at least 10 listings. If you are in a hurry then navigate to Geodirectory > General > Dummy Data and then populate your site with some dummy data which can be deleted later.

Tip: By default GeoDirectory supports only one post type called Places. So if you are planning to add more post types like Hotels, Restaurants, Bars etc., then check our Custom Post Types addon.

After adding some listings, you home page might look like this.

 

bbPress data

  1. Add some forums
  2. forums-forum
  1. Add some topics by visiting yourdomainname.com/forums . Make sure you created some forums first.
  2. Add some replies to each topic.

Available Widgets

A number of widgets included in whoop.  You can read more about each widget and its description by visiting this page.

Home Page

Navigate to Appearance > Widgets

Lets use some widgets to build our home page.

Before proceed, make sure you know about widget locations.  Widget locations indicated using arrows on the following screenshot.

wid-locations

Remove Default widgets from home page

Expand the following widget locations and completely remove all widgets from them.

  1. GD Home Top Section
  2. GD Home Content Section
  3. GD Home Right Section

Check the following screenshot for example.

remove-home-widget

 

Once you remove everything, the home page might look like this.

Now lets add some widgets to the these locations.

  1. GD Home Content Section
    1. Whoop > Your Next Review Awaits
    2. Whoop > Recent Activity
    3. GD > Best of widget
      1. Set Tab Layout to Tabs on Left
  2. GD Home Right Section
    1. Whoop > User Info
    2. Whoop > Review of the Day
    3. Whoop > Popular & Latest Events
    4. Whoop > Today in Talk
    5. GD List > Fresh Lists

home-add-widget

Listing Pages

Expand the following widget locations and remove only marked widgets from them.

listing-page

Search Pages

Lets keep the same listing page structure in search page too.

Expand the following widget locations and remove only marked widgets from them.

search

Listing Detail ( Single ) Pages

Lets remove all widgets from the following widget locations.

Expand the following widget locations and completely remove all widgets from them.

detail-widget

Now add the following widgets to GD Detail Sidebar

  1. Whoop > Are You Interested?  ( GeoDirectory Events Required and will be displayed only on single event pages )
  2. GeoDirectory : Business Hours  ( GD Business Hours Required : Note this was a third party plugin that is no longer available. GeoDirectory V2 will include Business Hours )
  3. GD > Related Listing

detail-sidebar2

For GD Business Hours you can use the following settings.

gdbishours

Note: GD Business Hour widget will be displayed only if you have filled the Business Hours information. This is how it look in sidebar.

business-hours

You might wanna remove the following details from the sidebar. ( Note: They are not widgets )

detail-sidebar

Its recommended to keep Listing Information and remove all other info boxes. But you can remove Listing Information box too if you prefer.

To remove those info boxes, Navigate to Geodirectory > Design > Detail and then Check the following checkboxes.

disable-info

Event Pages

Event Listing Page

events-listing

When you visit, yourdomain.com/events/  you can see normal event listing page, generated by GeoDirectory. Widgets used in this page comes from GD Listing Top Section, GD Listing Right Sidebar ( Scroll above and refer Listing Pages section )

Event Index Page

This page can be accessed by visiting this url.

yourdomain.com/events/?e_index=true

event-index

When GeoDirectory Events active, whoop registers the following widget locations.

event-index-sidebar

Just place the following widgets in those widget locations.

  1. Event Index Sidebar
    1. Whoop > Popular & Latest Events ( Widget Type: Popular events )
    2. Whoop > Popular & Latest Events ( Widget Type: Latest events )
    3. event-sidebar-widgets
  2. Event Index Content
    1. Whoop > Event Updates
    2. Whoop > Popular & Latest Events ( Widget Type: Popular events )
    3. event-index-widgets

 

BuddyPress Follow

No additional configuration required for BuddyPress follow. After plugin activation you can see two new tabs called Following, Followers in member profile page.

BuddyPress Compliments

To configure BuddyPress compliments, please follow this tutorial.

GeoDirectory Lists

To configure GeoDirectory Lists, follow this tutorial.

BuddyPress Profile Fields

BuddyPress profile can be Edited from Account settings > Profile Info

Some profile fields are automatically created when you activate whoop theme. ( BuddyPress must be activated before activating whoop theme. So If you don’t see any profile fields, activate some other theme and then activate whoop again )

To add more fields or Delete existing fields, Navigate to Users > Profile Fields

profile-fields

  1. Don’t remove Name field, since its required
  2. Don’t rename Group

Hide tabs from BuddyPress

If you would like to hide some tabs on BuddyPress profile pages, Navigate to Whoop Options > BuddyPress Options

buddytabs

Limit 1 Review / User / Post

By default user can post unlimited number of reviews on a listing. If you would like to limit 1 review for each listing, then navigate too Whoop Options > Review Settings > Limit 1 Review / User / Post  > Enabled

limit-review

Translate Whoop

Whoop theme is one of the Geodirectory Framework themes. Each Geodirectory Framework theme is translated with the same textdomain for the language file.

The file should be located on the server at:

/wp-content/languages/themes

File should be named as in the following examples:

geodirectory_framework-en_US.mo / geodirectory_framework-en_US.po
geodirectory_framework-es_ES.mo / geodirectory_framework-es_ES.po
etc