feat(wordpress): adiciona plugin wordpress (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:51 +00:00
parent a32752df8a
commit 63b1d79095
58 changed files with 7380 additions and 0 deletions
@@ -0,0 +1,130 @@
+---
+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.
+layer: wiki
+---
+
+# /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