Goal

Set up everything mam-geodirectory needs from the WordPress admin: tell each GeoDirectory post type which Gravity Form is its Add/Edit Listing form, pick a default category for new submissions, decide which fields are visible in the app, configure push-notification labels, and set up the role names that show up in the Add Users form.

After this recipe the app’s Add/Edit Listing form, Send Notification form, Add Users (staff/manager) form, and Approve Listing form will all be wired correctly for every registered GeoDirectory post type.

Prerequisites

• WordPress admin access (activate_plugins capability for the page; saves require manage_options).
• GeoDirectory installed and at least one GD post type registered (typically gd_place).
• mam-main and mam-geodirectory activated.
• mam-gravity-forms-manager (or whatever provides the mam_generated_forms filter) activated; the settings page reads its form IDs to drive most of the dropdowns.
• A Gravity Form per GD post type that you want to use as the Add/Edit Listing form, plus a single Send Notification form, an Add Users form, and (optionally) Approve Listing, Claim Listing, Manage Invite, and Add QR Code forms.

Where to find the page

In WordPress admin: Mobile App Manager → Geodirectory. The page renders tabs along the top:

• Settings (the global tab — tab=gd-settings)
• One tab per registered GD post type, labelled GD {Plural label} (e.g., GD Places)
• Claim Listing (tab=gd-claim-listings) — bulk-invite tool, covered in Recipe: Bulk-invite venue owners

Custom tabs added through Hook: mam_geodirectory_admin_settings_tabs appear here too.

Steps

1. Configure the global Settings tab

Open the Settings tab. The fields here apply across every GD post type:

The Claim Listings sub-section (toggles in the same tab when their IDs match gd-claim* or mam_gd_claim*):

Save. The Save button rotates back to the same tab on success.

2. Configure each post-type tab

For every registered GD post type the page renders a tab. Each tab carries:

• Add or Edit Listing Form (a Gravity Forms picker, stored under a key like geodirectory_form_geodirectory_add_listing_form-gd_place). Pick the Gravity Form that the app should open for “Add Listing” or “Edit Listing” on this post type.
• Geodirectory Post Type — auto-filled with the tab’s slug; do not edit.
• A Default category for new listings dropdown (mam_geodirectory_category_for_new_{post_type}).
• Add in Draft mode for new listings (mam_geodirectory_add_in_draft_{post_type}). When yes, app submissions land as pending (or publish if the submitter is an administrator).
• Editor can delete listing (mam_geodirectory_editor_can_delete_{post_type}).
• Instructions (mam_geodirectory_instructions_{post_type}) — free-form text shown at the top of the in-app form.
• A field visibility manager at the bottom — one checkbox per GeoDirectory custom field. Unchecking a field stores mam-for-gf-form-field-special-handling-{form_id}-fieldid-{field_id} as 2, which the Gravity Forms manager interprets as “hide this field in the app form.”

Save. Repeat for every post type.

3. Wire the side forms

Open Settings again and scroll to the Send Notification, Add Users, Manage Invites, Add QR Code to DL the App, and Approve Listing form pickers (these are added to the global form-settings list by mam_gd_form_manager). Each one expects a Gravity Form ID. Pick the form you’ve created for that purpose. The plugin will then map the form’s fields to the slugs it expects (message-title, user-email, user-role, postid, etc.).

If you skip a side form, the corresponding feature silently turns off:

• No Send Notification form → the Send Notification tab bar button never appears.
• No Add Users form → the Edit Staff tab bar button never appears.
• No Manage Invites form → the auto-display pending-invite bootstrap form never appears.
• No Approve Listing form → admins cannot approve pending listings from the app.
• No Add QR Code form → the in-app QR-code field is never injected.

4. Verify

• Open the mobile app as an administrator. On any listing detail screen you should see Edit Listing, Edit Staff, Edit Events, Send Notification, and Approve Listing tab bar buttons (when applicable).
• Open the app as a listing owner. You should see Edit Listing, Edit Staff, Edit Events, Send Notification.
• Open the app as a non-staff user. You should see Favorites, Phone, Website, Map, Email, Share (and Chat if configured).
• Submit a new listing from the app. If you set “Add in Draft” the listing should appear in pending status; an administrator opening the app should now see Approve Listing on its detail screen.

Variations

• Add a custom admin tab. Use Hook: mam_geodirectory_admin_settings_tabs to add a tab key, then Hook: mam_geodirectory_admin_settings_tabcontent{tab} to render its body.
• Append HTML to the global Settings tab. Use Hook: mam_geodirectory_admin_settings.
• Add fields to the in-app Add/Edit Listing form definition. Use Hook: mam_geodirectory_add_edit_form_fields.

Verification

This article was last verified against:

• Plugin: mam-geodirectory v2.1.5
• Source: includes/mam_geodirectory_admin_settings.php
• Source: includes/mam_gd_form_manager.php

Re-verify whenever the option keys above are renamed, the toggle/text/conditional-choice list in mam_geodirectory_admin_settings::create_settings_array() changes, or the side-form list in mam_gd_form_manager::mam_gf_get_form_settings() changes.

Related articles

• Plugin: mam-geodirectory
• Recipe: Pricing package fields
• Recipe: Bulk-invite venue owners
• Form: Add/Edit Listing
• Form: Send Notification
• Form: Add or remove staff and managers
• Form: Approve Listing
• Form: Manage staff invitation
• Form: Add QR Code
• Hook: mam_geodirectory_admin_settings_tabs
• Hook: mam_geodirectory_admin_settings_tabcontent{tab}
• Hook: mam_geodirectory_admin_settings
• Hook: mam_geodirectory_add_edit_form_fields

Metadata