[FAQ] Добавление собственных BBCodes в phpBB3

SLITE

Прежде чем приступим к созданию свои тегов, ознакомися что же такое вообще bbCode.

bbCode — язык разметки, используемый для форматирования сообщений на многих электронных досках объявлений (BBS) и форумах. Для форматирования текста используются теги, подобные тегам HTML, но, в отличие от них, заключённые в квадратные скобки. Перед отображением страницы движок форума производит разбор текста и преобразование его в HTML- или XHTML-код.
© Wikipedia

phpBB3 Olympus содержит возможность, с помощью которой вы можете добавлять собственные BBCodes из интерфейса панели администрирования.
phpBB по умолчанию содержит в себе некоторые из самых часто используемых BBCodes, но бывают ситуации, когда необходимо добавить собственные BBCodes, и сейчас мы рассмотрим как создавать свои теги.

Для начала зайдите в панель администрирования, а в ней в раздел «Сообщения».
В этом разделе слева нажмите ссылку «BBCodes». Для добавления нового BBCode нажмите кнопку «Добавить BBCode».
Теперь вы увидите три области для ввода текста и один переключатель.
Область «Использование BBCode» служит для ввода BBCode, то есть, похожа на то, что будут вводить пользователи. Область «Замена HTML» служит для ввода кода замены HTML.
Область «Текст подсказки» служит для ввода краткой подсказки по использованию нового BBCode.
Обычно подсказки отображаются при проведении указателя мыши над кнопкой BBCode на странице размещения сообщения. И, наконец, переключатель «Показывать на странице ответа» позволяет отображать или скрыть кнопку с BBCode со страницы размещения сообщения.
Скрытие кнопки не отключает BBCode — пользователи могут вручную вводить BBCode.

Теперь давайте пробежимся по области «Использование BBCode». Здесь вы вводите BBCode. Это очень просто: всё, что необходимо сделать — это добавить BBCode и лексемы. Лексемы — это специальные слова в верхнем регистре, окружённые фигурными скобками { … }. Лексемы являются метками-заполнителями для вводимого пользователем содержимого. Необходимо правильно указать размещение лексем и ввести дополнительные параметры и аргументы при необходимости. Давайте создадим очень простой BBCode [red], выделяющий текст красным цветом.

Введите следующее:

Код: Выделить всё

[red]{TEXT}[/red]

Вы можете использовать следующие лексемы:

{TEXT} — любой текст, соответствующий чему-либо
{NUMBER} — любая последовательность цифр
{EMAIL} — правильный адрес электронной почты
{URL} — правильный адрес URL
{LOCAL_URL} — локальный адрес URL
{COLOR} — Цвет HTML. Цвет может быть задан в числовом формате #FF1234 или ключевым словом цвета CSS

Область «Замена HTML»

В эту область вводится код HTML, заменяющий BBCode. Не забывайте добавлять сюда лексемы, используемые вами в области «Использование BBCode». Продолжая наш пример с красным текстом, в это поле необходимо ввести следующую замену HTML:
Код: Выделить всё
```
<span style="color: red;">{TEXT}</span>
```

Область «Текст подсказки»

Здесь всё просто — введите короткую подсказку, которая будут появляться при проведении мыши над кнопкой с новым BBCode.

Опция «Показывать на странице ответа»

При снятии флажка, кнопка с этим BBCode не будет отображаться на странице размещения сообщений. Снятие флажка не отключает BBCode, а просто скрывает кнопку. Пользователи всегда могут вручную написать BBCode.

Другие параметры BBCode

Для изменение параметров BBCode щёлкните по кнопке редактирования на странице BBCodes. Для удаление ненужного BBCode щёлкните по кнопке удаления. При этом обратите внимание на то, что при удалении BBCode текст и фактический BBCode останутся в сообщениях, но замена HTML также будет удалена. Другими словами, при удалении BBCode ваш красный текст больше не будет красным, и просто будет отображён как [red]ваш бывший красный текст[/red].

Часто запрашиваемые BBCodes

