Wordpress плагин для импорта записей со стен сообществ и комментариев к ним из социальной сети ВКонтакте

Техническая информация

— Wordpress версии не мение 4.4.0
Приобрести VK to WP 0.3 Beta

Схема поста

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

  • {image} – Изображения записи.
  • {text} – Текст записи.
  • {video} – iframe код видеоплеера.
  • {doc} – Ссылки на документы.
  • {link} – Внешние ссылки прикреплённые к записи.
* Если какие-то данные игнорируются в настройках, в пост они не попадают, даже если указаны в схеме.

Типы вложений

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

#Хэш теги

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

Автор поста

Опция позволяет установить автора создаваемых постов из импортируемых записей.

Пост готов к публикации

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

Формирование заголовка

Опция состоит из наборов правил формирования заголовка поста из импортируемой записи, это необходимо, так как записи не содержат заголовка…

  • {br} - Формирование заголовка из первой строки (до символа прерывания строки).
  • {stamp} – Установит в качестве заголовка метку времени unix (когда смысл не нужен).
  • {words=10} – Сформирует заголовок из первых 10 слов, кол-во можно изменить.
  • {chars=60} – Сформируем заголовок из первых 60 символов, кол-во можно изменить.
Данные шаблоны можно окружить текстом, либо не использовать вовсе, а указать произвольный текст.

Изображения в постах

Вложение постов, типа «Изображение». Варианты действий с вложением:

  • Игнорировать – т.е. не загружать и не добавлять в пост.
  • Только загружать – изображения будут, как положено, загружены на сервер, добавлены в медиатеку с привязкой к посту, что даст возможность выводить имеющиеся изображения самостоятельно как вам это удобно.
  • Загружать и добавлять – как и в предыдущем варианте, только ещё будут добавлены в пост, согласно схеме поста.
  • Не загружать – изображения будут добавлены в пост согласно схеме поста без загрузки на сервер, в качестве источника будет сервер VK (хотлинк).

Размер изображений

Предлагает выбрать размер изображений (из списка зарегистрированных в WP размеров), который будет использоваться при добавлении изображения в пост (в случаи загрузки на сервер создаются копии изображений зарегистрированных в WP размеров), помимо этого, данные размеры доступны и при самостоятельном выводе изображений.

Код изображения

Опция шаблон, html код изображения, для добавления изображений в пост.
Данный шаблон так же используется для изображений из вложения типа «Документ» (gif анимация и png изображения).

Внешние ссылки

Опция определяет действия в случаи, если к записи прикреплена внешняя ссылка (вложение link).

  • Игнорировать – Ссылки не будут добавляться в пост.
  • Добавлять – Ссылки будут добавлены в пост согласно шаблону ссылок, выводится ссылки будут согласно схеме поста.
  • Игнорировать запись – Запись, содержащая вложенные ссылки не будет добавляться, т.е. просто будет пропущена.

Код внешних ссылок

Опция шаблон, определяющий внешний вид для внешних ссылок (вложений link).

  • {url} – URL-адрес ссылки
  • {title} – Заголовок ссылки (как правило title источника).
  • {description} – Описание содержимого страницы (может отсутствовать).
  • {caption} – Подпись для ссылки (может отсутствовать).
  • {photo} – Изоражение со страницы (может отсутствовать).

Документы

Вложение постов, типа «Документ», к данному типу относятся всевозможные форматы файлов, включая gif анимацию. Опция предлагает следующие действия:

  • Игнорировать – т.е. не загружать и не добавлять в пост.
  • Загружать – файл загружается на сервер, и добавляется к посту в виде ссылки на файл.
  • Не загружать - Файлы будут добавлены в пост в виде ссылок на источник без загрузки.
  • Такие документы как изображения gif и png вставляются как изображения в обоих последних случаях.

Фильтр документов

Возможно, вам не нужны все попадающиеся в записях документы, в таком случаи можно воспользоваться фильтрацией по формату.

  • [allow] – Фильтр примет все документы.
  • [allow:gif,png,pdf] – Данный фильтр примет только указанные в наборе форматы.
  • [disallow:gif,png] – Данный фильтр напротив примет все форматы, кроме указанных в наборе.

Видео в постах

Вложение постов, типа «Видео», опция позволит игнорировать, либо добавлять прикреплённое видео в посты согласно схеме поста, при этом загрузка видеофайла не производится, видео в посты вставляется через iframe на плеер VK, YouTube, Rutube, Vimeo и т.д.

Код видео

Вы можете определить код плеера для вставки видео, т.е. указать html код iframe со всеми необходимыми атрибутами – нужный размер и т.д.
<video></video> псевдоним <iframe></iframe> с теми же параметрами как для iframe
Так же в данной области с html кодом доступны три шаблона:

  • {src} – Ссылка на плеер.
  • {title} – Название видеозаписи.
  • {description} – Описание видеозаписи.

Группы

Данная опция позволяет добавлять неограниченное кол-во необходимых вам групп.
В первом поле необходимо указать короткую ссылку или Id группы.
Выпадающий список «Категория» - в выбранную категорию будут добавляться посты из данной группы.
Поле «Кол-во записей» - Количество записей, которое будет запрошено у API, не факт, что все они будут добавлены, всё зависит от настроек, к данному кол-ву так же будут относиться и репосты.
Смещение говорит плагину о том, какое кол-во записей следует пропустить перед запросом.
Опция (галочка) «Все записи» позволит импортировать все записи из сообщества, плагин будет автоматически производить смещение, по завершению выставит его в 0, и отменит данную опцию, чтобы не ходить по кругу, т.е. далее будут запрашиваться только последние записи.

Комментарии к записям

Опция даёт возможность определить - необходимо ли импортировать комментарии к записям.

* Импортируются лишь комментарии без вложений.

Ограничение комментариев

Буквально устанавливается ограничение по кол-ву получаемых комментариев для каждой записи. Значение 0 снимает ограничение, позволяя получить все комментарии.

Сортировка комментариев

Опция позволяет определить, какие комментарии в случаи ограничения по кол-ву вам нужны – первые, либо последние.

  • ASC - От первых (старых) к последним (новым).
  • DESC - От последних (новых) к первым (старым).

Автор комментария

Как вы наверняка знаете, в ВК у пользователей указаны имя и фамилия, данная опция позволяет определить, как должен отображаться автор комментария – только его имя, или имя и фамилия.

Cron

Плагин выполняется по средствам стандартного планировщика заданий (Cron) WP, который в свою очередь выполняет задания, когда на сайте есть какая-либо активность, т.е. обращение пользователей или ботов к страницам сайта, чтобы не рассчитывать на наличие данной активности - настоятельно рекомендуется добавить wp-cron.php в Cron сервера, на выполнение каждую минуту, что обеспечит стабильное получение постов, комментариев и вложений.