mailru.common.guestbook.post js api

Показывает пользователю диалог публикации записи в Гостевую книгу.

Параметры

Имя Тип Описание
paramsobjectобъект с информацией о записи, которую вы хотите создать

Пример параметра params:

  1. {
  2. // id пользователя, в гостевую книгу которого пишется сообщение
  3. // по умолчанию текущий пользователь
  4. 'uid': '123',
  5. 'title': 'заголовок записи, будет написан жирным шрифтом',
  6. // text никак не обрабатывается (ссылки не выделяются)
  7. // обязательное поле
  8. 'text': 'основной текст вашей записи',
  9. // картинка, которая будет отображаться в записи
  10. 'img_url': 'http://exmaple.com/img.gif',
  11. 'action_links': [
  12. // абсолютные URL'ы работают только для внешних сайтов
  13. // для приложений href будет даписан в якорь ссылки на страницу приложения
  14. {'text': 'заголовок ссылки 1', 'href': 'http://example.com/test1'},
  15. {'text': 'заголовок ссылки 2', 'href': 'http://example.com/test2'}
  16. ]
  17. }
Ограничение на длину заголовка и текста — 400 символов. Ограничение на длину текста ссылок — 20 символов. Обратите внимание, что абсолютные URL'ы в action_link'ах работают только для внешних сайтов, для приложений ссылка под записью всегда будет вести на страницу приложения, а href будет дописан в якорь (после #). Этот текст можно прочитать с помощью функции hash.readjs. Если размер картинки, указанной в img_url, превышает 420×280 пикселей, то она будет пропорционально уменьшена.

Результат

Для получения результата выполнения функции подписывайтесь на события, описанные в секции «Генерируемые события».

Генерируемые события

mailru.common.events.guestbookPublish

  1. {
  2. // варианты: opened/closed/publishSuccess/publishFail/authError
  3. 'status': "publishSuccess",
  4. }

Пример вызова

  1. mailru.events.listen(mailru.common.events.guestbookPublish, function(event) {
  2. // эта функция будет вызываться при закрытии диалога
  3. alert(event.status);
  4. });
  5. mailru.common.guestbook.post({'title':'title', 'text': 'description'});

См. также

Использование JS API

Функции JS API