convert_smilies()

0.71 wp-includes / formatting.php / Кодекс WordPress

Преобразует все текстовые смайлики в эмодзи или изображения.

Преобразование будет проигнорировано внутри HTML-тегов <code>, <pre>, <style>, <script>, <textarea>.

Раньше в админке WordPress был чекбокс, который позволял включать/отключать это преобразование (так как оно автоматическое, да), а значит и работу этой функции, это была опция use_smilies в Настройках написания, но затем эту опцию сделали включенной по умолчанию, а чекбокс выпилили, т.е. функция будет работать всегда. Хотя, я думаю, вы спокойно можете использовать хук pre_option_option, чтобы её отключить.

convert_smilies( $text )

Параметры

$text: (строка) Текст, смайлики в котором нужно преобразовать.

Преобразования

Текстовый смайлик	Эмодзи / картинка
`;-)`	😉
`;)`	😉
`:\|`	😐
`:x`	😡
`:wink:`	😉
`:twisted:`	😈
`:smile:`	🙂
`:shock:`	😯
`:sad:`	🙁
`:roll:`	🙄
`:razz:`	😛
`:oops:`	😳
`:o`	😮
`:neutral:`	😐
`:mrgreen:`	mrgreen.png
`:mad:`	😡
`:lol:`	😆
`:idea:`	💡
`:grin:`	😀
`:evil:`	👿
`:eek:`	😮
`:cry:`	😥
`:cool:`	😎
`:arrow:`	➡
`:P`	😛
`:D`	😀
`:???:`	😕
`:?:`	❓
`:?`	😕
`:-\|`	😐
`:-x`	😡
`:-o`	😮
`:-P`	😛
`:-D`	😀
`:-?`	😕
`:-)`	🙂
`:-(`	🙁
`:)`	🙂
`:(`	🙁
`:!:`	❗
`8O`	😯
`8-O`	😯
`8-)`	😎

В этой таблице обратите на единственное название файла изображения mrgreen.png – изображение будет взято из папки /wp-includes/images/smilies/, а раньше, когда не использовались эмодзи, все изображения смайликов брались оттуда.

Примеры

В ядре WordPress эта функция уже добавлена на хуки, например те, которые применяются при выводе текста комментария функцией comment_text() или контента записи функцией the_content().

Тем не менее вот несколько примеров её работы:

echo convert_smilies( 'Привет! :)' );
// Привет! 🙂
 
echo convert_smilies( 'Привет! :mrgreen:' );
// Привет! <img src="http://localhost/wordpress/wp-includes/images/smilies/mrgreen.png" alt=":mrgreen:" class="wp-smiley" style="height: 1em; max-height: 1em;" />

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Преобразования
Пример