Para resolver um problema ou melhorar seu módulo, você deseja criar atualizações para ele para que seus clientes possam se beneficiar dos aprimoramentos.

O GrowCRM determinará se há uma nova atualização para seu módulo pelo arquivo init cabeçalho da versão.

Por exemplo, você lançou uma versão 1.0.0 e a Se os usuários estiverem usando esta versão, no momento em que o usuário instalar a versão 1.0.0 e ativar o módulo, o GrowCRM armazenará o número da versão do módulo ativado no banco de dados.

Então você lança a versão 1.1.0 e o usuário carrega/instala novamente os arquivos do módulo, o GrowCRM determinará que a versão do cabeçalho do arquivo não é a mesma que a armazenada no banco de dados e mostrará uma mensagem ao usuário para atualizar o banco de dados.

A migração de módulos do GrowCRM estende a biblioteca de migração do framework CodeIgniter e usa o tipo de migração Sequencial. Lembre-se de que não é possível alterar o tipo Sequencial para Carimbo de data/hora.

Se você não estiver familiarizado com a biblioteca de migração do CodeIgniter, o melhor é verificar seu documentação.

Cada migração é numerada em sequência, começando com 001. Cada número deve ter três dígitos e não deve haver espaços na sequência.

Crie (se não existir) uma pasta chamada migrations no diretório do módulo. Após criar a pasta, o local será: modules/[module-name]/migrations

Para nosso exemplo, você deve criar um arquivo de migração e.q.  110_version_110.php com o seguinte conteúdo:

O arquivo 110_version_110.php executará uma atualização para a versão do seu módulo  1.1.0.

Lembre-se de que no seu gancho de ativação, você ainda deve ter as últimas alterações para o banco de dados, os arquivos de migração serão executados apenas para instalações existentes que estejam usando uma versão mais antiga, o a instalação do novo módulo deve obter essas alterações no banco de dados do gancho de instalação.

Ressalvas

Downgrade

Não há possibilidade de fazer downgrade para versões anteriores. Por esse motivo, basta adicionar o método up em seus arquivos de migração.

Crie um arquivo de migração sempre que A versão do cabeçalho do módulo foi alterada.

Você deve criar um arquivo de migração sempre que alterar o número da versão do módulo, mesmo que não haja alterações no banco de dados.

O GrowCRM não consegue determinar se você tem ou não atualizações no banco de dados, mas o arquivo de migração deve ser executado para atualizar o número da versão em banco de dados.

Em casos como este, quando não há consultas a serem executadas no arquivo de migração, basta deixar o método up e.q. vazio. conforme mostrado no exemplo acima.

O usuário verá que há uma atualização necessária no banco de dados, clicará em “Atualizar banco de dados”, uma migração vazia será executada e o número do banco de dados será atualizado com sucesso.