Добавляем шорткод в Wordpress - add_shortcode | Wiki | PWODEV
, 13.11.2017 12:36

Добавляем шорткод в WordPress — add_shortcode


add_shortcode()

Добавляет в WordPress новый шоткод и хук для него. Для каждого шордкода можно добавить только одну функцию обработчик. Если добавить больше чем одну то последняя будет перезаписывать все предыдущие.

Если шордкод имеет атрибуты, то они преобразуются в нижний регистр перед передачей в функцию. Значения останутся прежними.

Примеры шорткода:

[shordcode]
[shordcode id='123']
[shordcode] текст [/shordcode]

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

add_shortcode( $tag , $func );

$tag (строка) (обязательный) — Название шоткода. Нельзя использовать нестандартные символы вроде: & / < > [ ] =.

$func (строка) (обязательный) — Название функции, которая отвечает за этот шоткод.

Функция получает 3 параметра:

  1. $atts (массив) — Ассоциативный массив атрибутов указанных в шорткоде.
  2. $content (строка) — Текст шорткода, когда используется закрывающая конструкция шорткода: [foo]текст шорткода[/foo]
  3. $tag (строка) — Тег шорткода. Может пригодится для передачи в доп. функции. Пр: если шорткод — [foo], то тег будет — foo.
    По умолчанию: текущий тег

Примеры:

function shortcode_function(){
  return "Text from shortcode_function";
}
add_shortcode('shortcode_name', 'shortcode_function');

Результат этой функции при вводе в тексте в редакторе [shortcode_name] будет текст «Text from shortcode_function»

Чтобы вызвать этот шорткод в php коде вызываем функцию do_shortcode()

do_shortcode('[shortcode_name]');

На этом пока все. Если у вас есть дополнения по этой статье, оставляйте комментарии ниже.


Добавить комментарий