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.read^js. Если размер картинки, указанной в 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'});

См. также

• guestbook.post^rest