Для публикации ссылки на страницу Вашего сайта используйте виджет
Share или его упрощенную версию — ссылку вида
https://vk.com/share.php?url=
Более подробно об использовании виджета Вы можете узнать на
отдельной странице.
Возможность поделиться с друзьями реализована в нескольких виджетах для внешних сайтов. В каждом из этих случаев к записи на стене пользователя будет прикреплена ссылка на страницу Вашего сайта, где размещен виджет:
- Виджет комментариев — пользователь может поделиться комментарием на своей стене. Параметр autoPublish позволяет настроить публикацию по умолчанию.
- Виджет «Мне нравится» — действие «Рассказать друзьям» создает на странице пользователя запись с опциональным комментарием.
- Виджет опросов — пользователь может поделиться результатом голосования в опросе.
Для публикации записей из клиентских и серверных приложений используйте метод
wall.post. Вы можете обращаться к нему напрямую, используя
классическую схему взаимодействия с API, из
SDK, из
Open API, если речь идет о приложении-сайте. В Open API и приложениях на vk.com действие потребует подтверждения пользователя.
Чтобы добавить к записи аудио, видео или фото, передайте в параметре
attachments тип объекта и его строковый идентификатор.
Тип объекта —
audio,
video,
photo или
doc.
Строковый идентификатор — это строка, включающая идентификатор владельца объекта (
owner_id) и идентификатор самого объекта (
audio_id,
video_id и т.д.).
Например, для фотографии
photo34_408897832 в
attachments нужно передать значение
photo34_408897832.
https://api.vk.com/method/wall.post
?owner_id=-1
&message="Tanya"
&attachments="photo34_408897832"
&access_token={YOUR_ACCESS_TOKEN}
&v=5.57
Запрос к методу wall.post для публикации записи с текстом "Tanya" и прикрепленной фотографией photo34_408897832 на стену сообщества ВКонтакте API.
Если Вы хотите прикрепить новый объект к записи на стене, необходимо сначала загрузить его на сервер ВКонтакте. В зависимости от типа контента используйте один из подходов, описанных
на этой странице. Затем используйте идентификатор загруженного объекта в параметре
attachments.
С помощью
wall.post Вы можете работать с предложенными и отложенными записями. Чтобы создать предложенную запись, передайте в
owner_id идентификатор публичной страницы, в которой текущий пользователь не является руководителем.
Чтобы создать отложенную запись, передайте время публикации в параметре
publish_date.
Для публикации предложенных и отложенных записей используйте параметр
post_id, значение для которого можно получить методом
wall.get с
filter=
suggests и
postponed соответственно.
Чтобы добавить к записи сниппет ссылки с внешнего сайта (превью-изображение, заголовок и описание), передайте URL в параметре
attachments. Например,
http://yandex.ru. Сниппет генерируется автоматически, более подробно об этом Вы можете прочитать в следующем разделе.
Сниппет ссылки на внешний сайт в записи на стене
Сниппет — это карточка с обложкой, изображением и заголовком для ссылки. Когда Вы публикуете ссылку в записи на стене, в комментарии или личном сообщении, сниппет генерируется автоматически — для этого используются данные с той страницы, на которую ведёт ссылка.
А именно:
- Заголовок. Если на странице есть теги og:title, mrc__share_title или twitter:title, то заголовок будет взят из одного из них (указанного первым), иначе будет использован тег <title>.
- Иллюстрация. Если на странице есть тег vk:image, то адрес изображения для иллюстрации будет взят из него. Если такого тега нет, проверяется содержимое тегов og:image, twitter:image, image — адрес изображения для иллюстрации будет взят из указанного первым, иначе будут взяты первые 8 тегов <img src="...">, и из них предложены в качестве иллюстрации те картинки, размер которых по ширине и высоте превышает 160 пикселей.
Мы рекомендуем использовать картинки размером не менее
510x228 пикселей. В этом случае ссылка будет сопровождаться увеличенной картинкой (
510x228 пикселей) в сниппете на стене. Если картинка имеет меньший размер (но не менее
160 пикселей по каждой из сторон), или к записи помимо ссылки прикреплены другие вложения, картинка в сниппете будет уменьшенная —
150x83 пикселя.
Например, указать заголовок и картинку для сниппета можно так:
<head>
<meta property="og:title" content="Заголовок страницы" />
<meta property="vk:image" content="https://pp.vk.me/c629531/v629531034/3172e/xEBYyER1WE4.jpg" />
</head>
Обратите внимание, данные для публикации могут кэшироваться. Если Вы изменили данные на своем сайте, а ВКонтакте при публикации отображаются старые значения, сбросьте кэш для ссылки на странице
pages.clearCache.
Для информационных ресурсов мы предлагаем возможность размещения публикаций в разделе
«Статьи».
Если ссылка на статью прикреплена к записи, под ней появляется кнопка «Просмотреть», которая ведет на вики-версию статьи. Пользователь может просмотреть ее содержимое, не переходя на внешний сайт.
Кнопка предпросмотра под записью
Чтобы подключить предпросмотр для ссылок с Вашего сайта, пожалуйста, напишите в
Поддержку. В заявке необходимо указать ссылки на несколько примеров статей, ссылку на сообщество Вашего сайта ВКонтакте, а также данные о посещаемости сайта и сообщества.
Открытая вики-версия статьи