Navigation and search filters

Filters for the mobile menu, menu locations, and the navigation search.

Jump to

• Mobile menu
  • generate_mobile_menu_label
  • generate_mobile_menu_media_query
• Menu locations
  • generate_navigation_location
• Search
  • generate_search_button
  • generate_search_label
  • generate_search_placeholder
  • generate_navigation_search_output
  • generate_navigation_search_menu_item_output

Mobile menu

generate_mobile_menu_label

GP Free

The generate_mobile_menu_label filter allows you to change the Menu text in your mobile menu button.

Parameters: $value (string). Default: Menu.

add_filter( 'generate_mobile_menu_label', function( $value ) {
    return $value;
} );

Guide: Navigation

generate_mobile_menu_media_query

GP Free

Starting in GeneratePress 2.3, the generate_mobile_menu_media_query allows us to change when the mobile menu is initiated.

Parameters: $value. Default: 768px.

add_filter( 'generate_mobile_menu_media_query', function() {
    return '(max-width: 1000px)';
} );

add_filter( 'generate_not_mobile_menu_media_query', function() {
    return '(min-width: 1001px)';
} );

Guide: Navigation

Back to top

Menu locations

generate_navigation_location

GP Free

The generate_navigation_location filter allows you to choose where your primary navigation is located.

Parameters: $value (string). Default: Your option set in Customize > Layout > Primary Navigation.

nav-below-header
nav-above-header
nav-float-right
nav-float-left
nav-left-sidebar
nav-right-sidebar

return '';

Guide: Navigation

Back to top

Search

generate_search_button

GP Free

The generate_search_button filter allows you to change the default Search text in your search button.

Parameters: $value (string). Default: Search.

add_filter( 'generate_search_button', function( $value ) {
    return $value;
} );

Guide: Navigation

generate_search_label

GP Free

The generate_search_label filter allows you to change the default Search for: text.

Parameters: $value (string). Default: Search for:

add_filter( 'generate_search_label', function( $value ) {
    return $value;
} );

Guide: Navigation

generate_search_placeholder

GP Free

The generate_search_placeholder filter allows you to change the default Search … placeholder text.

Parameters: $value (string). Default: Search.

add_filter( 'generate_search_placeholder', function( $value ) {
    return $value;
} );

Guide: Navigation

generate_navigation_search_output

GP Free

The generate_navigation_search_output filter allows you to change the HTML markup of your navigation search form.

Parameters: $value. Default: shown right, computed at render time:

sprintf(
				'<form method="get" class="search-form navigation-search" action="%1$s">
					<input type="search" class="search-field" value="%2$s" name="s" title="%3$s" />
				</form>',
				esc_url( home_url( '/' ) ),
				esc_attr( get_search_query() ),
				esc_attr_x( 'Search', 'label', 'generatepress' )
			)

add_filter( 'generate_navigation_search_output', function() {<br>    printf(  <br>        '<form method="get" class="search-form navigation-search" action="%1$s"><br>            <input type="search" class="search-field" value="%2$s" name="s" title="%3$s" /><br>            <input type="hidden" name="post_type" value="product" /><br>        </form>', <br>        esc_url( home_url( '/' ) ), <br>        esc_attr( get_search_query() ),   <br>        esc_attr_x( 'Search', 'label', 'generatepress' ) <br>    ); <br>} );

add_filter( 'generate_navigation_search_output', function() {
    printf(  
        '<form method="get" class="search-form navigation-search" action="%1$s">
            <input type="search" class="search-field" value="%2$s" name="s" title="%3$s" />
            <input type="hidden" name="post_type" value="post" />
        </form>', 
        esc_url( home_url( '/' ) ), 
        esc_attr( get_search_query() ),   
        esc_attr_x( 'Search', 'label', 'generatepress' ) 
    ); 
} );

add_filter( 'generate_navigation_search_output', function() {<br>    printf(<br>        '<form method="get" class="search-form navigation-search" action="%1$s"><br>            <input type="search" placeholder="Enter your search" class="search-field" value="%2$s" name="s" title="%3$s" /><br>        </form>',<br>        esc_url( home_url( '/' ) ),<br>        esc_attr( get_search_query() ),<br>        esc_attr_x( 'Search', 'label', 'generatepress' ) <br>    ); <br>} );

add_filter( 'generate_navigation_search_output', function() {
    printf( // WPCS: XSS ok, sanitization ok. 
        '<form method="get" class="search-form navigation-search" action="%1$s"> <input type="search" class="search-field" value="" name="s" title="%2$s" /> </form>', 
        esc_url( home_url( '/' ) ), 
        esc_attr_x( 'Search', 'label', 'generatepress' ) );
} );

Guide: Navigation

generate_navigation_search_menu_item_output

GP Free

The generate_navigation_search_menu_item_output filter allows you to change the HTML markup of the navigation search toggle.

Parameters: $value. Default: shown right, computed at render time:

sprintf(
							'<li class="search-item menu-item-align-right"><a aria-label="%1$s" href="#">%2$s</a></li>',
							esc_attr__( 'Open Search Bar', 'generatepress' ),
							generate_get_svg_icon( 'search', true ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Escaped in function.
						)

add_filter( 'generate_navigation_search_menu_item_output', function( $value ) {
    return $value;
} );

Guide: Navigation

Back to top