manifest / ai / prompt_builder

Prompt Builder

Plugin WordPress que gera prompts estruturados para posts

by Arthur Felizdoro · github.com/arthurfelizdoro/prompt_builder

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/arthurfelizdoro/prompt_builder/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/arthurfelizdoro/prompt_builder ↗

Um plugin WordPress intuitivo para gerar prompts estruturados para Inteligências Artificiais.

📄 Descrição

Prompt Builder é um plugin WordPress criado para facilitar a geração de prompts para ferramentas de Inteligência Artificial.

Desenvolvido como parte do Desafio Técnico – Desenvolvedor(a) Full Stack WordPress, o plugin foi inteiramente elaborado com o auxílio de técnicas de IA (Gemini), incluindo a correção ortográfica e geração deste arquivo.

⚙️ Funcionalidades

✅ Geração de Prompts Estruturados
Crie prompts detalhados a partir de um briefing base, combinando com múltiplos requisitos definidos pelo usuário.

✅ Adição Dinâmica de Requisitos
Adicione ou remova campos de requisitos (em formato chave:valor) em tempo real.

✅ Criação de Rascunhos de Post
Transforme o prompt gerado (ou a resposta da IA) em um rascunho de post WordPress com apenas um clique.

✅ Integração com API de IA
Conecte o plugin à sua chave de API de IA (como Gemini) e envie prompts diretamente do WordPress.

🌍 Internacionalização
Pronto para tradução com suporte ao text-domain.

🧩 Instalação

📦 Instalação Manual

Baixe o arquivo .zip do plugin. (https://drive.google.com/file/d/1k7vm4Gzck1agaK9ayMjvRefiBTnoHoKk/view?usp=sharing)
No painel do WordPress, vá em Plugins > Adicionar Novo > Carregar Plugin.
Envie o .zip e clique em Instalar Agora.
Após instalado, clique em Ativar Plugin.

🔑 Configuração da API

No painel do WordPress, acesse Ferramentas > Prompt Builder.
Na seção "Configurações da API da IA", insira sua chave de API.

A chave deve ser solicitada ao desenvolvedor.
Clique em Salvar.

✨ Como Usar

Acesse Ferramentas > Prompt Builder.
Em Briefing, insira a ideia central do prompt.
Em Requisitos, adicione pares de chave:valor (ex: Tom: Formal, Público: Desenvolvedores).
Clique em Gerar Prompt para visualizar o resultado.

Após isso, você pode:

✅ Clicar em Criar Rascunho de Post para salvar como post.
🤖 Clicar em Pedir pra IA para enviar à API e receber a resposta diretamente na interface.

🧪 Desenvolvimento e Testes

Este plugin inclui testes unitários com PHPUnit para garantir a estabilidade e funcionalidade da geração de prompts.

🔧 Pré-requisitos

Ambiente de teste WordPress configurado.
Recomenda-se o uso de wp-env ou configuração manual com wp-cli e install-wp-tests.sh.

🚀 Usando `wp-env`

Instale o Docker Desktop e o pacote global @wordpress/env:
```
npm install -g @wordpress/env
```

Crie um arquivo .wp-env.json na raiz do projeto (caso não exista):

{
  "plugins": [
    "."
  ],
  "tests": {
    "php": "latest"
  }
}

Inicie o ambiente de testes:
```
wp-env start
```

Execute os testes:

wp-env run cli phpunit tests/

Ou um teste específico:

wp-env run cli phpunit tests/test-pb-gerar-prompt.php

📁 Arquivos de Teste

Os testes estão localizados em:
tests/test-pb-gerar-prompt.php
Os cenários testam a função pb_gerar_prompt com diferentes combinações de briefing e requisitos.