Функция wp_specialchars_decode() в WordPress с примерами

Доступна с версии: 2.8

Функция wp_specialchars_decode() в WordPress выполняет обратную замену HTML-сущностей на соответствующие символы. Она обрабатывает следующие сущности: &, <, >, ", и '. Эта функция полезна при необходимости преобразовать HTML-сущности в их исходные символы.

wp_specialchars_decode( string $text, string|int $quote_style = ENT_NOQUOTES ): string

Параметры

$text
- (string, обязательный) Текст, который нужно декодировать. Включает HTML-сущности, подлежащие замене на обычные символы.
$quote_style
- (string|int, необязательный) Указывает, как обрабатывать кавычки:
  - ENT_COMPAT — декодирует только двойные кавычки (").
  - ENT_QUOTES — декодирует как двойные, так и одинарные кавычки (" и ').
  - ENT_NOQUOTES — не изменяет кавычки (значение по умолчанию).
Параметр также поддерживает значения из функции _wp_specialchars():
- 'single' — заменяет только одинарные кавычки (').
- 'double' — заменяет только двойные кавычки (").

Возвращаемое значение

Возвращает обработанный текст, где HTML-сущности заменены на соответствующие символы.

Примечания

Эта функция не обрабатывает все возможные HTML-сущности. Например, она не декодирует сущности вроде – (–).
Для полного декодирования всех сущностей можно использовать html_entity_decode().

Пример 1: Замена HTML-сущностей на обычные символы

$string = <<<'TEXT'
Амперсанд - &amp; / &#038; / &#x26;
Одинарные кавычки - &#039; / &#x27;
Двойные кавычки - &quot; / &#034; / &#x22;
Больше - &gt; / &#062; 
Меньше - &lt; / &#060; 
TEXT;

echo wp_specialchars_decode( $string, ENT_QUOTES );

Результат выполнения кода:

Амперсанд - & / & / &
Одинарные кавычки - ' / '
Двойные кавычки - " / " / "
Больше - > / > 
Меньше - < / <

Пример 2: Декодирование текста с настройкой `ENT_COMPAT` (только двойные кавычки)

$text = 'Цитаты: &quot;Пример текста&quot; и &apos;еще пример&apos;.';
echo wp_specialchars_decode($text, ENT_COMPAT);

Результат выполнения кода:

Цитаты: "Пример текста" и &apos;еще пример&apos;.

Пример 3: Использование только для одинарных кавычек

$sample_text = 'Текст с одинарной кавычкой: &#039;';
echo wp_specialchars_decode($sample_text, 'single');

Результат выполнения кода:

Текст с одинарной кавычкой: '

Заключение

Функция wp_specialchars_decode() полезна, когда требуется преобразовать часть HTML-сущностей обратно в символы, оставляя другие без изменений. В зависимости от параметров $quote_style, можно гибко контролировать, какие именно сущности будут преобразованы.

wp_specialchars_decode() в WordPress: Использование, Параметры и Примеры

Пример 1: Замена HTML-сущностей на обычные символы

Пример 2: Декодирование текста с настройкой ENT_COMPAT (только двойные кавычки)

Пример 3: Использование только для одинарных кавычек

Заключение

Стартовая премиум тема для WordPress

Дополнительно по: Форматирование

before_last_bar()

sanitize_title()

sanitize_title_with_dashes()

tag_escape()

wp_check_invalid_utf8()

wp_filter_kses()

wp_filter_nohtml_kses()

wp_filter_post_kses()

wp_kses()

wp_kses_data()

wp_strip_all_tags()

wp_targeted_link_rel()

normalize_whitespace()

number_format_i18n()

remove_accents()

set_url_scheme()

size_format()

strip_fragment_from_url()

trailingslashit()

untrailingslashit()

url_shorten()

user_trailingslashit()

utf8_uri_encode()

wp_convert_hr_to_bytes()

wp_html_excerpt()

wp_rel_nofollow()

wp_specialchars_decode()

make_clickable()

links_add_target()

force_balance_tags()

ent2ncr()

convert_smilies()

capital_P_dangit()

wp_trim_words()

wpautop()

wptexturize()

zeroise()

balanceTags()

backslashit()

antispambot()

add_magic_quotes()

absint()

Пример 2: Декодирование текста с настройкой `ENT_COMPAT` (только двойные кавычки)