--- name: elementor-pro-widgets description: Catálogo completo e verificado dos widgets nativos Elementor Pro (30 gerais + 5 WooCommerce) e como os descobrir/adicionar via EMCP Tools. Usar quando "widgets elementor pro", "que widgets pro existem", "loop grid", "nested tabs", "form elementor pro", "table of contents elementor", "portfolio elementor", "reviews carousel elementor". layer: wiki --- # /elementor-pro-widgets — Catálogo de Widgets Nativos Elementor Pro Catálogo obtido ao vivo via `list-widgets(tier:"pro")` num site Elementor Pro 4.0.0 (EMCP Tools), cruzado com a documentação oficial. Widget types testados como legacy (`add-free-widget`/`add-pro-widget` + `widget_type`), não atómicos — Elementor Pro ainda não migrou o catálogo completo para elementos atómicos 4.0. ## Como descobrir e adicionar (workflow) 1. `list-widgets({ tier: "pro" })` — confirma quais dos 30+5 abaixo estão realmente disponíveis nesta ligação (Elementor Pro tem de estar activo). 2. `get-widget-schema({ widget_type })` — parâmetros curados (obrigatórios, defaults, enums). **Campo é `widget_type`, não `type`.** 3. `add-pro-widget({ post_id, parent_id, widget_type, settings })` num container legacy (`add-container`), ou `add-free-widget` se a tool `add-pro-widget` estiver desligada nesse site (verificar com `list-widgets` primeiro — `tier:"pro"` a devolver resultados não implica que `add-pro-widget` esteja montada; é frequentemente a primeira tool fechada num deny-list de produção). 4. Ver skill `emcp-page-building` para as regras de coexistência atómico/legacy e para `batch-update`/`update-element` genérico. ## Catálogo — widgets gerais (30) | `widget_type` | Título | Uso | |---|---|---| | `form` | Form | Formulários de contacto/captação com tipos de campo configuráveis, acções de submissão | | `posts` | Posts Grid | Grelha pesquisável de posts/pages com contagem de colunas e paginação | | `countdown` | Countdown | Temporizador com modo data-limite ou evergreen, labels e mensagem de expiração custom | | `price-table` | Price Table | Tabela de plano de preços com moeda, preço promocional, lista de features, ribbon, CTA | | `flip-box` | Flip Box | Cartão de dois lados que vira ao hover, cada lado com gráfico/título/descrição | | `animated-headline` | Animated Headline | Título com efeito de destaque ou texto rotativo | | `call-to-action` | Call to Action | Bloco CTA com título, descrição, botão e gráfico/ribbon opcional | | `slides` | Slides | Slider hero full-width com heading/descrição/botão/background por slide | | `testimonial-carousel` | Testimonial Carousel | Carrossel rotativo de testemunhos com skins, layouts e navegação | | `price-list` | Price List | Lista tipo menu com título, preço, descrição, imagem e separador | | `gallery` | Gallery | Galeria de imagens avançada com layouts grid/justified/masonry e filtros | | `share-buttons` | Share Buttons | Botões de partilha social para a página actual com skins e formas | | `table-of-contents` | Table of Contents | Índice auto-gerado a partir dos headings da página, com marcação de secção activa | | `blockquote` | Blockquote | Citação estilizada com texto, atribuição de autor, opção de tweet | | `lottie` | Lottie Animation | Embed de animação Lottie JSON com triggers, loop, velocidade, renderer | | `hotspot` | Hotspot | Imagem interactiva com pontos clicáveis/hover configuráveis | | `nav-menu` | Navigation Menu | Menu de navegação WordPress com layouts, ponteiros de hover, breakpoint de dropdown | | `loop-grid` | Loop Grid | Posts/pages/CPTs em grelha renderizada por um loop template | | `loop-carousel` | Loop Carousel | Posts em carrossel renderizado por um loop template, responsivo | | `media-carousel` | Media Carousel | Carrossel de imagens/vídeos com skins carousel/slideshow/coverflow | | `nested-tabs` | Nested Tabs | Tabs modernas onde cada conteúdo de tab é um container populável livremente | | `nested-accordion` | Nested Accordion | Acordeão moderno onde cada item é um container populável livremente | | `portfolio` | Portfolio | Grelha filtrável de posts/CPTs para portfólio/trabalho, com modal | | `author-box` | Author Box | Avatar, nome, bio do autor do post e link para os posts dele | | `login` | Login | Formulário de login frontend com labels, remember-me, link de password perdida | | `code-highlight` | Code Highlight | Bloco de código com syntax highlight, linguagem, tema, números de linha | | `reviews` | Reviews | Carrossel de reviews/testemunhos com slides por vista, autoplay, loop | | `off-canvas` | Off-Canvas | Painel off-canvas deslizante com posição, largura, animação de entrada | | `progress-tracker` | Progress Tracker | Indicador de progresso de scroll (horizontal ou circular) | | `search` | Search | Input de pesquisa do site com dropdown de resultados ao vivo opcional e tabs por post-type | ## Catálogo — widgets WooCommerce (5) | `widget_type` | Título | Uso | |---|---|---| | `woocommerce-products` | WooCommerce Products | Grelha de produtos WooCommerce com colunas/linhas, ordenação | | `wc-add-to-cart` | WooCommerce Add to Cart | Botão de adicionar ao carrinho para um produto específico, com quantidade | | `woocommerce-cart` | WooCommerce Cart | Renderiza a página completa do carrinho WooCommerce | | `woocommerce-checkout-page` | WooCommerce Checkout | Renderiza a página completa de checkout WooCommerce | | `woocommerce-menu-cart` | WooCommerce Menu Cart | Ícone de mini-carrinho para o menu/header com indicador de itens | ## Notas - Este catálogo é o que `list-widgets(tier:"pro")` devolveu ao vivo — pode variar ligeiramente por versão do Elementor Pro; correr sempre `list-widgets` primeiro no site alvo em vez de confiar cegamente nesta tabela para um `widget_type` exacto. - `add-pro-widget` está frequentemente no deny-list de sites de produção (ver skill `emcp-tools` para o mecanismo). Se estiver desligada, reportar ao utilizador em vez de tentar contornar via `add-free-widget` com um `widget_type` Pro — normalmente falha da mesma forma (widget não registado para essa chamada). ## Skills relacionadas - `emcp-page-building` — sequência de construção de página, coexistência atómico/legacy, `batch-update`. - `elementskit-widgets` / `powerpack-widgets` — catálogos de addons de terceiros (não aparecem em `list-widgets`, exigem `get-widget-schema(..., full:true)`).