🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

GravityExtra Directory Setup Guide

Updated 11 min read WordPress Plugins Integrations A–Z
On this page
  1. What you need
  2. Install and activate
  3. Directories
  4. Listing fields
  5. Adding listings
  6. Search, filters and sorting
  7. Grid, list and map
  8. The listing page
  9. Reviews and ratings
  10. Claim listing
  11. User dashboard
  12. Featured listings, plans and payments
  13. E-mail notices
  14. Structured data
  15. Blocks and shortcodes
  16. CSV import and export
  17. On phones and for every visitor
  18. Privacy and outside requests
  19. Troubleshooting

GravityExtra Directory turns a WordPress site into a directory: local businesses, restaurants, shops, trails, venues, member profiles or anything else people want to search and compare. You can run several directories on one site, each with its own listing fields, categories, tags, locations and rules. Visitors search by keyword, category, location and distance, filter by your own fields and switch between a grid, a list and a map. Owners add and edit their listings on the front end, follow them in a dashboard and claim listings that already exist. It is a standalone WordPress plugin: no Gravity Forms needed. This guide covers installation, directories and fields, adding listings, search and maps, listing pages, reviews, claims, plans and payments, e-mails, structured data, blocks and shortcodes, CSV import and export, and what happens without a license.

What you need

WordPress 6.5 or newer and PHP 7.4 or newer. Any theme works, classic or block based: listings are normal WordPress posts of their own type, so your theme shows them with its usual single and archive templates, and the plugin adds the directory layout inside the content. WooCommerce is optional and only needed for paid listing plans. Managing directories needs the manage_options capability (administrators); approving listings uses the normal WordPress post permissions, and reviews are moderated in Comments like any comment.

Install and activate

  • Upload the plugin zip in Plugins → Add New → Upload Plugin and activate it. A first directory called Listings is created with a useful set of fields.
  • Go to Directories → License, enter your GravityExtra license key and press Activate License. The key is shown masked once it is active.
  • Open Directories to edit the first directory or add your own.
The License tab of the Directories screen with the license key field showing a masked active key and a Deactivate License button
Activate your license key on the License tab.

Without an active license the directory features are switched off: your listings stay in the database and visitors see them as normal posts, but the search, maps, submission form, dashboard, reviews, claims and import are not shown, and the settings are read-only. Administrators see a short note where a directory would appear. Nothing is deleted.

Directories

Each directory is its own post type, with its own Categories, Tags and Locations, and its own menu in the WordPress admin, for example Places or Trails. On Directories → Add directory you choose a slug (it becomes part of the post type name and can not change later), the singular and plural names and the URL base. Then you set what the directory allows:

  • Front-end submission, with or without a login. Guests can submit with an e-mail address when you allow it.
  • Moderation: new listings wait for approval; optionally edits of published listings wait too.
  • Reviews with star ratings, with or without approval.
  • Claims, so owners can ask to take over a listing.
  • Map view and a map on listing pages, with the start point and zoom for an empty map.
  • Default view (grid, list or map), grid columns, listings per page and default order.
  • Distance unit (kilometres or miles) and the radius choices of the search.
  • Images per listing and the schema.org type used for structured data.

Listing fields

Every listing has a name, a description, categories, tags and a location. The fields builder adds the rest. Open a directory, add fields, give each one a label and a type, and drag the order with the up and down buttons. The field types are text, paragraph, number, drop-down, checkboxes, website, e-mail, phone, address with map pin, opening hours, image gallery, video (YouTube or Vimeo link) and social links.

The directory settings screen with the listing fields builder: a list of fields such as Address, Phone, Website, Price range and Amenities, one opened to show its label, key, type, choices and options
The listing fields builder.

Each field has a few switches:

  • Required: the front-end form will not save without it.
  • Shown on the listing: switch it off for private details such as a contact e-mail that only you should see.
  • On the front-end form: switch it off for fields only your team fills in.
  • Search filter: text, number, drop-down and checkbox fields can become filters in the search form. Number fields get a minimum and maximum box.
  • Shown on cards: show a short value, such as a price range, on the result cards.

The first address field gives the map pin. When an address is saved without a pin, the plugin looks it up once with the address lookup service set in the settings and stores the point. Owners can also place the pin by clicking the map or dragging the marker. Opening hours take an opening and closing time per day, a closed tick, and a note for holidays; closing after midnight is supported, and the listing page shows an Open now or Closed now badge in your site time zone.

