WordPress шорткоды: как использовать контентные и одиночные шорткоды
Шорткоды в WordPress очень помогают создавать качественный контент. А это важно для SEO продвижения сайта в поисковых системах Яндекс и Google. Сейчас мы расскажем подробно что это такое и как ими пользоваться.
Тире использовать не рекомендуется, об этом даже написано в официальной документации WordPress. Но на практике тире не вызывает никаких конфликтов и его применение никак не навредит.
Форматы атрибутов:
Смело ставьте пробел и до и после знаков =: attr = value, attr= value, attr =value. Даже будет лучше, если вы их разделите пробелом.
Прописывать имя можно в верхнем, хоть в нижнем регистре, все равно после парсинга оно преобразуется в нижний.
Так же при необходимости в значении позиционного атрибута можно использовать кавычки, если оно содержит пробелы или другие символы, требующие экранирования. Важно помнить, что использование позиционных атрибутов может усложнить чтение кода и его сопровождение, поэтому следует использовать их с осторожностью.
Чтобы полностью поддерживать HTML в атрибутах, необходимо сначала кодировать значения, вводимые пользователем, а затем декодировать их при обработке. Это позволит избежать ошибок и гарантировать правильную работу шорткодов, особенно в случаях, когда значения атрибутов содержат специальные символы или теги HTML.
Помните, что безопасность вашего сайта зависит от правильного использования атрибутов и их значений.
То результат будет выглядеть так:
Например, следующий код: [tag_a] [tag_a] [/tag_a] [/tag_a] будет обработан как текст, потому что вложенные шорткоды имеют одинаковое название. Если вы хотите использовать вложенные, убедитесь, что у них уникальные названия, чтобы избежать таких проблем.
Запомните, что при создании шорткода нужно использовать уникальное имя, чтобы избежать конфликтов с другими плагинами или темами.
Таким образом, при использовании шорткода [my_shortcode] в контенте записи, он будет заменен на "Текст, который заменит shortcode.". Если в функции обработчике использовать echo вместо return, то текст не будет заменять shortcode, а будет выводиться на экран в неожиданных местах.
Пример кода для создания Контентного шорткода:
Теперь можно использовать шорткод так: [name]My Caption[/name] и получить результат:
При вызове шорткода можно передать атрибут class со значением "headline", которое будет использоваться для обрамления контента shortcode тегом <div> с классом "headline".
Эта функция будет обрабатывать контент основного шорткода и передавать его в do_shortcode(). Функция do_shortcode() будет обрабатывать контент и находить в нем другие shortcode, обрабатывая их рекурсивно, если это необходимо.
Не забывайте сохранить и можно проверять. Выходите из админки и смотрите что получилось. Если ничего не изменилось, то нужно почистить куки в браузере или открыть сайт в другом месте.
Этот код удаляет только один shortcode. Если нужно удалить все зарегистрированные шорткоды, достаточно вызвать функцию remove_all_shortcodes():
Таким образом, вы можете без проблем удалять зарегистрированные шорткоды, когда они больше не нужны.
А еще данный модуль является одним из самых удобных и надежных дополнений к функциям WordPress для управления редиректами и популярности веб-ресурса.