wpseek.com
A WordPress-centric search engine for devs and theme authors



_wp_kses_allow_note_mention_span › WordPress Function

Since7.1.0
Deprecatedn/a
› _wp_kses_allow_note_mention_span ( $allowed, $context )
Access:
  • private
Parameters: (2)
  • (array<string,array<string,bool>>) $allowed The allowed tags structure for the context.
    Required: Yes
  • (string) $context The kses context.
    Required: Yes
Returns:
  • (array<string,array<string,bool>>) Modified allowed tags structure.
Defined at:
Codex:

Allows the note mention chip markup in comment content.

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.


Related Functions: _wp_kses_sanitize_note_mention_classes, wp_kses_allowed_html, wp_kses_normalize_entities, wp_kses_xml_named_entities, wp_allow_comment

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;
}