O V-Pro permite personalizar o fluxo de projetos por meio da criação de novos status, adequando o acompanhamento às etapas reais do seu processo interno.

Disponível a partir da versão 1.6.2

Status padrão de projetos

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

• Não iniciado

• Em andamento

• Em espera

• Cancelado

• Finalizado

Os status Não iniciado e Finalizado são considerados status centrais do sistema e não devem ser alterados, pois isso pode comprometer o funcionamento correto dos projetos.

Quando usar status personalizados

Status personalizados são úteis para:

• Adaptar o fluxo do projeto à metodologia da empresa

• Criar etapas intermediárias (ex: Planejamento, Homologação, Implantação)

• Melhorar a visualização em listas e quadros de projetos

Como adicionar um novo status de projeto

A criação de novos status é feita via hook, utilizando um pequeno trecho de código.

Exemplo: criar o status Planejamento

1. Criar o arquivo auxiliar

No diretório:

application/helpers/

Crie o arquivo:

my_functions_helper.php

2. Inserir o código abaixo

<?php

hooks()->add_filter('before_get_project_statuses', 'vpro_add_custom_project_status');

function vpro_add_custom_project_status($current_statuses)
{
    $current_statuses[] = array(
        'id' => 50,               // ID único do status
        'color' => '#989898',     // Cor em hexadecimal
        'name' => 'Planejamento', // Nome exibido
        'order' => 10,            // Ordem de exibição
        'filter_default' => true  // Exibir por padrão nas listas
    );

    return $current_statuses;
}

3. Salvar o arquivo

Após salvar o arquivo, o novo status ficará imediatamente disponível nos projetos do V-Pro.

Explicação dos parâmetros

• id
  Identificador único do status.
  Utilize valores mais altos para evitar conflitos com status nativos do sistema (os padrões usam IDs baixos).
  ⚠️ Não altere o ID após projetos já estarem usando esse status.

• color
  Cor associada ao status, usada em listas e visualizações.
  Deve ser informada em formato hexadecimal (ex: #FF0000).

• name
  Nome do status exibido para os usuários.

• order
  Define a posição do status em listas e quadros (quanto menor, mais à esquerda ou acima).

• filter_default

  • true: projetos com esse status aparecem por padrão nas listas

  • false: projetos com esse status ficam ocultos por padrão e precisam ser exibidos via filtro

Boas práticas

• Use IDs únicos e altos (ex: acima de 50)

• Não altere IDs após o uso em projetos ativos

• Evite remover status já utilizados

• Mantenha os status centrais intactos

Recursos relacionados

• Configurações de projetos

• Controle de permissões de projetos

• Atividades do projeto

• Visão geral financeira do projeto