Descrição
# Post Numerator
Post Numerator é um plugin WordPress que gera números sequenciais automaticamente para Custom Post Types (CPT), Custom Content Types (CCT) e Pedidos do WooCommerce.
## Funcionalidades
– Gera números sequenciais para qualquer Custom Post Type ou Custom Content Type
– Gera números sequenciais para Pedidos do WooCommerce
– Números formatados com zeros à esquerda (ex: 00001, 00002, etc.)
– Ativa/desativa a geração de números para tipos de post específicos
– Permite definir o número inicial para cada tipo de post
– Reinicia a sequência de números individualmente por tipo de post
– Interface administrativa moderna e intuitiva
– Compatível com JetEngine Custom Content Types
## Segurança
O plugin implementa várias medidas de segurança:
1. **Verificação de Permissões**
– Requer capacidade `manage_options` para acessar configurações
– Verifica permissões antes de executar ações administrativas
– Protege endpoints AJAX contra acessos não autorizados
2. **Proteção Contra CSRF**
– Implementa verificação de nonce em todos os formulários
– Usa tokens de segurança em requisições AJAX
– Verifica referrer em submissões de formulário
3. **Sanitização de Dados**
– Sanitiza todas as entradas de usuário
– Escapa dados na saída
– Valida tipos de dados antes do armazenamento
4. **Proteção do Banco de Dados**
– Usa funções seguras do WordPress para acesso ao banco
– Implementa verificações antes de atualizar dados
– Mantém integridade dos números sequenciais
5. **Prevenção de Acesso Direto**
– Bloqueia acesso direto a arquivos PHP
– Verifica constante ABSPATH
– Protege arquivos sensíveis
## Instalação
1. Faça upload da pasta `post-numerator` para o diretório `/wp-content/plugins/`
2. Ative o plugin através do menu ‘Plugins’ no WordPress
3. Acesse Configurações > Post Numerator para configurar o plugin
## Como Usar
### Configuração Inicial
1. Vá até Configurações > Post Numerator no painel administrativo do WordPress
2. Ative a numeração para os tipos de post desejados usando os toggles
3. Defina o número inicial para cada tipo de post (opcional)
4. Clique em “Salvar Configurações” para aplicar as mudanças
5. O plugin irá gerar automaticamente números sequenciais para novos posts dos tipos ativados
### Para Pedidos do WooCommerce:
1. Certifique-se de que o WooCommerce está instalado e ativo
2. Vá até “Configurações > Post Numerator”
3. Localize “Pedidos” na lista de tipos de post
4. Ative a numeração para pedidos
5. Defina o número inicial desejado
6. Clique em “Salvar Alterações”
### Usando com JetEngine Listings
Para exibir o número sequencial em um JetEngine listing:
1. No editor do Listing, Adicione um “Dynamic Field”
2. Escolha “Meta Data” como fonte de dado
3. Na opção “Meta Field” Deixe como está, sem seleção
4. No “Object field / Meta field / Repeater key / Component prop” digite exatamente ‘_sequence_number’
Caso os zeros à esquerda não apareçam, faça o seguinte:
1. Habilite a opção “Filter field output”
2. Selecione “Zeroise (add leading zeros)” na configuração do filtro
3. Na opção “Threshold”, defina o número de dígitos desejados (ex: 5 para 00001)
#### Personalizando a Exibição no Listing
Para personalizar como o número aparece no listing:
1. Use o campo “Field Format” do JetEngine
2. Exemplos:
– Para adicionar “Nº” antes do número: `Nº %s`
– Para adicionar “ORÇ” antes: `ORÇ %s`
– Para adicionar “/2024” depois: `%s/2024`
### Usando o Shortcode
O plugin fornece o shortcode `` com várias opções de personalização:
“`
“`
Parâmetros disponíveis:
– `post_type`: Tipo de post específico (opcional)
– `post_id`: ID específico do post (opcional)
– `prefix`: Texto antes do número (ex: “ORÇ”)
– `suffix`: Texto depois do número (ex: “/2024”)
– `digits`: Número de dígitos para formatação (padrão: 5)
– `format`: Formato personalizado (padrão: “%s”)
Exemplos de uso:
“`
# Número básico: 00001
# Com prefixo: ORÇ-00001
# Com sufixo: 00001/2024
# Completo: ORÇ-00001/2024
# Específico para orçamentos
# Com 3 dígitos: 001
“`
### Outras Formas de Exibir o Número
Em templates PHP, você pode usar:
“`php
<?php echo get_post_meta(get_the_ID(), ‘_sequence_number’, true); ?>
“`
### Reiniciando a Sequência
Para reiniciar a sequência de um tipo de post específico:
1. Vá até Configurações > Post Numerator
2. Localize o card do tipo de post desejado
3. Clique no botão “Reiniciar Sequência”
4. Confirme a ação
5. A sequência será reiniciada e começará novamente do número inicial definido
## Configuração
– Cada tipo de post pode ser ativado/desativado individualmente
– Números são formatados como “00000” por padrão
– Os números são exibidos em uma meta box no editor de posts
– As sequências podem ser reiniciadas a qualquer momento
– O número inicial pode ser configurado para cada tipo de post
## Compatibilidade
– WordPress 5.0 ou superior
– PHP 7.2 ou superior
– Compatível com JetEngine
– Compatível com WooCommerce
– Funciona com qualquer tema WordPress
## Suporte
Para suporte ou solicitações de recursos, por favor crie uma issue no repositório do plugin.
## Autor
Elder Silva
## Licença
Este plugin está licenciado sob GPL v2 ou posterior.
## Changelog
### 1.0.0
– Lançamento inicial
– Funcionalidade básica de geração de números sequenciais
– Interface administrativa para gerenciar tipos de post
– Funcionalidade de reiniciar sequência
– Meta box no editor de posts
– Shortcode para exibição do número
– Suporte ao JetEngine
### 1.1.0
– Adicionado suporte a pedidos do WooCommerce
– Números sequenciais agora substituem os números padrão dos pedidos
– Melhorias na documentação
Avaliações
Não há avaliações ainda.