WordPress плагин Special Text Boxes

Март 12, 2009 | minimus
Рубрика: Виджеты, Плагины

Довольно часто блоггеру требуется каким-либо образом выделить в статье важный текст. Это может быть предупреждение, важная информация, предостережение и т.п. Разумеется, можно использовать для подсветки текста стили, добавляя их прямо в текст статьи, или, на худой конец, использовать стиль цитаты. Но не все умеют пользоваться стилями, а цитата не подходит на все случаи жизни. Чтобы упростить себе (и не только себе) жизнь, я написал небольшой плагин для подсветки текста в статьях.

(This post is available on english language.)

Плагин добавляет в WordPress небольшой файл таблицы стилей и короткие коды (short codes) для подсветки текста. Выглядит это так:

Простые блоки:

Это пример подсветки текста-предостережения. Вывод производится спомощью ID «alert». Длина подсвечиваемого текста не имеет значения.

Это пример подсвеченного текста для вывода линка скачивания. Вывод производится с помощью ID «download».

Это пример информационного блока. Вывод производится посредством ID «info».

Это пример подсветки предупреждающего текста. Выводится при использовании ID «warning». Использование короткого кода без ID даст такой-же эффект.

Это пример чёрного блока. Как его использовать я ещё не придумал.

Это пример настраиваемого блока. Для его настройки используйте редактор настраиваемого блока в админ-панели.

Простые блоки с использованием больших иконок:

Это пример подсвеченного текста для вывода линка скачивания. Вывод производится с помощью ID «download».

Это пример информационного блока. Вывод производится посредством ID «info».

Это пример чёрного блока. Как его использовать я ещё не придумал.

Блоки с заголовком:

Внимание, опасность!!!

Это пример подсветки текста-предостережения с заголовком. Вывод производится спомощью ID «alert». Длина подсвечиваемого текста не имеет значения.

Скачать

Это пример подсвеченного текста для вывода линка скачивания с заголовком. Вывод производится с помощью ID «download».

Информация

Это пример информационного блока с заголовком. Вывод производится посредством ID «info».

Внимание!

Это пример подсветки предупреждающего текста с заголовком. Выводится при использовании ID «warning». Использование короткого кода без ID даст такой-же эффект.

Чёрный блок

Это пример чёрного блока с заголовком. Как его использовать я ещё не придумал.

Настраиваемый блок

Поддерживаемые языки

Админ-панель плагина доступна на следующих языках:

Английский
Русский
Итальянский (перевод Gianni Diurno)
Белорусский (перевод Fat Cower)
Узбекский (перевод Алишер Сафаров)
Польский (перевод Daniel Fruzynski)
Арабский (перевод مدونة رسين)
Голландский (перевод Rene)
Украинский (перевод Официальная команда локализации)
Немецкий (перевод Renate)

Установка

Распаковать файл архива плагина
Поместить папку плагина в папку WordPress wp-content/plugins
Активировать плагин на странице плагинов
Настроить внешний вид блоков по вкусу

Плагин готов к использованию!

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

Для подсветки текста, используйте следующий короткий код:

[stextbox id="НУЖНЫЙ_ID"]Подсвечиваемый текст и/или короткие коды[/stextbox]

или (только для версии 0.1.2+)

[stextbox id="НУЖНЫЙ_ID" caption="Заголовок"]Подсвечиваемый текст и/или короткие коды[/stextbox]

НУЖНЫЙ_ID может принимать следующие значения:

alert – красный блок. Предостережение, опасность.
download – синий блок. Скачивания.
info – зелёный блок. Информация.
warning – жёлтый блок. Предупреждение.
black – чёрный блок. (???)
grey – серый блок. Введён для возможности демонстрации коротких кодов используемых в WordPress.
custom – настраиваемый админом блога блок

ЗАГОЛОВОК – любой нужный Вам заголовок для подсвечиваемого текста.

Внимание

Не используйте id «grey» для демонстрации коротких кодов wp-special-textboxes. Это приведёт к ошибке парсера WordPress. Ничего страшного не случится, но нужного результата Вы не добьётесь.

Вы можете использовать короткие коды других плагинов внутри короткого кода wp-special-textboxes. Например:

[stextbox id="download" caption="Скачать"][download id="48"][/stextbox]

Это пример использования «короткого кода» плагина Download Manager внутри «короткого кода» плагина wp-special-textboxes. Результат вывода этой конструкции можно увидеть в разделе «Скачать» этой статьи.

