List of Filters and Actions
This is our list of filters and actions available in MailPoet for use by developers.
A Filter is a function that can be hooked to an event in WordPress (called hooks).
Need a developer to help you? We recommend those at Codeable (affiliate link).
Filters | |
mailpoet_api_newsletters_get_after | |
mailpoet_api_newsletters_save_before | |
mailpoet_cron_worker_sending_queue_batch_size | |
mailpoet_sending_newsletter_render_after | |
mailpoet_mailer_smtp_connection_timeout | |
mailpoet_mailer_smtp_transport_agent (this filter is replaced with mailpoet_mailer_smtp_option starting from MailPoet 3.89.3) Sets additional transport options; mostly to modify context options for ssl:// and tls:// transports http://php.net/manual/en/context.ssl.php |
|
wpmu_registration_enabled | |
mailpoet_archive_no_newsletters | |
mailpoet_archive_title | |
mailpoet_archive_date | |
mailpoet_archive_subject | |
mailpoet_rendering_post_process | |
mailpoet_newsletter_shortcode_link Creates custom link shortcode that's rendered when newsletter is sent/previewed. |
|
mailpoet_newsletter_shortcode Creates custom shortcode that's rendered when newsletter is sent/previewed. |
|
mailpoet_conflict_resolver_whitelist_style Prevents third-party plugin's JS or CSS dependencies from being unloaded. |
|
mailpoet_form_widget_post_process Sets rendered form body before output. Used to modify form parameters (e.g., setting form's target to something other than self) |
|
mailpoet_newsletter_post_excerpt_length Sets custom post excerpt size. Used when fetching posts inside Editor (ALC or regular Post block) or during rendering. |
|
mailpoet_permission_access_plugin_admin Sets permission to view MailPoet/Mailpoet → Help/MailPoet → Premium/MailPoet → Welcome/MailPoet → Update pages. |
|
mailpoet_permission_manage_settings Sets permission to view MailPoet → Settings. |
|
mailpoet_permission_manage_emails Sets permission to view MailPoet → Emails. |
|
mailpoet_permission_manage_subscribers Sets permission to view MailPoet → Subscribers. |
|
mailpoet_permission_manage_forms Sets permission to view MailPoet → Forms. |
|
mailpoet_permission_manage_segments Sets permission to view MailPoet → Segments. |
|
mailpoet_permission_update_plugin Sets permission to activate/deactivate plugin. |
|
mailpoet_cron_request_url Overrides default URL used to access the plugin in the background |
|
mailpoet_cron_request_args Overrides default arguments used by https://codex.wordpress.org/Function_Reference/wp_remote_get |
|
mailpoet_subscription_before_subscribe Action, which fires before a subscription is stored in the database. You can use this action to intercept the subscription being stored by throwing an UnexcpectedValueException. Example: add_action( 'mailpoet_subscription_before_subscribe', function($data, $segmentIds, $form) { if ($form->id() !== 10 || !in_array(21, $segmentIds)) { return; } if ($data['some_custom_field'] === 'wrong') { throw new \MailPoet\UnexpectedValueException("You can not use 'wrong' in the some_custom_field."); } }, 10, 3 ); |
mailpoet_subscription_limit_enabled Enables/disables IP throttling in subscription form. Expects a boolean. Example: add_filter('mailpoet_subscription_limit_enabled', '__return_false'); |
mailpoet_subscription_limit_window
Overrides throttling window (IP addresses memory span). Default: DAY_IN_SECONDS
mailpoet_subscription_limit_base
Overrides throttling base timeout (the first one that gets doubled every time). Default: MINUTE_IN_SECONDS
mailpoet_segments_with_subscriber_count
Add dynamic segments on newsletters and subscribers page.
mailpoet_get_subscribers_in_segment_finders
Enables hooking a finder which can find subscribers in a dynamic segment.
mailpoet_get_subscribers_listings_in_segment_handlers
Loads listings handlers for subscribers in a dynamic segment.
mailpoet_subscribers_listings_filters_segments
Loads dynamic segment for subscribers filter.
mailpoet_bridge_api_request_timeout
Sets timeout for Bridge API HTTP requests. Useful on slow hosts where connection times out on large HTTP requests.
mailpoet_search_terms_args
Update search terms arguments. Useful for sites with a lot of tags to prioritise categories in search.
mailpoet_manage_subscription_page_form_fields
Customize form fields displayed on the Manage Subscription page. The argument is an array of fields and their properties.
mailpoet_manage_subscription_page
Customize the template of the Manage Subscription page. The argument is a rendered HTML code of the page to be displayed.
mailpoet_unsubscribe_confirmation_page
Change confirmation sentence. The URL to confirm unsubscribing is sent as a 2nd parameter to the filter.
mailpoet_display_custom_fonts
Disable Google Fonts to stop loading it.
mailpoet_display_form_supported_post_types
Add a custom post type where forms should be displayed.
mailpoet_re_captcha_size
It can be either normal or compact (docs).
Actions | ||
mailpoet_initialized | ||
mailpoet_api_setup | ||
mailpoet_setup_reset | ||
mailpoet_api_newsletters_duplicate_after |
||
mailpoet_api_newsletters_save_after | ||
mailpoet_conflict_resolver_styles |
||
mailpoet_conflict_resolver_scripts | ||
mailpoet_conflict_resolver_router_url_query_parameters | |
MailPoet 3 Premium
Filters | ||
mailpoet_newsletters_before_router | ||
mailpoet_newsletters_listing_stats_before | ||
mailpoet_newsletters_listings_standard_actions | ||
mailpoet_newsletters_listings_welcome_notification_actions | ||
mailpoet_newsletters_listings_notification_history_actions | ||
mailpoet_newsletters_3rd_step_fields | ||
mailpoet_newsletters_types | ||
mailpoet_newsletters_before_router | ||
mailpoet_newsletters_listings_welcome_notification_actions | ||
mailpoet_api_newsletters_save_before | ||
mailpoet_api_newsletters_get_after | ||
mailpoet_sending_newsletter_render_after | ||