Opiny - Plugin para WordPress

Integre widgets de pesquisa da Opiny (NPS, Avaliações, Reporte de Bugs) no seu site WordPress em segundos, sem precisar editar código.

Este plugin permite gerenciar múltiplas pesquisas simultaneamente e definir regras de exibição específicas para cada uma (ex: mostrar apenas na Home, ou apenas em artigos do blog).

🚀 Funcionalidades

Integração Fácil: Basta colar o ID da pesquisa gerado no painel da Opiny.

Múltiplos Widgets: Adicione quantas pesquisas quiser no mesmo site.

Controle de Exibição: Defina exatamente em quais páginas cada pesquisa deve aparecer usando regras de caminho simples.

Performance: O script é injetado de forma assíncrona no rodapé, não afetando a velocidade de carregamento do seu site.

📦 Instalação

Opção 1: Via Painel do WordPress (Recomendado)

• Baixe o arquivo .zip deste plugin no diretório /opiny.

• No painel do seu WordPress, vá para Plugins > Adicionar Novo.

• Clique no botão Enviar Plugin no topo da tela.

• Selecione o arquivo ZIP e clique em Instalar Agora.

• Após a instalação, clique em Ativar Plugin.

Opção 2: Instalação Manual (FTP/SFTP)

• Descompacte o arquivo do plugin.

• Faça upload da pasta opiny-feedback para o diretório /wp-content/plugins/ do seu servidor.

• Acesse o menu Plugins no WordPress e ative o Opiny - Feedback & Pesquisas.

⚙️ Configuração

Após ativar o plugin, você verá um novo item no menu lateral chamado Opiny.

• Acesse Opiny no menu lateral.

• Clique no botão + Adicionar Pesquisa.

Preencha os campos:

1. Survey ID (ID da Pesquisa)

Este é o código único da sua pesquisa.

• Acesse o painel da Opiny (https://www.google.com/search?q=app.opiny.com.br).

• Entre na pesquisa desejada.

• Vá na aba "Instalação" ou copie o ID da URL ou das configurações.

• Exemplo: cmjt5c5d00003jr0wngf8kjga

2. Regra de Exibição (Caminho)

Defina onde o widget deve aparecer. O plugin compara a URL atual do usuário com esta regra.

📍 Regras de Caminho (Patterns)

Regra	Onde aparece?
*	Todas as páginas do site.
/	Apenas na Página Inicial (Home).
/contato	Apenas na página exata /contato.
/blog/*	Em todas as páginas que começam com /blog/ (ex: /blog/post-1, /blog/categoria/tech).
/produtos/*	Em todos os produtos da loja.

❓ Perguntas Frequentes

O widget não está aparecendo, o que fazer?

• Verifique se o Survey ID está correto e não contém espaços em branco.

• Verifique se a Regra de Exibição corresponde à página que você está visitando.

• No painel da Opiny, certifique-se de que a pesquisa está com status ATIVA.

• Limpe o cache do seu site (se utilizar plugins como WP Rocket, Autoptimize, etc).

Posso colocar duas pesquisas na mesma página?

• Sim, mas recomendamos cautela para não poluir a experiência do usuário. O plugin injetará ambos os scripts se as regras de caminho coincidirem.

O plugin deixa o site lento?

• Não. O script da Opiny (SDK) é leve e carregado de forma diferida (assíncrona) no rodapé da página (wp_footer), garantindo que o conteúdo principal carregue primeiro.

📝 Licença

Este projeto está licenciado sob a licença GPLv2.