Добавим информацию к шорткоду: работа с шорткодами, функциями php

Бывают такие ситуации, когда требуется добавить ту или иную информацию к уже активному шорткоду. То есть обработать шорткод (или же функцию) как бы внутри отрабатываемого (ранее созданного) шорткода. Прочтите предыдущую статью, в которой рассказано о шорткодах WordPress подробнее и с примерами (для админов магазинов на Woocommerce – шорткоды).

 

Кто-то скажет: а зачем что-то придумывать? когда можно просто добавить информацию в активный шорткод?

Да, можно… но это не всегда решает задачи требовательных админов, попросту не всегда целесообразно… К примеру, если требуется добавить некие php задачи – типа проверку по ролям пользователей и в зависимости от разрешений выдавать или скрывать информацию на той или иной странице…

…конечно, все это возможно организовать в активном шорткоде, переделав его логику и пр. Но нужно ли это, стоит? тем более, если данная фича требуется временно…

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

 

Итак, поехали… обработка вложенных шорткодов:

 

 

 

 

 

Как создать шорткод ? простой пример создания шорткода

 

 

Сам шордкод (его имя) создается просто. Пример:

 

1) задаем имя шорткода и помещаем имя в квадратные кавычки []

 

 

 

 

получится примерно так:

 

[имя]

 

создаем шорткод:

 

 

add_shortcode( 'имя', 'ats_s_markets' );
function ats_s_markets() {
return '';
// или какой-то процесс
}

 

 

Простейший шорткод создан. Возникает естественный вопрос, а как же вывести шорткод на экран?

 

 

вывод на экран информации шорткода в html организуется так:

 

 

В зависимости от того документа, в котором будете добавлять “вывод” шорткода, предстоит поступать так (подробности ниже):

 

 

do_shortcode( '[имя]' );

<?php do_shortcode( '[имя]' ); // возможно с оператором echo ?>

 

 

имена шорткодв которые нельзя использовать

 

 

В ядре WordPress по умолчанию уже есть несколько зарегистрированных шорткодов. Эти имена нельзя использовать, при создании своих – будут ошибки!

 

Возможно, данный список в дальнейшем будет пополняться разработчиками WP:

 

audio, wp_caption, или caption, embed, gallery, video, playlist …разумеется, имена в квадратных кавычках!..

 

 

 

 

обработка вложенных шорткодов внутри активного или попросту добавить шорткод в шорткод

 

 

Если нужно обработать шорткод внутри шорткода, а это главная тема данного поста, то при обработке контента, скажем так, основного шорткода, потребуется использовать do_shortcode() внутри основного, чтобы соответственно обработать вложенный шорткод.

 

 

 

add_shortcode( 'имя', 'ats_markets_admins' ); //do_shortcode( '[имя]' )
function ats_markets_admins() {
if ( current_user_can( 'administrator' )) { 
return '<span class="postmesy">то, что нужно вывести только для Админа</span>'; 
}
}
//Пояснения админу
add_shortcode( 'имя2', 'ats_s_markets' );
function ats_s_markets() {
return '' . ats_markets_admins() . '' . '<!-- noindex -->то, что нужно отработать для всех<!--/ noindex -->'; // здесь использую не ШОРТ, а ФУНКЦИЮ
}

 

 

В данном коде (предпоследняя строка) я добавляю к активному шорту НЕ добавочный шотркод:

 

do_shortcode( '[имя]' )

 

но функцию: ats_markets_admins() – которая здесь отработает равнозначно!! Однако во всем есть нюансы…

 

..конечно же, возможно добавить и дополнительный шорт (первая строка кода).

 

 

 

 

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

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

 

Как этот тег шорткода убрать, следующая глава:

 

 

как удалить тег шорткода

 

 

 

 

add_shortcode( 'имя', '__return_false' ); //вместо 'имя' укажем 'contents'

 

 

Одинокий тег шорткода будет в записях убран! Подробнее о том, как удалить из записей нерабочие теги шорткода!?

 

 

 

 

Если вам требуется НАПРОЧЬ удалить тег шорткода (стереть из Б.Д,), то об этом как раз в следующей статье – полезные SQL-запросы Базы Данных. Либо воспользоваться одним из плагинов для подобных целей.