Комментарии Cusdis

Плагин комментариев Cusdis

Для пользователей, которые не ищут сложные экосистемы комментариев, Cusdis - идеальное решение для комментариев. Легкий, простой в использовании и с открытым исходным кодом, это отличный вариант для пользователей, которым не требуются сложные функции и большие размеры загрузки других популярных систем комментариев. Он также может быть размещен самостоятельно; отличный вариант, если вы запускаете несколько сайтов и хотели бы сохранить полный контроль над данными ваших комментаторов.

Плагин комментариев Cusdis позволяет вам интегрировать Cusdis на ваш сайт Publii, позволяя пользователям добавлять комментарии к вашим публикациям.

Добавление поддержки плагина комментариев в вашу тему (для старых или пользовательских тем)

Если вы используете более раннюю версию Publii themes или свою собственную пользовательскую тему, то, прежде чем вы сможете использовать плагины для комментариев, доступные на нашем маркетплейсе, вам нужно будет внести небольшие изменения в файл post.hbs вашей темы, чтобы комментарии могли работать правильно. Для этого выполните следующие действия:

Откройте предпочитаемое вами приложение file Explorer и перейдите в папку Documents/Publii /sites/YOUR_SITE/input/themes/YOUR_THEME.
где 'YOUR_SITE' - это название вашего сайта, а 'YOUR_THEME' - это папка для темы, которую вы в данный момент используете на сайте.
Используя редактор кода по вашему выбору, откройте файл post.hbs (его можно открыть в базовых приложениях, таких как notepad, если у вас не установлен какой-либо специальный редактор кода).

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

