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

name, description, layer

name	description	layer
element-pack-widgets	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".	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).