claude-plugins/wordpress/skills/element-pack-widgets/SKILL.md

---
name: element-pack-widgets
description: Catálogo completo e verificado dos widgets Element Pack Pro (BdThemes) para Elementor — 168 widgets core (`element_pack_active_modules`) + 95 widgets de integração com plugins de terceiros, com o widgetType real de cada um extraído do código-fonte (`get_name()` em `modules/<slug>/widgets/*.php`) — não estão no catálogo curado do EMCP Tools (list-widgets), por isso precisam de get-widget-schema com full:true. Usar quando "element pack", "bdt-widget", "advanced heading elementor", "mega menu elementor", "custom carousel elementor", "brand grid", "crypto currency widget".
layer: wiki
---

# /element-pack-widgets — Catálogo de Widgets Element Pack Pro (BdThemes)

Element Pack Pro (plugin `bdthemes-element-pack`, activo em **descomplicar.pt**, v9.8.12) regista
os próprios widgets Elementor **fora** do catálogo curado do EMCP Tools — `list-widgets` não os
lista e `get-widget-schema` sem `full:true` devolve `"Not in the curated catalog"`.

Catálogo extraído directamente de `get_name()` em cada `modules/<slug>/widgets/*.php`, num site em
produção — **não adivinhado por convenção de nomes**, o que importa porque a convenção
`bdt-<slug-do-módulo>` tem 11 excepções reais confirmadas (ver `references/catalogo.md`). Catálogo
completo (168 core + 95 integração) em `references/catalogo.md`.

## Como usar (workflow)

1. Confirmar que `bdthemes-element-pack` está activo: `list-plugins`, procurar o slug (ou
   `wp option get element_pack_active_modules --format=json` via SSH para ver módulos on/off).
2. `get-widget-schema({ widget_type: "bdt-<slug>", full: true })` — **sempre `full:true`**, nunca
   confiar no catálogo curado. Devolve o schema de controlos real e vivo do widget (responsivo,
   condições de exibição, efeitos).
3. Adicionar com `add-free-widget({ post_id, parent_id, widget_type, settings })` num container
   **legacy** (`add-container`) — mesma mecânica de `elementskit-widgets`/`powerpack-widgets`, sem
   equivalente atómico v4.
4. **Nunca assumir o `widgetType` pela pasta do módulo** — confirmado no código-fonte, 11 excepções
   reais: `we-forms` → `bdt-we-form` (singular), `gravity-forms` → `bdt-gravity-form`,
   `ninja-forms` → `bdt-ninja-form`, `edd-download-history` → `bdt-easy-digital-download-history`,
   `edd-profile-editor` → `bdt-easy-digital-profile-editor`, `edd-purchase-history` →
   `bdt-easy-digital-purchase-history`, `events-calendar-carousel/grid/list` → `bdt-event-*` (sem
   "calendar"), `fooevents-calendar` → `fooevents-calendar` (sem prefixo `bdt-`). E **um caso não
   resolvido**: `lightbox` resolve para `widgetType: "lightbox"` no código, mas `get-widget-schema`
   devolve 0 propriedades para `bdt-lightbox` e uma resposta anormalmente grande (1624 propriedades
   — provável fallback do EMCP, não o schema real) para `lightbox`; tratar como **não confirmado**
   até verificar directamente numa página de teste antes de usar em produção.
5. Testado ponta-a-ponta em produção (19-08-2026): página draft → `add-container` →
   `add-free-widget` com `bdt-advanced-heading` → `get-page-structure`/`get-element-settings`
   confirmaram persistência → limpeza da página de teste.

## Widgets mais usados (ver `references/catalogo.md` para os 168+95 completos)

| `widgetType` | Título | Uso |
|---|---|---|
| `bdt-advanced-heading` | Advanced Heading | título com sub-heading, split text, efeitos de fundo |
| `bdt-custom-carousel` | Custom Carousel | carrossel genérico de slides imagem/vídeo/template |
| `bdt-mega-menu` | Mega Menu | menu mega multi-coluna, requer `element_pack_other_settings.mega-menu = on` |
| `bdt-brand-grid` / `bdt-brand-carousel` | Brand Grid/Carousel | logótipos de marcas em grelha/carrossel |
| `bdt-price-table` | Price Table | tabela de preços |
| `bdt-flip-box` | Flip Box | cartão com flip ao hover |
| `bdt-testimonial-carousel` | Testimonial Carousel | testemunhos em carrossel |
| `bdt-countdown` | Countdown | temporizador de contagem decrescente |
| `bdt-crypto-currency-ticker` | Crypto Ticker | ticker de criptomoedas em tempo real |
| `bdt-post-grid` | Post Grid | grelha de posts com query control |
| `bdt-timeline` | Timeline | linha do tempo vertical/horizontal |
| `bdt-table-of-content` | Table of Content | índice automático da página |
| `bdt-instagram` | Instagram Feed | feed do Instagram |
| `bdt-svg-maps` | SVG Maps | mapas SVG interactivos por região |
| `bdt-review-card` | Review Card | cartão de avaliação/review |

## Notas

- 168 widgets são **core**, controlados por `element_pack_active_modules` (todos `on` neste site
  excepto `cookie-consent`, verificado 19-08-2026) — ver `mcp-element-pack` para ligar/desligar via
  MCP dedicado.
- 95 widgets são **de integração**: só funcionam com o plugin de terceiros correspondente activo
  (ACF, bbPress, BuddyPress, Charitable, Easy Digital Downloads, The Events Calendar, Tutor LMS,
  WooCommerce, Give, LearnPress, vários plugins de formulários). Confirmar o plugin dependente antes
  de inserir — `add-free-widget` não valida isto, pode inserir um widget "órfão" que não renderiza.
- `mega-menu` é widget **e** módulo de outros_settings — o widget só produz saída com
  `element_pack_other_settings['mega-menu'] = 'on'` (hoje `off` em produção); confirmar/activar via
  `mcp-element-pack` antes de o usar.

## Skills relacionadas
- `mcp-element-pack` — MCP dedicado para gerir licença/módulos/mega-menu/white-label/custom-code
  do Element Pack Pro em descomplicar.pt via WP-CLI/SSH (não cobre inserção de widgets).
- `emcp-page-building` — mecânica de coexistência atómico/legacy, sequência de construção.
- `elementskit-widgets` / `powerpack-widgets` — catálogos dos addons concorrentes, mesmo padrão de
  descoberta (`full:true` obrigatório, fora do catálogo curado).