Skip to content

itsriodejaneiro/concordamos-plugin

Repository files navigation

Concordamos

Descubra o poder de concordar - Plugin WordPress para organizar votações com Voto Quadrático

UMA FORMA DE VOTAR PELO CONSENSO

Imagine um lugar onde suas opiniões têm peso, não importa o quão diferentes sejam. No Concordamos, acreditamos na participação e no encontro de consensos. Somos diferentes de outros meios de votação. Valorizamos não apenas a sua escolha, mas também a intensidade do seu apoio. Descubra como estamos promovendo decisões mais inclusivas. Botão: Conheça mais o projeto

O Concordamos é uma ferramenta flexível e de código aberto, disponível gratuitamente, que pode ser facilmente integrada em qualquer site construído em WordPress.

O que torna o Concordamos único é a sua metodologia, chamada de Votação Quadrática, que capacita os eleitores a expressarem suas preferências de forma mais precisa e flexível. Em vez de se limitar a escolher apenas uma opção, os eleitores podem distribuir um número limitado de créditos de votos entre as suas escolhas favoritas. Isso promove uma abordagem menos centralizada e mais inclusiva para a tomada de decisões. Venha explorar como o Concordamos está revolucionando a forma como as pessoas participam e influenciam processos democráticos.

CONFIGURAÇÃO DO PLUGIN

Sobre o plugin:

O plugin permite, com muita flexibilidade:

  • Configurar o total de números de créditos que cada eleitor recebe
  • É possível votar com ou sem cadastro e login na plataforma
  • Os votos podem ser tanto positivos quanto negativos
  • Gerar links de voto cujo uso é único para realização de pesquisas, garantindo o anonimato

PRÉ-REQUISITOS

Para instalar o plugin em uma plataforma WordPress é necessário que atenda pré-requisito(s):

  • Versão do WordPress: 5.8 ou mais atual
  • Versão do PHP: 7.4
  • Habilitar API REST

Esse plugin foi testado na versão 6.3 do WordPress.

INSTALAÇÃO:

  1. Para preparar o plugin para uso é rodar o comando ./dev-scripts/producao.sh na raiz do projeto.
  2. Faça o upload completo do arquivo concordamos.zip no diretório de /wp-content/plugins/
  3. Ative o plugin através da tela dos Plugins instalados, em Plugins, no painel do WordPress

O comando do ponto 2 cria um zip na pasta ./trunk/zip/ com o nome concordamos.zip. Isso porque o script ./dev-scripts/producao.sh gera o zip do plugin já com o nome correto e também remove a pasta node_modules.

PRIMEIROS PASSOS

Ao instalar o plugin em um tema do WordPress são necessárias configurações para que o layout disponibilizado pelo plugin seja incorporado nas páginas do tema. Para utilização completa do plugin é necessária realização de dois fluxos de configuração, de modo que todas as páginas sejam implementadas na plataforma que o instalou.

O primeiro passo para editar o plugin do Concordamos é realizar o login em um cadastro que possui permissão de administrador no painel WordPress. Após o primeiro passo, deve acessar o painel do WordPress do site para aplicar as páginas de votações.

Portanto, o segundo passo é clicar no ícone do WordPress acima do cabeçalho: image

Ocorrerá o direcionamento para o painel do WordPress: image

COMO CONFIGURAR AS PÁGINAS DE VOTAÇÕES

Para implementar as páginas de votações, após acessar o painel do WordPress, é necessário acessar Páginas e clicar em adicionar nova para adicionar uma nova página: image

Após clicar adicionar nova, deve atribuir um nome e clicar em publicar. Iremos chamá-la de Criar votação, mas você pode atribuir um nome de sua escolha. Em Modelo, selecionaremos Criar votação.

Com isso, todas as páginas da votação serão implementadas no site. Sendo elas: criação de votação, lista de votações públicas, detalhes da votação, votação e informações da votação.

COMO CONFIGURAR AS PÁGINAS DE CADASTRO

Para implementar as páginas de cadastro, após acessar o painel do WordPress, é necessário acessar Páginas e clicar em adicionar nova para adicionar uma nova página: image

Após clicar adicionar nova, deve atribuir um nome, selecionar o modelo e clicar em publicar. Esse mesmo fluxo deve ser feito para todas as páginas de cadastro, sendo elas: login, cadastro de usuário, minha conta e change password (esqueci a senha). E não se esqueça de publicar!

Assim, chamaremos a primeira página de Login e em Modelo selecionaremos Login [Concordamos]: image

O mesmo deve ser feito para Cadastro de usuário selecionando Criar usuário [Concordamos] em Modelo: image

De mesmo modo para Minha conta [Concordamos]: image

E, para Esqueci a senha selecionando Change password [Concordamos]: image

Com isso, concluímos as configurações disponíveis no plugin do Concordamos.

COMO UTILIZAR AS VOTAÇÕES

