Благодаря уникальной системе голосования, обмена и управления потоками, GraphComment является мощным инструментом для предоставления комментариев вашим пользователям с альтернативной философией дизайна, что делает его отличным для создания сообществ.

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

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

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

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

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

   {{#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}}
   

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

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

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

Как получить идентификатор GraphComment

Для корректной работы плагина комментариев GraphComment требуется идентификатор GraphComment. Идентификатор можно задать при создании учетной записи на веб-сайте GraphComment. Чтобы получить его, выполните следующие действия:

1. Перейдите на GraphComment и нажмите на кнопку Зарегистрироваться в верхней части экрана.
2. Вам будет предложено зарегистрироваться на GraphComment, используя свою учетную запись Google, Facebook или Twitter; щелкните ту, которую вы хотите использовать для входа. В качестве альтернативы есть возможность зарегистрироваться по электронной почте; нажмите на текст электронного письма внизу поля регистрации, чтобы начать этот процесс.
3. После регистрации вам нужно будет создать веб-сайт. Важным параметром здесь является идентификатор сайта; здесь вы можете ввести текст для вашего идентификатора GraphComment, который затем вы можете ввести в Publii.
4. Если вы уже создали свой сайт в GraphComment и вам нужно получить идентификатор GraphComment, вы можете сделать это, открыв панель управления GraphComment и нажав на название вашего веб-сайта на левой боковой панели. Затем перейдите на вкладку "Настройка" в верхней части экрана. Вы попадете на страницу Настройки, которая содержит информацию о том, как добавить GraphComment на ваш сайт.
5. По умолчанию слева должна быть выбрана опция Универсальный код; если нет, нажмите на нее сейчас. Вы увидите окно, содержащее код для встраивания; из этого нам нужно только значение из переменной graphcommentId . Это должно выглядеть примерно так:

   graphcommentId: "SITE_NAME-"

   Скопируйте текст, заключенный в кавычки; это ваш идентификатор GraphComment.
6. Откройте Publii, введите идентификатор сайта в настройках плагина и сохраните изменения. Теперь плагин готов к работе!

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

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

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

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

С помощью опций плагина GraphComment вы можете изменить стиль и другие визуальные элементы раздела комментариев на вашем сайте. Доступные опции:

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

• Идентификатор GraphComment - Введите здесь идентификатор сайта, который вы установили при создании веб-сайта в GraphComment. Идентификатор необходимо ввести, прежде чем плагин сможет работать.

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

• Заголовок заголовка - текст, введенный в это поле, будет использоваться в качестве заголовка поля для комментариев на вашем сайте.
• Уровень заголовка - Устанавливает размер / стиль заголовка, который следует использовать для заголовка заголовка.
• Запасное сообщение - Текст, введенный в это поле, будет отображаться, если поле для комментариев не сможет загрузиться из-за того, что пользователь отключил скрипты или использует браузер, в котором нет поддержки скриптов. По умолчанию рекомендуется включить JavaScript для отображения комментариев.
• Оболочка комментариев - Устанавливает пользовательский CSS-класс для оболочки комментариев; то есть внешней области, окружающей раздел комментариев. Оставьте это значение по умолчанию, чтобы использовать стандартный набор стилей в коде темы.
• Внутренняя оболочка комментариев - Устанавливает пользовательский CSS-класс для внутренней оболочки комментариев; внутренняя область раздела комментариев. Оставьте по умолчанию, чтобы использовать встроенный стиль комментариев темы.
• Заголовок комментариев - Устанавливает пользовательский класс CSS для заголовка комментариев; для дополнительных параметров оформления поверх или альтернативно стилю по умолчанию, который применяется к соответствующему тексту H2-H6. Оставьте по умолчанию использование стандартного оформления темы.

  Например, для семантических целей вы хотите оставить заголовок H2, но уменьшить размер его шрифта, поэтому вы можете использовать один из доступных классов в наших темах: h1 h2 h3 h4 h5 h6  

  Чтобы изменить выравнивание текста, используйте следующие классы: align-left align-right align-center

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

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