---
name: crocoblock
description: Desenvolvimento com o ecossistema Crocoblock e todos os JetPlugins para Elementor. Cobre selecção, licenciamento, instalação, configuração e integração entre JetEngine, JetSmartFilters, JetWooBuilder, JetElements, JetPopup, JetFormBuilder e mais.
---

# /crocoblock — Ecossistema Crocoblock + JetPlugins

Desenvolvimento com o ecossistema Crocoblock: suite de plugins para Elementor cobrindo CPT, filtros AJAX, WooCommerce, forms, popups, booking e muito mais.

## Matriz de Plugins

| Plugin | Função Principal | Quando Usar |
|--------|-----------------|-------------|
| **JetEngine** | CPT, Meta Boxes, Relations, Query Builder, Listings, Dynamic Content | Qualquer site com conteúdo dinâmico/estruturado |
| **JetSmartFilters** | Filtros AJAX para listings e arquivos | Catálogos, portfolios, diretórios filtráveis |
| **JetWooBuilder** | Templates WooCommerce com Elementor | Lojas com design personalizado de produto/categoria/checkout |
| **JetElements** | Widgets adicionais (Timeline, Progress Bar, Circle Progress, Maps) | Adicionar widgets não disponíveis no Elementor base |
| **JetPopup** | Popups com triggers avançados | Lead capture, notificações, banners condicionais |
| **JetFormBuilder** | Forms com lógica condicional + notificações | Formulários complexos, integração CRM, booking light |
| **JetTabs** | Tabs, Accordions, Toggle | Conteúdo tabulado interactivo |
| **JetBlocks** | Widgets para header/footer (nav, cart, search) | Cabeçalhos e rodapés custom no Theme Builder |
| **JetSearch** | Pesquisa AJAX avançada | Sites com necessidade de search instantâneo |
| **JetBooking** | Sistema de booking/reservas | Alojamento, serviços com calendário de disponibilidade |
| **JetThemeCore** | Theme Builder alternativo ao Elementor Pro | Theme Builder sem licença Elementor Pro |
| **JetReviews** | Reviews/ratings para qualquer CPT | Reviews além de WooCommerce |
| **JetTricks** | Efeitos visuais (parallax, hotspot, unfold) | Elementos visuais avançados |
| **JetCompareWishlist** | Comparar e wishlist para produtos/CPT | E-commerce ou catálogos com comparação |

## Licença e Instalação

### Subscrição Crocoblock

```
Planos: Single Site / 3 Sites / Unlimited Sites (anual ou lifetime)
Todos os planos incluem todos os plugins + atualizações
Dashboard: account.crocoblock.com > Downloads
```

### Instalação (CWP)

```bash
PHP="/opt/alt/php-fpm83/usr/bin/php"
WP="$PHP /usr/local/bin/wp --allow-root --path=/home/USER/public_html"

# 1. Upload do ZIP via WP Admin ou WP-CLI
$WP plugin install /tmp/jet-engine.zip --activate

# 2. Activar licença (via WP Admin > JetPlugins Licences)
# Cada plugin tem campo de licença separado
# Ou activar globalmente em Crocoblock > License

# 3. Verificar versões
$WP plugin list --search="jet*" --fields=name,version,status --format=table
```

### Ordem de Instalação Recomendada

```
1. JetEngine          (base do ecossistema — criar antes de outros)
2. JetSmartFilters    (depende do JetEngine para filtrar listings)
3. JetElements        (widgets independentes)
4. JetWooBuilder      (se WooCommerce presente)
5. JetFormBuilder     (forms independentes)
6. JetPopup           (depende de Elementor Pro ou JetThemeCore)
7. JetBlocks          (apenas se Theme Builder activo)
8. Restantes          (conforme necessidade)
```

## Integrações Principais

### JetEngine + JetSmartFilters (padrão mais comum)

```
JetEngine Query Builder → Listing Grid → JetSmartFilters
                                              ↑
                              Filtros ligados ao mesmo Query Builder ID
```

**Passos:**
1. Criar CPT no JetEngine
2. Criar Query Builder (tipo: Posts)
3. Criar Listing Template com Elementor
4. Adicionar Listing Grid ao Elementor (apontar para o Query)
5. Adicionar Filter Widget e ligar ao mesmo Listing Grid

