---
name: powerpack-widgets
description: Catálogo completo e verificado dos 97 widgets PowerPack Elements Pro para Elementor, com o widgetType real de cada um extraído do código-fonte (classes/class-pp-config.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 "powerpack", "pp-widget", "advanced menu elementor", "hotspots elementor", "flip box powerpack", "woo product elementor", "info box powerpack".
layer: wiki
---

# /powerpack-widgets — Catálogo de Widgets PowerPack Elements Pro

PowerPack Elements (Team IdeaBox, plugin `powerpack-elements`) regista os próprios widgets Elementor **fora** do catálogo curado do EMCP Tools — `list-widgets` não os lista. Este catálogo foi extraído directamente do array de configuração fonte (`wp-content/plugins/powerpack-elements/classes/class-pp-config.php`, método `get_widget_info()`) num site em produção com PowerPack Elements Pro 2.11.7 — **não adivinhado por convenção de nomes**, o que importa porque a convenção `pp-<nome-módulo>` tem excepções reais confirmadas (ver notas abaixo da tabela).

Catálogo completo (97 widgets) em `references/catalogo.md` — esta página tem o workflow e os widgets mais úteis para arranque rápido.

## Como usar (workflow)

1. Confirmar que `powerpack-elements` está activo: `list-plugins`, procurar o slug.
2. `get-widget-schema({ widget_type: "pp-<slug>", full: true })` — **não estão no catálogo curado**, a chamada sem `full:true` devolve erro "Not in the curated catalog". `full:true` devolve o schema de controlos bruto.
3. Adicionar com `add-free-widget({ post_id, parent_id, widget_type, settings })` num container **legacy** (`add-container`) — mesma mecânica de `elementskit-widgets`, sem equivalente atómico.
4. **Nunca assumir o `widgetType` pelo nome da pasta do módulo** — verificado no código-fonte: `Hotspots` → `pp-image-hotspots` (não `pp-hotspots`), `Onepage_Nav` → `pp-one-page-nav` (não `pp-onepage-nav`), `Popup_Box` (pasta `modal-popup`) → `pp-modal-popup`, `Link_Effects` → **`pa-link-effects`** (prefixo `pa-`, não `pp-`!). Confirmar sempre com `get-widget-schema(full:true)` antes de construir em produção — ver tabela completa para todas as excepções.

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

| `widgetType` | Título | Uso |
|---|---|---|
| `pp-info-box` | Info Box | ícone/imagem + título + descrição, muito usado em secções de features |
| `pp-flipbox` | Flip Box | cartão de dois lados com flip ao hover |
| `pp-advanced-menu` | Advanced Menu | menu de navegação avançado com mega-menu |
| `pp-image-hotspots` | Image Hotspots | pontos interactivos sobre imagem (excepção de nome — pasta `hotspots`) |
| `pp-pricing-table` | Pricing Table | tabela de preços |
| `pp-team-member` | Team Member | cartão de membro de equipa |
| `pp-testimonials` | Testimonials | testemunhos com carrossel |
| `pp-posts` | Advanced Posts | grelha/lista de posts avançada com query control |
| `pp-login-form` | Login Form | formulário de login frontend |
| `pp-business-hours` | Business Hours | horário de funcionamento |
| `pp-countdown` | Countdown Timer | temporizador |
| `pp-table-of-contents` | Table of Contents | índice automático |
| `pp-instafeed` | Instagram Feed | feed do Instagram |
| `pp-modal-popup` | Popup Box | popup modal (excepção de nome — pasta `modal-popup`) |
| `pp-woo-product-price` | Woo — Product Price | preço de produto WooCommerce, um de ~15 widgets `pp-woo-*` |

## Notas

- 15 dos 97 widgets são específicos WooCommerce (`pp-woo-*`) e só têm efeito útil com WooCommerce activo e no contexto de um produto/loja.
- Alguns módulos listados no directório `modules/` (`display-conditions`, `dynamic-tags`, `presets-style`, `query-control`, `devices`) são **extensões transversais**, não widgets autónomos — não aparecem no catálogo porque não têm `widgetType` próprio; afectam definições de outros widgets PowerPack (o mesmo padrão visto no `elementskit-widgets` com `ekit_cursor_text_label`).

## Skills relacionadas
- `emcp-page-building` — mecânica de coexistência atómico/legacy, sequência de construção.
- `elementor-pro-widgets` — catálogo nativo Elementor Pro (curado, no `list-widgets`).
- `elementskit-widgets` — catálogo do addon concorrente ElementsKit Lite (também fora do catálogo curado).