Simple Sponsorships 1.8.1 has 81 actions and 118 filters, read directly from its source code on Nov 18, 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 Simple Sponsorships fires an action
add_action( 'ss_account_dashboard', function() {
// Your code runs here.
}, 10, 1 );
// Change a value Simple Sponsorships is about to use
add_filter( 'ss_create_sponsorships_package_availability_check', function( $value, $args ) {
// 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
-
/** * Account dashboard. */ do_action( 'ss_account_dashboard' ); -
/** * This can be used to check availability of all packages even the initial * availability is fine. */ apply_filters( 'ss_create_sponsorships_package_availability_check', null, $args['packages'] ); -
/** * Filters the string of price markup. */ apply_filters( 'ss_price', $return, $price, $args, $unformatted_price ); -
apply_filters( 'ss_after_setting_output', $html, $args ); -
apply_filters( 'ss_after_field_output', $html, $args ); -
do_action( 'ss_sponsorship_details', $sponsorship_object, 'account' ); -
do_action( 'ss_email_header', $args['email_heading'] ); -
do_action( 'ss_sponsorship_sponsor', $sponsorship_object ); -
do_action( "ss_{sanitize_text_field(strtolower($_GET['ss-action']))}", $_GET ); -
do_action( "ss_{sanitize_text_field(strtolower($_POST['ss-action']))}", $_POST ); -
apply_filters( 'ss_form_sponsors_fields', $fields ); -
apply_filters( "ss_get_sponsorships_table_column_value_{$column}", $ret, $sponsorship ); -
apply_filters( 'ss_package_types', array( 'normal' => __( 'Normal', 'simple-sponsorships' ), ) ); -
do_action( 'ss_sponsorship_customer_details', $sponsorship_object ); -
do_action( 'ss_sponsorship_form', $sponsorship_object ); -
apply_filters( 'ss_sponsorships_table_list_sql_where', $join ); -
apply_filters( 'widget_title', $instance['title'] ); -
apply_filters( "{$this->slug}_validation_message_{$key}", $validation_message, $field ); -
apply_filters( "{strtolower(__CLASS__)}_meta_table_name", $wpdb->prefix . $this->meta_table ); -
apply_filters( "{strtolower(__CLASS__)}_table_name", $wpdb->prefix . $this->table ); -
apply_filters( 'formatted_ss_price', number_format( $price, $args['decimals'], $args['decimal_separator'], $args['thousand_separator'] ), $price, $args['decimals'], $args['decimal_separator'], $args['thousand_separator'] ); -
do_action( "get_template_part_{$slug}", $slug, $name, $args ); -
do_action( "giveasap_{$integration}_integration_activated" ); -
do_action( "giveasap_{$integration}_integration_deactivated" ); -
apply_filters( 'metabox_info_fields', array( '_email' => array( 'title' => __( 'Email', 'simple-sponsorships' ), 'type' => 'email', 'name' => '_email', 'id' => 'ss_email' ), '_website' => array( 'title' => __( 'Website', 'simple-sponsorships' ), 'type' => 'url', 'name' => '_website', 'id' => 'ss_web' ), '_company' => array( 'title' => __( 'Company', 'simple-sponsorships' ), 'type' => 'text', 'name' => '_company', 'id' => 'ss_compan... ); -
apply_filters( 'metabox_sponsoring_fields', array( '_available_qty' => array( 'id' => '_available_qty', 'name' => '_available_qty', 'title' => __( 'Available Quantity', 'simple-sponsorships' ), 'desc' => __( 'This is the quantity that is still unused and how many times this Sponsor can still be added to content', 'simple-sponsorships' ), 'type' => 'number', ), ) ); -
apply_filters( 'raw_ss_price', floatval( $negative ? $price * -1 : $price ) ); -
do_action( "ss_{$this->get_type()}_{$column}_{$value}", $id ); -
do_action( "ss_{$this->get_type()}_{$column}_updated", $value, $old[ $column ], $id ); -
apply_filters( "ss_{$this->slug}_posted_data", $data ); -
do_action( "ss_account_{$key}_endpoint", $value ); -
do_action( 'ss_account_content' ); -
do_action( 'ss_account_created', $user_id, $account_data ); -
apply_filters( 'ss_account_creation_errors', $errors, $username, $email ); -
apply_filters( 'ss_account_sponsor_info_data', array( 'name' => array( 'title' => __( 'Name', 'simple-sponsorships' ), 'value' => esc_html( $sponsor->get_data( 'post_title' ) ), ), 'description' => array( 'title' => __( 'Description', 'simple-sponsorships' ), 'value' => wp_kses_post( $sponsor->get_data( 'post_content' ) ), ), 'website' => array( 'title' => __( 'Website', 'simple-sponsorships' ), 'value' => esc_html( $sponsor->get_data( '_we... ); -
do_action( "ss_add_package_after_field_{$field_slug}", $fields ); -
do_action( "ss_add_package_before_field_{$field_slug}", $fields ); -
do_action( 'ss_add_package_form_bottom' ); -
do_action( 'ss_add_package_form_top' ); -
do_action( "ss_add_sponsorship_after_field_{$field_slug}", $fields ); -
do_action( "ss_add_sponsorship_before_field_{$field_slug}", $fields ); -
do_action( 'ss_add_sponsorship_form_bottom', false ); -
do_action( 'ss_add_sponsorship_form_top', false ); -
apply_filters( 'ss_admin_enqueue_pages', array( 'sponsors_page_ss-sponsorships', 'sponsors_page_ss-packages', 'sponsors_page_ss-reports', 'sponsors_page_ss-settings', 'sponsors_page_ss-integrations', 'widgets.php', ) ); -
apply_filters( 'ss_admin_localize_script', array( 'nonce' => wp_create_nonce( 'ss-admin-nonce' ), 'ajax' => admin_url( 'admin-ajax.php' ), 'text' => array( 'no_sponsor_found' => __( 'No Sponsor Found', 'simple-sponsorships' ), 'activate' => __( 'Activate', 'simple-sponsorships' ), 'deactivate' => __( 'Deactivate', 'simple-sponsorships' ), ), 'package' => array( 'editable' => array( 'item-title', 'item-amount' ) ) ) ); -
do_action( "ss_admin_page_{str_replace('-','_',$_REQUEST['page'])}" ); -
do_action( 'ss_after_payment_form' ); -
do_action( 'ss_after_payment_form_fields', $sponsorship ); -
do_action( 'ss_after_sponsor_form' ); -
do_action( 'ss_after_sponsor_form_fields' ); -
apply_filters( 'ss_ajax_packages_get_total_fragments', array( 'total' => $total, 'total_formatted' => Formatting::price( $total ), ), $total, $packages, $package_objects ); -
apply_filters( "ss_allow_template_part_{$slug}_{$name}", true ); -
apply_filters( 'ss_available_payment_gateways', $_available_gateways, $this->sponsorship ); -
apply_filters( 'ss_bacs_process_payment_sponsorship_status', 'on-hold', $sponsorship ); -
do_action( 'ss_before_payment_form' ); -
do_action( 'ss_before_payment_form_fields', $sponsorship ); -
do_action( 'ss_before_sponsor_form' ); -
do_action( 'ss_before_sponsor_form_fields', $form, $args ); -
apply_filters( 'ss_content_show_placeholder', $show_placeholder, $content_id, $sponsors ); -
apply_filters( 'ss_content_types', $content_types ); -
apply_filters( 'ss_countries', array( 'AF' => __( 'Afghanistan', 'simple-sponsorships' ), 'AX' => __( 'Åland Islands', 'simple-sponsorships' ), 'AL' => __( 'Albania', 'simple-sponsorships' ), 'DZ' => __( 'Algeria', 'simple-sponsorships' ), 'AS' => __( 'American Samoa', 'simple-sponsorships' ), 'AD' => __( 'Andorra', 'simple-sponsorships' ), 'AO' => __( 'Angola', 'simple-sponsorships' ), 'AI' => __( 'Anguilla', 'simple-s... ); -
do_action( 'ss_create_account', $username, $email, $errors ); -
apply_filters( 'ss_create_sponsorships_account_required', false, $posted_data ); -
apply_filters( 'ss_currencies', $currencies ); -
apply_filters( 'ss_currency_symbol', $symbol, $currency ); -
do_action( "ss_edit_package_after_field_{$field_slug}", $fields ); -
do_action( "ss_edit_package_before_field_{$field_slug}", $fields ); -
do_action( 'ss_edit_package_form_bottom' ); -
do_action( 'ss_edit_package_form_top' ); -
do_action( "ss_edit_sponsorship_after_field_{$field_slug}", $fields ); -
do_action( "ss_edit_sponsorship_before_field_{$field_slug}", $fields ); -
do_action( 'ss_edit_sponsorship_form_bottom', $sponsorship ); -
do_action( 'ss_edit_sponsorship_form_bottom_after_buttons', $sponsorship ); -
do_action( 'ss_edit_sponsorship_form_top', $sponsorship ); -
apply_filters( 'ss_email_format_string', str_replace( $find, $replace, $string ), $this ); -
apply_filters( 'ss_email_from_address', get_option( 'admin_email' ), $this ); -
apply_filters( 'ss_email_from_name', get_option( 'site_title' ), $this ); -
apply_filters( 'ss_email_headers', $header, $this->id ); -
apply_filters( 'ss_email_styles', ob_get_clean() ); -
apply_filters( "ss_endpoint_{$endpoint}_title", $title, $endpoint ); -
do_action( "ss_form_field_{$args['type']}", $args, $wrap_field ); -
apply_filters( 'ss_format_postcode', $postcode, $country ); -
do_action( 'ss_fs_loaded' ); -
apply_filters( 'ss_gateway_description', $this->description, $this->id ); -
apply_filters( 'ss_gateway_icon', $icon, $this->id ); -
apply_filters( 'ss_gateway_method_description', $this->method_description, $this ); -
apply_filters( 'ss_gateway_method_title', $this->method_title, $this ); -
apply_filters( 'ss_gateway_title', $this->title, $this->id ); -
apply_filters( 'ss_get_endpoint_url', $url, $endpoint, $value, $permalink ); -
apply_filters( 'ss_get_file_contents', $content, $path, $id ); -
apply_filters( 'ss_get_file_contents_path', $path, $id ); -
apply_filters( 'ss_get_package_fields', $fields ); -
apply_filters( 'ss_get_price_decimal_separator', ss_get_option( 'price_decimal_sep' ) ); -
apply_filters( 'ss_get_price_decimals', ss_get_option( 'price_num_decimals', 2 ) ); -
apply_filters( 'ss_get_price_thousand_separator', ss_get_option( 'price_thousand_sep' ) ); -
apply_filters( 'ss_get_query_vars', $this->query_vars ); -
apply_filters( 'ss_get_return_url', $return_url, $sponsorship ); -
apply_filters( 'ss_get_settings', $settings ); -
apply_filters( 'ss_get_settings_sections', $sections ); -
apply_filters( 'ss_get_sponsor_page', $link ); -
apply_filters( 'ss_get_sponsors_args', $args ); -
apply_filters( 'ss_get_sponsors_default_statuses', array( 'publish', 'ss-inactive' ) ); -
apply_filters( 'ss_get_sponsorship_fields', $fields ); -
apply_filters( 'ss_get_template_part', $templates, $slug, $name ); -
apply_filters( 'ss_get_view_account_url', ss_get_endpoint_url( 'view-sponsorship', $this->get_id(), get_permalink( $account_page ) ), $this ); -
apply_filters( 'ss_gravity_form_settings_fields', array( 'ss_sponsorship_form' => $ss_form, 'ss_sponsorship_redirect' => $ss_redirect, ), $form, $fields ); -
apply_filters( 'ss_is_account_creation_enabled', 1 === absint( ss_get_option( 'allow_account_creation', '0' ) ) ); -
apply_filters( 'ss_mail_content', $this->style_inline( $message ) ); -
apply_filters( 'ss_new_account_data', array( 'user_login' => $username, 'user_pass' => $password, 'user_email' => $email, 'role' => 'subscriber', ) ); -
apply_filters( 'ss_non_setting_types', array( 'header', 'descriptive_text', 'hook', ) ); -
apply_filters( 'ss_notice_html', '<div class="ss-notice ss-notice-%s">%s</div>' ); -
do_action( 'ss_package_added', $package_id, $posted_data ); -
apply_filters( 'ss_package_check_required', $return, $packages ); -
apply_filters( 'ss_package_get_price', $this->get_data( 'price' ), $this ); -
apply_filters( 'ss_package_get_price_formatted', Formatting::price( $this->get_price(), array( 'exclude_html' => $exclude_html ) ), $this->get_price(), $exclude_html, $this ); -
apply_filters( 'ss_package_get_title', $this->get_data('title' ), $this ); -
apply_filters( 'ss_package_get_type', $this->get_data('type' ), $this ); -
apply_filters( 'ss_package_is_available', 'unavailable' !== $this->get_status(), $this ); -
apply_filters( 'ss_package_statuses', array( 'available' => __( 'Available', 'simple-sponsorships' ), 'unavailable' => __( 'Unavailable', 'simple-sponsorships' ), ) ); -
do_action( 'ss_package_updated', $id, $posted_data ); -
apply_filters( 'ss_packages_column_price', $price, $item ); -
apply_filters( 'ss_packages_column_title_actions', array( 'edit' => '<a href="' . admin_url( 'edit.php?post_type=sponsors&page=ss-packages&ss-action=edit-package&id=' . $item['ID'] ) . '">' . __( 'Edit', 'simple-sponsorships' ) . '</a>', ) ); -
apply_filters( 'ss_payment_gateway_supports', in_array( $feature, $this->supports ), $feature, $this ); -
apply_filters( 'ss_payment_gateways', $load_gateways ); -
apply_filters( 'ss_paypal_args', $this->get_transaction_args( $sponsorship ), $sponsorship ); -
apply_filters( 'ss_paypal_args_with_items', array_merge( $this->get_transaction_args( $order ), $this->get_line_item_args( $order, true ) ), $order ); -
do_action( 'ss_plugin_loaded' ); -
apply_filters( "ss_posted_{$this->slug}_{$type}_field", apply_filters( 'ss_posted_' . $this->slug . '_field_' . $key, $value ) ); -
apply_filters( "ss_posted_{$this->slug}_field_{$key}", $value ); -
apply_filters( 'ss_price_args', wp_parse_args( $args, array( 'ex_tax_label' => false, 'currency' => '', 'decimal_separator' => self::get_price_decimal_separator(), 'thousand_separator' => self::get_price_thousand_separator(), 'decimals' => self::get_price_decimals(), 'price_format' => self::get_price_format(), 'exclude_html' => false, ) ) ); -
apply_filters( 'ss_price_format', $format, $currency_pos ); -
apply_filters( 'ss_price_trim_zeros', false ); -
apply_filters( 'ss_register_sponsor_post_statuses', array( 'ss-inactive' => array( 'label' => _x( 'Inactive', 'Sponsor status', 'simple-sponsorships' ), 'public' => false, 'exclude_from_search' => false, 'show_in_admin_all_list' => true, 'show_in_admin_status_list' => true, 'label_count' => _n_noop( 'Inactive <span class="count">(%s)</span>', 'Inactive <span class="count">(%s)</span>', 'simple-sponsorships' ), ), ) ); -
apply_filters( 'ss_registered_integrations', array( 'gravityforms' => '\Simple_Sponsorships\Integrations\GravityForms', 'stripe' => '\Simple_Sponsorships\Integrations\Dummy\Stripe', 'recurring-payments' => '\Simple_Sponsorships\Integrations\Dummy\Recurring_Payments_Dummy', 'package-slots' => '\Simple_Sponsorships\Integrations\Dummy\Package_Slots', 'post-paid-form' => '\Simple_Sponsorships\Integrations\Dummy\Post_Paid_Form_Dummy', 'package... ); -
apply_filters( 'ss_registration_error_email_exists', __( 'An account is already registered with your email address. Please log in.', 'simple-sponsorships' ), $email ); -
apply_filters( 'ss_registration_error_username_exists', sprintf( __( 'The username %s has already been taken. Please try another.', 'simple-sponsorships' ), $username ) ); -
apply_filters( 'ss_required_field_notice', sprintf( __( '%s is a required field.', 'simple-sponsorships' ), '<strong>' . esc_html( $field_label ) . '</strong>' ), $field, $key, $this->slug ); -
apply_filters( 'ss_sanitize_key', $key, $raw_key ); -
apply_filters( 'ss_session_start_uri_blacklist', array( 'feed', 'feed/rss', 'feed/rss2', 'feed/rdf', 'feed/atom', 'comments/feed' ) ); -
apply_filters( "ss_settings_{$tab}_sanitize", $input ); -
apply_filters( "ss_settings_{$tab}-{$section}_sanitize", $input ); -
apply_filters( 'ss_settings_emails', array( 'main' => array( 'ss_email_background_color' => array( 'id' => 'ss_email_background_color', 'label' => __( 'Background Color', 'simple-sponsorships' ), 'type' => 'color', 'default' => '#ffffff' ), 'ss_email_body_background_color' => array( 'id' => 'ss_email_body_background_color', 'label' => __( 'Body Background Color', 'simple-sponsorships' ), 'type' => 'color', 'default' => '#ffffff' )... ); -
do_action( "ss_settings_field_{$args['type']}", $args ); -
apply_filters( 'ss_settings_gateways', array( 'main' => array( 'enable_payments' => array( 'id' => 'enable_payments', 'label' => __( 'Enable Payments', 'simple-sponsorships' ), 'type' => 'checkbox', ), 'payment_instructions' => array( 'id' => 'payment_instructions', 'label' => __( 'Payment Instructions', 'simple-sponsorships' ), 'type' => 'textarea', 'desc' => __( 'Instructions that will show if the payments are not enabled so your ... ); -
apply_filters( 'ss_settings_sanitize', $output[ $key ], $key ); -
apply_filters( "ss_settings_sanitize_{$type}", $output[ $key ], $key ); -
do_action( 'ss_settings_tab_bottom', $active_tab ); -
do_action( "ss_settings_tab_bottom_{$active_tab}_{$section}" ); -
do_action( 'ss_settings_tab_top', $active_tab ); -
do_action( "ss_settings_tab_top_{$active_tab}_{$section}" ); -
apply_filters( 'ss_settings_tabs', $tabs ); -
apply_filters( 'ss_sponsor_form_field_value', '', $field ); -
apply_filters( 'ss_sponsor_form_non_meta', array( 'status', 'amount', 'subtotal', 'currency', 'gateway', 'transaction_id', 'package', 'sponsor', 'date', 'key', 'ss_key', 'sponsor_terms', ) ); -
do_action( 'ss_sponsor_form_sponsorship_created', $sponsorship_id ); -
do_action( 'ss_sponsor_post_save', $sponsor, $post ); -
do_action( 'ss_sponsor_post_saved_for_content', $sponsors, $post ); -
apply_filters( 'ss_sponsored_content_table_columns', array( 'post_title' => __( 'Title', 'simple-sponsorships' ), 'post_excerpt' => __( 'Excerpt', 'simple-sponsorships' ), 'link' => __( 'Link', 'simple-sponsorships' ) ) ); -
do_action( "ss_sponsors_column_{$column}", $post_id ); -
apply_filters( 'ss_sponsors_metaboxes', array( 'sponsor-info' => array( 'title' => __( 'Information', 'simple-sponsorships' ), 'callback' => array( $this, 'metabox_info' ), ), 'sponsoring' => array( 'title' => __( 'Sponsoring', 'simple-sponsorships' ), 'callback' => array( $this, 'metabox_sponsoring' ), ), ) ); -
do_action( 'ss_sponsorship_activated', $this ); -
do_action( 'ss_sponsorship_add_meta', $posted_data, $sponsorship ); -
do_action( 'ss_sponsorship_added', $sponsorship_id ); -
do_action( 'ss_sponsorship_before_calculate_totals', $ret, $args, $sponsorship ); -
do_action( 'ss_sponsorship_create_item', $id, $this, $item, $meta ); -
do_action( 'ss_sponsorship_created', $ret, $args, $sponsorship ); -
apply_filters( 'ss_sponsorship_formatted_amount', Formatting::price( $this->get_data( 'amount' ) ), $this->get_data( 'amount' ), $this ); -
apply_filters( 'ss_sponsorship_get_data_non_sponsor', array( 'name' => $db->get_meta( $this->get_id(), '_sponsor_name', true ), '_email' => $db->get_meta( $this->get_id(), '_email', true ), '_website' => $db->get_meta( $this->get_id(), '_website', true ), '_company' => $db->get_meta( $this->get_id(), '_company', true ), ), $this ); -
apply_filters( "ss_sponsorship_is_{$status}", $status === $this->get_data( 'status' ), $this ); -
do_action( 'ss_sponsorship_item_delete', $item_id ); -
do_action( 'ss_sponsorship_sponsor_created', $sponsor_id, $posted_data ); -
apply_filters( 'ss_sponsorship_statuses', array( 'request' => __( 'Request', 'simple-sponsorships' ), 'approved' => __( 'Approved', 'simple-sponsorships' ), 'on-hold' => __( 'On Hold', 'simple-sponsorships' ), 'paid' => __( 'Paid', 'simple-sponsorships' ), 'rejected' => __( 'Rejected', 'simple-sponsorships' ), 'failed' => __( 'Failed', 'simples-sponsorships' ), ) ); -
do_action( 'ss_sponsorship_update_item', $id, $this, $item, $meta ); -
do_action( 'ss_sponsorship_update_meta', $posted_data, $sponsorship ); -
do_action( 'ss_sponsorship_updated', $id, $posted_data ); -
do_action( 'ss_sponsorships_admin_package_field_after_packages', $field, $sponsorship ); -
apply_filters( 'ss_sponsorships_column_sponsor_actions', array( 'view' => '<a href="' . admin_url( 'post.php?post=' . $item['sponsor'] . '&action=edit' ) . '">' . __( 'View', 'simple-sponsorships' ) . '</a>', ) ); -
apply_filters( 'ss_sponsorships_column_title_actions', array( 'edit' => '<a href="' . admin_url( 'edit.php?post_type=sponsors&page=ss-sponsorships&ss-action=edit-sponsorship&id=' . $item['ID'] ) . '">' . __( 'Edit', 'simple-sponsorships' ) . '</a>', ) ); -
apply_filters( 'ss_sponsorships_table_columns', array( 'id' => __( '#', 'simple-sponsorships' ), 'status' => __( 'Status', 'simple-sponsorships' ), 'amount' => __( 'Amount', 'simple-sponsorships'), 'date' => __( 'Date', 'simple-sponsorships' ), ) ); -
do_action( 'ss_sponsorships_table_list_filters' ); -
apply_filters( 'ss_start_session', $start_session ); -
apply_filters( 'ss_template_paths', $file_paths ); -
apply_filters( 'ss_templates_dir', 'ss_templates' ); -
do_action( "ss_update_{$this->get_current_class()}_data_{$key}", $value, $this ); -
do_action( 'ss_updated' ); -
apply_filters( 'ss_use_php_sessions', $ret ); -
do_action( 'wp_session_cleanup' ); -
do_action( 'wp_session_commit' ); -
apply_filters( 'wp_session_expiration', 30 * 60 ); -
apply_filters( 'wp_session_expiration_variant', 24 * 60 ); -
do_action( 'wp_session_start' );
Generated from Simple Sponsorships'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: