English

Русский

Donate

Forum

yvComment

v.1.9.0, (0.08Mb) последнее изменение: 22 октября, 2007. Что нового? , Для разработчиков  Download yvComment: local file (slow)

Краткое описание

yvComment - это расширение (компонент + плагин), позволяющее добавлять комментарии к Статьям Joomla! 1.5.

yvComment написан с нуля специально для Joomla! 1.5, и он НЕ совместим с предыдущими версиями Джумлы/Мамбы (Joomla!/Mambo). Поэтому, к нём используются наиболее развитые возможности Джумлы версии 1.5.

Замечание! Данная страница обновляется гораздо реже, чем выходят обновления yvComment-а. Наиболее полная и современная информация размещена на англоязычной странице, ориентированной на международную аудиторию.

Установка

Для установки yvComment-а, Вам НЕОБХОДИМО иметь, как минимум Joomla! 1.5 build 8688 (RC2) или более новую, рекомендуется билд 8688 или новее (см. этот совет).

Необходимо установить как "yvComment Component", так и "yvComment Plugin". Дистрибутив содержит внутри себя "файлы пакетов" как Компонента, так и Плагина.

В случае появления проблем, см. раздел Выявление неисправностей ниже.

Быстрый старт

В этом разделе, в качестве примера, приведена последовательность шагов настройки yvComment-а после того, как Вы успешно установили как yvComment Плагин, так и Компонент.

1. В интерфейсе Администратора: создайте новый раздел (например, "Comments") и запомните его ID на будущее.
2. Создайте новую Категорию (например, "Unsorted comments"), которая принадлежит разделу "Comments".
3. В меню Расширения->Менеджер плагинов->кликните плагин "yvComment" и назначьте эти Раздел и Категорию для будущих комментариев - на странице параметров Плагина (см. рисунок ниже).
   
4. Разрешите Гостям добавлять комментарии (если Вы этого хотите).
5. Измените опцию "Создать ссылку с текста 'Комментарии(n)' на другую страницу" на "Страница Статьи с комментариями", при этом в Ваших блогах вы увидите ссылку "Добавьтe Ваш комментарий"...
6. Сохраните новую конфигурацию Плагина.
7. Теперь Вы можете попробовать добавлять комментарии на сайте - Вы увидите, что эти комментарии появляются также в модуле "Latest News" ("Последние новости"). Если Вам этого не нужно, то: в интерфейсе Администратора идите в "Расширения->Менеджер модулей"->модуль "Latest News" и установите параметр "ID Раздела" равным "1" (то есть задайте фильтр для списка новостей: "1" - это ID Раздела "News"). После этого комментарии не появятся в списке "Latest News".
8. Если Вам нужен модуль "Последние комментарии", то создайте ещё один модуль типа mod_latestnews:
   В меню "Расширения->Менеджер модулей" нажмите кнопку "Новый",
   выберите модуль "Последние новости" ("Latest News") и нажмите кнопку "След." (Next).
   Далее дайте новому модулю заголовок, например, "Последние комментарии", установите параметр "ID Раздела" равным ID раздела "Comments" (см. шаг 1), укажите позицию модуля и сохраните его.

Это всё!

Ниже приведена более детальная информация о данном расширении:

Администрирование, конфигурирование и кастомизация

Все установки конфигурации данного расширения задаются в "Параметрах yvComment-плагина" (интерфейс Администратора, в меню Расширения->Менеджер плагинов->yvcomment).

По-умолчанию, yvComment использует для хранения Комментариев то же место (таблицу базы данных), в котором хранятся Статьи. Измените значение параметра "Использовать таблицу контента" на "Нет", если Вы хотите, чтобы Ваши комментарии хранились в своей собственной таблице (я этого делать НЕ советую!). Только имейте ввиду, что в этом случае Вы потеряете некоторые довольно интересные возможности (см. ниже...)

Для того, чтобы отличать Комментарии (Комментарии Статей) от самих Статей (а также, от другого контента, например, Новостей...), Вам необходимо специально создать Раздел и Категорию к которым будут относиться Комментарии, а затем указать эти Раздел и Категорию в параметрах yvComment-плагина. Указанные Раздел и Категория НЕ ДОЛЖНЫ использоваться для другого контента (например, для "обычных" Cтатей), во избежание путаницы.

