wp-includes/blocks/navigation-link.php:311Returns a navigation link variation
$entityWP_Taxonomy|WP_Post_Type$kindstringarrayfunction build_variation_for_navigation_link( $entity, $kind ) { $title = ''; $description = ''; // Get default labels based on entity type $default_labels = null; if ( $entity instanceof WP_Post_Type ) { $default_labels = WP_Post_Type::get_default_labels(); } elseif ( $entity instanceof WP_Taxonomy ) { $default_labels = WP_Taxonomy::get_default_labels(); } // Get title and check if it's default $is_default_title = false; if ( property_exists( $entity->labels, 'item_link' ) ) { $title = $entity->labels->item_link; if ( isset( $default_labels['item_link'] ) ) { $is_default_title = in_array( $title, $default_labels['item_link'], true ); } } // Get description and check if it's default $is_default_description = false; if ( property_exists( $entity->labels, 'item_link_description' ) ) { $description = $entity->labels->item_link_description; if ( isset( $default_labels['item_link_description'] ) ) { $is_default_description = in_array( $description, $default_labels['item_link_description'], true ); } } // Calculate singular name once (used for both title and description) $singular = $entity->labels->singular_name ?? ucfirst( $entity->name ); // Set default title if needed if ( $is_default_title || '' === $title ) { /* translators: %s: Singular label of the entity. */ $title = sprintf( __( '%s link' ), $singular ); } // Default description if needed. // Use a single space character instead of an empty string to prevent fallback to the // block.json default description ("Add a page, link, or another item to your navigation."). // An empty string would be treated as missing and trigger the fallback, while a single // space appears blank in the UI but prevents the fallback behavior. // We avoid generating descriptions like "A link to a %s" to prevent grammatical errors // (e.g., "A link to a event" should be "A link to an event"). if ( $is_default_description || '' === $description ) { $description = ' '; } $variation = array( 'name' => $entity->name, 'title' => $title, 'description' => $description, 'attributes' => array( 'type' => $entity->name, 'kind' => $kind, ), ); // Tweak some value for the variations. $variation_overrides = array( 'post_tag' => array( 'name' => 'tag', 'attributes' => array( 'type' => 'tag', 'kind' => $kind, ), ), 'post_format' => array( // The item_link and item_link_description for post formats is the // same as for tags, so need to be overridden. 'title' => __( 'Post Format Link' ), 'description' => __( 'A link to a post format' ), 'attributes' => array( 'type' => 'post_format', 'kind' => $kind, ), ), );Introduced in 5.9.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
src/wp-includes/blocks/navigation-link.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.