Преобразует все текстовые смайлики в эмодзи или изображения.
Преобразование будет проигнорировано внутри HTML-тегов <code>
, <pre>
, <style>
, <script>
, <textarea>
.
Раньше в админке WordPress был чекбокс, который позволял включать/отключать это преобразование (так как оно автоматическое, да), а значит и работу этой функции, это была опция use_smilies
в Настройках написания, но затем эту опцию сделали включенной по умолчанию, а чекбокс выпилили, т.е. функция будет работать всегда. Хотя, я думаю, вы спокойно можете использовать хук pre_option_option, чтобы её отключить.
convert_smilies( $text )
Параметры
- $text
- (строка) Текст, смайлики в котором нужно преобразовать.
Преобразования
В этой таблице обратите на единственное название файла изображения 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;" />