File Manager

📂 File Manager

📝 Edit File: home-link.php

<?php
/**
 * Server-side rendering of the `core/home-link` block.
 *
 * @package WordPress
 */

/**
 * Build an array with CSS classes and inline styles defining the colors
 * which will be applied to the home link markup in the front-end.
 *
 * @since 6.0.0
 *
 * @param  array $context home link block context.
 * @return array Colors CSS classes and inline styles.
 */
function block_core_home_link_build_css_colors( $context ) {
	$colors = array(
		'css_classes'   => array(),
		'inline_styles' => '',
	);

// Text color.
	$has_named_text_color  = array_key_exists( 'textColor', $context );
	$has_custom_text_color = isset( $context['style']['color']['text'] );

// If has text color.
	if ( $has_custom_text_color || $has_named_text_color ) {
		// Add has-text-color class.
		$colors['css_classes'][] = 'has-text-color';
	}

if ( $has_named_text_color ) {
		// Add the color class.
		$colors['css_classes'][] = sprintf( 'has-%s-color', $context['textColor'] );
	} elseif ( $has_custom_text_color ) {
		// Add the custom color inline style.
		$colors['inline_styles'] .= sprintf( 'color: %s;', $context['style']['color']['text'] );
	}

// Background color.
	$has_named_background_color  = array_key_exists( 'backgroundColor', $context );
	$has_custom_background_color = isset( $context['style']['color']['background'] );

// If has background color.
	if ( $has_custom_background_color || $has_named_background_color ) {
		// Add has-background class.
		$colors['css_classes'][] = 'has-background';
	}

if ( $has_named_background_color ) {
		// Add the background-color class.
		$colors['css_classes'][] = sprintf( 'has-%s-background-color', $context['backgroundColor'] );
	} elseif ( $has_custom_background_color ) {
		// Add the custom background-color inline style.
		$colors['inline_styles'] .= sprintf( 'background-color: %s;', $context['style']['color']['background'] );
	}

return $colors;
}

/**
 * Build an array with CSS classes and inline styles defining the font sizes
 * which will be applied to the home link markup in the front-end.
 *
 * @since 6.0.0
 *
 * @param  array $context Home link block context.
 * @return array Font size CSS classes and inline styles.
 */
function block_core_home_link_build_css_font_sizes( $context ) {
	// CSS classes.
	$font_sizes = array(
		'css_classes'   => array(),
		'inline_styles' => '',
	);

$has_named_font_size  = array_key_exists( 'fontSize', $context );
	$has_custom_font_size = isset( $context['style']['typography']['fontSize'] );

if ( $has_named_font_size ) {
		// Add the font size class.
		$font_sizes['css_classes'][] = sprintf( 'has-%s-font-size', $context['fontSize'] );
	} elseif ( $has_custom_font_size ) {
		// Add the custom font size inline style.
		$font_sizes['inline_styles'] = sprintf( 'font-size: %s;', $context['style']['typography']['fontSize'] );
	}

return $font_sizes;
}

/**
 * Builds an array with classes and style for the li wrapper
 *
 * @since 6.0.0
 *
 * @param  array $context    Home link block context.
 * @return string The li wrapper attributes.
 */
function block_core_home_link_build_li_wrapper_attributes( $context ) {
	$colors          = block_core_home_link_build_css_colors( $context );
	$font_sizes      = block_core_home_link_build_css_font_sizes( $context );
	$classes         = array_merge(
		$colors['css_classes'],
		$font_sizes['css_classes']
	);
	$style_attribute = ( $colors['inline_styles'] . $font_sizes['inline_styles'] );
	$classes[]       = 'wp-block-navigation-item';

if ( is_front_page() ) {
		$classes[] = 'current-menu-item';
	} elseif ( is_home() && ( (int) get_option( 'page_for_posts' ) !== get_queried_object_id() ) ) {
		// Edge case where the Reading settings has a posts page set but not a static homepage.
		$classes[] = 'current-menu-item';
	}

$wrapper_attributes = get_block_wrapper_attributes(
		array(
			'class' => implode( ' ', $classes ),
			'style' => $style_attribute,
		)
	);

return $wrapper_attributes;
}

/**
 * Renders the `core/home-link` block.
 *
 * @since 6.0.0
 *
 * @param array    $attributes The block attributes.
 * @param string   $content    The saved content.
 * @param WP_Block $block      The parsed block.
 *
 * @return string Returns the post content with the home url added.
 */