Adding listings

There are three ways to add listings. In the admin, use the directory menu, for example Places → Add Place: the Listing details box holds your fields, and the Listing status box sets featured, featured until, plan, end date and claimed. Owners use the front-end form. And you can import a CSV file, described below.

The front-end form shows the name, description, categories, location, tags and every field marked for the form. Images are uploaded right in the form (JPEG, PNG, GIF or WebP, up to 5 MB each, and no more than the plan or directory allows). The address part has a Find address on the map button and a small map for the pin. A hidden honeypot field stops simple spam bots, and every form is protected with a WordPress nonce.

The front-end Add your place form with the address fields, a Find address on the map button and a map where the pin can be clicked or dragged
Front-end submission with the address pin picker.

When moderation is on, new listings wait for review. The Moderation tab of the Directories screen lists them from every directory with Preview, Approve and Reject buttons; rejected listings go to the bin. The owner gets an e-mail when the listing goes live.

The Moderation tab listing a new place waiting for approval, with Preview, Approve and Reject buttons
Moderation queue for new listings.

Search, filters and sorting

The search form has a keyword box, the category and location lists, a Near box with a Use my location button, a radius list and a More filters panel with your field filters. Keyword search looks at the name and description and also inside the listing fields, so a search for patio finds places that list a patio among their amenities, and a street name finds the places on that street.

A distance search needs a point: either the visitor allows the browser to share the position, or the address typed into Near is looked up (once, then cached for 30 days). Results are limited to the chosen radius and sorted nearest first, with the distance on each card. Other orders are featured first (the default), newest, name and top rated. Results come in pages; the page links and the sort keep the filters.

A directory page with a search bar for keyword, category, location, place and distance, a results toolbar with sorting and Grid, List and Map buttons, and a grid of listing cards with photos, star ratings and addresses
The directory page: search, sort, views and listing cards.

Grid, list and map

The view buttons switch between a grid of cards, a list and a map. The map uses the Leaflet library that ships inside the plugin and OpenStreetMap tiles by default; featured listings get an orange pin, and each pin opens a small pop-up with a link. The list next to the map shows the same results. In Directories → Settings you can set another tile server URL (it needs the {z}, {x} and {y} placeholders) and its credit line; while OpenStreetMap tiles are used, the OpenStreetMap credit stays on the map. For a busy site, use a tile provider or your own tile server.

The map view of the directory: pins for every result on an OpenStreetMap map, featured places in orange, an open pop-up with a link, and the result list next to the map
Map view with a pin for every result.

The listing page

Listing pages keep your theme and add the directory layout: badges for featured and claimed listings, the rating, categories and locations, the description, the gallery, the video and paragraph fields in the main column, and a side panel with the address and its map, phone (tap to call), website, opening hours, social links, tags and your other fields. Under it come the reviews and, when the directory allows it, a claim box.

A single listing page for a coffee shop with Featured and Claimed badges, a rating, the description, a photo gallery and a video, and a side panel with the address and map, phone, website, price range, amenities and opening hours with an Open now badge
A listing page: details, hours, gallery, video, map and reviews.

Reviews and ratings

Logged-in visitors can rate a listing from one to five stars and write a review, once per listing; owners can not review their own listings. When review approval is on, new reviews wait in Comments, where you can filter by Listing reviews. The average and the number of reviews are stored on the listing, shown on cards and pages, used for the Top rated order and sent to search engines as an aggregate rating. Reviews are kept out of your theme’s normal comment lists and widgets.

Claim listing

When claims are on, a logged-in visitor can press Claim this listing on an unclaimed listing, explain how they are connected to the business and leave a phone number. Your team gets an e-mail, and the Claims tab lists the request with Approve and Reject. Approving moves the listing to the claimant, marks it as claimed (with a badge on the page), rejects other open claims for the same listing and e-mails everyone involved.

User dashboard

Put the dashboard on a page and link it in your menu. Owners see their listings with the status (published, waiting for review, awaiting payment, expired or draft), rating and end date, and can view, edit, renew or delete them. The dashboard also lists their claims and the latest reviews of their listings, and has an Add button for every directory that accepts submissions.

The owner dashboard listing three places with their status (published, waiting for review), rating, end date and Edit and Delete links, plus an Add a place button
The user dashboard.

