Skip to content

Latest commit

 

History

History
89 lines (69 loc) · 3.31 KB

README.md

File metadata and controls

89 lines (69 loc) · 3.31 KB

Easy Votes

Aquest projecte permet crear i gestionar una enquesta amb una sola pregunta i quatre opcions de resposta. Els resultats de l'enquesta es mostren en un gràfic de barres, i els administradors poden modificar la pregunta i les opcions, buidar les dades i descarregar els resultats en format Excel.

Característiques

  • Creació d'Enquestes: Es pot definir una pregunta i quatre opcions de resposta.
  • Votació: Els usuaris poden votar i veure els resultats en temps real.
  • Gestió per a Administradors:
    • Modificació de la pregunta i opcions.
    • Buidatge de dades anteriors.
    • Descàrrega dels resultats en format Excel.

Tecnologies Utilitzades

  • HTML/CSS: Per a la interfície d'usuari.
  • JavaScript: Per a la lògica de la pàgina i la gestió de l'enquesta.
  • PHP: Per a la gestió del backend, incloent l'emmagatzematge de dades.
  • JSON: Per a l'emmagatzematge de la configuració de l'enquesta i els vots.
  • Chart.js: Per a la visualització dels resultats en un gràfic de barres.
  • SheetJS (xlsx): Per a la generació i descàrrega de fitxers Excel amb els resultats.

Instal·lació i Configuració

  1. Clonar el repositori:

    git clone https://github.com/orilpik/easy-votes.git
cd easy-votes

  2. Configura els fitxers:

    • survey.json: Aquest fitxer ha de contenir la pregunta i les opcions inicials de l'enquesta. Exemple: 
      {
    "question": "Quin és el teu color preferit?",
    "options": ["Rojo", "Azul", "Verde", "Amarillo"]
}
    • votes.json: Aquest fitxer començarà buit: 
      []

  3. Configura el servidor:

    • Assegura't que el servidor tingui PHP instal·lat i configurat correctament.
    • Còpia els fitxers del projecte al directori del servidor.

  4. Permisos:

    • Assegura't que els fitxers survey.json i votes.json tinguin els permisos adequats perquè el servidor pugui llegir i escriure.

Ús

  1. Interfície d'Usuari:

    • Els usuaris poden accedir a la pàgina principal per veure l'enquesta, votar i veure els resultats.

  2. Accés d'Administrador:

    • Afegiu ?mode=admin a l'URL per accedir a les funcionalitats d'administració (ex: https://urquiabas.com/votacions/?mode=admin).
    • En mode administrador, podreu modificar la pregunta i opcions, buidar les dades anteriors i descarregar els resultats.

  3. Inserció en Altres Pàgines:

    • Podeu inserir l'enquesta en altres pàgines mitjançant un iframe. Exemple: 
      <iframe src="https://urquiabas.com/votacions/" style="width: 100%; height: 100vh; border: none;" onload="this.style.height = this.contentWindow.document.body.scrollHeight + 'px';"></iframe>
    • Assegureu-vos que el domini és de confiança si l'insertareu en plataformes com SharePoint.

Contribució

Les contribucions són benvingudes! Si voleu col·laborar:

  1. Fork el projecte.
  2. Creeu una branca amb les vostres funcions: 
    git checkout -b feature/nova-funcio
  3. Commit els canvis: 
    git commit -m "Afegida una nova funció"
  4. Push a la branca: 
    git push origin feature/nova-funcio
  5. Obriu una Pull Request.

Llicència

Aquest projecte està llicenciat sota la llicència Creative Commons Zero.