По-умолчанию, yvComment использует простой файл стилей (components/com_yvcomment/default.css), который предназначен для того, чтобы стать для Вас отправной точкой для последующей кастомизации. Если Вы создали собственные стили в Вашем шаблоне, то Вы должны отключить этот файл стилей, изменив на "Нет" значение параметра "Использовать CSS файл по-умолчанию".

Комментарии можно увидеть и в интерфейсе Администратора, в меню: Компоненты->yvComment->List of Comments. Администратор может видеть, редактировать и удалять комментарии из этого вида. Данная возможность нужна, в основном, в том случае, если Вы решили НЕ "Использовать таблицу контента" для хранения комментариев.

Просмотр комментариев

Существует два способа просмотра Комментариев. Если Вы "Используете таблицу контента", то Вам доступны оба указанных ниже способа, а если - нет, то только "Способ yvComment-а" .

Обычный способ Джумлы

Если Вы "Используете таблицу контента" для хранения Комментариев, то с точки зрения самой Джумлы, Комментарии - это обычные Cтатьи (правда, относящиеся к определённому Разделу). Фактически, Вы можете рассматривать yvComment как ещё один (быстрый и простой) способ публикации статей, новостей и т.п. (как ещё одно "измерение" контента, если Вам так угодно ): yvComment позволяет Вам создавать Комментарии (потомки) Статей, а также он позволяет Вам добавлять Комментарии к Комментариям, создавая таким образом древовидную структуру статей/комментариев (потомков/предков).

Итак, Для просмотра Комментариев Вы можете использовать:

• Тот же "Менеджер материалов" в интерфейсе Администратора (Совет: Включите фильтр по Разделу для того, чтобы видеть только Комментарии).
• Функцию поиска, встроенную в Джумлу.
• Все виды  ("Типы пунктов меню"), которые применимы для Статей ("Материалов").
• А также другие раширения для Джумлы, разработанные для Статей. Например, модуль "Latest News" при установке по-умолчанию (без фильтра по Разделам/Категориям) показывает Вам заголовки Комментариев как заголовки обычных Статей. Если Вы выберите такую ссылку, то Вы увидите Комментарий в "Виде Статьи" - так же, как и любую другую статью. Правда, в этом случае сам yvComment распознаёт Комментарий и добавляет, для Вашего удобства, ссылку от Комментария к родительской Статье. Интересно!
• Вы можете использовать модуль "Последние Новости" в качестве "Последних Комментариев" - просто настройте его на показ "Статей" (на самом деле - Комментариев) из Вашего, заранее определённого, раздела "Comments" или из одной из его категорий.
  
  Совет: Если Вам нужен модуль "Последние комментарии", то создайте ещё один модуль типа mod_latestnews:
  В меню "Расширения->Менеджер модулей" нажмите кнопку "Новый",
  выберите модуль "Последние новости" ("Latest News") и нажмите кнопку "След." (Next).
  Далее дайте новому модулю заголовок "Последние комментарии", установите параметр "ID Раздела" равным ID раздела "Comments", укажите позицию модуля и сохраните его.

Способ yvComment-а

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

В настоящий момент есть два варианта "Видов" для yvКомментариев (которые Вы можете использовать, создавая "страницы", т.е. "пункты меню" Вашего сайта):

Плагин (или вид "Comment" для меню)

