{"id":368669,"date":"2025-10-24T10:04:35","date_gmt":"2025-10-24T04:04:35","guid":{"rendered":"https:\/\/directorist.com\/?post_type=docs&p=368669"},"modified":"2025-10-24T10:04:39","modified_gmt":"2025-10-24T04:04:39","password":"","slug":"action-hooks","status":"publish","type":"docs","link":"https:\/\/directorist.com\/docs\/action-hooks\/","title":{"rendered":"Action Hooks"},"content":{"rendered":"\n

Directorist provides a rich set of action hooks<\/strong> that allow developers to extend or modify its functionality without editing the core files.
Each hook fires at a specific point in the plugin lifecycle, enabling you to inject custom code for listings, payments, notifications, directories, and more.<\/p>\n\n\n\n

Core Plugin Actions<\/h2>\n\n\n\n

These hooks help you run code during key lifecycle events such as installation, update, or load completion.<\/p>\n\n\n\n

Hook<\/th>Description<\/th><\/tr><\/thead>
directorist_loaded<\/code><\/td>Fires when the Directorist plugin is fully loaded.<\/td><\/tr>
directorist_installed<\/code><\/td>Fires when Directorist is installed.<\/td><\/tr>
directorist_updated<\/code><\/td>Fires when Directorist is updated.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Template and Display Actions<\/h2>\n\n\n\n

These hooks let you modify or inject elements in front-end templates such as listings, dashboards, search forms, and checkout pages.<\/p>\n\n\n\n

Hook<\/th>Context<\/th><\/tr><\/thead>
directorist_before_settings_panel_header<\/code><\/td>Before rendering the settings panel header.<\/td><\/tr>
directorist_before_directory_type_edited<\/code><\/td>Before editing a directory type.<\/td><\/tr>
directorist_before_all_directory_types<\/code><\/td>Before displaying all directory types.<\/td><\/tr>
directorist_before_contact_form_submit_button<\/code><\/td>Before the contact form submit button.<\/td><\/tr>
directorist_single_listing_after_title<\/code><\/td>After the single listing title.<\/td><\/tr>
directorist_before_add_listing_from_frontend<\/code><\/td>Before rendering the Add Listing form.<\/td><\/tr>
directorist_before_submit_listing_frontend<\/code><\/td>Before submitting a listing from frontend.<\/td><\/tr>
directorist_after_submit_listing_frontend<\/code><\/td>After submitting a listing from frontend.<\/td><\/tr>
directorist_after_file_upload_form_field<\/code><\/td>After rendering file upload fields.<\/td><\/tr>
atbdp_before_terms_and_conditions_font<\/code><\/td>Before the terms and conditions section.<\/td><\/tr>
directorist_search_listing_before_title<\/code><\/td>Before displaying search listing title.<\/td><\/tr>
directorist_search_listing_after_search_bar<\/code><\/td>After the search bar in search listings.<\/td><\/tr>
atbdp_before_all_categories_loop<\/code> \/ atbdp_after_all_categories_loop<\/code><\/td>Before \/ after categories loop.<\/td><\/tr>
atbdp_before_all_locations_loop<\/code> \/ atbdp_after_all_locations_loop<\/code><\/td>Before \/ after locations loop.<\/td><\/tr>
directorist_before_reset_password_form<\/code> \/ directorist_after_reset_password_form<\/code><\/td>Before \/ after reset password form.<\/td><\/tr>
atbdp_before_login_form_end<\/code><\/td>Before the login form ends.<\/td><\/tr>
atbdp_before_user_registration_submit<\/code><\/td>Before registration submit button.<\/td><\/tr>
directorist_author_listings_before_loop<\/code><\/td>Before author listings loop.<\/td><\/tr>
directorist_before_author_profile_section<\/code><\/td>Before author profile section.<\/td><\/tr>
directorist_before_author_about_section<\/code><\/td>Before author about section.<\/td><\/tr>
directorist_author_listing_after_about_section<\/code><\/td>After author about section.<\/td><\/tr>
directorist_before_list_listings_loop<\/code><\/td>Before list view loop.<\/td><\/tr>
directorist_before_listings_pagination<\/code> \/ directorist_after_listings_pagination<\/code><\/td>Before \/ after pagination.<\/td><\/tr>
directorist_before_grid_listings_loop<\/code> \/ directorist_after_grid_listings_loop<\/code><\/td>Before \/ after grid listings loop.<\/td><\/tr>
directorist_before_map_listings_loop<\/code> \/ directorist_after_map_listings_loop<\/code><\/td>Before \/ after map listings loop.<\/td><\/tr>
directorist_before_listing_types<\/code><\/td>Before listing types render.<\/td><\/tr>
atbdp_payment_receipt_after_total_price<\/code><\/td>After total price in payment receipt.<\/td><\/tr>
directorist_dashboard_navigation<\/code> \/ directorist_after_dashboard_navigation<\/code><\/td>Before \/ after dashboard navigation.<\/td><\/tr>
directorist_dashboard_contents<\/code> \/ directorist_after_dashboard_contents<\/code><\/td>Dashboard content area.<\/td><\/tr>
directorist_dashboard_listing_th_*<\/code> \/ directorist_dashboard_listing_td_*<\/code><\/td>Customize table header and cell content in dashboard listings.<\/td><\/tr>
directorist_dashboard_before_pagination<\/code> \/ directorist_dashboard_after_pagination<\/code><\/td>Pagination hooks in dashboard.<\/td><\/tr>
atbdp_before_checkout_form_start<\/code> \/ atbdp_after_checkout_form_end<\/code><\/td>Surround checkout form.<\/td><\/tr>
atbdp_before_cc_form<\/code> \/ atbdp_after_cc_form<\/code><\/td>Surround credit card form.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Email and Notification Actions<\/h2>\n\n\n\n

Used to trigger custom email or notification behavior when listings or orders are created, updated, or completed.<\/p>\n\n\n\n

Hook<\/th>Fires When<\/th><\/tr><\/thead>
directorist_email_on_notify_owner_order_created<\/code><\/td>Owner receives order created email.<\/td><\/tr>
directorist_email_on_notify_owner_order_completed<\/code><\/td>Owner receives order completed email.<\/td><\/tr>
directorist_email_on_notify_owner_listing_submitted<\/code><\/td>Owner receives listing submission email.<\/td><\/tr>
directorist_email_on_notify_admin_listing_published<\/code><\/td>Admin notified when listing is published.<\/td><\/tr>
directorist_email_on_notify_owner_listing_published<\/code><\/td>Owner notified when listing is published.<\/td><\/tr>
directorist_email_on_notify_owner_listing_edited<\/code><\/td>Owner notified when listing is edited.<\/td><\/tr>
directorist_email_on_notify_owner_listing_to_expire<\/code><\/td>Owner notified before listing expires.<\/td><\/tr>
directorist_email_on_notify_owner_listing_expired<\/code><\/td>Owner notified after expiration.<\/td><\/tr>
directorist_email_on_notify_owner_to_renew<\/code><\/td>Owner notified for renewal.<\/td><\/tr>
directorist_email_on_notify_owner_listing_deleted<\/code><\/td>Owner notified after deletion.<\/td><\/tr>
directorist_email_on_notify_admin_become_author<\/code><\/td>Admin notified on author request.<\/td><\/tr>
directorist_email_on_notify_admin_order_created<\/code> \/ directorist_email_on_notify_admin_order_completed<\/code><\/td>Admin notified about orders.<\/td><\/tr>
directorist_email_on_notify_admin_listing_submitted<\/code> \/ directorist_email_on_notify_admin_listing_edited<\/code><\/td>Admin notified about listings.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Listing Management Actions<\/h2>\n\n\n\n

These actions run during the listing creation, update, or deletion process.<\/p>\n\n\n\n

Hook<\/th>Description<\/th><\/tr><\/thead>
directorist_ajax_before_request_handling<\/code> \/ directorist_ajax_after_request_handling<\/code><\/td>Around AJAX request handling.<\/td><\/tr>
atbdp_before_processing_submitted_listing_frontend<\/code><\/td>Before processing frontend listing submission.<\/td><\/tr>
atbdp_before_processing_to_update_listing<\/code><\/td>Before updating listing.<\/td><\/tr>
atbdp_listing_updated<\/code> \/ atbdp_listing_inserted<\/code><\/td>After listing update or insert.<\/td><\/tr>
atbdp_listing_published<\/code><\/td>After listing published.<\/td><\/tr>
atbdp_after_created_listing<\/code><\/td>After listing created.<\/td><\/tr>
atbdp_before_renewal<\/code> \/ atbdp_after_renewal<\/code><\/td>Around listing renewal process.<\/td><\/tr>
directorist_listing_deleted<\/code><\/td>After listing deleted.<\/td><\/tr>
atbdp_all_listings_badge_template<\/code><\/td>Customize badge template on listings.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Payment and Order Actions<\/h2>\n\n\n\n

Hooks for handling custom gateways, order status changes, and payment flows.<\/p>\n\n\n\n

Hook<\/th>Description<\/th><\/tr><\/thead>
atbdp_order_created<\/code><\/td>After an order is created.<\/td><\/tr>
atbdp_offline_payment_created<\/code><\/td>After offline payment is created.<\/td><\/tr>
atbdp_process_{gateway}_payment<\/code><\/td>Process payment for a specific gateway. Replace {gateway}<\/code> with your gateway slug.<\/td><\/tr>
atbdp_online_order_processed<\/code><\/td>After online order processed.<\/td><\/tr>
atbdp_order_completed<\/code><\/td>After order marked completed.<\/td><\/tr>
atbdp_custom_order_column_content<\/code><\/td>Output custom content in the order list table.<\/td><\/tr>
atbdp_order_status_changed<\/code><\/td>When order status changes.<\/td><\/tr>
atbdp_email_receipt_after_total_price<\/code><\/td>After total price in email receipt.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Directory and Taxonomy Actions<\/h2>\n\n\n\n
Hook<\/th>Description<\/th><\/tr><\/thead>
directorist_before_create_directory_type<\/code> \/ directorist_after_create_directory_type<\/code><\/td>Around creation of a directory type.<\/td><\/tr>
directorist_before_update_directory_type<\/code> \/ directorist_after_update_directory_type<\/code><\/td>Around update of a directory type.<\/td><\/tr>
directorist_before_directory_type_updated<\/code><\/td>Before directory type updated.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Review and Comment Actions<\/h2>\n\n\n\n

Use these to customize or track user reviews and comments.<\/p>\n\n\n\n

Hook<\/th>Description<\/th><\/tr><\/thead>
directorist_review_validate_data<\/code><\/td>Validate review data before saving.<\/td><\/tr>
directorist_review_updated<\/code><\/td>After review updated.<\/td><\/tr>
directorist_review_clear_cache<\/code><\/td>Clear review cache.<\/td><\/tr>
directorist_review_rating_updated<\/code><\/td>After review rating updated.<\/td><\/tr>
directorist_review_content_before<\/code> \/ directorist_review_content_after<\/code><\/td>Wrap review content.<\/td><\/tr>
directorist_after_comment_textarea<\/code><\/td>After comment textarea.<\/td><\/tr>
directorist_comment_form_before_fields<\/code> \/ directorist_comment_form_after_fields<\/code><\/td>Around comment form fields.<\/td><\/tr>
directorist_comment_form<\/code> \/ directorist_comment_form_after<\/code><\/td>During comment form render.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Import and Migration Actions<\/h2>\n\n\n\n
Hook<\/th>Description<\/th><\/tr><\/thead>
directorist_listing_imported<\/code><\/td>After a listing is imported.<\/td><\/tr>
directorist_before_directory_type_updated<\/code><\/td>Before directory type updated during import.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Background Process Actions<\/h2>\n\n\n\n

Used for updater, licensing, and tracking integrations.<\/p>\n\n\n\n

Hook<\/th>Description<\/th><\/tr><\/thead>
include_style_settings<\/code><\/td>Include style settings.<\/td><\/tr>
post_edd_sl_plugin_updater_setup<\/code><\/td>After EDD Software Licensing updater setup.<\/td><\/tr>
in_plugin_update_message-{file}<\/code><\/td>Displays plugin update message.<\/td><\/tr>
before_appsero_license_section<\/code> \/ after_appsero_license_section<\/code><\/td>Around Appsero license section.<\/td><\/tr>
{slug}_tracker_optin<\/code> \/ {slug}_tracker_optout<\/code><\/td>User tracking opt-in\/out.<\/td><\/tr>
{slug}_uninstall_reason_submitted<\/code><\/td>After uninstall feedback submitted.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Database Actions<\/h2>\n\n\n\n
Hook<\/th>Description<\/th><\/tr><\/thead>
atbdp_pre_insert_{type}<\/code><\/td>Before inserting data of a specific type.<\/td><\/tr>
atbdp_post_insert_{type}<\/code><\/td>After inserting data of a specific type.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

Directorist provides a rich set of action hooks that allow developers to extend or modify its functionality without editing the core files.Each hook fires at a specific point in the plugin lifecycle, enabling you to inject custom code for listings, payments, notifications, directories, and more. Core Plugin Actions These hooks help you run code during key lifecycle […]<\/p>\n","protected":false},"author":24585,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[699],"doc_tag":[],"class_list":["post-368669","docs","type-docs","status-publish","hentry","doc_category-developers-doc"],"year_month":"2026-03","word_count":1091,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"yousuf.sovware","author_nicename":"yousuf-sovware","author_url":"https:\/\/directorist.com\/author\/yousuf-sovware\/"},"doc_category_info":[{"term_name":"Developers Doc","term_url":"https:\/\/directorist.com\/docs-category\/developers-doc\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/368669","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/users\/24585"}],"replies":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/comments?post=368669"}],"version-history":[{"count":0,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/368669\/revisions"}],"wp:attachment":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/media?parent=368669"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_category?post=368669"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_tag?post=368669"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}