### JetEngine + JetWooBuilder

```
CPT Produto (WooCommerce) → JetEngine Meta Boxes → JetWooBuilder Template
                                                          ↑
                                        Campos custom visíveis no template
```

### JetEngine + JetFormBuilder

```
JetFormBuilder → Submit → Create/Update JetEngine Post
                       → Notificação email
                       → Redirect
```

### JetPopup Triggers Disponíveis

| Trigger | Uso |
|---------|-----|
| On page load | Newsletter, anúncio |
| Exit intent | Retenção de visitante |
| Scroll (%) | Conteúdo contextual |
| Click on element | Mais informação inline |
| After inactivity | Re-engagement |
| User logged in/out | Conteúdo condicional |

## Dify KB — Consultar Antes de Implementar

```javascript
// Dataset Crocoblock (primário)
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "bdf85c26-1824-4021-92d1-be20501b35ac",
  query: "[componente ou funcionalidade]"
})

// Dataset Crocoblock alternativo
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "139cdf67-afce-46ec-9ccd-2a06040e5b9d",
  query: "[componente ou funcionalidade]"
})
```

## Troubleshooting Comum

### Plugin não activa após upload

```bash
# Verificar se Elementor está activo (dependência)
$WP plugin list --search=elementor --fields=name,status

# Verificar erros PHP
$WP eval 'error_reporting(E_ALL); ini_set("display_errors", 1);' --allow-root --path=$PATH

# Limpar transients após activar
$WP transient delete --all --allow-root --path=$PATH
```

### Conflito entre versões

```
Regra: Manter todos os JetPlugins na mesma major version
Verificar: account.crocoblock.com > Changelogs para breaking changes
```

### Listings não actualizam após filtrar

```bash
# Regenerar CSS Elementor
$WP elementor flush-css --regenerate --allow-root --path=$PATH

# Limpar cache de objecto
$WP cache flush --allow-root --path=$PATH
```

## Padrões de Uso por Tipo de Site

### Site Corporativo / Portfolio

```
JetEngine (CPT: Projecto, Serviço, Testemunho)
+ JetSmartFilters (filtrar por categoria/tag)
+ JetElements (timeline, animações)
```

### E-commerce Avançado

```
WooCommerce + JetEngine (meta boxes extra)
+ JetWooBuilder (templates produto, categoria, cart)
+ JetCompareWishlist
+ JetSmartFilters (filtros loja)
```

### Directório / Listagem de Negócios

```
JetEngine (CPT: Negócio, com Relations para Categoria/Localização)
+ JetSmartFilters (filtros AJAX por localização, categoria, preço)
+ JetSearch (pesquisa instantânea)
+ JetEngine Maps (mapa de listagens)
```

### Portal com Accounts de Utilizador

```
JetEngine (CPT, Profile Builder)
+ JetFormBuilder (submissão de conteúdo por utilizador)
+ JetEngine Relations (conteúdo associado ao utilizador)
```

### Site com Reservas

```
JetBooking (calendário + disponibilidade)
+ JetFormBuilder (form de reserva)
+ JetEngine (meta boxes de propriedade/serviço)
```

## JetEngine MCP Server (v3.8.0+)

A partir do JetEngine 3.8.0, existe integração nativa com agentes IA via **MCP Server**:

```
WP Admin > JetEngine > AI Command Center > Enable MCP Server
→ Claude pode inspecionar schema completo (CPTs, CCTs, Relações, Queries)
→ e criar/modificar estruturas via linguagem natural
```

Usar `references/automation.md` para detalhes sobre Formless Actions, JetSmartFilters Indexer e pipelines de automação.

## Referências Adicionais

- **`references/plugins.md`** — Referência detalhada de cada plugin (widgets, configurações, casos de uso avançados)
- **`references/patterns.md`** — Padrões de integração avançados (multi-relation, filtros aninhados, profile builder completo)
- **`references/automation.md`** — MCP Server nativo, JetFormBuilder Formless Actions, JetSmartFilters Indexer, Kits export/import, cache e riscos críticos

---

**Versão**: 1.1.0 | **Autor**: Descomplicar® | **Data**: 18-02-2026

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
