WordPress плагин Special Text Boxes

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

(This post is available on english language.)

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

Режим CSS

Это пример подсветки текста-предостережения. Вывод производится спомощью ID “alert”. Длина подсвечиваемого текста не имеет значения.
Это пример подсвеченного текста для вывода линка скачивания. Вывод производится с помощью ID “download”.
Информация
Это пример информационного блока с заголовком. Вывод производится посредством ID “info”.

Режим Javascript

Это пример подсветки предупреждающего текста. Выводится при использовании ID “warning”. Использование короткого кода без ID даст такой-же эффект. ;)
Черная цитата
Это пример чёрного блока с заданным по умолчанию заголовком. Как его использовать я ещё не придумал.
Пользовательский стиль
Это пример пользовательского блока.

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

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

Установка

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

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

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

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

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

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

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

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

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

Кроме того, Вы можете задать в репозитарии стилей плагина столько стилей, сколько Вам нужно.

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

Внимание
Не используйте 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 – цвет фона (режим CSS), начальный цвет градиента (режим Javascript)
  • bgcolorto – конечный цвет градиента (режим Javascript)
  • cbgcolor – цвет фона заголовка (режим CSS), начальный цвет градиента заголовка (режим Javascript)
  • cbgcolorto - конечный цвет градиента заголовка (режим Javascript)
  • image – полный URL изображения. Для вывода блока без иконки, используйте значение null
  • big – используйте этот параметр для принудительной установки размера изображения. Может быть true или false. Только для режима CSS.
  • mode – режим отображения (css|js)
  • float – включение режима обтекания текста (true, false), по умолчанию false
  • align – выравнивание блока специального текста в режиме обтекания текста (left, right), по умолчанию left
  • width – ширина блока в пикселах в режиме обтекания текста (только цифры, без px), по умолчанию 200
  • collapsed – показывает блок при загрузке в свёрнутом виде, если сворачивание/разворачивание разрешено в параметрах
  • mleft – левый отступ в пикселах.
  • mright – правый отступ в пикселах.
  • mtop – верхний отступ в пикселах.
  • mbottom – нижний отступ в пикселах.
  • collapsing – разрешить/запретить сворачивание/разворачивание блока
  • defcaption – использовать заданный по умолчанию заголовок блока
Код блока из примера настройки на лету
[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]

Настройка

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

Репозитарий стилей

Начиная с версии 4.0.65 плагин позволяет иметь столько стилей, сколько нужно владельцу блога. Все стили хранятся в репозитарии стилей (таблице базы данных) и могут быть настроены на любой вкус. Стили делятся на две категории: предустановленные (системные и специальные) и пользовательские. Параметры всех стилей могут быть изменены администратором блога. Отличие заключается в том, что ярлыки (уникальные имена) можно задавать только для пользовательских стилей. Ярлыки для предустановленных стилей изменить невозможно.

Используйте репозитарий для настройки существующих и создания новых стилей внешнего вида блоков.

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

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

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

где

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

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

