<< tópico anterior	próximo tópico>>

Enquetes

O Enquetes, software de gerenciamento de enquetes, permite a você inserir painéis de votação em seu site e mostrar os resultados das pesquisas em gráficos de barra. Tem também o recurso de bloquear o voto de um usuário pelo mesmo IP por 30 minutos. Isso evita que o usuário dê um "back" no browser e vote duas ou mais vezes seguidas.

Observação:
Por favor leia atentamente todas as explicações sobre a instalação e uso do Enquetes nesta página antes de enviar sua dúvida à equipe técnica.

O processo de votação é o seguinte:

Já para fazer usar uma enquete em seu site, os passos são os seguintes:

1. Instalar o Enquetes em sua conta de hospegadem.

2. Criar uma enquete.

3. Inserir os códigos PHP (ou SSI) do painel de votação e tabela de resultados nas páginas de seu site.

Instalando o gerenciador de enquetes

Antes de instalar o Enquetes em sua conta, certifique-se de que você já tenha aberto um banco de dados MySQL através da função MySQL do Painel de Controle.

1. Clique na função Enquetes de seu painel de controle. A tela de gerenciamento do Enquetes aparecerá.

2. Escreva a senha do banco de dados no campo apropriado. É a senha que estava em vigor para o Painel de Controle/FTP/SSH quando você pediu para instalar o banco de dados MySQL em sua conta. Essa senha não muda, mesmo você alterando a senha do Painel de Controle/FTP/SSH posteriormente. Se você não lembra da senha, por favor entre em contato com o pessoal de suporte.

3. Clique no botão Instalar Enquetes. A tela será recarregada informando o sucesso da operação. Clique no link e você irá para a tela de administração do Enquetes.

Feita a instalação do Enquetes em sua conta, um novo diretório será acrescentado na raiz de sua web, enquetes/. A título de curiosidade, dentro desse diretório há os seguintes arquivos:

• barra.gif: é o arquivo gráfico de dimensão 1x11 pixels que é usado para formar o gráfico de barras das estatísticas de voto. Você pode editar esse arquivo se quiser, por exemplo, alterar a cor da barra.

• enquete.phtml: script PHP que gera o painel de votação das enquetes.

• votar.phtml: script que computa os votos e coleta as estatísticas.

• resultados.phtml: mostra a tabela de resultados da enquete.

O subdiretório admin/ vai para a página de administração e requer acesso autenticado. Use o login e a senha de sua conta.

Criando uma nova enquete

1. Siga para a tela de administração do Enquetes no endereço http://www.seu.domínio/enquetes/admin/. Lá há uma lista das enquetes que já foram criadas até agora em sua conta. O link nova enquete vai estar no final da página (ou logo abaixo do título se você ainda não tiver definido alguma enquete). Clique nele.

2. A tela de título "Nova enquete" aparecerá. Nela há os seguintes campos:

• Título da enquete: é a pergunta que você quer fazer ao usuário de seu site. Ex.: "Qual seu esporte favorito?" (não inclua as aspas).
• Opções: são as alternativas de respostas que você quer oferecer ao usuário, uma por linha. No caso da pergunta acima, por exemplo, você escreveria:

• Fonte do texto da tabela de resultados: escreva a fonte do texto da tabela que aparece após o usuário ter votado. Algo do tipo "Arial" ou "Arial,Verdana". Pode ser deixado em branco se você quiser usar a fonte default.

• Tamanho da fonte do texto da tabela de resultados: escreva o tamanho da fonte. Pode ser relativo (o tamanho normal de fonte é 3; um tamanho relativo é de -2 a +4) ou absoluto (de 1 a 7, equivalentes a 8, 10, 12, 14, 18, 24 e 36, respectivamente). Deixe em branco se não quiser especificar.

• Página de resultados: é a página que surge para o visitande após ter feito sua escolha de voto. Nessa página você deve incluir o arquivo votar.phtml, que é o script que gera a tabela de resultados. O valor do campo deve ser uma URL relativa ao diretório /enquetes/ de seu site. Se deixado em branco, a página de resultados será /enquetes/votar.phtml.

• Abrir página de resultados em uma nova janela: aqui você define se quer que a página de resultados apareça em uma nova janela do browser, após o voto ter sido computado. Veja o exemplo na figura seguinte:

• Largura e altura da janela: escreva as dimensões dessa janela, em pixels (se você escolheu ligar a opção acima).

3. Clique no botão Criar. Você voltará para a tela de administração e a enquete que você criou vai estar incluída na lista.

Mudando as propriedades de uma enquete

1. Siga para a tela de administração do Enquetes. Clique no link editar do enquete que você deseja modificar na lista. Uma nova tela se abrirá com as propriedades da enquete.

2. Você pode modificar os seguintes valores da enquete escolhida:

• Título da enquete (é a pergunta feita na pesquisa): altere a pergunta e clique em Mudar título.

• Opção de voto: altere o texto da opção e clique em Mudar descrição. Note que você só vai mudar o texto, o número de votos associado à opção vai continuar o mesmo (ou seja, não dá para mudar duas opções de posição no formulário de voto). Também você pode apagar uma opção qualquer. Apenas clique no link apagar ao lado da opção.

• Adicionar uma opção: escreva a nova opção no último campo (o que está em branco) na lista de opções. Clique em Adicionar.

• Tipo de controle, fonte/tamanho do texto da tabela de resultados, página de resultados, abrir em nova janela, dimensões nova janela: mude os valores e clique em Alterar para gravar no banco de dados.