Комментарии к Статьям появляются под статьёй тогда, когда Вы видите полный текст Статьи (точнее, когда Статья показана в "виде Статья" (Article view). Если эта Статья является, фактически, Комментарием к другой Статье, то yvComment покажет Вам ссылку на родительскую статью ("Это - комментарий к "..."").

Страница "Список комментариев" (List of Comments)

Вы можете создать страницы (Пункты меню) для просмотра списка комментариев. Тип пункта меню: "List of Comments". Список на этой странице может быть отфильтрован по Разделу и/или Категории родительских Статей. Так образом, у Вас может быть, например, страница "Комментарии к Новостям", если Вы зададите значение параметра "Section of commented Articles" равным "News" (выбор раздела по названию, из списка).

Для каждого комментария из списка yvComment покажет Вам ссылку на родительскую Статью.

yvComment использует встроенную в Джумлу возможность разбивки списка по страницам.

Добавление, редактирование и удаление комментариев

Для добавления Комментария используется форма "Добавьте Ваш комментарий" внизу страницы со Статьёй, когда Вы видите полный текст Статьи (точнее, когда Статья показана в "виде Статья" (Article view).

yvComment позволяет Вам писать комментарий в режиме "исходного HTML текста" (указывать HTML-теги) в поле "Комментарий" - только в том случае,  если Вы соответственно установили значение параметра "Разрешить использовать HTML-теги в тексте комментариев при их добавлении/редактировании" равным "Разрешить только HTML" (или "Разрешить необработанные данные", что может быть небезопасно?).

По-умолчанию, пользователь должен войти в Систему для того, чтобы добавить комментарий. Установите значение параметра "Разрешить гостям добавлять комментарии" равным "Да" для того, чтобы разрешить Гостям (незарегистрированным посетителям сайта) добавлять комментарии. Имейте ввиду, что в этом случае Вы можете быть подвержены спаму (защита от спама в yvComment-е пока слаба в данном случае, разве что параметры "Минимальный период (в секундах) между публикацией комментариев...") .

Прямо из сайта пользователь может редактировать свои комментарии (кликая на ту же картинку: - что и для редактирования Статей). Администратор может редактировать и удалять любые комментарии (не забывайте, что Администратор может полноценно управлять комментариями через "Менеджер Материалов" в Административном интерфейсе....

Использование WYSIWYG-редакторов

Если Вы "Используете таблицу контента", для хранения комментариев, то Вы можете видеть комментарии как обычные Статьи (например, в модуле "Latest news") . В этом случае, Вы можете редактировать Комментарии также, как и Статьи - с использованием выбранного Вами WYSIWYG-редактора. yvComment покажет Вам такие отредактированные комментарии с форматированием (и с рисунками...).

Локализация

В настоящее время yvComment переведён на следующие языки: Английский, Русский и Персидский/Фарси.

Выявление неисправностей

• Если у Вас есть проблемы, то, пожалуйста, начните чтение этой страницы с самого верха - она как раз и создана для этих целей: ответить на Ваши вопросы и решить Ваши проблемы.
• Текущая версия yvComment-а требует версии Джумлы "Joomla! 1.5 build 7357 или новее" (т.е. больше номер билда). yvComment  успешно тестировался на "Joomla! 1.5 Beta 2" (build=7357). Более того, он точно НЕ работает на более старых версиях Джумлы 1.5.
  Поэтому, если у Вас есть проблемы, то начните с обновления ядра Джумлы.
• Существуют известные проблемы и с Бетой 2: например, не правильно работает разбиение на страницы, - поэтому рекомендуем переходить на версию Джумлы, новее, чем Бета 2 (билд больше, чем 7357).
  
  TIP: Точный номер билда Вашей копии Джумлы можно увидеть недалеко от верха файла CHANGELOG.php . Например, для "Joomla! 1.5 Beta 2" Вы увидите следующую строку:
  * @version $Id: CHANGELOG.php 7357 2007-05-04 19:51:39Z jinx $
  - где 7357 и есть искомый "билд (build)" ядра Джумлы.
     
• Если у Вас ещё остались проблемы, то запаситесь терпением чтения на английском языке и читайте сообщения форума: this Joomla! forum. Там уже собрано много вопросов - ответов - комментариев...
• Если и после этого проблемы остались, то, пожалуйста:
  - опишите проблемы с максимальной степенью подробности, указывая точный номер билда Джумлы (см. выше, как его определить),
  - и посылайте это описание, на английском языке, в форум, указанный выше: это наиболее вероятное место для получения ответа.

Удачи!

Обратная связь

Обратная связь приветствуется!

• Если Вы хотите обсудить yvComment с Joomla!-сообществом, то отправляйтесь в Joomla! forum. См. также раздел "Будущие планы и мысли" ниже перед тем, как отправлять Ваши пожелания.
• Если Вы хотите написать отзыв о данном расширении или прочитать отзывы других пользователей, то идите в Joomla! Extensions Directory. Помогите другим сделать правильный выбор!   
• Если Вы нашли ошибку (баг) в yvComment-е, или даже придумали исправление для него, то отправляйте их автору!

Будущие планы и мысли (ToDo)

См. Future plans and thoughts

История изменений

См. на History of changes.

Лицензия

Программа распространяется бесплатно (GPL, Freeware). Если программа Вам нравится, то поддержите её разработку.

Программа распространяется как есть, без каких-либо гарантий, явных или подразумеваемых.

(c) 2007 Юрий Волков, Москва, Россия

...