function render_block_core_home_link( $attributes, $content, $block ) {
	if ( empty( $attributes['label'] ) ) {
		// Using a fallback for the label attribute allows rendering the block even if no attributes have been set,
		// e.g. when using the block as a hooked block.
		// Note that the fallback value needs to be kept in sync with the one set in `edit.js` (upon first loading the block in the editor).
		$attributes['label'] = __( 'Home' );
	}
	$aria_current = '';

if ( is_front_page() ) {
		$aria_current = ' aria-current="page"';
	} elseif ( is_home() && ( (int) get_option( 'page_for_posts' ) !== get_queried_object_id() ) ) {
		// Edge case where the Reading settings has a posts page set but not a static homepage.
		$aria_current = ' aria-current="page"';
	}

return sprintf(
		'<li %1$s><a class="wp-block-home-link__content wp-block-navigation-item__content" href="%2$s" rel="home"%3$s>%4$s</a></li>',
		block_core_home_link_build_li_wrapper_attributes( $block->context ),
		esc_url( home_url() ),
		$aria_current,
		wp_kses_post( $attributes['label'] )
	);
}

/**
 * Register the home block
 *
 * @since 6.0.0
 *
 * @uses render_block_core_home_link()
 * @throws WP_Error An WP_Error exception parsing the block definition.
 */
function register_block_core_home_link() {
	register_block_type_from_metadata(
		__DIR__ . '/home-link',
		array(
			'render_callback' => 'render_block_core_home_link',
		)
	);
}
add_action( 'init', 'register_block_core_home_link' );

Type	Item Name	Actions
📁	..
📁	archives
📁	audio
📁	avatar
📁	block
📁	button
📁	buttons
📁	calendar
📁	categories
📁	code
📁	column
📁	columns
📁	comment-author-name
📁	comment-content
📁	comment-date
📁	comment-edit-link
📁	comment-reply-link
📁	comment-template
📁	comments
📁	comments-pagination
📁	comments-pagination-next
📁	comments-pagination-numbers
📁	comments-pagination-previous
📁	comments-title
📁	cover
📁	details
📁	embed
📁	file
📁	footnotes
📁	freeform
📁	gallery
📁	group
📁	heading
📁	home-link
📁	html
📁	image
📁	latest-comments
📁	latest-posts
📁	legacy-widget
📁	list
📁	list-item
📁	loginout
📁	media-text
📁	missing
📁	more
📁	navigation
📁	navigation-link
📁	navigation-submenu
📁	nextpage
📁	page-list
📁	page-list-item
📁	paragraph
📁	pattern
📁	post-author
📁	post-author-biography
📁	post-author-name
📁	post-comments-form
📁	post-content
📁	post-date
📁	post-excerpt
📁	post-featured-image
📁	post-navigation-link
📁	post-template
📁	post-terms
📁	post-title
📁	preformatted
📁	pullquote
📁	query
📁	query-no-results
📁	query-pagination
📁	query-pagination-next
📁	query-pagination-numbers
📁	query-pagination-previous
📁	query-title
📁	quote
📁	read-more
📁	rss
📁	search
📁	separator
📁	shortcode
📁	site-logo
📁	site-tagline
📁	site-title
📁	social-link
📁	social-links
📁	spacer
📁	table
📁	tag-cloud
📁	template-part
📁	term-description
📁	text-columns
📁	verse
📁	video
📁	widget-group
📄	archives.php
📄	avatar.php
📄	block.php
📄	blocks-json.php
📄	button.php
📄	calendar.php
📄	categories.php
📄	comment-author-name.php
📄	comment-content.php
📄	comment-date.php
📄	comment-edit-link.php
📄	comment-reply-link.php
📄	comment-template.php
📄	comments-pagination-next.php
📄	comments-pagination-numbers.php
📄	comments-pagination-previous.php
📄	comments-pagination.php
📄	comments-title.php
📄	comments.php
📄	cover.php
📄	file.php
📄	footnotes.php
📄	gallery.php
📄	heading.php
📄	home-link.php
📄	image.php
📄	index.php
📄	latest-comments.php
📄	latest-posts.php
📄	legacy-widget.php
📄	list.php
📄	loginout.php
📄	media-text.php
📄	navigation-link.php
📄	navigation-submenu.php
📄	navigation.php
📄	page-list-item.php
📄	page-list.php
📄	pattern.php
📄	post-author-biography.php
📄	post-author-name.php
📄	post-author.php
📄	post-comments-form.php
📄	post-content.php
📄	post-date.php
📄	post-excerpt.php
📄	post-featured-image.php
📄	post-navigation-link.php
📄	post-template.php
📄	post-terms.php
📄	post-title.php
📄	query-no-results.php
📄	query-pagination-next.php
📄	query-pagination-numbers.php
📄	query-pagination-previous.php
📄	query-pagination.php
📄	query-title.php
📄	query.php
📄	read-more.php
📄	require-dynamic-blocks.php
📄	require-static-blocks.php
📄	rss.php
📄	search.php
📄	shortcode.php
📄	site-logo.php
📄	site-tagline.php
📄	site-title.php
📄	social-link.php
📄	tag-cloud.php
📄	template-part.php
📄	term-description.php
📄	widget-group.php