где

  • color – Цвет шрифта блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • ccolor – Цвет шрифта заголовка блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • bcolor – Цвет окантовки блока (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • bgcolor – Цвет фона (режим CSS), начальный цвет градиента (режим Javascript) (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • bgcolorto – Конечный цвет градиента (режим Javascript) (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • cbgcolor – Цвет фона заголовка (режим CSS), начальный цвет градиента заголовка (режим Javascript) (шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • cbgcolorto – конечный цвет градиента заголовка (режим Javascript)(шесть шестнадцатиричных цифр цвета без символа #, определённых как строка (string))
  • image – полный URL иконки (рекомендуется изображение PNG с прозрачным фоном, 25х25 пиксел для малой иконки и 50х50 для большой). Используйте значение null для вывода блока без иконки (string)
  • big – Используйте этот параметр для определения размера заданной иконки (большая, малая). Может быть true или false (boolean as string).
  • mode – режим отображения (css|js)
  • float – включение режима обтекания текста (true, false), по умолчанию false
  • align – выравнивание блока специального текста в режиме обтекания текста (left, right), по умолчанию left
  • width – ширина блока в пикселах в режиме обтекания текста (только цифры, без px), по умолчанию 200
  • collapsed – показывает блок при загрузке в свёрнутом виде, если сворачивание/разворачивание разрешено в параметрах (true|false)
  • mleft – левый отступ в пикселах.
  • mright – правый отступ в пикселах.
  • mtop – верхний отступ в пикселах.
  • mbottom – нижний отступ в пикселах.
  • collapsing – разрешить/запретить сворачивание/разворачивание блока (true|false)
  • defcaption – использовать заданный по умолчанию заголовок блока (true|false)
  • direction – направление языка, для вставок цитат с иным направлением языка (ltr|rtl)
  • level – уровень вложения блока. Только для режима Javascript. Позволяет отложить прорисовку внутреннего блока до тех пор, пока не будет прорисован внешний блок. (0|1)

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

или

Блок в блоке

Если Вы хотите вставить один блок в другой, используйте короткий код “stb“. Например:

[stextbox id="info" defcaption="true"]Некоторый текст[stb id="download" defcaption="true" collapsed="false" collapsing="false"]Некоторый текст во внутреннем блоке[/stb][/stextbox]

Режим CSS

Инфо
Некоторый текст
Скачать
Некоторый текст во внутреннем блоке

Режим Javascript

Инфо
Некоторый текст
Скачать
Некоторый текст во внутреннем блоке

Виджет

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

Виджет Специальный Текст

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

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

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

Скачать

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

Автор: minimus, версия: 4.3.72, обновлён: 13.02.2012,
Требуется версия WP: 3.0 или выше, протестирован до версии: 3.3.2.
Скачать (49 812 раз) (27 голосов)

Тестирование

Тестирование
Тестирование плагина проводилось на следующих браузерах:

1. Internet Explorer 7..9

2. Mozilla FireFox 3..9

3. Opera 10.0..11.52

4. Google Chrome 11.0.154.53..15.0.874.121

5. Apple Safari 3.1.2..5.1.1 (for Windows)

© 2009 – 2011, minimus. Все права защищены. При копировании и републикации статьи, ссылка на первоисточник обязательна.

Популярность: 94%

Похожие статьи:

  1. Special Text Boxes 4. Опрос!
  2. Special Text Boxes 3. Опрос
  3. WordPress плагин My WP Plugin Info
  4. Подсветка специального текста в Blogger-блоге
  5. WordPress плагин Simple View

Комментарии

  1. oyua сказал:

    Добрый день!

    Прошу прощения, но подобная ошибка возникает и в IE8.
    Правда, в IE8 выдается немного иное сообщение:

    Сообщение: Предполагается наличие функции
    wstb.js.php          Строка: 2
    Код: 0                   Символ: 1
    URI-код: http://blogcoding.ru/35671b/URZFSVkaFkQUEh0EWlRHQUVKQUNLRkMZAl4PRwZbRh9JDkReCltKHBQVHkZJVlFaUQgeQgFJR1YOSQRATF9BH04RRVtNX0odEw1DCk9WQA4CSgsYUQ==/
    Перезаливка файла wstb.js.php  по ftp - не помогает.
    Более того, на локальной копии сайта данная ошибка тоже наблюдается. 

    Можно ли это исправить?

    С уважением,

    oyua

  2. oyua сказал:

    Добрый день!
    Сегодня обновил Ваш плагин (до версии 3.3.35).
    В баузерах IE сообщения об ошибках не выдаются.
    Все работает нормально.
    Спасибо!
    Удачи!

  3. Ван сказал:

    класс! вот как раз для цитат очень хорошо подходит!

  4. nethead сказал:

    1) Установил себе плагин, почему то он на английском языке…
    2) Не появляется иконка редактирования текста…Что делать?

  5. nethead сказал:

    3) При нажатии иконки редактирования текста, появляютя ироглифы

  6. Perri Mason сказал:

    У меня такой вопрос, хоть убей, отображается заголовок и сам блок с текстом раздельно…

  7. Георгий сказал:

    Скачал, все вроде бы нормально, а вот поля текста внутри рамки не могу отрегулировать (хочеться увлеличить поля текста). И еще: рамка заглавия низкая

  8. Joker сказал:

    Как в шаблоне single.php после записи вставить блок, там должен быть яваскрипт. У мя выбивает ошибку.

    • minimus сказал:

      Попробуйте так:

  9. armo сказал:

    У меня не работает, выводится только текст, а подсветки нет

  10. armo сказал:

    Плагин вообще не дружис Dean’s FCKEditor, как это можно исправить?

    • minimus сказал:

      Надо смотреть, перерабатывать плагин … Чуть позже – сейчас переустанавливаю винду … :(

      • armo3000 сказал:

        Здравствуйте, просмотрев сохраненный с помощью Dean FCKEditor пост с помощью стандартного редактора стало ясно, что FCKEditor превращает кавычки в ". Следовательно, в плагин нужно добавить поддержку " вместо кавычек. Вот пример: . Заранее благодарен :)

  11. Mamont сказал:

    Хочу выразить свою признательность автору за плагин. Огромное спасибо.
    И вопрос. Или пожелание. Есть необходимость создать несколько “настраиваемых” блоков-заготовок. Как можно это сделать? Если нет – примите, как предложение для следующей версии.

  12. Андрей сказал:

    Плагин поставил давно, но пользоваться стал недавно. Сейчас ещё раз перечитал настройки. Вот только про закруглённые углы я что-то не нашёл, где ставится.. Точнее, почему не закругляется :-)

    • minimus сказал:

      Устанавливается в параметрах (Дополнительные параметры -> Разрешить использование закруглённых углов?).
      Не закругляется в Opera, IE6..8
      Закругляется в Safari, Chrome, Firefox, IE9.

  13. Александр сказал:

    Установил плагин, но когда в текстовом редакторе выделяю текст, открывается окошечко с настройками – так вот в нем сплошные кракозябры, а не текст. Пользоваться не возможно. У меня вордпресс 2.9.2.  Что делать?

  14. Вадим сказал:

    Что нужно прописать чтобы настроить “на лету” свернутость или развернутость в заголовок?

  15. Вадим сказал:

    Блин… кое как нашел этот сайт и эту тему )))) можно на будущее в плагин вставить прямую ссылку на сайт и эту тему.
    Вы не поверите как я искал этот сайт! Скопировал название плагина “Special Text Boxes” и вставил в яндекс )))))))))))))))))))))))))

  16. kibastos сказал:

    подскажите как задать ширину в пикселях? Пробовал указать в основных параметрах с помощью диалога вставки – не получилось…

    • minimus сказал:

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

  17. Wower сказал:

    Спасибо за плагин, но у меня проблема. Во всех браузерах съехала кнопка открыть\закрыть, где нужно отредактировать стиль должным образом, чтобы точно изменить ее положение для блоков? Пример косяка в ссылке “Сайт”.
     
    Заранее спасибо.

  18. Ginom сказал:

    Добрый день, нужна помощь в решении проблемы, жду дельных советов, а не переустанови или смени тему и т.д, уже пробовал
    Описание: При установки некоторых плагинов например Special Text Boxes Версия 3.5.45 в визуальный редактор добавляются кнопки быстрой вставки с ними и проблемы. Нажимаю на кнопку появляется всплывающее окошко но пустое, в нем нет не полей ничего.
    Даная проблема присутствует во всех браузерах, что у меня установлены IE, Opera, Firefox. Я переключался на стандартную тему получил тот же результат, отключал другие плагины, не помогает, делал чистую установку бес толку WordPress 3.0.

    • minimus сказал:

      Проверьте вспомогательные файлы в папке js … У Вас сервер очень туго работает, могло что-нибуть плохо выгрузиться на сервер …

      • Ginom сказал:

        Да я проверял по несколько раз, все файлы на месте, причем качал два архива со страницы автора и от вас, результат один, может есть еще какие советы?

  19. Ginom сказал:

    Добрый день.
    Установил simple-view последнею версию, та же проблема, при вызове окна быстрого ввода оно появляется пустым без полей. Мне кажется я нашел причину но не знаю как ее исправить.. По моему причина в том, что кнопки встраиваются при активации не в то поле, то есть если бы они разместились там же где кнопки вставить изображение, видео файл и тд, то есть над редактором, то все бы работало. Думаю такое должно происходить у каждого кто делает чистую установку вордпресса и плагинов simple на последних версиях вордпресс, по крайней мере я нашел в гугле обсуждение такой же проблемы, но не решение.
    minimus может посмотрите верна ли мысль? Просто кнопки вставить изображение, те что над редактором из коробки нормально открываются.

    • minimus сказал:

      Было бы неплохо перенести обсуждение этого вопроса на форум. Там же я постарался ответить на Ваш вопрос (в общих чертах). ;)

      • Ginom сказал:

        не вижу смысла регистрироваться еще и на форуме, ибо ответ на мой вопрос (в общих чертах) не учитывает того, что я писал ранее. Все файлы я проверил, они соответствуют оригиналам. я на локальном сервере дважды инсталировал чистую сборку и каждый раз одна и таже беда.

        • minimus сказал:

          Не всё и не всегда работает на локальном сервере, особенно js на денвере. Именно поэтому локальными серваками не пользуюсь, хотя XAMPP был очень даже неплох. Проблема в том, что то, что работает на локали, может не заработать в сети и наоборот. Я поставил чистый WP 3.0 на тестовый блог – всё работает. Проверьте сколько у Вас выделено памяти … Кстати, Ваш блог грузится больше пяти минут и половина файлов не грузится вовсе …

          • Ginom сказал:

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

            • Ginom сказал:

              Нашел я причину, все до смешного просто.) Банерарезка в касперском почему то воспринимала именно окна этих плагинов как рекламные банеры, не знаю, чем они отличаются от окон других плагинов и самого вордпресса.

              • minimus сказал:

                Касперский – паникёр! ;) Впрочем … может оно так и надо :)
                Большинство окон делается как HTML, у меня PHP

  20. SnoUweR сказал:

    Поменял тему. Плагин начал странно работать :( . Спойлеры в записях теперь не открываются. И оформления у спойлеров нету. Просто тупо текст и стрелочка V. Что могло случиться?
     
    Сайт указал. Надеюсь на вашу помощь
    WP 3.0.1

    • minimus сказал:

      Попробуйте переустановить плагин – у Вас вообще ничего не грузится (из файлов плагина) – ни CSS, ни скрипты. :(

Обратные ссылки

Выскажите своё мнение

*