O V-Pro permite estender os status de tarefas para que se adaptem melhor ao seu fluxo de trabalho. Além dos status padrão, é possível criar novos status personalizados por meio de um hook simples.

Disponível a partir da versão 1.6.2

Status padrão do sistema

Por padrão, o V-Pro possui os seguintes status de tarefa:

• Não iniciada

• Em andamento

• Testando

• Aguardando retorno

• Concluída

Os status Não iniciada, Em andamento e Concluída são status centrais do sistema e não devem ser alterados, para garantir o funcionamento correto do V-Pro.

Visão geral da criação de novos status

A criação de novos status é feita via código, utilizando um hook que injeta os status adicionais no sistema.

Neste exemplo, serão adicionados dois novos status de tarefa:

• Em espera

• Pronto para produção

Passo a passo para adicionar novos status

1. Criar o arquivo de funções personalizadas

No diretório:

application/helpers

Crie o arquivo (caso ainda não exista):

my_functions_helper.php

2. Adicionar o código de criação dos status

Cole o código abaixo no arquivo my_functions_helper.php:

<?php

// Versão 2.3.0 ou superior
hooks()->add_filter('before_get_task_statuses','my_add_custom_task_status');

// Para versões anteriores à 2.3.0, comente a linha acima
// e descomente a linha abaixo:
// add_action('before_get_task_statuses','my_add_custom_task_status');

function my_add_custom_task_status($current_statuses)
{
    // Adiciona o status "Em espera"
    $current_statuses[] = array(
        'id'             => 50, // ID único do status
        'color'          => '#989898',
        'name'           => 'Em espera',
        'order'          => 10,
        'filter_default' => true
    );

    // Adiciona o status "Pronto para produção"
    $current_statuses[] = array(
        'id'             => 51, // ID único do status
        'color'          => '#be51e0',
        'name'           => 'Pronto para produção',
        'order'          => 11,
        'filter_default' => true
    );

    return $current_statuses;
}

Explicação dos parâmetros

id

Identificador único do status.
Recomenda-se usar valores altos (acima dos padrões do sistema) para evitar conflitos futuros.

Importante: não altere o ID de um status depois que ele já estiver sendo usado em tarefas.

color

Cor do status, definida em formato hexadecimal
Exemplo: #FF0000

name

Nome do status que será exibido para os usuários.

order

Define a ordem de exibição do status, inclusive nas colunas do Kanban.

filter_default

Controla se as tarefas com esse status aparecem nas listas por padrão:

• true → aparece automaticamente

• false → só aparece se o filtro for ajustado manualmente

Exemplo de uso: status como Cancelado geralmente não devem aparecer por padrão.

Finalização

Após salvar o arquivo my_functions_helper.php, os novos status estarão disponíveis imediatamente no V-Pro e poderão ser utilizados em tarefas existentes ou novas.

Boas práticas

• Sempre utilize IDs exclusivos e altos

• Evite alterar ou remover status que já estejam em uso

• Use cores que facilitem a identificação visual no Kanban

• Utilize filter_default = false para status que não devem aparecer no dia a dia

Recursos relacionados

• Criar nova tarefa

• Tarefas recorrentes

• Copiar tarefa

• Adicionar responsáveis à tarefa

• Configurações avançadas de tarefas