diff --git a/src/wp-admin/includes/misc.php b/src/wp-admin/includes/misc.php index 51fa058393..e0d4ddc5bc 100644 --- a/src/wp-admin/includes/misc.php +++ b/src/wp-admin/includes/misc.php @@ -688,23 +688,46 @@ function set_screen_options() { } break; default: + if ( '_page' === substr( $option, -5 ) || 'layout_columns' === $option ) { + /** + * 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 to 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 bool $keep Whether to save or skip saving the screen option value. + * Default false. + * @param string $option The option name. + * @param int $value The number of rows to use. + */ + $value = apply_filters( 'set-screen-option', false, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores + } + /** * 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. + * The dynamic portion of the hook, `$option`, refers to the option name. * * Returning false to the filter will skip saving the current option. * - * @since 2.8.0 + * @since 5.4.2 * * @see set_screen_options() * - * @param bool $keep Whether to save or skip saving the screen option value. Default false. - * @param string $option The option name. - * @param int $value The number of rows to use. + * @param bool $keep Whether to save or skip saving the screen option value. + * Default false. + * @param string $option The option name. + * @param int $value The number of rows to use. */ - $value = apply_filters( 'set-screen-option', false, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores + $value = apply_filters( "set_screen_option_{$option}", false, $option, $value ); if ( false === $value ) { return;