Whoop Theme – Available Widgets

Available Widgets

Here is the list of widgets, added by whoop.

For GeoDirectory

  1. Your Next Review Awaits
  2. User Info
  3. Review of the Day

For GeoDirectory Events

  1. Are you interested?
  2. Popular & Latest Events

For BuddyPress

  1. Recent Activity
  2. Event Updates ( Also depends on GeoDirectory Events )
  3. Friends

For bbPress

  1. Today in Talk

Tip: All whoop widget names start with Whoop >   Example : Whoop > Your Next Review Awaits   So all whoop widgets can be easily found on widgets section when you search for Whoop >  using CTRL + F ( CMD + F on MAC )

 

Your Next Review Awaits

your-next-review

  1. Only logged in users can see this widget
  2. This widget fetches posts from current user’s bookmarks. ( User can bookmark a post from listing page by clicking bookmark button.)bookmark-button
  3. This widget needs upto 10 posts. So when not enough ( current user’s ) bookmarked posts available, it will look for some high rated posts which are not yet reviewed by current user.

User Info

user-info

  1. This widget displays logged in user’s information.
  2. The number 3 from above screenshot is user’s friend count. ( BuddyPress required )
  3. The number 8 from above screenshot is the number of reviews user posted.
  4. That Schenectady, NY part coming from Account Settings > Profile Info > My Hometown  ( BuddyPress required )
  5. Account Settings link can be found here.
  6. account-settings

Review of the Day

review-of-the-day

  1. This widget will be visible only when there is a Review of the Day available.
  2. You may have to set Review of the Day everyday.
  3. To set review of the day, Navigate to Comments 
  4. comments-page
  5. Under each comment ( Only reviews ), you can see a link named Mark as ROTD – ( Current Day and Date ). Clicking that link will mark that review as Review of the Day.
  6. mark-as-rotd
  7. If you would like to undo, you can click  Remove from ROTD – ( Current Day and Date )
  8. remove-from-totd

Are you interested? ( GeoDirectory Events required )

are-you-interested

  1. Only logged in users can able to see this widget.
  2. This widget is applicable only for Events post type. For other post types, it won’t get displayed.
  3. Enroll ( I’m in, Sounds Cool ) buttons will be visible only for future events. i.e The current event’s event start date should be greater than current date.
  4. Users can undo their actions by clicking Cancel link.
  5. undo-enroll

Popular & Latest Events ( GeoDirectory Events required )

pop-lat-events

In the above screenshot, same widget is used 3 times with different widget names.

  1. You can use this widget to list popular events or latest events.
  2. You can set the widget listing type by selecting widget type. ( Refer the following screenshot )
  3. widget-type
  4. When you place the widget in main content, the layout will be displayed differently. It will display, Browse all events button, See event for links and the submitter info. ( refer other popular events in the above screenshot )

Recent Activity ( BuddyPress Required )

recent-activity

  1. This widget displays information about the recent activity.
  2. Only logged in users can see filter links. ( Near You, Friends and Your Activity)
  3. Activity will be recorded and displayed, when a user becomes a friend with another user.
  4. Activity will be recorded and displayed, when a user write a review for a place.

Event Updates ( BuddyPress & GeoDirectory Events Required )

event-updates

  1. When a user click I’m in or Sounds Cool button from Are You Interested? widget, the activity will be recorded.
  2. The latest 5 activities will be displayed in Event Updates widget.

Friends ( BuddyPress Required )

friends

  1. This widget can be displayed only on BuddyPress user profile pages.
  2. So place your widget in BuddyPress Sidebar
  3. You can set the number of users to display on the widget. Default value is 4.

Today in Talk ( bbPress Required )

today-in-talk

  1. This widget shows latest forum topics

 

GeoDirectory Lists – Overview

Introduction

Using GeoDirectory Lists, you can create your own place list.  Example: My Favorite Restaurants

Note: As of now GeoDirectory Lists can be used only with Whoop theme. Other themes are not supported yet.

Prerequisites

  1. GeoDirectory
  2. Whoop Theme (Optional)
  3. Posts 2 Posts
  4. Buddypress (Optional)

Posts 2 Posts

GeoDirectory Lists heavily depends on Posts 2 Posts Plugin. So Please install it first before installing GeoDirectory Lists.

Installation

Please follow this tutorial, to install the plugin.

Reset Permalinks

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

Links

  1. List index can be accessed by visiting yourdomain.com/lists/
  2. A new list can be created by visiting yourdomain.com/add-list/
Index Page screenshot

list-index

Add List Page screenshot

list-add

To create a List

  1. Navigate to Account Settings > Lists
  2. Click Create List button.
  3. create-list
  4. Enter List Title and List Description and then click Create
  5. You will redirected to a page where you can add items to your list.
  6. Drag and Drop items from the left side to right side. Note: You can see only the listings your reviewed.
  7. add-items
  8. After adding items to your list click Done to save.
  9. Click View List to view your list.

To Edit List Items

edit-items

To Edit List Title and Description

edit-title

 

 

BuddyPress Compliments – Overview

Introduction

BuddyPress Compliments is a buddypress addon created by GeoDirectory. BuddyPress members can compliment each other using this plugin.

Note: As of now BuddyPress Compliments can be used only with Whoop theme. Other themes are not supported yet.

Prerequisites

BuddyPress Compliments depends on the following in order to work.

  1. BuddyPress
  2. Whoop Theme

Installation

Please follow this tutorial, to install the plugin.

Configuration and Usage

After plugin activation, you can see a new menu link compliments under settings

  1. You can add unlimited number of compliment types with icons.
  2. Please note, the recommended icon size is 20px x 20px
  3. Here is the screenshot of compliment page where you can add compliment types.
  4. A Compliment button and Compliments tab are added to each profile page. ( Note: Compliments button will not be visible on logged in user’s profile page.
  5. When you click Compliments button a popup will be displayed with compliment types.
  6. Submitted compliments will be visible in user’s compliments section.
  7. compliments-section

 

 

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