Как показать код на сайте на WordPress. Рекомендуемые плагины. Часть 2.

Описывается как показать код на сайте на WordPress – php, css, html и др., а так же шорткоды. Вторая часть статьи “Рекомендуемые плагины”. Описываются плагины, которые весьма желательно использовать на сайте. Первая часть “Плагин woosidebars“. Третья часть статьи посвящена очень полезному плагину – визуальному конструктору страничек Visual Composer.

Часто при написании страничек необходимо показать программный код или код шорткодов. Рассмотрим как это сделать.

Как показать код на сайте на WordPress

Для того, чтобы показать программный код на страничке сайта на WordPress есть прекрасный плагин SyntaxHighlighter. Необходимо его установить и активировать на сайте (см. “Как установить плагин WordPress” и “Как обновить плагин WordPress“).

Как только плагин активирован переходим на страничку настроек плагина  “Параметры” (Setting)->SyntaxHighlighter.

показать код на сайте. Рис. 1. Настройки SyntaxHighlighter

Рис. 1. Настройки SyntaxHighlighter

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

Теперь плагин можно начинать использовать.

Каждый кусок кода заключается в теги шорткода между [sourcecode] и [/sourcecode]. При этом, чтобы плагин мог понять, какой код отображается, необходимо задавать параметр lang или language.  Допустимые значения следующие: php, css, xml, html, js, jscript, java, bash, shell, plain, text и т. д. Или, что гораздо проще, можно использовать теги языка, например, [php]здесь код[/php].

Если в коде присутсвует html, то теобходимо установить параметр htmlscript=true. Если перевая линия должна быть не первой, то параметр firstline=xx задает  номер первой строки. Параметр highlight=x1,x2,x3 высвечивает строчки x1,x2,x3. Параметр title=”Заголовок” выводит заголовок кода. С остальными параметрами шорткода можно познакомиться на страничке настроек плагина.

Как показать шорткод на сайте на WordPress

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

Я с этим столкнулся, написав статью о шорткодах плагина bbPress (“Шорткоды bbPress“), порадовался, а потом установил и настроил сам плагин (“Форум для сайта на WordPress“). Через несколько дней решил внести небольшие корректировки и с ужасом обнаружил, что вместо кода шорткодов на страничке отображаются куски форума.

Краткий поиск результатов не дал. Наверное, народ не использует на сайте то, что он описывает.

Пришлось написать несколько строчек кода php для файла functions.php дочерней темы. Обязательно должна использоваться именно дочерняя тема, иначе при первом же обновлении темы изменения будут стерты. Что такое дочерняя тема и как ее создать см. статью “Дочерняя тема WordPress“. Итак, шаг за шагом.

1. Создать безопасное соединение с сервером. Как это сделать см. “Что такое ssh/sftp и для чего он нужен?” для OS Linux (OSX) или “SSH клиент для Windows PuTTY” и “Клиент SSH для Windows Bitvise Tunnelier” для Windows.

2. Стать суперпользователем (См. «Команды Linux. Краткое описание.«)

#su

3. Переходим в папку с темами:

cd /chroot/httpd/var/www/wordpress/wp-content/themes/имя_темы-child/   для сети виртуальных сайтов WordPress Multisite или
cd /chroot/httpd/var/www/wp-content/themes/имя_темы-child/    для сайта WordPress

4. При помощи редактора vi (подробнее см. “Редактор vi. Краткая инструкция“) копируем отсюда и добавляем в файл functions.php перед последней строчкой

?>

следующий код:

/****
Usage: [bg_echo_shortcode bold="true"]Content[/bg_echo_shortcode]
bold - prints shortcode text in Bold, if not, should be installed "false"
****/

add_shortcode( 'bg_echo_shortcode', 'bg_echo_shortcode_content' );

function bg_echo_shortcode_content( $atts, $content = null ) {
 extract( shortcode_atts( array(
 'bold' => false,
 ), $atts ) );
 $prefix = '';
 $suffix = '';
 if ( ! $bold ) {
 $prefix = '<strong>';
 $suffix = '</strong>';
 }
 return '[' . $prefix . $content . $suffix . ']';
}

Должно выглядеть, как на рис. 3

показать код на сайте. Рис. 3. Шорткод вывода шорткодов

Рис. 3. Шорткод вывода шорткодов

Этот код печатает жирным шрифтом в квадратных скобках все, что между [bg_echo_shortcode] и [/bg_echo_shortcode], то есть шорткод. Квадратные скобки шорткода набирать не надо. Если надо вывести содержание шорткода нормальным шрифтом, то необходимо использовать параметр bold=false.

Описано как показать код на сайте на WordPress – php, css, html и др., а так же шорткоды.

,

No comments yet.

Leave a Reply