The value to return instead of the option value. This differs from $default_value, which is used as the fallback value in the event the option doesn’t exist elsewhere in get_option() .
Default false (to skip past the short-circuit).
$optionstring
Option name.
$default_valuemixed
The fallback value to return if the option does not exist.
Default false.
This hook is used to temporarily alter a WordPress option before the display of a specific view. WordPress options (e.g. the blog configuration) are usually set in the back-end by the user or programmatically by a plugin. The options are stored in the database. To alter the value of an option during the rendering of a page without changing it permanently in the database, you may use this hook.
Example option name {$option} can the following:
pre_option_posts_per_page
pre_option_posts_per_rss
pre_option_template
pre_option_stylesheet
pre_option_blog_charset
pre_option_home
...
For a list of all available options, call wp_load_alloptions()
which returns the list of available options as an array that you could store in a variable or display for debugging purposes.
The example below shows how to alter the amount of displayed posts per page for a specific category (here, the ‘foo’ category). The code is added to the functions.php file of the theme.
add_filter('pre_option_posts_per_page', 'limit_posts_per_page');
function limit_posts_per_page( $posts_per_page ) {
global $wp_query;
if ( $wp_query->query_vars['category_name'] == 'foo' )
{
return 20;
}
return $posts_per_page;
}
You must log in before being able to contribute a note or feedback.
Example: Filter the
blogname
option on the homepageExample migrated from Codex:
The example below shows how to alter the amount of displayed posts per page for a specific category (here, the ‘foo’ category). The code is added to the
functions.php
file of the theme.