{{#if @config.post.displayComments}} 
    <div class="post__comments"> 
       <div class="wrapper"> 
          <h2 class="h5">{{ translate 'post.comments' }}</h2> 
       {{> disqus}} 
       </div> 
    </div> 
{{/if}}

И измените его на:

{{#if @config.post.displayComments}}
    <div class="post__comments"> 
       <div class="wrapper"> 
          {{{@commentsCustomCode}}}
       </div> 
    </div> 
{{/if}}

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

Активация плагина

Плагин можно включить, нажав кнопку переключения в поле Комментарии Cusdis раздела Инструменты и плагины приложения Publii. Если переключатель изменится с серого на синий. значит, плагин включен. Вам нужно будет добавить свой идентификатор приложения из вашей учетной записи Cusdis в настройки плагина, прежде чем плагин сможет работать правильно; для этого откройте экран "Параметры плагина", нажав на поле комментариев Cusdis в любом месте, кроме кнопки переключения; это откроет параметры плагина. Требуется только идентификатор приложения, но вы можете найти более подробную информацию о доступных параметрах в этом разделе позже в этом руководстве.

Как найти свой идентификатор приложения Cusdis

Единственная информация, которую необходимо добавить в параметры плагина Cusdis, - это идентификатор приложения; без него плагин комментариев не сможет функционировать. К счастью, создать учетную запись в Cusdis очень просто. Чтобы создать идентификатор приложения, выполните следующие действия:

Перейдите на веб-сайт Cusdis и нажмите на кнопку Начать бесплатно, чтобы открыть экран входа в систему.
Вам нужно будет войти в систему, используя свою учетную запись Google или GitHub. Нажмите на кнопку Войти с помощью ..., чтобы выбрать предпочитаемый вариант, и следуйте инструкциям для входа в систему.
Теперь Cusdis запросит у вас веб-сайт; это имя используется только для определения комментариев сайта, которые вы проверяете, находясь на панели управления Cusdis, поэтому не стесняйтесь вводить любое имя, которое вам нравится.
Теперь вы попадете на панель управления Cusdis, где вы можете просматривать комментарии, добавленные на ваш сайт, и управлять ими. Чтобы узнать свой идентификатор приложения, нажмите на кнопку Вставить код в верхней части экрана, чтобы открыть всплывающее окно.
Нам не нужен здесь весь код; вместо этого нам нужно проверить третью строку, которая начинается с data-app-id. Это будет выглядеть примерно так:
```
data-app-id="a2d11511-7012-4254-9483-cb49c8f4dfe8"
```
Скопируйте строку цифр, тире и букв между кавычками; это будет ваш идентификатор приложения.
Скопируйте свой идентификатор приложения в настройки плагина в Publii и сохраните изменения. Плагин комментариев теперь настроен.

Включение комментариев

Для того, чтобы Cusdis отображал комментарии к вашим публикациям, ему также необходимо место, куда можно добавить поле для комментариев. Темы Publii включают раздел для комментариев, но по умолчанию он отключен, чтобы предотвратить возникновение визуальных ошибок при отключении плагинов без комментариев. Вам нужно будет изменить опцию Комментарии в настройках вашей темы; после включения Publii создаст область комментариев на странице, где плагин может отображаться. Чтобы использовать комментарии на своем сайте, сначала перейдите в раздел "Тема" приложения, щелкнув соответствующую опцию в меню левой боковой панели, затем перейдите в раздел "Пользовательские настройки → Параметры публикации" в настройках темы и включите опцию "Отображать комментарии"................."

Кроме того, вы можете включить комментарии на отдельные должности в каждом конкретном случае при создании новой записи или редактировании поста, нажав на Настройки значок в правом верхнем углу области редактирования (значок "шестеренка"), чтобы открыть настройки, нажав на другие варианты, опции, чтобы увидеть полный подбор вариантов. В нижней части этого раздела будет опция Отображать комментарии, которую вы можете включить / отключить специально для этого поста.

Параметры комментариев Cusdis

Этот плагин предлагает несколько простых опций для настройки внешнего вида вашего раздела комментариев. Доступные опции:

Конфигурация комментариев

ИДЕНТИФИКАТОР приложения - Введите идентификатор приложения, предоставленный Cusdis в этом разделе. Это поле необходимо заполнить, прежде чем плагин комментариев сможет работать.
Узел данных - этот параметр определяет узел, на который Cusdis должен отправлять и получать данные комментариев. По умолчанию для этого параметра установлено значение https://cusdis.com; это следует изменять, только если вы используете автономный экземпляр Cusdis.
Цветовая схема - задает цветовую схему раздела комментариев; выбирайте между светлым режимом и Темным режимом. В качестве альтернативы, установка для него значения Auto позволит разделу комментариев переключать режимы в соответствии с настройками браузера пользователя.

Интеграция с темой

Заголовок заголовка - текст, введенный в это поле, будет использоваться в качестве заголовка поля для комментариев на вашем сайте.
Уровень заголовка - Устанавливает размер / стиль заголовка, который следует использовать для заголовка заголовка.
Запасное сообщение - текст, введенный в это поле, будет отображаться, если поле комментариев не может загрузиться из-за отключения пользователем скриптов или использования браузера, в котором нет поддержки скриптов. По умолчанию рекомендуется включить JavaScript для отображения комментариев.
Оболочка комментариев - Устанавливает пользовательский CSS-класс для оболочки комментариев; то есть внешней области, окружающей раздел комментариев. Оставьте это значение по умолчанию, чтобы использовать стандартный набор стилей в коде темы.
Внутренняя оболочка комментариев - устанавливает пользовательский CSS-класс для внутренней оболочки комментариев; внутренняя область раздела комментариев. Оставьте по умолчанию, чтобы использовать встроенный стиль комментариев темы.
Заголовок комментариев - Устанавливает пользовательский класс CSS для заголовка комментариев; для дополнительных параметров оформления поверх или альтернативно стилю по умолчанию, который применяется к соответствующему тексту H2-H6. Оставьте по умолчанию, чтобы использовать стандартный стиль темы.
Например, для семантических целей вы хотите оставить заголовок H2, но уменьшить размер шрифта, поэтому вы можете использовать один из доступных классов в наших темах: h1 h2 h3 h4 h5 h6
Чтобы изменить выравнивание текста, используйте следующие классы: align-left align-right align-center

Дополнительные параметры

Отложенная загрузка - включение этой опции позволяет разделу комментариев использовать отложенную загрузку. Он использует моменты, когда браузер простаивает, для предварительной загрузки раздела комментариев, когда пользователь прокручивает страницу вниз, чтобы уменьшить задержку перед отображением комментариев.
Интеграция с банерами cookie - Включение этой опции добавит встроенному баннеру файлов cookie Publii возможность давать согласие пользователям на использование файлов cookie из Cusdis.
Идентификатор группы файлов cookie - Эта опция становится доступной только тогда, когда включена опция интеграции баннеров с файлами cookie. Здесь вы можете указать группу файлов cookie, в которую должны быть добавлены файлы cookie Cusdis, например "комментарии". Обязательно добавьте (если оно не существует) название группы в раздел GDPR настроек сайта. Инструкции о том, как это сделать, можно найти в разделе GDPR этой документации.