task_log_add
Срабатывает после выполнения действия с задачей.
Доступно начиная с версии 1.0.0.
Задачи
Входящие параметры (передаются по ссылке)
$params['task'] array Массив свойств задачи со следующими ключами:
$params['task']['id'] int ID задачи.
$params['task']['name'] string Название задачи.
$params['task']['text'] string Текст, введённый при выполнении действия.
$params['task']['create_contact_id'] int ID сотрудника, создавшего задачу.
$params['task']['create_datetime'] datetime Дата и время создания задачи.
$params['task']['update_datetime'] datetime Дата и время самого позднего обновления задачи.
$params['task']['assigned_contact_id'] int|null ID сотрудника, которому назначено выполнение задачи.
$params['task']['project_id'] int ID проекта, к которому относится задача.
$params['task']['milestone_id'] int|null ID срока, к которому относится задача.
$params['task']['number'] int Номер задачи в рамках проекта.
$params['task']['status_id'] int ID статуса задачи.
$params['task']['priority'] int Значение приоритета.
$params['task']['assign_log_id'] int ID записи в истории действий о самом позднем назначении задачи.
$params['task']['hidden_timestamp'] int|null Timestamp даты и времени, до которого задача отмечена как скрытая.
$params['task']['due_date'] date Дата дедлайна.
$params['task']['comment_log_id'] date ID записи в истории действий о самом позднем добавлении комментария.
$params['task']['uuid'] string Глобальный идентификатор задачи.
$params['task']['public_hash'] string|null Хеш-строка для использования в URL публичной ссылки на задачу.
$params['log'] array Массив с информацией о выполненном действии со следующими ключами:
$params['log']['id'] int ID записи в истории действий.
$params['log']['task_id'] int ID задачи.
$params['log']['project_id'] int ID проекта, в котором оказалась задача после выполнения действия с ней.
$params['log']['contact_id'] int ID контакта, который выполнил действие.
$params['log']['text'] string Текст, введённый при выполнении действия.
$params['log']['create_datetime'] datetime Дата и время выполнении действия.
$params['log']['before_status_id'] int ID статуса, в котором задача находилась до выполнения действия.
$params['log']['after_status_id'] int ID статуса, в который задача попала после выполнения действия.
$params['log']['action'] string Обозначение действия с задачей.
$params['log']['assigned_contact_id'] int ID сотрудника, на которого назначена задача после выполнения действия.
$params['log']['attach_count'] int Количество прикреплённых файлов при выполнении действия.
$params['task']['id'] int ID задачи.
$params['task']['name'] string Название задачи.
$params['task']['text'] string Текст, введённый при выполнении действия.
$params['task']['create_contact_id'] int ID сотрудника, создавшего задачу.
$params['task']['create_datetime'] datetime Дата и время создания задачи.
$params['task']['update_datetime'] datetime Дата и время самого позднего обновления задачи.
$params['task']['assigned_contact_id'] int|null ID сотрудника, которому назначено выполнение задачи.
$params['task']['project_id'] int ID проекта, к которому относится задача.
$params['task']['milestone_id'] int|null ID срока, к которому относится задача.
$params['task']['number'] int Номер задачи в рамках проекта.
$params['task']['status_id'] int ID статуса задачи.
$params['task']['priority'] int Значение приоритета.
$params['task']['assign_log_id'] int ID записи в истории действий о самом позднем назначении задачи.
$params['task']['hidden_timestamp'] int|null Timestamp даты и времени, до которого задача отмечена как скрытая.
$params['task']['due_date'] date Дата дедлайна.
$params['task']['comment_log_id'] date ID записи в истории действий о самом позднем добавлении комментария.
$params['task']['uuid'] string Глобальный идентификатор задачи.
$params['task']['public_hash'] string|null Хеш-строка для использования в URL публичной ссылки на задачу.
$params['log'] array Массив с информацией о выполненном действии со следующими ключами:
$params['log']['id'] int ID записи в истории действий.
$params['log']['task_id'] int ID задачи.
$params['log']['project_id'] int ID проекта, в котором оказалась задача после выполнения действия с ней.
$params['log']['contact_id'] int ID контакта, который выполнил действие.
$params['log']['text'] string Текст, введённый при выполнении действия.
$params['log']['create_datetime'] datetime Дата и время выполнении действия.
$params['log']['before_status_id'] int ID статуса, в котором задача находилась до выполнения действия.
$params['log']['after_status_id'] int ID статуса, в который задача попала после выполнения действия.
$params['log']['action'] string Обозначение действия с задачей.
$params['log']['assigned_contact_id'] int ID сотрудника, на которого назначена задача после выполнения действия.
$params['log']['attach_count'] int Количество прикреплённых файлов при выполнении действия.
… код плагина …
Результат работы плагина
Задачи
Пример кода плагина
PHP
public function taskLogAdd(&$params)
{
if (strlen(trim($params['log']['text'] ?? ''))) {
waLog::log(
sprintf_wp(
"Text entered by user %s during the execution of an action on task #%d:\n%s",
wa()->getUser()->getName(),
$params['task']['id'],
$params['log']['text']
),
sprintf('tasks/plugins/%s/task_log_add.log', $this->id)
);
}
}
