ForumAddMessage
int ForumAddMessage( string MESSAGE_TYPE, int FID, int TID, int MID, array arFieldsG, &string strErrorMessage, &string strOKMessage [, int iFileSize] );
Добавляет или изменяет сообщение (и возможно тему) форума. В переменную, передаваемую в параметре strErrorMessage дописывает ошибки, которые произошли при работе функции. В переменную, передаваемую в параметре strOKMessage дописывает сообщения об успехах, которые произошли при работе функции.
Примечание. Функция использует внутреннюю транзакцию. Если у вас используется MySQL и InnoDB, и ранее была открыта транзакция, то ее необходимо закрыть до ее подключения.
Параметры функции
Параметр | Описание |
---|---|
MESSAGE_TYPE | Тип работы функции. Может принимать следующие значения: NEW - создание новой темы и добавление в нее сообщения, EDIT - изменение сообщения (и темы, если на это есть права), REPLY - новое сообщение в существующую тему. |
FID | Код форума, в который добавляется новая тема. Актуален для типа работы NEW, в остальных случаях восстанавливается из кода темы. |
TID | Код темы, в которую добавляется сообщение. Актуален для типа работы REPLY, в остальных случаях восстанавливается из кода сообщения. Для добавления новой темы должен быть равен 0. |
MID | Код сообщения, которое необходимо изменить. Актуален для типа работы EDIT. В остальных случаях должен быть равен 0. |
arFieldsG |
Массив параметров сообщения и темы. Должен содержать следующие ключи POST_MESSAGE - тело сообщения, TITLE - заголовок темы (если NEW или EDIT и разрешено изменение темы), AUTHOR_NAME - имя автора сообщения, DESCRIPTION - описание темы (если NEW или EDIT и разрешено изменение темы), ICON_ID - иконка темы (если NEW или EDIT и разрешено изменение темы), USE_SMILES - разрешено заменять смайлики на их графические изображения, ATTACH_IMG - присоединенный файл - массив со структурой элементов массива $_FILES |
strErrorMessage | Переменная, в которую функция дописывает сообщения об ошибках, которые произошли при ее работе. |
strOKMessage | Переменная, в которую функция дописывает сообщения об успехах, которые произошли при ее работе. |
iFileSize | Максимальный размер загружаемых файлов в байтах. Не обязательный параметр, по умолчанию равен 50000 (байт). |
captcha_word | Слово с капчи. |
captcha_sid | Сессия капчи. |
captcha_code | Введенное пользователем слово. |
Возвращаемое значение
Возвращает ID сообщения, если функция отработала без ошибок. В противном случае возвращает False.Следует помнить, что внутри функции используется глобальная переменная $USER. То есть, сообщение запишется в базу от текущего авторизованного пользователя.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024