PHPackages                             refersonprado/order-custom-code - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. refersonprado/order-custom-code

ActiveMagento2-module

refersonprado/order-custom-code
===============================

Certisign Order Custom Code

1.0.4(3mo ago)04OSL-3.0PHPPHP ^8.1

Since Jan 22Pushed 3mo agoCompare

[ Source](https://github.com/refersonprado/order-custom-code)[ Packagist](https://packagist.org/packages/refersonprado/order-custom-code)[ RSS](/packages/refersonprado-order-custom-code/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (6)Used By (0)

Certisign Order Custom Code
===========================

[](#certisign-order-custom-code)

Este módulo para Magento 2 gera automaticamente um código identificador personalizado (`custom_code`) para cada pedido realizado na loja. O código é persistido na base de dados e disponibilizado para visualização no frontend, painel administrativo e via API.

Funcionalidades
---------------

[](#funcionalidades)

- **Geração Automática**: O código é gerado durante o checkout através do evento `sales_order_place_before`.
- **Lógica de Composição**: O identificador segue o padrão `{Prefixo}-{AnoMês}-{IncrementId}-{QuantidadeTotal}`.
- **Configuração Flexível**: Ativação e definição de prefixo via Admin.
- **Visibilidade**:
    - Exibição na página de sucesso do checkout.
    - Coluna dedicada na grid de pedidos (Sales Grid).
    - Bloco informativo no detalhe do pedido no Admin.
- **Retroatividade**: Comando de console para popular pedidos antigos.

Instalação
----------

[](#instalação)

### Via Composer (Recomendado)

[](#via-composer-recomendado)

1. No terminal, execute: ```
    composer require refersonprado/order-custom-code
    ```

    *(Nota: Requer que o repositório esteja configurado no teu composer.json)*.
2. Atualize os módulos: ```
    bin/magento setup:upgrade
    ```

### Via app/code (Manual)

[](#via-appcode-manual)

1. Cria a estrutura de pastas: `app/code/Certisign/OrderCustomCode`.
2. Copie todos os arquivos do módulo para este diretório.
3. Execute os seguintes comandos do Magento: ```
    bin/magento module:enable Certisign_OrderCustomCode
    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento setup:static-content:deploy
    ```

Configuração
------------

[](#configuração)

1. Navegue até **Lojas** > **Configuração** > **Certisign** > **Order Custom Code**.
2. **Enable**: Ativa a funcionalidade.
3. **Prefix**: Define o prefixo desejado (ex: VAL).

Comandos CLI
------------

[](#comandos-cli)

Para gerar códigos para pedidos que foram criados antes da instalação do módulo, utilize o comando:

```
bin/magento certisign:order:populate-custom-code
```

Informações Adicionais
----------------------

[](#informações-adicionais)

Caso deseje fazer consultar SQL irei deixar algumas para facilitar o processo, como consulta por custom\_code, update em massa para resetar o campo e update em massa para popular campos de pedidos que já foram feitos antes da implementação.

1. SELECT para consulta por custom code

```
   SELECT * FROM sales_order WHERE custom_code = 'VALOR-DO-CUSTOM-CODE';
```

2. UPDATE para limpar todos os custom\_code

```
UPDATE sales_order SET custom_code = '' WHERE custom_code IS NOT NULL;
```

3. UPDATE para pedidos que já foram feitos

```
UPDATE sales_order
SET
    custom_code = CONCAT(
        'VAL', '-',
        DATE_FORMAT(created_at, '%Y%m'), '-',
        increment_id, '-',
        CAST(total_qty_ordered AS UNSIGNED)
    ),
    updated_at = NOW()
WHERE
    custom_code
```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance78

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

116d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d50b50b9c194b996cffdb9fc1375cf691470a50a8301dd937fc5a35ea270bfaf?d=identicon)[refersonprado](/maintainers/refersonprado)

---

Top Contributors

[![refersonprado](https://avatars.githubusercontent.com/u/71836499?v=4)](https://github.com/refersonprado "refersonprado (17 commits)")

### Embed Badge

![Health badge](/badges/refersonprado-order-custom-code/health.svg)

```
[![Health](https://phpackages.com/badges/refersonprado-order-custom-code/health.svg)](https://phpackages.com/packages/refersonprado-order-custom-code)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.2M1](/packages/fastly-magento2)[mage-os/module-automatic-translation

Automatic AI content translation for Mage-OS.

277.1k](/packages/mage-os-module-automatic-translation)[zepgram/module-rest

Technical module to industrialize API REST call with dependency injection pattern using Guzzle library

1326.2k](/packages/zepgram-module-rest)[graycore/magento2-graphql-introspection-cache

1015.2k](/packages/graycore-magento2-graphql-introspection-cache)[mage-os/mageos-common-async-events

Send REST requests to external endpoints asynchronously. This module implements the most common events like order creation and customer change.

147.7k2](/packages/mage-os-mageos-common-async-events)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

126.8k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)