_wp_kses_allow_note_mention_span( $allowed, string $context ): array<string,

In this article

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only by core. It is listed here for completeness.

Allows the note mention chip markup in comment content.

Description

The notes @ mention completer stores a mention as a chip carrying the mentioned user’s ID in a class token: <span class="wp-note-mention user-N">@Name</span>. The default comment allowlist does not allow span at all, so for users without unfiltered_html the mention would be stripped on save.

The allowance is deliberately narrow and always on: span is a semantics-free element and _wp_kses_sanitize_note_mention_classes() reduces its class to the two mention tokens right after kses runs, so regular (including anonymous) commenters gain nothing beyond the inert mention markup itself.

Parameters

array<string, bool>> $allowed The allowed tags structure for the context.
$contextstringrequired
The kses context.

Return

array<string, array<string, bool>> Modified allowed tags structure.

Source

function _wp_kses_allow_note_mention_span( $allowed, $context ): array {
	if ( ! is_array( $allowed ) ) {
		$allowed = array();
	}
	if ( 'pre_comment_content' !== $context ) {
		return $allowed;
	}

	if ( ! isset( $allowed['span'] ) || ! is_array( $allowed['span'] ) ) {
		$allowed['span'] = array();
	}

	$allowed['span']['class'] = true;

	return $allowed;
}

Changelog

VersionDescription
7.1.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.