tasks_log

Срабатывает при получении истории обработки для списка задач. Позволяет изменить или расширить содержимое записей перед их отображением.

Доступно начиная с версии 1.2.0.

Задачи

Входящие параметры (передаются по ссылке)

$logs array Массив с информацией об истории обработки задач. Ключи многоуровневого массива: task_id — ID задач; log_id — ID записей в истории обработки задач.
$logs[task_id][log_id]['id'] int ID записи.
$logs[task_id][log_id]['task_id'] int ID задачи.
$logs[task_id][log_id]['project_id'] int ID проекта, в котором оказалась задача после выполнения действия с ней.
$logs[task_id][log_id]['contact_id'] int ID контакта, который выполнил действие.
$logs[task_id][log_id]['text'] string Текст, введённый при выполнении действия.
$logs[task_id][log_id]['create_datetime'] datetime Дата и время выполнении действия.
$logs[task_id][log_id]['before_status_id'] int ID статуса, в котором задача находилась до выполнения действия.
$logs[task_id][log_id]['after_status_id'] int ID статуса, в который задача попала после выполнения действия.
$logs[task_id][log_id]['action'] string Обозначение действия с задачей из списка: 'add' (создание), 'edit' (редактирование), '' (другое действие — смена статуса).
$logs[task_id][log_id]['assigned_contact_id'] int ID сотрудника, на которого назначена задача после выполнения действия.
$logs[task_id][log_id]['contact'] array Массив свойств сотрудника, выполнившего действие с задачей, со следующими ключами:
$logs[task_id][log_id]['contact']['id'] int ID сотрудника.
$logs[task_id][log_id]['contact']['login'] string Логин.
$logs[task_id][log_id]['contact']['firstname'] string Имя.
$logs[task_id][log_id]['contact']['middlename'] string Отчество.
$logs[task_id][log_id]['contact']['lastname'] string Фамилия.
$logs[task_id][log_id]['contact']['name'] string Полное имя.
$logs[task_id][log_id]['contact']['company'] string Название компании.
$logs[task_id][log_id]['contact']['photo'] int Значение поля photo из таблицы wa_contact.
$logs[task_id][log_id]['contact']['photo_url'] string Относительный URL изображения сотрудника.
$logs[task_id][log_id]['assigned_contact'] array Массив свойств сотрудника, назначенного ответственным за выполнение задачи, с ключами, описанными для массива contact.
$logs[task_id][log_id]['status_changed'] bool Флаг, означающий смену статуса задачи при выполнении действия.
$logs[task_id][log_id]['action_name'] string Название статуса задачи.
$logs[task_id][log_id]['assignment_changed'] bool Флаг, означающий смену назначенного сотрудника.
… код плагина …

Результат работы плагина

Задачи

Пример кода плагина

PHP

public function tasksLog(&$logs)
{
    // Modify the logs before they are displayed, if necessary.
    array_walk($logs, function (&$task_logs) {
        array_walk($task_logs, function (&$task_log_entry) {
            // E.g., set a custom parameter value for each log entry.
            $plugin_param_name = $this->id . '_some_param_name';
            $task_log_entry['params'][$plugin_param_name] = '...';
        });
    });
}