_wptexturize_pushpop_element()WP 2.9.0

Searches for disabled element tags. Pushes element to stack on tag open and pops on tag close.

Assumes first char of $text is tag opening and last char is tag closing. Assumes second char of $text is optionally / to indicate closing as in </html>.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

null. Ничего (null).

Использование

_wptexturize_pushpop_element( $text, $stack, $disabled_elements );
$text(строка) (обязательный)
Text to check. Must be a tag like <html> or [shortcode].
$stack(string[]) (обязательный) (передается по ссылке — &)
Array of open tag elements.
$disabled_elements(string[]) (обязательный)
Array of tag names to match against. Spaces are not allowed in tag names.

Список изменений

С версии 2.9.0 Введена.

Код _wptexturize_pushpop_element() WP 6.7.1

function _wptexturize_pushpop_element( $text, &$stack, $disabled_elements ) {
	// Is it an opening tag or closing tag?
	if ( isset( $text[1] ) && '/' !== $text[1] ) {
		$opening_tag = true;
		$name_offset = 1;
	} elseif ( 0 === count( $stack ) ) {
		// Stack is empty. Just stop.
		return;
	} else {
		$opening_tag = false;
		$name_offset = 2;
	}

	// Parse out the tag name.
	$space = strpos( $text, ' ' );
	if ( false === $space ) {
		$space = -1;
	} else {
		$space -= $name_offset;
	}
	$tag = substr( $text, $name_offset, $space );

	// Handle disabled tags.
	if ( in_array( $tag, $disabled_elements, true ) ) {
		if ( $opening_tag ) {
			/*
			 * This disables texturize until we find a closing tag of our type
			 * (e.g. <pre>) even if there was invalid nesting before that.
			 *
			 * Example: in the case <pre>sadsadasd</code>"baba"</pre>
			 *          "baba" won't be texturized.
			 */

			array_push( $stack, $tag );
		} elseif ( end( $stack ) === $tag ) {
			array_pop( $stack );
		}
	}
}