Filter hook 'set-screen-option'

in WP Core File wp-admin/includes/misc.php at line 773

View Source

set-screen-option

Filter Hook
Description
Filters a screen option value before it is set. The filter can also be used to modify non-standard `[items]_per_page` settings. See the parent function for a full list of standard options. Returning false from the filter will skip saving the current option. or the 'layout_columns' option.

Hook Information

File Location wp-admin/includes/misc.php View on GitHub
Hook Type Filter
Line Number 773

Hook Parameters

Type Name Description
mixed $screen_option The value to save instead of the option value. Default false (to skip saving the current option).
string $option The option name.
int $value The option value.

Usage Examples

Basic Usage
<?php
// Hook into set-screen-option
add_filter('set-screen-option', 'my_custom_filter', 10, 3);

function my_custom_filter($screen_option, $option, $value) {
    // Your custom filtering logic here
    return $screen_option;
}

Source Code Context

wp-admin/includes/misc.php:773 - How this hook is used in WordPress core
<?php
 768  				 * @param mixed  $screen_option The value to save instead of the option value.
 769  				 *                              Default false (to skip saving the current option).
 770  				 * @param string $option        The option name.
 771  				 * @param int    $value         The option value.
 772  				 */
 773  				$screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 774  			}
 775  
 776  			/**
 777  			 * Filters a screen option value before it is set.
 778  			 *

PHP Documentation

<?php
/**
				 * Filters a screen option value before it is set.
				 *
				 * The filter can also be used to modify non-standard `[items]_per_page`
				 * settings. See the parent function for a full list of standard options.
				 *
				 * Returning false from the filter will skip saving the current option.
				 *
				 * @since 2.8.0
				 * @since 5.4.2 Only applied to options ending with '_page',
				 *              or the 'layout_columns' option.
				 *
				 * @see set_screen_options()
				 *
				 * @param mixed  $screen_option The value to save instead of the option value.
				 *                              Default false (to skip saving the current option).
				 * @param string $option        The option name.
				 * @param int    $value         The option value.
				 */
Quick Info
  • Hook Type: Filter
  • Parameters: 3
  • File: wp-admin/includes/misc.php
Related Hooks

Related hooks will be displayed here in future updates.