# Elementor

Editor visual Elementor no seu WordPress: páginas, modelos e estilos globais editáveis elemento por elemento via MCP.

Fonte: https://ardumaker.com/pt/docs/elementor/

- Categoria: Servidores e infraestrutura
- Estado: Disponível
- Requisitos: Um site [WordPress](https://ardumaker.com/pt/docs/wordpress) instalado como app; O plugin Elementor ativo (Elementor Pro para condições de modelo)
- Ferramentas MCP (Escrevem ou modificam): `controlar_cache_wordpress`, `probar_web_wordpress`, `instalar_app`
- Ferramentas MCP (Destrutivas): `editar_elementor_wordpress`, `editar_diseno_elementor_wordpress`, `editar_contenido_wordpress`, `editar_archivos_wordpress`

## O que permite fazer?

O Elementor é a variante de editor visual de um site WordPress. A ArduMaker o instala ao criar o site e depois permite editar o design elemento por elemento, sem abrir o editor: o agente lê a estrutura da página, muda o necessário e a plataforma regenera o CSS.

- Ver a estrutura de uma página ou modelo com os ids de cada elemento.
- Adicionar, modificar, mover, duplicar ou apagar elementos, ou substituir a árvore inteira.
- Mudar estilos, cores, tipografias, margens, valores por dispositivo (`_tablet`, `_mobile`) e conteúdo dinâmico.
- Criar modelos (header, footer, página, seção, popup) e editar os estilos globais do kit.

## Quando convém usar?

- Redesenhar ou ajustar páginas de um site feito com Elementor a partir de um agente de IA.
- Mudar cores e tipografias do site inteiro de uma vez.
- Duplicar uma página como base de outra (copia também seus metadados do Elementor).

## Como funciona na ArduMaker?

Com `config.extras` incluindo `elementor`, ao criar o site são instalados e ativados o plugin `elementor` e seu tema base `hello-elementor` a partir do wordpress.org.

1. O campo `_elementor_data` da página é lido com wp-cli.
2. A mudança é aplicada na árvore de elementos (um patch de `settings`; `null` apaga uma chave).
3. É escrito de volta por stdin e a página fica em modo Elementor.
4. O CSS do Elementor é regenerado.

## O que muda realmente?

Muda o metadado `_elementor_data` da página ou modelo e, para o design global, a configuração do kit ativo (`system_colors`, `custom_colors`, `system_typography`, `custom_typography`, `custom_css`). Tudo vive no banco do site.

> **PRECAUCION:** `reemplazar` troca a árvore inteira da página: convém um backup do site antes.

## Esquema

**Edição de uma página Elementor**

```text
Agente (`editar_elementor_wordpress` com `post_id` e ação)
  ↓
wp-cli (lê `_elementor_data`)
  ↓
Árvore de elementos (adicionar, modificar, mover, duplicar, apagar)
  ↓
wp-cli (escreve por stdin e regenera o CSS)
```

## Resultado esperado

A página publicada mostra a mudança. Para conferir antes e depois, `probar_web_wordpress` captura a página em desktop, tablet ou celular.

## Erros e resolução

- `wordpress_comando_fallido` (422): o wp-cli não conseguiu ler ou escrever a página; a saída cortada diz por quê.
- Se a mudança não aparecer, `controlar_cache_wordpress` com `elementor` limpa o CSS do Elementor (também transientes, cache de objetos e regras de reescrita).
- As condições de um modelo só se aplicam com Elementor Pro.
- Se a variante não pôde ser instalada ao criar o site: `wordpress_variantes_no_instaladas`, pode ser repetida.

## Relação com MCP

O Elementor é editado pelo domínio [/mcp/wordpress](https://ardumaker.com/pt/mcp/wordpress) (referência geral em [/mcp/docs](https://ardumaker.com/pt/mcp/docs)). As duas ferramentas modificam o site, então um agente somente leitura não as vê.

- `editar_elementor_wordpress`: uma página ou modelo (`post_id`) com `ver` (`full` para todos os settings), `agregar`, `modificar`, `mover`, `duplicar`, `eliminar` ou `reemplazar`.
- `editar_diseno_elementor_wordpress`: `listar_plantillas`, `crear_plantilla`, `ver_estilos`, `cambiar_estilos`.
- Complementos: `editar_contenido_wordpress` (duplicar páginas), `editar_archivos_wordpress` com `guardar_codigo_global` (CSS e JS do site inteiro), `controlar_cache_wordpress`.
- Instalar: `instalar_app` com `config.extras: ["elementor"]`.

## Funcionalidades relacionadas

- [WordPress](https://ardumaker.com/pt/docs/wordpress/)
- [WooCommerce](https://ardumaker.com/pt/docs/woocommerce/)
- [Servidor MCP](https://ardumaker.com/pt/docs/servidor-mcp/)