# Crocoblock — Referência Detalhada de Plugins

## JetElements

Widgets adicionais para Elementor. Não depende do JetEngine.

### Widgets Principais

| Widget | Uso |
|--------|-----|
| Animated Box | Caixa com flip/hover reveal |
| Circle Progress | Gauge circular animado |
| Timeline | Cronologia vertical/horizontal |
| Countdown Timer | Contador regressivo |
| Scroll Navigation | Navegação por secções |
| Maps | Google Maps avançado |
| Weather | Widget de meteorologia |
| Price List | Lista de preços |
| Progress Bar | Barra de progresso |
| Slider | Slider de imagens/conteúdo |
| Portfolio | Grid de portfolio com filtros |
| Testimonials | Slider de testemunhos |

---

## JetSmartFilters

Filtros AJAX para qualquer listing (JetEngine, WooCommerce, Archive).

### Tipos de Filtros

| Tipo | Quando Usar |
|------|-------------|
| Checkboxes | Categorias múltiplas |
| Radio | Opção única (ordenação) |
| Select | Dropdown de valores |
| Range | Preço, área (slider min-max) |
| Date Range | Filtrar por datas |
| Search | Pesquisa por texto |
| Rating | Filtrar por estrelas |
| Color Picker | Filtros visuais por cor |

### Configuração Essencial

```
1. Criar filter em JetSmartFilters > Filters
2. Seleccionar Source: JetEngine Query / WC_Query / WP_Query
3. Seleccionar Field: meta field / taxonomy / post field
4. Adicionar Filter Widget ao Elementor
5. Ligar ao Listing Grid via "Apply filters for" (seleccionar ID do listing)
```

### Filtros Aninhados (Dependent Filters)

```
Exemplo: Distrito → Concelho (filho depende do pai)
- Configurar taxonomy pai e filho no JetEngine
- Em JetSmartFilters: activar "Hierarchical taxonomy filter"
- Ou usar "Visible terms" com condição dinâmica
```

---

## JetWooBuilder

Templates custom para WooCommerce via Elementor.

### Templates Disponíveis

| Template | Substitui |
|----------|-----------|
| Shop (Archive) | Página principal da loja |
| Product | Single product page |
| Cart | Página de carrinho |
| Checkout | Página de checkout |
| My Account | Dashboard do cliente |
| Thank You | Página pós-compra |
| Category | Página de categoria |

### Widgets JetWooBuilder

```
Products Grid           # Grid de produtos com query custom
Product Price          # Preço com styling avançado
Product Gallery        # Galeria com thumbnails
Add to Cart            # Botão com variantes
Product Tabs           # Descrição, Reviews, Atributos
Related Products       # Produtos relacionados
Mini Cart              # Cart dropdown
```

### Configurar Template de Produto

```
1. JetWooBuilder > Templates > Add New
2. Template Type: Product
3. Editar com Elementor — arrastar widgets JetWoo
4. Conditions: incluir "Product" (todos) ou específico por categoria/tag
```

---

## JetFormBuilder

Forms com lógica condicional, integrações e notificações.

### Tipos de Campos

```
Text, Email, Tel, URL, Number, Textarea
Date, Time, DateTime
Select, Radio, Checkboxes
File Upload, Image Upload
Hidden Field, Calculated Field
Repeater Field (subformulário dinâmico)
```

### Acções Pós-Submit

| Acção | Função |
|-------|--------|
| Send Email | Notificação email standard |
| Send Email (Advanced) | Template HTML customizado |
| Create Post | Criar CPT (com JetEngine) |
| Update User | Actualizar user meta |
| Webhook | Enviar para n8n/Make/Zapier |
| Redirect | Redirecionar após submit |
| Register User | Criar conta WP |
| Login User | Login automático |
| MailChimp/ActiveCampaign | Subscrição newsletter |

### Formulário Silencioso (Para n8n)

```php
// Receber POST externo que passa pelas validações do JetFormBuilder
// Criar formulário com campos que correspondem ao payload
// Submeter via HTTP POST para: /wp-json/jet-form-builder/v1/process-form
// Autenticação: Application Passwords
```

---

## JetPopup

Popups com triggers e condições de display avançadas.

### Triggers

| Trigger | Config |
|---------|--------|
| On Page Load | Delay em segundos |
| Exit Intent | Detecta movimento para fora |
| Scroll to Element | Scroll até % ou selector CSS |
| Click on Element | Selector CSS do trigger |
| After Inactivity | Segundos sem interacção |
| After N Page Views | Contador de visitas |
| Once Per Session | Não repete na sessão |

### Conditions (Display)

```
URL match / URL contains
User logged in / out
User role
Device type (mobile/desktop)
WooCommerce: cart empty/not empty, specific product in cart
JetEngine: post type, taxonomy, specific post
```

---

## JetBooking

Sistema de booking com calendário de disponibilidade.

### Fluxo Base

```
1. Configurar Unidade de Booking (ex: Quarto, Serviço)
2. Definir preços (diários, por horas, temporada)
3. Definir disponibilidade e check-in/check-out rules
4. Criar template de booking com Elementor
5. Adicionar Calendário + Booking Form ao template
6. Configurar emails de confirmação
```

### Integração WooCommerce

```
JetBooking → WooCommerce Product → Checkout WooCommerce
- Preço calculado automaticamente (n noites × preço/noite)
- Stock = disponibilidade do calendário
```

---

## JetBlocks

Widgets para construir headers e footers com Elementor.

### Widgets Disponíveis

```
Navigation Menu        # Menu responsivo avançado
Site Logo             # Logo com dark mode toggle
Cart Button           # Contador de itens no carrinho
Search Box            # Pesquisa com AJAX
Auth Links            # Login/Logout dinâmico
User Name             # Nome do utilizador logado
Breadcrumbs           # Fil d'Ariane
Mobile Menu           # Menu hamburger
```

---

## JetThemeCore

Theme Builder alternativo ao Elementor Pro (para licenças Free).

### Templates

```
Header / Footer
Single (Posts, CPT)
Archive (Category, Tag, CPT Archive)
Search Results
404
```

### Diferença vs Elementor Pro Theme Builder

```
JetThemeCore: Gratuito, condições básicas
Elementor Pro: Mais condições, melhor integração com Popup Builder
Recomendação: Usar Elementor Pro se disponível
```

---

*Crocoblock Plugins Reference | Descomplicar® | 18-02-2026*