• Desativar/ativar enquete: se a enquete está ativa (o sistema aceitará tentativas de votação), você poderá desativá-la. Se não, ser-lhe-á dada a opção de ativá-la. Os links são desativar e ativar, respectivamente.

Inserindo uma enquete em seu site

1. Siga para a tela de administração do Enquetes (http://www.seu.domínio/enquetes/admin/). Clique no link código da enquete com que você deseja trabalhar. Uma nova tela aparecerá com os código PHP e SSI para a inserção do painel de votação e da página de resultados (após o voto ou não).

2. Você pode inserir o painel de votação em uma página HTML de seu site de duas maneiras (as duas dão o mesmo resultado): mude a extensão do arquivo da página para .phtml (ou .php ou .php3), transformando-o em um arquivo PHP, ou para .shtml, que no caso, torna-o um arquivo com SSI.

3. Edite o arquivo e insira os códigos especificados no passo 1 onde você preferir. Veja o exemplo:

<html>
<body>
...
<p>Por favor dê sua opinião a seguir:<br>
</p>
...
</body>
</html>

Depois (extensão .phtml, .php ou .php3)

<html>
<body>
...
<p>Por favor dê sua opinião a seguir:<br>
<? $enquete = 1;
include("./enquetes/enquete.phtml"); ?></p>
...
</body>
</html>

ou (extensão .shtml)

<html>
<body>
...
<p>Por favor dê sua opinião a seguir:<br>
<!--#include virtual="/enquetes/enquete.phtml?enquete=1"--></p>
...
</body>
</html>

Para a página de resultados, apenas as extensões de tipo de arquivo PHP funcionam (.phtml, .php ou .php3). Então mude a extensão da página para uma das mencionadas e insira o código sugerido.

Importante:
Isso só precisa ser feito, no entanto, se você especifiou um página de resultados para a enquete diferente de /enquetes/votar.phtml (essa é a página default para quando você deixa o valor em branco ao criar a enquete).

Antes (página HTML comum):

<html>
<head>
<title>Resultados da enquete da semana</title>
</head>
<body>
...
<p></p>
...
</body>
</html>

Depois (extensão .phtml, .php ou .php3)

<html>
<head>
<title>Resultados da enquete da semana</title>
</head>
<body>
...
<p><? include("./enquetes/votar.phtml"); ?></p>
...
</body>
</html>

Para inserir a tabela de resultados de uma determinada enquete em uma página, sem que ela seja a página de resultados definida para a enquete, você deve alterar a extensão do arquivo para .phtml (ou .php ou .php3) ou .shtml e inserir os códigos sugeridos na função código da enquete.

<html>
<head>
<title>Resultados da enquete da semana</title>
</head>
<body>
...
<p></p>
...
</body>
</html>

Depois (extensão .phtml, .php ou .php3)

<html>
<head>
<title>Resultados da enquete da semana</title>
</head>
<body>
...
<p><? $enquete = 1;
include("./enquetes/resultados.phtml"); ?></p>
...
</body>
</html>

ou (extensão .shtml)

<html>
<head>
<title>Resultados da enquete da semana</title>
</head>
<body>
...
<p><!--#include virtual="/enquetes/resultados.phtml?enquete=1"--></p>
...
</body>
</html>

Observações:
1. Os códigos que foram inseridos acima (destacados em fundo verde) serviram apenas de exemplo. Por favor use os códigos indicados na função código da enquete com que você deseja trabalhar. Se você usar extensão PHP para inserir os códigos na página, certifique-se se usar o caminho do arquivo indicado (enquetes.phtml ou resultados.phtml) relativo à página.

2. A página de resultados da enquete deve estar especificada no campo "Página de resultados" da enquete, que você define ao criar a enquete ou ao editar suas propriedades.

3. A página de resultados é genérica, ou seja, só precisa ser definida uma vez para ser usada com qualquer enquete.

4. Para criar um link para a tela com os resultados da enquete, insira o seguinte código HTML na mesma página onde fica o painel de votação:

<a href="JavaScript:abreResultados()">Ver resultados</a>

No caso, o usuário poderá ver os resultados sem ter que votar primeiro.

Administrando as enquetes

1. Na tela de administração do Enquetes (http://www.seu.domínio/enquetes/admin/) há uma lista das enquetes que já foram criadas até agora em sua conta. Cada entrada da lista tem as seguintes informações sobre uma determinada enquete:

• Cod (código): é o número da enquete no banco de dados.

• Título: é a pergunta (p.e., "Quantas horas em média você usa a Internet?").

• Criação: é a data de criação da enquete junto ao banco de dados.

• Último voto: a data do último voto computado.

• Opções: número de opções de voto que você definiu.

• Votos: número de votos computados desde que a enquete foi criada.

• Página de resultados: é a página PHP para a qual o visitante é direcionado após ter submetido seu voto. Nela são mostrados os resultados da pesquisa até aquele instante. O default é a página /enquetes/votar.phtml.

• Nova janela (sim/não): define se a página de resultados é aberta em uma nova janela do browser do usuário após ele ter votado.

• Tipo de controle (radio/checkbox/select): especifica o tipo de controle escolhido para o painel de votação.

• Funções - editar: mudar as características da enquete, como título, mudar descrição de opções, adicionar ou apagar opções, etc. Veja mais logo abaixo.

• Funções - votar: simular votação na enquete. Observação: o voto é realmente computado!

• Funções - ver resultados: resultados da enquete, em gráficos de barras e porcentagem.

• Funções - código: códigos PHP e SSI para inserção do painel de votação e tabela de resultados em páginas de seu site.

• Funções - apagar: remover enquete do banco de dados.

<< tópico anterior		próximo tópico>>