Filters Reference

Complete reference of all filter hooks available in AI Image SEO Optimizer. Use filter hooks to modify values returned by the plugin — AI model configuration, image queries, prompts, UI labels, and more.

Optimization Lifecycle

add_filter( 'infyp_after_ai_optimization', function( $new_data, $image_id, $model_name ) {n    // Modify and return $new_datan    return $new_data;n}, 10, 3 );

add_filter( 'infyp_allowed_optimize_field_types', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_generated_keywords', function( $sanitized_keywords, $image_id ) {n    // Modify and return $sanitized_keywordsn    return $sanitized_keywords;n}, 10, 2 );

add_filter( 'infyp_max_keywords', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_optimize_extended_field', function( $image_id, $field_type, $existing_keywords ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 3 );

add_filter( 'infyp_optimize_field_result', function( $image_id, $field_type, $existing_keywords, $custom_prompt ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 4 );

add_filter( 'infyp_process_ai_result_data', function( $new_data, $result, $image_id ) {n    // Modify and return $new_datan    return $new_data;n}, 10, 3 );

add_filter( 'infyp_run_optimization', function( $result, $image_id, $existing_keywords, $custom_prompt ) {n    // Modify and return $resultn    return $result;n}, 10, 4 );

add_filter( 'infyp_run_single_field_optimization', function( $result, $image_id, $field_type, $options ) {n    // Modify and return $resultn    return $result;n}, 10, 4 );

add_filter( 'infyp_save_extended_field_result', function( $image_id, $field_type, $result, $current_value ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 4 );

AI Providers & Prompts

add_filter( 'infyp_ai_models', function( $ai_models ) {n    // Modify and return $ai_modelsn    return $ai_models;n} );

add_filter( 'infyp_ai_response_possible_keys', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_api_retry_config', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_calculate_api_cost', function( $cost, $model, $tokens, $base_cost ) {n    // Modify and return $costn    return $cost;n}, 10, 4 );

add_filter( 'infyp_extended_field_prompt', function( $model, $field_type, $language, $prompt_addon, $existing_keywords ) {n    // Modify and return $modeln    return $model;n}, 10, 5 );

add_filter( 'infyp_get_provider_for_model', function( $provider, $model ) {n    // Modify and return $providern    return $provider;n}, 10, 2 );

add_filter( 'infyp_image_context', function( $prompt_addon, $image_id, $field_type ) {n    // Modify and return $prompt_addonn    return $prompt_addon;n}, 10, 3 );

add_filter( 'infyp_keywords_prompt', function( $prompt, $model, $language, $prompt_addon ) {n    // Modify and return $promptn    return $prompt;n}, 10, 4 );

add_filter( 'infyp_max_prompt_length', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_model_labels', function( $model_labels ) {n    // Modify and return $model_labelsn    return $model_labels;n} );

add_filter( 'infyp_prompt_addon', function( $prompt_addon, $image_id, $field_type ) {n    // Modify and return $prompt_addonn    return $prompt_addon;n}, 10, 3 );

add_filter( 'infyp_prompt_format', function( $format, $model, $config ) {n    // Modify and return $formatn    return $format;n}, 10, 3 );

add_filter( 'infyp_prompt_sections', function( $sections, $field_type, $model, $language ) {n    // Modify and return $sectionsn    return $sections;n}, 10, 4 );

add_filter( 'infyp_provider_for_model', function( $model ) {n    // Modify and return $modeln    return $model;n} );

add_filter( 'infyp_register_ai_providers', function( $this ) {n    // Modify and return $thisn    return $this;n} );

add_filter( 'infyp_simplified_prompt', function( $prompt, $model, $provider, $language ) {n    // Modify and return $promptn    return $prompt;n}, 10, 4 );

add_filter( 'infyp_single_field_prompt', function( $prompt, $model, $field_type, $language, $prompt_addon, $existing_keywords ) {n    // Modify and return $promptn    return $prompt;n}, 10, 6 );

Settings & Configuration

add_filter( 'infyp_allowed_api_key_providers', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_allowed_edit_fields', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_extended_field_types', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_get_active_model', function( $model ) {n    // Modify and return $modeln    return $model;n} );

add_filter( 'infyp_get_api_key', function( $key, $provider ) {n    // Modify and return $keyn    return $key;n}, 10, 2 );

add_filter( 'infyp_get_language', function( $lang ) {n    // Modify and return $langn    return $lang;n} );

add_filter( 'infyp_get_setting', function( $value, $key, $default ) {n    // Modify and return $valuen    return $value;n}, 10, 3 );

add_filter( 'infyp_supported_mime_types', function( $value ) {n    // Modify and return $valuen    return $value;n} );

Image Data & Queries

add_filter( 'infyp_changelog_entry', function( $entry ) {n    // Modify and return $entryn    return $entry;n} );

add_filter( 'infyp_find_image_usage', function( $usage, $image_id ) {n    // Modify and return $usagen    return $usage;n}, 10, 2 );

add_filter( 'infyp_get_image_base64', function( $base64, $image_id ) {n    // Modify and return $base64n    return $base64;n}, 10, 2 );

add_filter( 'infyp_get_image_count', function( $count, $args ) {n    // Modify and return $countn    return $count;n}, 10, 2 );

add_filter( 'infyp_get_image_ids', function( $ids, $args ) {n    // Modify and return $idsn    return $ids;n}, 10, 2 );

add_filter( 'infyp_image_data_response', function( $data, $image_id ) {n    // Modify and return $datan    return $data;n}, 10, 2 );

add_filter( 'infyp_image_query_args', function( $args ) {n    // Modify and return $argsn    return $args;n} );

add_filter( 'infyp_image_query_where_conditions', function( $where_conditions, $filter_types ) {n    // Modify and return $where_conditionsn    return $where_conditions;n}, 10, 2 );

add_filter( 'infyp_image_usage_html', function( $html, $image_id, $usage ) {n    // Modify and return $htmln    return $html;n}, 10, 3 );

add_filter( 'infyp_image_usage_post_ids', function( $image_id, $image_url ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 2 );

add_filter( 'infyp_image_usage_taxonomy', function( $image_id, $image_url, $metadata ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 3 );

add_filter( 'infyp_populate_lookup_table', function( $stats, $table_name, $wpdb ) {n    // Modify and return $statsn    return $stats;n}, 10, 3 );

add_filter( 'infyp_search_index_combined_parts', function( $combined_parts, $image_id, $attachment ) {n    // Modify and return $combined_partsn    return $combined_parts;n}, 10, 3 );

add_filter( 'infyp_validate_image_id', function( $is_valid, $image_id ) {n    // Modify and return $is_validn    return $is_valid;n}, 10, 2 );

File Renaming & Redirects

add_filter( 'infyp_filename_before_apply', function( $new_data, $image_id, $old_data ) {n    // Modify and return $new_datan    return $new_data;n}, 10, 3 );

add_filter( 'infyp_pre_file_rename', function( $post_id, $new_filename_sans_ext, $file_path ) {n    // Modify and return $post_idn    return $post_id;n}, 10, 3 );

Table & UI

add_filter( 'infyp_admin_header_badge', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_admin_i18n_strings', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_admin_localize_data', function( $localize_data ) {n    // Modify and return $localize_datan    return $localize_data;n} );

add_filter( 'infyp_admin_menu_capability', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_edit_field_log_name', function( $field, $field ) {n    // Modify and return $fieldn    return $field;n}, 10, 2 );

add_filter( 'infyp_edit_field_old_value', function( $image_id, $field ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 2 );

add_filter( 'infyp_handle_edit_field', function( $image_id, $field, $value ) {n    // Modify and return $image_idn    return $image_id;n}, 10, 3 );

add_filter( 'infyp_image_table_columns_before', function( $columns ) {n    // Modify and return $columnsn    return $columns;n} );

add_filter( 'infyp_post_type_filter_options', function( $filter_options ) {n    // Modify and return $filter_optionsn    return $filter_options;n} );

add_filter( 'infyp_provider_display_names', function( $names ) {n    // Modify and return $namesn    return $names;n} );

add_filter( 'infyp_reset_banner_meta_keys', function( $banner_meta_keys, $user_id ) {n    // Modify and return $banner_meta_keysn    return $banner_meta_keys;n}, 10, 2 );

add_filter( 'infyp_skip_prepare_items', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_table_column_', function( $column_name, $item ) {n    // Modify and return $column_namen    return $column_name;n}, 10, 2 );

add_filter( 'infyp_table_columns_after_title', function( $columns ) {n    // Modify and return $columnsn    return $columns;n} );

add_filter( 'infyp_usage_chart_provider_colors', function( $value ) {n    // Modify and return $valuen    return $value;n} );

Security & Rate Limiting

add_filter( 'infyp_capability_map', function( $capabilities ) {n    // Modify and return $capabilitiesn    return $capabilities;n} );

add_filter( 'infyp_check_capability', function( $has_cap, $action ) {n    // Modify and return $has_capn    return $has_cap;n}, 10, 2 );

add_filter( 'infyp_max_security_events', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_rate_limited_actions', function( $rate_limited_actions ) {n    // Modify and return $rate_limited_actionsn    return $rate_limited_actions;n} );

add_filter( 'infyp_rate_limits', function( $this ) {n    // Modify and return $thisn    return $this;n} );

Page Builders

add_filter( 'infyp_detect_page_builder', function( $post_id, $image_url, $image_id ) {n    // Modify and return $post_idn    return $post_id;n}, 10, 3 );

add_filter( 'infyp_pagebuilder_adapter_info', function( $info ) {n    // Modify and return $infon    return $info;n} );

add_filter( 'infyp_register_pagebuilder_adapters', function( $this ) {n    // Modify and return $thisn    return $this;n} );

Extensibility Points

add_filter( 'infyp_allowed_post_types', function( $types ) {n    // Modify and return $typesn    return $types;n} );

add_filter( 'infyp_post_type_fallback_conditions', function( $post_type_conditions, $filter_type, $wpdb ) {n    // Modify and return $post_type_conditionsn    return $post_type_conditions;n}, 10, 3 );

add_filter( 'infyp_seo_score_result', function( $result, $image_id ) {n    // Modify and return $resultn    return $result;n}, 10, 2 );

add_filter( 'infyp_seo_score_thresholds', function( $value ) {n    // Modify and return $valuen    return $value;n} );

add_filter( 'infyp_taxonomy_filter_types', function( $filter_types ) {n    // Modify and return $filter_typesn    return $filter_types;n} );

add_filter( 'infyp_valid_filter_types', function( $valid_types, $allowed ) {n    // Modify and return $valid_typesn    return $valid_types;n}, 10, 2 );