Документация / Каналы

WordPress

Подключите свой сайт на WordPress по паролю приложения и публикуйте посты как записи сайта с изображением записи.

English version · API для разработчиков

Содержание

Здесь канал — ваш собственный сайт на WordPress. Пост превращается в запись сайта: первая строка текста — заголовок, остальное — Markdown, который отправляется на сайт как HTML. Общие вещи о каналах описаны в разделе Каналы: обзор.

Что можно публиковать

  • Текст и ссылка — запись из подписи. Для ссылки адрес добавляется в конец записи после пустой строки.
  • Изображение — одно, оно загружается на сайт и становится изображением записи (миниатюрой). Берётся первое изображение поста.

Видео не поддерживается. Лимит длины текста сервис не задаёт.

Как подпись превращается в запись:

  1. Первая непустая строка — заголовок. Если она начинается с # и пробела, эти знаки отбрасываются.
  2. Всё, что ниже, — тело записи в Markdown; на сайт оно уходит в виде HTML.
  3. Если в подписи одна строка, она же становится и телом.

HTML-разметка, вписанная в текст, отбрасывается, небезопасные ссылки не создаются. Заголовок не может быть пустым.

Перед началом

Вам нужны:

  • сайт на WordPress, доступный по https (адрес по http:// не принимается) и с включённым REST API;
  • имя пользователя WordPress, от имени которого будут публиковаться записи;
  • пароль приложения. Создайте его в WordPress: откройте Users, затем Profile, раздел Application Passwords и добавьте новый пароль.

Пароль приложения хранится вместе с каналом и отправляется только на ваш сайт. Адрес сайта должен быть общедоступным: частные адреса не принимаются.

Подключение

  1. Откройте Каналы и нажмите Добавить каналы.
  2. В карточке WordPress нажмите WordPress.
  3. На странице Подключить сайт WordPress заполните:
    • Адрес сайта — адрес сайта, например example.com; приставку https:// можно не вводить;
    • Имя пользователя — имя пользователя WordPress;
    • Пароль приложения — пароль приложения.
  4. Нажмите Подключить. Сервис проверяет вход, спрашивая у сайта, кто вы.
  5. На странице Добавьте новые каналы отметьте сайт и нажмите Добавить новый.

Настройки в редакторе поста

Когда в редакторе выбран канал WordPress, под полем текста появляется блок WordPress с подсказкой о заголовке и изображении записи и настройкой Статус:

  • Опубликовать — запись публикуется сразу (значение по умолчанию);
  • Черновик — запись сохраняется на сайте как черновик.

Если что-то не работает

  • Введите адрес вашего сайта. — адрес сайта не указан.
  • Сайт должен быть доступен по https. — введён адрес по http://. Используйте https.
  • Адрес сайта указан неверно. — адрес введён неверно.
  • Введите имя пользователя и пароль приложения. — не заполнено имя пользователя или пароль приложения.
  • Сайт ответил не так, как WordPress. REST API включён? — сайт не отвечает как WordPress. Проверьте адрес и включён ли REST API.
  • Если вход не удался, сервис показывает сообщение сайта. Проверьте имя пользователя и пароль приложения, при необходимости создайте новый пароль.
  • WordPress: первая строка текста — заголовок поста, а она пуста. — напишите заголовок первой строкой.
  • У аккаунта WordPress нет действующих учётных данных. Переподключите его. — доступ потерян, например пароль приложения отозван. Нажмите Переподключить на карточке канала и введите новый пароль.
  • Сайт вернул ответ, который не удалось прочитать. — ответ сайта не удалось разобрать; проверьте сайт, прежде чем публиковать повторно.

Подробнее о переподключении и статусах каналов — в разделе Каналы: обзор.