Filters Hooks

Filters & Hooks

Saltus Framework provides several hooks to customize its behavior.

Actions

Hook	Description	Parameters
saltus/framework/duplicate_post/after	Triggered after a post is successfully duplicated	string $post_type, int $original_post_id, int $new_post_id
saltus/framework/admin_filters/filter_output/{$filter_id}	Allows overriding the HTML output of a specific admin filter	SaltusAdminFilters $instance, array $filter_args, string $element_id
saltus/framework/drag_and_drop/update_menu_order	Triggered after the menu order is updated via drag and drop	None

Filters

Hook	Description	Parameters	Default
saltus/framework/modeler/priority	Filters the priority of the init hook used to register models	int $priority	1
saltus/framework/services	Filters the list of service classes to be registered	array $services	Core services array
saltus/framework/models/path	Filters the directory path where model files are located	string $path	{project_path}/src/models/
saltus_models_path	Legacy alias for saltus/framework/models/path	string $path	{project_path}/src/models/
saltus/framework/models/extra_models	Allows adding extra model configurations programmatically	array $extra_models	[]
saltus_models	Legacy alias for saltus/framework/models/extra_models	array $models	[]
saltus/framework/admin_filters/category_list	Filters the term name shown in taxonomy dropdown filters	string $name, WP_Term $term	$term->name
saltus/framework/meta/matched_fields	Filters the mapping between Saltus field types and Codestar field types	array $field_map	Built-in map
saltus/framework/duplicate_post/args	Filters the data used to create a new duplicated post	array $args, int $original_post_id	Copied post data
saltus/framework/duplicate_post/excluded_meta_keys	Filters meta keys that should not be copied during duplication	array $keys	['_wp_old_slug', '_edit_lock', '_edit_last']
saltus/framework/admin_filters/{$post_type}/filter_query/{$filter_id}	Filters the query arguments for a specific admin filter	array $vars, array $query, array $filter	[]

MCP Runtime Filters

These filters control MCP/Abilities runtime behavior:

Filter	Purpose	Default
saltus/framework/mcp/audit/enabled	Enable or disable audit writes	true
saltus/framework/mcp/audit/retention_days	Days to keep audit rows	30
saltus/framework/mcp/rate_limit/enabled	Enable or disable rate limiting	true
saltus/framework/mcp/rate_limit/max_requests	Max calls per window	60
saltus/framework/mcp/rate_limit/window_seconds	Rate-limit window size	60
saltus/framework/mcp/rate_limit/identifier	Override the rate-limit key	Current user or request IP
saltus/framework/mcp/cache/enabled	Enable or disable caching	true
saltus/framework/mcp/cache/ttl	Override cache TTL per tool	Tool-defined TTL
saltus/framework/mcp/cache/cacheable	Override whether a tool is cacheable	Tool-defined
saltus/framework/health/audit_sample_size	Audit rows sampled by health endpoint	100
saltus/framework/mcp/namespace	MCP ability namespace	saltus
saltus/framework/mcp/ability_category	MCP ability category	Saltus Framework
saltus/framework/mcp/ability_prefix	MCP ability prefix	saltus