Короткие коды можно вставлять в текст статьи с помощью диалога вставки:

Диалог вставки

Настройка «на лету»

Это пример настроенного «на лету» блока-предостережения (alert).

Пример настройки на лету

Это пример настроенного «на лету» блока-предостережения. Вывод произвёлся с помощью id alert, и параметров коротких кодов.

Параметры настройки «на лету»:

color – цвет текста
ccolor – цвет текста заголовка
bcolor – цвет окантовки
bgcolor – цвет фона
cbgcolor – цвет фона заголвка
image – полный URL изображения. Для вывода блока без иконки, используйте значение null
big – используйте этот параметр для принудительной установки размера изображения. Может быть true или false.
float – включение режима обтекания текста (true, false), по умолчанию false
align – выравнивание блока специального текста в режиме обтекания текста (left, right), по умолчанию left
width – ширина блока в пикселах в режиме обтекания текста (только цифры, без px), по умолчанию 200

Код блока из примера настройки на лету

[stextbox id="alert" caption="Пример настройки на лету" color="000000" ccolor="ffffff" bgcolor="f7cdf5" cbgcolor="f844ee" bcolor="f844ee" image="http://blogcoding.ru/wp-content/plugins/wp-special-textboxes/images/heart.png"]Это пример настроенного «на лету» блока-предостережения. Вывод произвёлся с помощью id alert, и параметров коротких кодов.[/stextbox]

Настройка

Параметры плагина wp-special-textboxes

C осторожностью используйте дополнительные параметры. Стандарт CSS3, на сегодняшний день, не является официальным стандартом (бета). Браузер не убьёт, но могут проявиться неприятные, с точки зрения эстетики восприятия, эффекты …

Настраиваемый блок. Редактор

Редактор настраиваемого блока

Используйте этот редактор для настройки внешнего вида настраиваемого блока. Редактор доступен в админ-панели.

Блок в любом месте блога

Если Вы хотите разместить блок подсвеченного текста где-то вне статьи, Вы можете воспользоваться функцией stbHighlightText. Например:

^?View Code PHP

1	<?php if(function_exists('stbHighlightText')) stbHighlightText('Test of function stbHighlightText.', 'warning', ''); ?>

Функция stbHighlightText определена как

^?View Code PHP

1	function stbHighlightText( $content = null, $id = 'warning', $caption = '', $atts = null )

где

$content – текст блока (string)
$id – ID блока (string)
$caption – заголовок блока, если требуется (string)
$atts – дополнительные параметры блока (array)

Массив дополнительных параметров определён как:

^?View Code PHP

atts = array(
  'color' => '',
  'ccolor' => '',
  'bcolor' => '',
  'bgcolor' => '',
  'cbgcolor' => '',
  'image' => '',
  'big' => '' );

где

color – Цвет шрифта блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
ccolor – Цвет шрифта заголовка блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
bcolor – Цвет окантовки блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
bgcolor – Цвет фона блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
cbgcolor – Цвет фона заголовка блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
image – полный URL иконки (рекомендуется изображение PNG с прозрачным фоном, 25х25 пиксел для малой иконки и 50х50 для большой). Используйте значение null для вывода блока без иконки (string)
big – Используйте этот параметр для определения размера заданной иконки (большая, малая). Может быть true или false (boolean as string).

Начиная с версии 2.0.22 полностью определять массив не требуется, достаточно определить лишь необходимые параметры:

^?View Code PHP

1	<?php if(function_exists('stbHighlightText')) stbHighlightText('Test of function stbHighlightText.', 'warning', '', array("image" => "http://simplelib/images/wp-b.png", "big" => "true")); ?>

Виджет

В Special Text Boxes 3 добавлена возможность вывода блока специального текста в сайдбар в виде виджета текста.

Текст может содержать HTML теги, а в режиме эмуляции PHP, и PHP-коды.

В режиме эмуляции PHP обязательно используйте PHP-теги даже, если Вы используете только PHP код и более ничего!

Для вывода виджета на заданных страницах блога, отключите вывод на всех страницах и выберите нужные параметры вывода.

Скачать

Special Text Boxes
Плагин подсвечивает выводимый текст в виде цветного блока

Автор: minimus, версия: 3.7.51, обновлён: 29.08.2010,
Требуется версия WP: 2.6 или выше, протестирован до версии: 3.0.1.
Скачать (13 855 раз) (9 голосов)