- Совместимость с XenForo
- 1.0
- 1.1
Довольно простое дополнение, предназначенное для цитирования выбранного текста сообщения. В цитату включается только текстовая информация, без форматирования ВВ-кодом. Цитата сохраняет информацию о пользователе, который добавил оригинальное сообщение и ссылку на сам пост. Дополнение довольно простое в установке и не требует дополнительных настроек.
Установка
1) Скачайте архив с аддоном и распакуйте.
2) Скопируйте содержимое папки ./upload в корневую папку форума на Вашем хостинге форума.
3) Откройте в панели администрирования диалог импортирования дополнений: Главная -> Установить Дополнение
4) Укажите путь к файлу esthetic.quote.selected.v.1.1.0.xml, который содержится в скачанном архиве и начните установку.
5) При необходимости, установить поддержку дополнительных языков из файлов esthetic.quote.selected.v.1.1.0.language.pack.ru-RU.xml иesthetic.quote.selected.v.1.1.0.language.pack.ua-UA.xml
Важно! Не забудьте предварительно удалить предыдущую версию дополнения, если такое установлено на Вашем форуме.
Для работы дополнения с более ранними версиями форума необходимо проконтролировать наличие трех хуков в шаблонах страниц. Рассмотрим поэтапно все необходимые хуки:
1) Открываем шаблон PAGE_CONTAINER. Сразу под тегом <head> должен начинаться код первого необходимого хука page_container_head. "Закрываться" хук должен сразу над закрывающим тегом </head>.
2) Аналогично предыдущему, в том же шаблоне PAGE_CONTAINER, необходимо проконтролировать наличие следующего хука body, размещенного внутри тега <body>:
3) Последний, необходимый для работы хук, содержится в шаблоне message. Проконтролируйте в нем наличие следующих строк:
При необходимости, вставьте недостающий хук message_content вручную.
Работа
Включение и отключение дополнения производится из панели администрирования путем активации/деактивации дополнения. Когда дополнение активно, во время выделения фрагментов текста сообщений, будет появляться всплывающая панель с предложением вставить цитату.
Панель содержит 4 элемента, 3 с которых - активные. Элемент №1, "корешок", позволяет при помощи указателя мыши передвигать панель по рабочей области экрана. Элемент №2, служит для выбора типа вставки. Вставку цитаты можно производить в двух режимах: без подписи(сведения о пользователе и сообщении отсутствуют) и с подписью(вставленная цитата будет содержать дополнительную информацию о сообщении, с которого взята и авторе сообщения). Последний активный элемент №3, кнопка "вставить" - завершает работу с цитируемым текстом. После ее нажатия панель исчезнет, а цитируемый текст будет передан в окно редактора ответа. Цитировать текст можно исключительно в границах одного сообщения. Нельзя добавлять цитаты, выделив сразу несколько сообщений. Пассивный элемент №4, "просмотр", служит для контроля текста цитаты и типа вставки. Чтобы убрать панель, достаточно просто снять выделение текста, кликнув по тексту сообщения.
Совместимость и устранение конфликтов
С целью упрощения устранения конфликтов, запуск JavaScript кодов дополнения вынесено в отдельный файл: QuoteSelectedDriver.js. Для запуска обработчиков событий приложение использует стандартный обработчик библиотеки jQuery $(document).ready(). Возникновение конфликтов возможно, если у Вас установлены другие дополнения, которые используют тот же обработчик $(document).ready(). В таком случае необходимо сделать следующее:
1) Найти JavaScript другого дополнения, который использует тот же обработчик $(document).ready() в своем коде.
2) Добавить в найденном скрипте внутри обработчика еще одну строку:
3) После сохранения открыть файл QuoteSelectedDriver.js и закомментировать в нем весь код(файл не удалять!):
Такой способ позволит избежать дублирования регистрации обработчика события document ready.
Настройки стиля
Для персональных настроек стиля панели цитирования в архив дополнения включен psd файл панели. Чтобы изменить цвет панели достаточно изменить цвет наложения цвета в эффектах слоев. Более сложные правки могут требовать изменений геометрии панели(корешка, кнопки вставки), что невозможно без правки кода JavaScript.
Установка
1) Скачайте архив с аддоном и распакуйте.
2) Скопируйте содержимое папки ./upload в корневую папку форума на Вашем хостинге форума.
3) Откройте в панели администрирования диалог импортирования дополнений: Главная -> Установить Дополнение
4) Укажите путь к файлу esthetic.quote.selected.v.1.1.0.xml, который содержится в скачанном архиве и начните установку.
5) При необходимости, установить поддержку дополнительных языков из файлов esthetic.quote.selected.v.1.1.0.language.pack.ru-RU.xml иesthetic.quote.selected.v.1.1.0.language.pack.ua-UA.xml
Важно! Не забудьте предварительно удалить предыдущую версию дополнения, если такое установлено на Вашем форуме.
Для работы дополнения с более ранними версиями форума необходимо проконтролировать наличие трех хуков в шаблонах страниц. Рассмотрим поэтапно все необходимые хуки:
1) Открываем шаблон PAGE_CONTAINER. Сразу под тегом <head> должен начинаться код первого необходимого хука page_container_head. "Закрываться" хук должен сразу над закрывающим тегом </head>.
HTML:
<head>
<xen:hook name="page_container_head">
...
</xen:hook>
</head>
HTML:
<body>
<xen:hook name="body">
...
</xen:hook>
</body>
HTML:
<xen:hook name="message_content" params="{xen:array 'message={$message}'}">
<div class="messageContent">
<article>
<blockquote class="messageText ugc baseHtml">
<xen:include template="ad_message_body" />
{xen:raw $message.messageHtml}
</blockquote>
</article>
{xen:raw $messageContentAfterTemplate}
</div>
</xen:hook>Работа
Включение и отключение дополнения производится из панели администрирования путем активации/деактивации дополнения. Когда дополнение активно, во время выделения фрагментов текста сообщений, будет появляться всплывающая панель с предложением вставить цитату.
Панель содержит 4 элемента, 3 с которых - активные. Элемент №1, "корешок", позволяет при помощи указателя мыши передвигать панель по рабочей области экрана. Элемент №2, служит для выбора типа вставки. Вставку цитаты можно производить в двух режимах: без подписи(сведения о пользователе и сообщении отсутствуют) и с подписью(вставленная цитата будет содержать дополнительную информацию о сообщении, с которого взята и авторе сообщения). Последний активный элемент №3, кнопка "вставить" - завершает работу с цитируемым текстом. После ее нажатия панель исчезнет, а цитируемый текст будет передан в окно редактора ответа. Цитировать текст можно исключительно в границах одного сообщения. Нельзя добавлять цитаты, выделив сразу несколько сообщений. Пассивный элемент №4, "просмотр", служит для контроля текста цитаты и типа вставки. Чтобы убрать панель, достаточно просто снять выделение текста, кликнув по тексту сообщения.
Совместимость и устранение конфликтов
С целью упрощения устранения конфликтов, запуск JavaScript кодов дополнения вынесено в отдельный файл: QuoteSelectedDriver.js. Для запуска обработчиков событий приложение использует стандартный обработчик библиотеки jQuery $(document).ready(). Возникновение конфликтов возможно, если у Вас установлены другие дополнения, которые используют тот же обработчик $(document).ready(). В таком случае необходимо сделать следующее:
1) Найти JavaScript другого дополнения, который использует тот же обработчик $(document).ready() в своем коде.
2) Добавить в найденном скрипте внутри обработчика еще одну строку:
Код:
$(document).ready(function () { // <-- Найти этот обработчик события
window.eqsRun(); // <-- Добавить эту строку
...
Код:
/*
$(document).ready(function () {
window.eqsRun();
});
*/Настройки стиля
Для персональных настроек стиля панели цитирования в архив дополнения включен psd файл панели. Чтобы изменить цвет панели достаточно изменить цвет наложения цвета в эффектах слоев. Более сложные правки могут требовать изменений геометрии панели(корешка, кнопки вставки), что невозможно без правки кода JavaScript.
![[OzzModz] Wiki Threads](/data/resource_icons/9/9852.jpg?1638007429){kind=icon}
