Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/everbero/catalog-access-gate/archive/refs/heads/main.zipPlugin WordPress para proteger downloads de catálogos PDF, liberando acesso somente após o envio de um formulário do Elementor Pro.
Inclui gerenciamento de catálogos, geração automática de thumbnail da primeira página do PDF, links de download protegidos e shortcodes prontos para exibição.
Funcionalidades
- Liberação de acesso após envio de formulário do Elementor Pro
- Controle de acesso por cookie
- Página de downloads protegida
- Upload e gerenciamento de catálogos no painel WordPress
- Geração automática de thumbnail da página 1 do PDF
- Botão de download estilizado
- Shortcodes para inserir catálogos em qualquer página
- Links de download protegidos por token e nonce
- Pasta de arquivos protegida automaticamente
- Bloqueio de indexação da página de downloads
- Interface simples para gestão de catálogos
Como funciona
- O visitante preenche um formulário do Elementor.
- O plugin grava um cookie liberando o acesso.
- O visitante é redirecionado para a página de downloads.
- Os catálogos aparecem na página via shortcode.
- O download é validado pelo plugin antes de liberar o arquivo.
Requisitos
- WordPress 6+
- Elementor
- Elementor Pro
Para geração automática de thumbnails:
- Imagick
- Ghostscript
Se o servidor não possuir essas extensões, o plugin continuará funcionando normalmente, apenas sem gerar a capa do catálogo.
Instalação
- Copie a pasta do plugin para:
wp-content/plugins/catalog-access-gate
-
Ative o plugin no painel do WordPress.
-
Acesse:
Configurações → Catálogo Access Gate
Configuração
Defina os seguintes parâmetros:
Nome do formulário
Nome do formulário configurado no widget Form do Elementor.
Exemplo:
Download de Catálogo
Página de downloads protegida
Página onde os catálogos serão exibidos.
Página de redirecionamento
Página para onde o usuário será enviado caso tente acessar a página protegida sem autorização.
Validade do cookie
Tempo em dias que o acesso permanecerá liberado.
Upload de catálogos
Na aba Catálogos do plugin:
- Informe o título do catálogo
- Selecione o arquivo PDF
- Envie
O plugin irá automaticamente:
- salvar o PDF
- gerar a thumbnail da primeira página
- registrar o catálogo
- disponibilizar um shortcode
Usando os catálogos
Cada catálogo possui um shortcode.
Exemplo:
[cag_catalog id="1"]
Personalizando o botão:
[cag_catalog id="1" label="Baixar catálogo"]
Adicionando classes CSS:
[cag_catalog id="1" label="Baixar catálogo" class="botao-custom"]
Exibição padrão
O shortcode renderiza automaticamente:
- thumbnail do catálogo
- título do catálogo
- botão azul de download
Estrutura do plugin
catalog-access-gate
│
├─ catalog-access-gate.php
│
├─ assets
│ └─ cag-style.css
│
└─ includes
├─ class-cag-plugin.php
├─ class-cag-helpers.php
├─ class-cag-installer.php
├─ class-cag-admin.php
├─ class-cag-elementor.php
├─ class-cag-access-control.php
├─ class-cag-downloads.php
└─ class-cag-catalog-manager.php
Segurança
O plugin implementa diversas camadas de proteção.
Proteção de página
A página de downloads só pode ser acessada após envio do formulário.
Proteção de download
Os downloads utilizam:
- nonce
- token de validação
- verificação de cookie
Proteção de arquivos
Os PDFs são armazenados em:
wp-content/uploads/cag-protected
A pasta possui .htaccess para impedir acesso direto.
Thumbnails dos catálogos
Se o servidor possuir Imagick + Ghostscript, o plugin gera automaticamente:
catalogo.pdf
catalogo-thumb.jpg
A thumbnail corresponde à primeira página do PDF.
Caso a geração não seja possível, o plugin continua funcionando normalmente.
Customização visual
O botão padrão utiliza a classe:
.cag-download-button
Você pode sobrescrever o estilo via CSS do tema.
Changelog
2.0.0
- Sistema completo de gerenciamento de catálogos
- Upload de PDFs pelo painel
- Geração automática de thumbnail
- Links de download protegidos
- Shortcodes dinâmicos
- Estrutura modular do plugin
- Melhorias de segurança
Autor
3X Web Desenvolvimento Digital