Просто копируйте и вставляйте эти BBCodes в администраторской панели управления.
Видео Google
Использование BBCode:
Код: Выделить всё
```
[googlevideo]{NUMBER}[/googlevideo]
```
Замена HTML:
Код: Выделить всё
```
<object type="application/x-shockwave-flash" data="http://video.google.com/googleplayer.swf?docId=-{NUMBER}" width="400" height="326">
<param name="movie" value="http://video.google.com/googleplayer.swf?docId=-{NUMBER}" />
<param name="allowScriptAcess" value="sameDomain" />
<param name="quality" value="best" />
<param name="bgcolor" value="#FFFFFF" />
<param name="scale" value="noScale" />
<param name="salign" value="TL" />
<param name="FlashVars" value="playerMode=embedded" />
</object>
```
Пример использования:
Код: Выделить всё
```
[googlevideo]ID видео[/googlevideo]
```
Рекомендуемый текст подсказки:
Введите ID видео. ID видео — это 18-значный номер после docid=- в адресе URL
Свернуть
BBCode видео YouTube
Использование BBCode:
Код: Выделить всё
```
[youtube]{TEXT}[/youtube]
```
Замена HTML:
Код: Выделить всё
```
<object type="application/x-shockwave-flash" data="http://www.youtube.com/v/{TEXT}" width="425" height="350">
<param name="movie" value="http://www.youtube.com/v/{TEXT}" />
<param name="wmode" value="transparent" />
</object>
```
Пример использования:
Код: Выделить всё
```
[youtube]Строка ID видео YouTube[/youtube]
```
или
Код: Выделить всё
```
[youtube]uBbmiQhuAhU[/youtube]
```
Рекомендуемый текст подсказки:
Введите строку ID видео. Строка ID видео — это часть после v= в адресе URL
Свернуть
Выравнивание по центру
Использование BBCode:
Код: Выделить всё
```
[center]{TEXT}[/center]
```
Замена HTML:
Код: Выделить всё
```
<div style="text-align: center;">{TEXT}</div>
```
Пример использования:
Код: Выделить всё
```
[center]Тест, выровненный по центру[/center]
```
Свернуть
Выравнивание по ширине
Использование BBCode:
Код: Выделить всё
```
[justify]{TEXT}[/justify]
```
Замена HTML:
Код: Выделить всё
```
<div style="text-align: justify;">{TEXT}</div>
```
Пример использования:
Код: Выделить всё
```
[justify]Тест, выровненный по ширине[/justify]
```
Свернуть
Выравнивание по левому краю
Использование BBCode:
Код: Выделить всё
```
[left]{TEXT}[/left]
```
Замена HTML:
Код: Выделить всё
```
<div style="text-align: left;">{TEXT}</div>
```
Пример использования:
Код: Выделить всё
```
[left]Тест, выровненный по левому краю[/left]
```
Свернуть
Выравнивание по правому краю
Использование BBCode:
Код: Выделить всё
```
[right]{TEXT}[/right]
```
Замена HTML:
Код: Выделить всё
```
<div style="text-align: right;">{TEXT}</div>
```
Пример использования:
Код: Выделить всё
```
[right]Тест, выровненный по правому краю[/right]
```
Свернуть
Цветной фон
Использование BBCode:
Код: Выделить всё
```
[background={COLOR}]{TEXT}[/background]
```
Замена HTML:
Код: Выделить всё
```
<span style="background-color: {COLOR};">{TEXT}</span>
```
Пример использования:
Код: Выделить всё
```
[background=yellow]Текст на жёлтом фоне[/background]
```
Свернуть
Шрифты
Использование BBCode:
Код: Выделить всё
```
[font={TEXT1}]{TEXT2}[/font]
```
Замена HTML:
Код: Выделить всё
```
<span style="font-family: {TEXT1};">{TEXT2}</span>
```
Пример использования:
Код: Выделить всё
```
[font=Georgia]Шрифт Georgia[/font]
```
Свернуть
Зачёркнутый текст
Использование BBCode:
Код: Выделить всё
```
[s]{TEXT}[/s]
```
Замена HTML:
Код: Выделить всё
```
<span style="text-decoration: line-through;">{TEXT}</span>
```
Пример использования:
~~Зачёркнутый текст~~
Свернуть
Мерцающий текст
Примечание: не работает в Microsoft Internet Explorer и в некоторых других браузерах.

Использование BBCode:
Код: Выделить всё
```
[blink]{TEXT}[/blink]
```
Замена HTML:
Код: Выделить всё
```
<span style="text-decoration: blink;">{TEXT}</span>
```
Пример использования:
Код: Выделить всё
```
[blink]Мерцающий текс[/blink]
```
Свернуть
Подстрочный текст
Примечание: полезен для химических уравнений.

Использование BBCode:
Код: Выделить всё
```
[sub]{TEXT}[/sub]
```
Замена HTML:
Код: Выделить всё
```
<span style="vertical-align: sub;">{TEXT}</span> 
```
Пример использования:
Код: Выделить всё
```
H[sub]2[/sub]O
```
Свернуть
Надстрочный текст
Примечание: полезен для математических уравнений.

Использование BBCode:
Код: Выделить всё
```
[sup]{TEXT}[/sup]
```
Замена HTML:
Код: Выделить всё
```
<span style="vertical-align: super;">{TEXT}</span> 
```
Пример использования:
Код: Выделить всё
```
x[sup]3[/sup]
```
Свернуть
Горизонтальная линия
Примечание: необязательно вписывать текст между тегами.

Использование BBCode:
Код: Выделить всё
```
[hr][/hr]
```
Замена HTML:
Код: Выделить всё
```
<hr />
```
Пример использования:
Код: Выделить всё
```
[hr][/hr]
```
Свернуть

Источник: teosofia.ru/knowledge-base/adding-custom-bbcodes-in-phpbb3.html