Skip to content
Docs

Activities

The addon can post community activity updates when members interact with GeoDirectory listings. Three activity types are supported, each controlled by its own admin toggle. Activities are written to the BuddyPress activity stream or the PeepSo stream, depending on which platform is active.

Activity types

Section titled “Activity types”
Activity Fires when Setting
New Place A gd_place listing transitions to published geodir_new_place_activity
Marked Favorite Place A member marks a listing as favorite geodir_favorite_activity
Place Review A review comment is added to a GeoDirectory listing (or an existing review is approved) geodir_review_activity

See Configure Settings for where to switch these on and off.

When activities are created

Section titled “When activities are created”
  • New place activity is posted when a place moves from any non-published status to published. This covers both direct publishing and a pending place being approved.
  • Favorite activity is posted when GeoDirectory fires its favorite hook. The addon disables GeoDirectory’s fast_ajax on activation so this event is captured.
  • Review activity is posted when a comment is inserted on a GeoDirectory listing and is approved, and also when a previously unapproved review is later approved. Non-GeoDirectory comments are ignored, so reviews on ordinary posts never generate activity.

BuddyPress activities

Section titled “BuddyPress activities”

BuddyPress activities are registered under three activity types: new_location_post, place_mark_favorite, and geodir_review_update. Each appears in the activity directory and on member, group, and member-group screens.

  • The activity text links to the listing (and, for reviews, to the review section of the listing).
  • If the listing has a featured image, a linked thumbnail is included alongside the activity excerpt.

PeepSo activities

Section titled “PeepSo activities”

PeepSo activities are posted to the PeepSo stream and tagged with the addon’s module marker so they can be rendered with an attachment.

  • Because PeepSo escapes activity content, the addon appends the bare listing URL to the activity text; PeepSo auto-links plain URLs at render time.
  • New place, review, and favorite activities each attach a preview of the listing (an oEmbed card, and for reviews the rating and review text).
  • Per-member opt-out. Each PeepSo member can turn off any of the three activity types for their own actions from their profile preferences. See Member Activity Preferences. A member who has never changed the switch is treated as opted in.
Section titled “Related”