Business Directory notification types

Summary

mam_business_directory_manager::mam_notification_list() registers nine notification types into the MAM notification list. Each has a source (mam-business-directory), a title (shown in the admin), a slug (used as message_type at dispatch), and a replacements token map. The four GeoDirectory event/reservation types are intentionally not present (events are out of scope for v1).

Define a template for each slug under Mobile App Manager → Notifications — the template is the only render path.


Listing, staff & approval

business-directory-request-to-add

Fires when a non-admin submits a new listing. Tokens: {title}, {url}.

business-directory-staff-invitation

Sent when a manager/staff member is invited. Tokens: {code}, {venue_name}, {listing_name}, {listing_invite_by}, {invite_name}.

business-directory-approve-listing

Sent when an admin approves/rejects a pending listing. Tokens: {title}, {note}, {status}.

business-directory-claim-listing-invitation

Sent by the bulk claim-invite tool. Tokens: {code}, {venue_name}.


Claim listing flow

business-directory-listing-claimed

To all admins when a listing is claimed/approved on any rail. Tokens: {venue_name}, {claimant_name}.

business-directory-claim-requested

To all admins when a user submits a claim request (approval mode). Tokens: {venue_name}, {claimant_name}.

business-directory-claim-approved

To the claimant when an admin approves their request. Token: {venue_name}.

business-directory-claim-rejected

To the claimant when an admin rejects their request. Token: {venue_name}.

business-directory-claim-lapsed

To all admins when a paid (IAP) claim subscription lapses and there is no free tier to downgrade to. Tokens: {venue_name}, {claimant_name}.


Dispatch points

The Business Directory Claim Listings module only fires its own wpbdm_claim_approved + wpbdm_listing_claimed hooks; the claim-requested / rejected / lapsed pushes are dispatched from this plugin’s own claim subaction handlers and lapse cron.


How to add a notification

  1. Hook mam_notification_list and append an entry with source: 'mam-business-directory' (or your own), a title, a slug, and a replacements map.
  2. Build a template under Mobile App Manager → Notifications.
  3. Dispatch via do_action('mam_notification_send_message', $message) with message_type = your slug and replacements populated.

  • Plugin: mam-business-directory
  • Business Directory forms
  • Recipe: Claim listing subscriptions
  • Recipe: Bulk-invite venue owners to claim

Metadata

Field Value
Article type JSON Key Reference
Plugin slug mam-business-directory
Category App Settings Reference
Audience WordPress admin
Was this article helpful?
Contents

    Need Support?

    Can't find the answer you're looking for? Don't worry we're here to help!