Featured listings come first in the default order, get a badge and an orange map pin. You can feature a listing by hand, with an optional end date, or through a plan. Plans are set per directory: a name, a description, a price, a duration in days (0 means no end), whether the plan features the listing, and how many images it allows. A directory without plans has free listings with no end date.

Paid plans need WooCommerce. Create a simple product for the plan, enter its product ID in the plan, and the plan shows its WooCommerce price in the form. After submitting, the owner is sent to the WooCommerce checkout with the listing in the cart; when the order is paid (processing or completed) the plan becomes active: the end date is set, the listing is featured if the plan says so, and the listing goes to the review queue or straight live. While WooCommerce is not active, paid plans are hidden and only free plans are offered. A daily task hides listings that reach their end date and ends featured periods; owners get an e-mail and can renew from the dashboard.

E-mail notices

The plugin sends plain-text e-mails through WordPress: to your team for new listings waiting for review and new claims, and to owners when a listing is approved, reviewed or expires, and to claimants when a claim is decided. Both groups can be switched off in the settings, and the team address can differ from the site admin address. Developers can change or stop any message with the gewdir_email filter.

Structured data

Listing pages print schema.org JSON-LD of the type chosen for the directory, LocalBusiness by default, or Restaurant, Store, ProfessionalService, LodgingBusiness, TouristAttraction and more, or none. It holds the name, link, description, images, postal address and map point, phone, opening hours, website and social links, and the aggregate rating when there are reviews. Private fields are never included. The gewdir_schema filter lets you add more.

Blocks and shortcodes

Six blocks are in the block inserter under Widgets, each with its settings in the sidebar and a live preview: Directory, Directory search, Directory map, Featured listings, Add listing form and Listing dashboard. The same output is available as shortcodes for classic themes and page builders:

  • [gewdir_directory dir="places"] with optional view, per_page, columns, search=”no”, map=”no”, category and location.
  • [gewdir_search dir="places" action="/find/"] a search form that sends visitors to the directory page.
  • [gewdir_map dir="places"] every listing with a pin, optionally by category, location or featured=”yes”.
  • [gewdir_listings dir="places" count="6"] featured listings (or the latest with featured=”no”).
  • [gewdir_submit dir="places"] the front-end form.
  • [gewdir_dashboard] the user dashboard.

CSV import and export

Directories → Import / Export downloads a directory as a UTF-8 CSV file with one row per listing: id, name, description, excerpt, status, categories, tags and locations (several separated by |), featured, plan, end date and every field. Addresses are split into street, city, region, postcode, country, lat and lng columns; checkboxes are separated by |, opening hours look like 1=09:00-17:00;7=closed. Cells that start like a spreadsheet formula are made safe. Import reads the same columns (comma or semicolon, first row = column names): a row with the id of an existing listing updates it, other rows create listings, missing categories are created, and addresses without a pin are looked up when the address lookup is on.

On phones and for every visitor

Every screen works on phones: the search fields stack, cards become one column, the listing page puts the side panel under the content, and the map stays usable with touch. Forms have real labels, errors are listed at the top and next to each field, the star rating works with the keyboard, focus is always visible and the map can be reached with the Tab key. The stylesheet and the small script (no jQuery) load only on pages with a directory; Leaflet loads only where a map is shown.

The directory on a phone: the search fields stacked in one column, the toolbar and the first listing card full width
The directory on a phone.

Privacy and outside requests

The plugin makes no outside request except the GravityExtra license and update checks, the map tiles in the visitor’s browser and, when it is on, the address lookup service for addresses and the Near box. The lookup can be switched off, in which case pins are placed by hand and distance search uses the visitor’s position. Review and claim forms need a login. When the plugin is deleted, its license data is always removed; listings, reviews, claims and settings are removed only when you tick Delete all data in the settings first.

Troubleshooting

  • A listing is missing from the map. It has no pin: open it, check the address or place the pin, and save.
  • “We could not find that place.” The lookup found nothing for the Near text. Try a city or postcode, or use the location button.
  • Paid plans do not show. WooCommerce must be active and the plan needs a product ID and a price above 0.
  • Listing pages give a 404 after adding a directory. Visit Settings → Permalinks once and save.
  • Nothing shows on the directory page. Check that the license is active; administrators see a note explaining what is missing.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr