Наличие комментариев в собственном блоге — одна из самых привлекательных функций. Узнайте, как интегрировать комментарии Isso, чтобы в вашем блоге появилась функция комментариев, ориентированная на конфиденциальность.

Наличие комментариев в вашем блоге — одна из самых привлекательных функций! К сожалению, Ghost Blogging Service не поддерживает любые комментарии из коробки. Хотя существует множество различных сервисов, таких как Disqus или Discourse, которые являются своего рода бесплатными (они имеют встроенную рекламу в бесплатной версии. А реклама — это ЗЛО), также существуют некоторые действительно бесплатные сервисы, такие как Комментарий, Шнак, CoralProject Talk и Иссо.

Я протестировал все бесплатные сервисы для своего блога и пришел к выводу, что Isso — лучший сервис для использования в Ghost Blog. В этой статье я расскажу, почему Isso является лучшим программным обеспечением, как его можно установить в среде Docker и как комментарии Isso можно интегрировать в любой блог (не только в программное обеспечение Ghost Blogging).

Почему Иссо?

Isso — это сервер комментариев, написанный на Python и JavaScript, который призван заменить Disqus или Discourse.

Он имеет несколько особенностей:

  • Это очень легкая система комментариев
  • Работает с Docker Compose
  • Использует SQLite, потому что комментарии — это не большие данные!
  • Очень минимальная система комментариев с простой системой модерации
  • Система комментариев с приоритетом конфиденциальности
  • Поддерживает уценку
  • Это бесплатно
  • Подобно нативным комментариям WordPress
  • Вы можете импортировать WordPress или Disqus
  • Вставьте его везде в один файл JS; 65 КБ (20 КБ в сжатом виде)

Все эти функции являются вескими причинами для выбора Isso в качестве вашей серверной системы комментариев, а не какой-либо другой. Если вы хотите установить его в среде Docker (или Docker Swarm), вы можете следовать моему личному руководству.

Установите комментарии Isso с помощью Docker

Предпосылка

  • Docker (опционально Docker Swarm): чтобы полностью следовать этому руководству по установке Isso для своего блога, вам потребуется работающая среда Docker. В конце я также предоставлю файл Docker Swarm.
  • Traefik: Traefik — это балансировщик нагрузки, который перенаправляет мой запрос в контейнер Docker. Вам нужно установить его, чтобы получить доступ к комментариям с помощью URL-адреса. Если у вас нет запущенного Traefik, вы узнаете в этом руководстве, как его настроить.

Если вы не хотите использовать Docker и Traefik, следуйте официальному руководству по установке на веб-сайте Isso.

Настройка файла Docker Compose

Если вы все подготовили, вы начинаете установку Isso. Во-первых, вам нужно скачать последнюю версию Isso со страницы GitHub: https://github.com/posativ/isso/. Вы можете либо скачать zip-файл, содержащий главную ветку, и извлечь его, либо клонировать:

git clone [email protected]:posativ/isso.git

Затем перейдите в папку isso, удалите файл docker-compose.yml, создайте новый файл docker-compose.yml и вставьте в него следующий фрагмент кода:

В строках 5–8 в этом файле Compose видно, что образ Isso будет создан из файла Dockerfile, который вы скачали из официального репозитория GitHub, и будет называться isso.

В строках 12–13 (и 34–35) я определил том, в котором все комментарии будут сохранены в базе данных SQLite.

Раздел ярлыков в строках 16–27 содержит важную информацию для Traefik. Замените YOUR_DOMAIN доменом, в котором должен быть доступен сервер Isso. Это важно для модерации комментариев.

В строках 28–33 я также добавил проверку работоспособности, которая будет проверять каждые 5 секунд, правильно ли работает серверная часть Isso. Чтобы узнать больше о проверках работоспособности Docker, вы должны прочитать это руководство:



Как успешно реализовать проверку работоспособности в Docker Compose
Важно знать, правильно ли работает служба Docker. Не работающая служба может привести к серьезному инциденту…www.paulsblog.dev



Конфигурация Isso Backend

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

В следующем файле показаны наиболее важные настройки, которые вам НЕОБХОДИМО обновить, чтобы иметь рабочий сервер Isso. Я объясню их позже.

[general]: укажите путь к базе данных, URL-адрес вашего блога и то, что вы хотите получать электронные письма при отправке новых комментариев.

[admin]: включите администрирование и установите пароль администратора. Это необходимо для входа в интерфейс администратора.

[модерация]: включить модерацию новых комментариев. Если установлено значение false, каждый комментарий будет отображаться мгновенно. Не рекомендуется!

[сервер]: задайте общедоступную конечную точку для серверной части Isso. Должно быть равно значению в файле Compose.

[smtp]: задайте настройки сервера электронной почты и данные учетной записи электронной почты.

Запустить бэкенд Иссо

После настройки файла Compose и isso.cfg в соответствии с вашими потребностями вы можете запустить серверную часть Isso, выполнив:

docker-compose up -d --build

Через несколько секунд ваш сервер Isso должен быть запущен в указанном домене. Вы можете проверить это, перейдя по ссылке https://your-chosen-domain.com/info.

Интегрируйте Isso в Ghost CMS (или любой аналогичный блог)

Отредактируйте фрагмент исходного кода

Теперь, когда вы установили серверную часть Isso, вы можете интегрировать комментарии в свой блог. Для этого все, что вам нужно сделать, это вставить следующий фрагмент в исходный код. Позже я объясню, как это делается в программе Ghost Blogging.

Прежде всего замените isso.knulst.de на домен, который вы использовали с вашим сервером Isso. Кроме того, вы должны внимательно прочитать фрагмент исходного кода, потому что есть две важные настройки:

  1. URL-адрес в data-isso начинается с двух /.
  2. URL-адрес в src также начинается с двух /.

Если вы измените URL-адреса в соответствии со своими потребностями, оставьте два / перед внутренним URL-адресом Isso. Это необходимо, потому что серверная часть Isso развернута на другом хосте, чем блог.

Добавьте фрагмент на свою страницу

Теперь с измененным фрагментом исходного кода вы можете добавлять комментарии в свой блог. Если вы используете платформу Ghost Blogging, вам следует сначала загрузить дизайн, который вы используете в своем экземпляре, и извлечь его в папку.

Найдите файл post.hbs и проверьте, где заканчивается статья. Лучшее место для комментариев — под списком тегов, который часто отображается в конце статьи. После того, как вы нашли закрывающий </div>, вставьте фрагмент перед этим </div>.

Заархивируйте свою тему, повторно загрузите ее в программное обеспечение для ведения блога Ghost и активируйте в интерфейсе дизайна.

Если вы используете другое программное обеспечение для ведения блога, вы также должны иметь возможность редактировать файл post html/php/js и добавлять фрагмент кода в то место, где вы хотите видеть комментарии.

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

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

После получения крутых комментариев они будут отображаться под вашим постом. Поскольку активировал функцию Gravatar и установил тип robohash, у меня есть крутые картинки роботов для каждого пользователя, который создает комментарий:

Развертывание в Docker Swarm

Чтобы развернуть Isso в вашем Docker Swarm, вы можете использовать мой файл Isso Docker Compose, который имеет те же настройки, что и обычный файл Compose. Но это будет работать только в том случае, если вы настроите свой Docker Swarm, как я описываю в этом руководстве:



Коротко о Docker Swarm
В этом простом руководстве показано, как можно создать работающий кластер docker swarm примерно за 15 минут. В этом простом руководстве показано…www.paulsblog.dev



Кроме того, вам нужен балансировщик нагрузки Traefik в вашем Docker Swarm, который будет использоваться файлом Compose. В этом руководстве я объяснил, как улучшить Docker Swarm с помощью Traefik:



4 важных сервиса, которые каждый должен развернуть в Docker Swarm
Расширьте свой Docker Swarm четырьмя важными сервисами, которые вам понравятся: Traefik, Portainer, Registry, FTP В моем последнем…www.paulsblog.dev



Заключительные примечания

В то время как многие авторы утверждают, что вам не нужна система комментариев, интегрированная в ваш блог, я полностью отрицаю этот аргумент! Лично я считаю, что комментарии — отличный способ взаимодействовать с вашими пользователями, отвечать на вопросы и создавать свое сообщество. Кроме того, если пользователи комментируют ваши статьи, вы можете использовать это взаимодействие для улучшения своего контента.

Вы можете увидеть мою реализацию комментариев Isso в моем блоге: https://www.paulsblog.dev. Не стесняйтесь использовать раздел комментариев к любой из моих статей. Буду премного благодарен!

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

Свяжитесь со мной в LinkedIn, Twitter и GitHub.

Эта статья изначально была опубликована в моем блоге по адресу https://www.paulsblog.dev/how-to-add-comments-to-your-blog/

Повышение уровня кодирования

Спасибо, что являетесь частью нашего сообщества! Больше контента в публикации Level Up Coding.
Подписывайтесь: Twitter, LinkedIn, Информационный бюллетень
Level Up меняет рекрутинг в сфере технологий ➡️ Присоединяйтесь к нашему коллективу талантов