WP_DEBUG

Notes about WordPress Gutenberg themes development.

  • Menu: edit items

    # , ,
    Read more

    To edit individual items of a menu

    add_filter( 'wp_nav_menu_objects', 'dev__add_smiley', 11, 2 );

function dev__add_smiley( $items, $args ) {

	foreach ( $items as &$item ) {

		// add class
		array_push($item->classes, 'dw-submenu__parent');
			
		$item->title = ':D ' . $item->title;

		// $item->title .= '</a>' . $subelement; note: close the link

		}

	}

	return $items;

}

    Sources:

    • https://developer.wordpress.org/reference/hooks/wp_nav_menu_items/
    • https://developer.wordpress.org/reference/hooks/wp_nav_menu_objects/

  • Redirections

    #
    Read more

    Si on veut cacher à la fois les single et les archives, le plus simple est public à false. Préciser show_ui et show_in_rest à true pour pouvoir les gérer dans l’admin et dans Gutenberg. Ne pas préciser de rewrite du tout, ou alors à false. 

    => les urls ne sont pas du tout accessibles de nulle part (pas de lien “Voir” dans le BO), y compris en SEO : c’est le plus pratique, et pas d’erreurs/oublis possibles.

    Pour mémoire, si on veut uniquement cacher les archives, avoir public à true, mais has_archive à false permet de pouvoir gérer une Page au même nom que slug des single. Si on ne veut aucune page au slug des singles, laisser has_archive à true, et créer une redirection via le filter template_redirect. (cas des Rapports d’ecomaison).

    Si on veut cacher uniquement les singles mais conserver l’archive (si on n’a pas de page qui fait le job, ce qui est quand même le cas le plus fréquent), il faut passer par du code WP de redirection sur le filter template_redirect  et bloquer les singles dans Yoast SEO.

    Sylvie

    To handle redirections:

    add_actions( 'template_redirect', 'fn' );

function fn() {
  wp_redirect( home_url( '/' ), 301 );
  exit;
}

    Sources:

    • https://developer.wordpress.org/reference/functions/wp_redirect/
    • https://developer.wordpress.org/reference/hooks/template_redirect/

  • Block rendering filter

    # , ,
    Read more
    add_filter( 'render_block', 'dev__paragraph_add_block', 10, 2 );

function dev__paragraph_add_block( $block_content, $block ){

	if ( 'core/paragraph' === $block['blockName'] ){
		$block_content = new WP_HTML_Tag_Processor( $block_content );
        $block_content->next_tag(); /* first tag should always be ul or ol */
        $block_content->add_class( 'wp-block-paragraph' );
        $block_content->get_updated_html();
	}

	return $block_content;

}

  • filter theme.json

    # ,
    Read more

    There is a way to intervene on the generation of the css based on the theme.json file.

    function update_with_dark_theme( $theme_json ){

        $dark_theme = json_decode( file_get_contents( get_template_directory() . '/styles/dark.json' ), true );
        return $theme_json->update_with( $dark_theme );

}

add_filter( 'wp_theme_json_data_user', 'dsfr_update_with_dark_theme' );

    It can be used to switch the theme scheme for e.g.

    function dsfr_reload_styles(){

	if ( isset( $_GET['scheme'] ) && $_GET['scheme'] == 'dark' ){

		add_filter( 'wp_theme_json_data_user', 'dsfr_update_with_dark_theme' );

	}

	wp_enqueue_global_styles();
	remove_action( 'wp_print_styles', 'print_emoji_styles' );

	header( 'Content-type: text/css' );
	wp_print_styles();

	exit();

}

add_action( 'wp_ajax_dsfr_reload_styles', 'dsfr_reload_styles' );
add_action( 'wp_ajax_nopriv_dsfr_reload_styles', 'dsfr_reload_styles' );

    Source : https://fullsiteediting.com/lessons/how-to-filter-theme-json-with-php/