Документация по кнопке «Нравится»

Чтобы вставить кнопку «Нравится» на вашу страницу, скопируйте следующий код в то место, где вы хотите чтобы она появилась.

Нравится

Если вы хотите сделать несколько кнопок, то тэг <script> надо вставлять только один раз.

Дополнительные настройки

Кнопку можно сконфигурировать по вашему желанию. Описанные ниже опции можно применять в любых комбинациях.

Задание ширины кнопки

Блок с кнопкой может иметь различную ширину по вашему желанию. Чтобы указать ширину, укажите в атрибуте data-mrc-config параметр width. Значение параметра может быть в пикселях (по умолчанию), em’ах и процентах. Указывайте ширину, достаточную для отображения желаемых опций. Для примеров значений пользуйтесь конфигуратором. Например:

Нравится

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

Вы можете задать параметры отображения записи в «Что Нового» в коде кнопки. Обратите внимание, что мы рекомендуем для конфигурации использовать правила, описанные в разделе Разметка страницы, так это благоприятно повлияет на SEO и работает в нескольких социальных сетях. Используйте параметры кнопки только в случае невозможности изменения кода страницы.

Для конфигурации записи используйте следующие GET-параметры в атрибуте href:

Не забудьте закодировать параметры, например, с помощью javascript функции encodeURIComponent. Не указанные параметры получаются роботом автоматически из страницы, на которой расположена кнопка (или на которую указывает url).

Например:

Нравится

Параметр url полезен при размещении кнопок на списках статей: достаточно указать в url ссылку на страницу со статьей и кнопка будет работать так же, как если бы она была размещена на той странице (будут получены картинки, заголовок и описание с той страницы).

Разметка страницы

Чтобы улучшить представление страницы в записях пользователей вы можете добавить на нее дополнительную разметку.

заголовок


   ...
   
   
   ...
   
    
   ...
   
   заголовок
   ...

описание


   ...
   
   
   ...
   
   
   ...

Если описание не найдено, то оно берется из первого тега <p> иди <div>, содержащего в начале минимум 100 символов текста без тегов.

картинки

Вы можете указать картинки, которые будут предложены пользователю, с помощью тегов <link rel="image_src" href="...">. В случае отсутствия таких тегов, будут взяты первые 100 уникальных картинок со страницы. Показаны будут только картинки площадью больше 2500 пикселей, в порядке убывания размера. Вы можете исключить показ конкретных картинок (например, баннеров), добавив к ним класс mrc__share_ignore.


   ...
   
   ...


   ...
   эта картинка будет показана в диалоге, если на странице не указан тэг link с image_src
   
   ...
   эта картинка не будет показана в диалоге
   
   ...

Также в параметр url можно передавать адрес картинки. В таком случае пользователю будет предложена одна эта картинка и возможность ввести комментарий.

видео

Если основная часть страницы — флэш видео, то вы можете обеспечить его просмотр прямо в ленте «Что Нового». Самый лучший вариант сделать это — использовать oEmbed, тогда ваше видео автоматически смогут получать различные инструменты и сайты, не только Мой Мир@Mail.Ru. Для правильной работы кнопки нужна поддержка discovery (см. раздел 4 спецификации oEmbed) в формате XML.

Если вы не хотите поддерживать oEmbed, то видео можно разметить с помощью следующего набора тэгов: 


   ...
   
   
   
   ...

Все параметры обязательные, размеры видео не должны превышать 420×420 пикселей (иначе оно сжимается с сохранением пропорций).

Собственная кнопка

Кнопки Вы можете сделать свою кнопку любой формы и размера. Важно, чтобы она вела на адрес http://connect.mail.ru/share?url=<адрес_вашей_страницы>.

Вы можете использовать макеты официальных кнопок для создания своего варианта.

Наш робот получает заголовок, описание и картинку для вашей страницы автоматически. Мы рекомендуем придерживаться рекомендаций раздела «Разметка страницы» для настройки внешнего вида записи так как они помогают SEO-продвижению и совместимы со стандартами других социальных сетей.

Кнопка «Нравится» поддерживает стандарт oExchange, поэтому вы можете задавать параметры записи с помощью параметров кнопки. Используйте такой вариант только если не можете изменить разметку страницы.

Адрес для простой страницы:

http://connect.mail.ru/share?url=<адрес_страницы>&title=<заголовок>&description=<описание>&image_url=<адрес_картинки>

Адрес для страницы с видео:

http://connect.mail.ru/share?url=<адрес_страницы>&title=<заголовок>&description=<описание>&
ctype=flash&screenshot=<адрес_картинки>&swfsrc=<адрес_флэшки>&width=<ширина_видео>&height=<высота_видео>

Возможные параметры смотрите в спецификации oExchange. В терминах спецификации, Offer Endpoint это http://connect.mail.ru/share. Адрес Target XRD — http://my.mail.ru/oexchange.xrd.