PaywallProject 4.5.3 has 46 actions and 51 filters, read directly from its source code on Nov 19, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when PaywallProject fires an action
add_action( 'ppaccess_checkout_email_captured', function( $user_id, $id, $arg3 ) {
// Your code runs here.
}, 10, 3 );
// Change a value PaywallProject is about to use
add_filter( 'ppaccess_checkout_payment_metadata', function( $value, $user_id ) {
// Change $value here.
return $value;
}, 10, 2 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
/** * Checkout now knows who the reader is, before they have paid. */ do_action( 'ppaccess_checkout_email_captured', $user_id, $level->id, array( 'path' => 'hosted', 'coupon' => $coupon ? $coupon_code : '', 'session_id' => (string) ( $session['id'] ?? '' ), 'return_url' => (string) ( $command['return_url'] ?? '' ), ) ); -
/** * Filters extra metadata for the PaymentIntent or subscription an inline * checkout is about to create. */ apply_filters( 'ppaccess_checkout_payment_metadata', array(), $user_id ); -
/** * Filters whether the current visitor may open a protected PDF. */ apply_filters( 'ppaccess_e_edition_file_access', $decision, $attachment_id ); -
/** * Fires when an address opts out of abandoned-checkout reminders. */ do_action( 'ppaccess_abandoned_checkout_unsubscribed', $email_hash ); -
/** * Fires after the built-in account cards, for integrations that add their own * (e.g. Newsletter Glue preferences). Echo a `<section * class="ppaccess-account-card">`. */ do_action( 'ppaccess_account_cards', $user_id ); -
/** * Fires after a gift link is created. */ do_action( 'ppaccess_article_gift_created', $gift_id, $user_id, (int) $post->ID, $url ); -
/** * Fires when a gift link is opened and spent. */ do_action( 'ppaccess_article_gift_redeemed', (int) $gift['post_id'], $gift ); -
/** * Filters the resolvers used for crawler verification, in the order they are * tried. */ apply_filters( 'ppaccess_bot_dns_resolvers', $cached ); -
/** * Filters the DNS budget for crawler verification, in milliseconds. */ apply_filters( 'ppaccess_bot_dns_timeout_ms', self::DEFAULT_TIMEOUT_MS ); -
/** * Allow a trusted server-side integration (e.g. a companion-app REST bridge * making an internal rest_do_request() loopback, which still passes through * this same rest_pre_dispatch filter) to skip CAPTCHA verification for one * specific request. Default false — public/browser traffic is unaffected * unless something explicitly opts a request out. */ apply_filters( 'ppaccess_captcha_bypass', false, $request ); -
/** * Allow a site-specific integration to enqueue additional captcha scripts or * overrides. */ do_action( 'ppaccess_captcha_enqueue', $provider, $key ); -
/** * Filters how many checkout email checks (/public/check-account-email) one IP * address may make per 15 minutes. Many readers can share one address (an * office, a school), so keep it well above what one reader needs. */ apply_filters( 'ppaccess_check_account_email_limit', self::ACCOUNT_CHECK_PER_IP ); -
/** * Filters how many checkouts (Pay or Subscribe) one IP address may start per * hour. Many readers can share an address (an office, a school), so keep it * well above what one reader needs. */ apply_filters( 'ppaccess_checkout_attempt_limit', self::PER_IP ); -
/** * Filters the hourly resume email caps per IP address and per site. */ apply_filters( 'ppaccess_checkout_resume_mail_limits', array( 'ip' => self::MAIL_PER_IP, 'site' => self::MAIL_PER_SITE, ) ); -
/** * Filters the throwaway email domains that cannot receive a code in place of a * failed CAPTCHA. Add a domain, or remove one a site's readers really use. A * domain also covers its subdomains. */ apply_filters( 'ppaccess_disposable_email_domains', self::DOMAINS ); -
/** * Filters the notice shown above a domain-restricted level's sign-up form. */ apply_filters( 'ppaccess_domain_restriction_notice', $notice, $level ); -
/** * Filters what the e-edition access page shows. Runs after the Settings → * E-edition wording, so code can still override it. */ apply_filters( 'ppaccess_e_edition_access_page', $data, $attachment_id ); -
/** * Filters how many free-registration email checks one IP address may make per * 15 minutes. Many readers can share one address (an office, a school), so * keep it well above what one reader needs. */ apply_filters( 'ppaccess_free_registration_check_limit', self::CHECK_PER_IP ); -
/** * Filters how many free-registration email checks whose CAPTCHA failed one IP * address may make per hour. Each reader needs one. */ apply_filters( 'ppaccess_free_registration_unverified_check_limit', self::UNVERIFIED_PER_IP ); -
/** * Filters whether a user counts as an active subscriber. */ apply_filters( 'ppaccess_is_active_subscriber', $active, $user_id, $level_ids ); -
/** * Filters the failed-password caps per account and per IP address. */ apply_filters( 'ppaccess_login_throttle_limits', array( 'account' => self::PER_ACCOUNT, 'ip' => self::PER_IP, ) ); -
/** * Filters the notice shown above a postal-code-restricted level's sign-up * form. */ apply_filters( 'ppaccess_postal_code_notice', $notice, $level ); -
/** * Filters whether the current single post gets the print stylesheet. */ apply_filters( 'ppaccess_print_enabled', $applies, $post ); -
/** * Filters the extra selectors hidden when an article is printed. */ apply_filters( 'ppaccess_print_hide_selectors', $selectors ); -
/** * Filters the post types that get the print stylesheet and footer. */ apply_filters( 'ppaccess_print_post_types', $types ); -
/** * This filter is documented in run(). */ apply_filters( 'ppaccess_reading_history_retention_days', self::VIEW_RETENTION_DAYS ); -
do_action( 'ppaccess_subscriber_created', $user_id, array( 'source' => 'quick_register' ) ); -
do_action( 'ppaccess_captcha_fields', 'quick_register' ); -
apply_filters( 'ppaccess_level_taxable', (bool) $this->settings->get( 'stripe_tax_enabled' ) && ! $level->custom_amount_active(), $level ); -
do_action( 'ppaccess_subscriber_level_changed', $user_id, $level->id ); -
apply_filters( 'ppaccess_email_body', $rendered_body, $key, $sample_send_vars ); -
apply_filters( 'ppaccess_js_post_container', ContentSelector::resolve( (string) $this->settings->get( 'js_post_container', ContentSelector::DEFAULT ) ) ); -
do_action( 'ppaccess_woocommerce_subscription_status_updated', $user_id, $status, $subscription_id ); -
do_action( 'breeze_clear_all_cache' ); -
apply_filters( 'https_local_ssl_verify', true, $url ); -
do_action( 'ppaccess_admin_notices' ); -
do_action( 'ppaccess_after_paywall', $post, $decision ); -
do_action( 'ppaccess_before_paywall', $post, $decision ); -
apply_filters( 'ppaccess_bot_bypass', (bool) $bot_bypass, $post ); -
apply_filters( 'ppaccess_bot_bypass_pre', null, $post ); -
apply_filters( 'ppaccess_checkout_prefill_email', '' ); -
apply_filters( 'ppaccess_connect_hub_url', 'https://paywallproject.com/wp-json/ppconnect/v1' ); -
apply_filters( 'ppaccess_e_edition_access_page_in_theme', true ); -
apply_filters( 'ppaccess_email_should_send', true, $template, $user_id, $level_id, $vars ); -
apply_filters( 'ppaccess_email_subject', $subject, $template, $vars ); -
do_action( 'ppaccess_free_level_claimed', (int) $user_id, $level->id, $created ); -
apply_filters( 'ppaccess_free_level_redirect_url', $fallback, $level, (int) $user_id ); -
do_action( 'ppaccess_free_registration_submit', $user->ID, $email, $request->get_params() ); -
do_action( 'ppaccess_gift_created', $id, $row ); -
do_action( 'ppaccess_gift_delivered', $gift_id, $row ); -
do_action( 'ppaccess_gift_paid', (int) $row['id'], $paid, $payment_intent ); -
do_action( 'ppaccess_gift_redeemed', (int) $row['id'], $user_id, $redeemed ); -
do_action( 'ppaccess_gift_reminder_sent', (int) $row['id'], $row ); -
do_action( 'ppaccess_group_created', $group_id, $owner_id ); -
do_action( 'ppaccess_group_invitation_accepted', $user_id, $context ); -
do_action( 'ppaccess_group_member_added', $user_id, $group->id ); -
do_action( 'ppaccess_group_member_removed', $user_id, $group->id, $previous_status ); -
apply_filters( 'ppaccess_ip_blocker_threshold', max( 1, (int) $this->settings->get( 'meter_count', 1 ) ) ); -
apply_filters( 'ppaccess_js_page_container', $page_container ); -
do_action( 'ppaccess_level_deleted', $id ); -
do_action( 'ppaccess_level_form_fields', $level, $is_edit ); -
do_action( 'ppaccess_level_saved', $saved_id, $post ); -
apply_filters( 'ppaccess_login_redirect', $default, $user ); -
apply_filters( 'ppaccess_mcp_write_limit', 30 ); -
apply_filters( 'ppaccess_mcp_write_time', null !== $this->clock ? ( $this->clock )() : time() ); -
apply_filters( 'ppaccess_offer_stripe_connect', $connected || ! ( new StripeGateway( $settings ) )->has_own_secret_key(), $mode ); -
apply_filters( 'ppaccess_passwordless_redirect', home_url( '/' ), $user_id ); -
do_action( 'ppaccess_payment_failed', $user_id, $data ); -
do_action( 'ppaccess_payment_one_time_completed', $user_id, $level->id, $payment_intent ); -
apply_filters( 'ppaccess_paywall_card_data', $data, $post, $decision ); -
apply_filters( 'ppaccess_paywall_card_html', $html, $data, $post, $decision ); -
apply_filters( 'ppaccess_private_storage_dir', '' ); -
do_action( 'ppaccess_purge_page_cache' ); -
apply_filters( 'ppaccess_sign_in_link_ip_limit', CheckoutResume::MAIL_PER_IP ); -
do_action( 'ppaccess_stripe_webhook', $type, $data, $event ); -
do_action( 'ppaccess_subscriber_plan_changed', $this->id(), $new_level_id, $old, $source ); -
do_action( 'ppaccess_subscriber_status_changed', $this->id(), $new_status, $old, $source ); -
do_action( 'ppaccess_subscription_activated', $user_id, $level->id, $subscription ); -
apply_filters( 'ppaccess_subscription_is_external', '' !== $management_url, $user_id, $subscriber ); -
apply_filters( 'ppaccess_subscription_management_url', '', $user_id, $subscriber, $level ); -
do_action( 'ppaccess_subscription_request_cancel', $user_id ); -
do_action( 'ppaccess_subscription_request_resume', $user_id ); -
do_action( 'ppaccess_subscription_switched_to_non_recurring', $user_id, $new_level_id, $old_sub_id ); -
do_action( 'ppaccess_subscription_update_payment_method', $user_id ); -
do_action( 'ppaccess_transaction_recorded', (int) $transaction['user_id'], $transaction ); -
do_action( 'ppaccess_transaction_refunded', $id, $total, $previous ); -
apply_filters( 'ppaccess_user_can_comment', $can, $subscriber, $allowed ); -
apply_filters( 'ppaccess_visibility_metabox_post_types', array( 'post', 'page' ) ); -
apply_filters( 'ppaccess_webhook_signature_tolerance', self::SIGNATURE_TOLERANCE ); -
do_action( 'ppaccess_woocommerce_order_processed', $user_id, $level_id, $order_number, $order ); -
do_action( 'ppaccess_woocommerce_order_revoked', $user_id, $level_id, $order_number, sanitize_key( $reason ), $order ); -
apply_filters( 'robots_txt', "User-agent: *\nDisallow: $path/wp-admin/\nAllow: $path/wp-admin/admin-ajax.php\n", (bool) get_option( 'blog_public' ) ); -
apply_filters( 'the_content', get_the_content( null, false, $post ) ); -
do_action( 'wp_login', $user->user_login, $user );
Generated from PaywallProject's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Done for you
Rather have it built for you?
Tell us what should change and we’ll write and test the code using these hooks.
Custom hook snippet
from $49
A small, update-safe change built on the plugin’s own hooks.
- Code written against the plugin’s actions and filters
- Tested on a staging copy of your site
- Install instructions included
Typical turnaround: 2–3 business days
Choose thisPlugin customisation
from $149
New features or changed behaviour, without editing the plugin’s files.
- Built as a companion plugin, so updates never wipe it
- Exact quote before we start
- Tested on staging, then deployed
Typical turnaround: 3–7 business days
Choose thisNot sure which fits? Describe what you need and we’ll suggest the simplest option.
Can't find the right hook?
We can build the customisation for you. Describe what you need: