mailru.common.guestbook.post — js api
Показывает пользователю диалог публикации записи в Гостевую книгу.
| Имя |
Тип |
Описание |
| params | object | объект с информацией о записи, которую вы хотите создать |
Пример параметра params:
{
// id пользователя, в гостевую книгу которого пишется сообщение
// по умолчанию текущий пользователь
'uid': 123,
'title': 'заголовок записи, будет написан жирным шрифтом',
// text никак не обрабатывается (ссылки не выделяются)
// обязательное поле
'text': 'основной текст вашей записи',
// картинка, которая будет отображаться в записи
'img_url': 'http://exmaple.com/img.gif',
'action_links': [
// абсолютные URL'ы работают только для внешних сайтов
// для приложений href будет даписан в якорь ссылки на страницу приложения
{'text': 'заголовок ссылки 1', 'href': 'http://example.com/test1'},
{'text': 'заголовок ссылки 2', 'href': 'http://example.com/test2'}
]
}
Ограничение на длину заголовка и текста — 400 символов. Ограничение на длину текста ссылок — 20 символов.
Обратите внимание, что абсолютные URL'ы в action_link'ах работают только для внешних сайтов, для приложений ссылка под записью всегда будет вести на страницу приложения, а href будет дописан в якорь (после #). Этот текст можно прочитать с помощью функции hash.readjs.
Если размер картинки, указанной в img_url, превышает 420×280 пикселей, то она будет пропорционально уменьшена.
Для получения результата выполнения функции подписывайтесь на события, описанные в секции «Генерируемые события».
mailru.common.events.guestbookPublish
{
// варианты: opened/closed/publishSuccess/publishFail/authError
'status': "publishSuccess",
}
mailru.events.listen(mailru.common.events.guestbookPublish, function(event) {
// эта функция будет вызываться при закрытии диалога
alert(event.status);
});
mailru.common.guestbook.post({'title':'title', 'text': 'description'});