WordPress
Добавить короткий код
Поиск…
Синтаксис
add_shortcode( $tag , $func );
параметры
| параметр | подробности |
|---|---|
| $ тег | (строка) (обязательно) Тег короткого кода, который нужно искать в сообщении |
| $ FUNC | (вызываемый) (обязательно) Крюк для запуска при обнаружении короткого кода |
замечания
- В обратном вызове короткого кода будут переданы три аргумента: атрибуты короткого кода, содержание короткого кода (если есть) и имя короткого кода.
- Для каждого короткого кода может быть только один крючок. Это означает, что если другой плагин имеет аналогичный короткий код, он переопределит ваш или ваш будет переопределять их в зависимости от того, какой заказ включены и / или запущены плагины.
- Имена атрибутов Shortcode всегда преобразуются в строчные буквы, прежде чем они передаются в функцию обработчика. Значения нетронуты.
- Обратите внимание, что функция, называемая коротким кодом, никогда не должна выводить какой-либо результат. Функции Shortcode должны возвращать текст, который будет использоваться для замены короткого кода. Прямое производство выходного сигнала приведет к неожиданным результатам. Это похоже на то, как должны работать функции фильтра, поскольку они не должны вызывать ожидаемые побочные эффекты от вызова, поскольку вы не можете контролировать, когда и где они вызываются.
Простой короткий код для недавней публикации
add_shortcode - это ключевое слово wp.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
endwhile;
endif;
wp_reset_query();
return $return_string;
}
Этот фрагмент можно поместить в вашу тему functions.php .
[recent-posts] Это короткий код для недавней публикации. Мы можем применить этот короткий код в бэкэнд (например, страницы, сообщения, виджеты).
Мы также можем использовать тот же короткий код внутри нашего кода. с помощью do_shortcode .
Например. echo do_shortcode( '[recent-posts]' );
Расширенный короткий код для последних сообщений
Эти функции принимают параметр для количества последних сообщений, которые вы хотите отобразить.
Пример: вы хотите отобразить только пять последних сообщений. Просто передал аргументы с posts = "5" (вы можете передать любое количество последних сообщений, которые вы хотите отобразить).
Функция выводит только пять последних сообщений из базы данных.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
extract(shortcode_atts(array(
'posts' => 1,
), $atts));
$return_string = '<ul>';
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
endwhile;
endif;
$return_string .= '</ul>';
wp_reset_query();
return $return_string;
}
Например. echo do_shortcode( '[recent-posts posts="5"]' );