CRIAÇÃO DE VOTAÇÕES

O primeiro passo para criar uma votação é criar uma conta através da página de criação de conta fornecida pelo plugin. Para criar a conta é necessário informar um e-mail e uma senha.

Após a criação da conta é possível criar uma votação. Para criar uma votação é necessário (quando obrigatório) o preenchimento dos seguintes campos:

  1. Selecionar se a votação é pública ou privada (obrigatório)

  2. Marcar se a votação requer login para quem for votar

  3. Informar o nome da votação (obrigatório)

  4. Inserir uma descrição da votação (obrigatório)

  5. Informar o número máximo de eleitores que poderão votar (obrigatório)

  6. Informar a quantidade de créditos que poderão aplicados como votos (obrigatório)

  7. Marcar se haverão votos negativos

  8. Preencher pelo menos uma tag (obrigatório)

  9. Preencher a data e o horário do período de início e término da votação (obrigatório)

  10. Marcar se o resultado deve ser exibido somente ao final da votação

  11. Adicionar mais de uma opção de voto (obrigatório)

Alguns dos pontos acima necessitam aprofundamento.

Sobre 1, ao criar uma votação pública, ela ficará disponível na lista de votações públicas. As votações privadas só aparecem na página da minha conta, elas ficam disponíveis: na aba votações criadas por mim, para quem criou a votação; na aba votações que eu participei, para quem votou.

Sobre 2, ao marcar que a votação requer login, somente quem cadastrar uma conta e realizar o login poderá votar. Se a votação não requer login, qualquer usuario poderá votar. Vale notar que somente quem vota com login tem acesso ao resultado da votação. image

Sobre 7, ao marcar se haverão votos negativos, quer dizer que o usuário poderá diminuir os votos de uma opção votando nela negativamente. Por exemplo, digamos que um usuário atribuiu 4 votos para uma mesma opção, caso um outro usuário dê 3 votos negativos para essa mesma opção, o total de votos da opção será 1.

Sobre 8, ao inserir mais de uma tag, as tags devem ser separadas por vírgula. image

Sobre 9, o preenchimento do período de início e término da votação é a única informação que pode ser alterada após a criação da votação. image

Sobre 11, cada opção de voto adicionada, tem como preenchimento obrigatório o título e tem como preenchimento opcional a descrição e um link. image

Após o preenchimento de pelo menos todos os campos obrigatórios, deve-se clicar em Criar Votação: image

Se a votação criada for uma votação pública, ocorrerá o direcionamento para a Links da Votação, na página onde ficam as Informações da Votação: image

A URL da votação pode ser compartilhada, ela direcionará direto para a aba Resultados Detalhados: image

A URL privada de administrador ao ser acessada por uma conta que não criou a votação, direciona para a mesma página acima, com o acesso aos links de votação e a possibilidade de editar as o período de votação: image

Se votação a criada for votação privada, ocorrerá o direcionamento para a aba links da votação. A URL da votação e a URL privada de administrador possui o mesmo comportamento que na votação pública. É importante ressaltar que a votação privada é acessada somente através das URLs individuais de voto: image

COMO VOTAR

Existem duas formas de acessar a página de votação pública: através da lista de votações públicas ou através da própria URL da página de votação.

Na lista de votações públicas, é necessário clicar na votação desejada: image

Ao acessar uma votação aberta, isto é, que está dentro do período de votação, ocorre o direcionamento para a página de detalhes da votação: image

Além do título, descrição, tags e período de votação, a página de detalhes de votações oferece informações sobre as opções de votos disponíveis e a quantidade de créditos que poderão ser aplicados nelas como votos.

Para acessar a votação, basta clicar em Participar da votação: image

Ocorrerá o direcionamento para a página de votação onde os votos são atribuídos. No voto quadrático cada voto possui um custo de créditos.

Chama-se voto quadrático porque a quantidade de votos é a raiz quadrada do custo de créditos. Por exemplo, 1 voto custa 1 crédito porque a raiz quadrada de 1 é 1; 2 votos custam 4 créditos porque a raiz quadrada de 4 é 2, e assim sucessivamente. image

Conforme os créditos são atribuídos eles são contabilizados visualmente na interface e são distribuídos como votos. Após votar, deve clicar em Confirmar Voto: image

RESULTADOS DA VOTAÇÃO

Os resultados da votação ficam na página Informações da Votação. Contudo, eles só podem ser visualizados por quem criou a votação e por quem votou com o login habilitado.

O resultado pode ser visto através de um gráfico disponível na aba Resultados Detalhados: image image

E, os votos realizados por um usuário podem ser consultados por ele em Meu Voto.

Caso durante a criação da votação tenha sido marcado para os resultados aparecerem somente ao fim do período da votação, a aba Resultados Detalhados não ficará disponível enquanto a votação não encerrar: image

Assim, conclui-se o fluxo de criação de votação, de votação e de consulta aos resultados da votação.