# Instalar no WordPress

> Instale o plugin SEVN Press, conecte o portal e confira se tudo funciona.

## O que você precisa

- WordPress 6.4 ou mais novo e PHP 7.4 ou mais novo.
- Um usuário administrador do WordPress.
- O arquivo do plugin (`sevn-ai.zip`) e as duas chaves do portal, enviados pela SEVN na contratação ou no teste grátis:
  - **Chave de API**: secreta. Liga o WordPress à SEVN. Nunca a coloque em páginas do site nem envie por e-mail aberto.
  - **Chave pública do site**: usada pelos recursos do leitor (resumo, áudio, Pergunte). Pode aparecer no HTML do site.

## 1. Instalar o plugin

1. No painel do WordPress, vá em **Plugins › Adicionar novo › Enviar plugin**.
2. Escolha o `sevn-ai.zip` e clique em **Instalar agora**.
3. Clique em **Ativar**.

## 2. Conectar o portal

Vá em **Configurações › SEVN Press** e preencha:

| Campo | O que colocar |
|---|---|
| URL da API | Deixe como está (`https://api-publishers.sevntech.com`), a menos que a SEVN peça outra |
| Chave de API | A chave secreta enviada pela SEVN |
| Chave pública do site | A chave pública enviada pela SEVN |

Clique em **Salvar alterações**. A mesma tela mostra o plano do portal, os módulos contratados e o uso do mês.

### Opção para a equipe técnica: chaves no `wp-config.php`

Em vez de salvar as chaves no painel, a equipe técnica pode defini-las no `wp-config.php`. Assim elas não ficam no banco do WordPress e ninguém no painel consegue vê-las ou mudá-las:

```php
define( 'SEVN_AI_API_KEY', 'a chave de API' );
define( 'SEVN_AI_SITE_KEY', 'a chave pública do site' );
```

Com as constantes definidas, os campos aparecem bloqueados na tela, com o aviso "Definida no wp-config.php".

## 3. Enviar o acervo

Os módulos que usam o acervo (Pergunte, links internos do Copiloto, Leia também) precisam das matérias antigas. Em **Configurações › SEVN Press**, seção **Acervo**, clique em **Importar acervo**. A tela mostra antes quantas matérias serão enviadas; a importação roda em segundo plano, em lotes de 50, pode ser pausada e não conta na cota do plano. Resumo, Pacote Social e tradução são gerados sozinhos só para as matérias dos últimos 7 dias, e o áudio só para as dos últimos 2 dias. Matérias novas e editadas vão sozinhas, no momento da publicação.

## 4. Conferir

- Abra uma matéria no editor: o painel **SEVN Press** aparece na lateral.
- Publique uma matéria de teste (com "[TESTE]" no título): o resumo aparece no topo da matéria (o padrão é publicar sozinho) e o Pacote Social chega para revisão.
- No site, os widgets do leitor aparecem sozinhos no topo e no fim das matérias. Para escolher outro lugar, use `<div data-sevn-ai="summary"></div>`, `data-sevn-ai="audio"`, `data-sevn-ai="ask"` ou `data-sevn-ai="related"` no tema.

## Atualizações

O plugin se atualiza pelo próprio WordPress: quando sai uma versão nova, ela aparece em **Painel › Atualizações** como qualquer plugin. A SEVN avisa antes de mudanças importantes.

## Problemas comuns

- **"Chave de API não configurada"**: a chave não foi salva. Confira em **Configurações › SEVN Press**.
- **Módulo não aparece no menu**: ele não faz parte do plano do portal. Fale com a SEVN.
- **Aviso de limite do plano**: a cota do mês está perto do fim ou acabou. Veja [Planos e limites](https://docs-press.sevntech.com/comecar/planos-e-limites/).