Skip to content

Latest commit

 

History

History
executable file
·
105 lines (65 loc) · 4.5 KB

readme.md

File metadata and controls

executable file
·
105 lines (65 loc) · 4.5 KB
Raw

ENGLISH DESCRIPTION at the end of the German text

Mat-O-Wahl - Ein einfach zu bedienender, freier Wahl-O-Mat Klon für jedermann

LIVE-DEMO

https://www.mat-o-wahl.de/ -> Ausprobieren (DE) 🍺

BEDIENUNG / INSTALLATION

  1. ZIP-Archiv herunterladen und entpacken (Github -> oben rechts -> Code -> Download ZIP)

  2. Datei /DATA/DEFINITION.JS in einem Texteditor (am besten mit Syntaxhervorhebung) bearbeiten.

  3. Fragen- und Antworten-CSV-Datei in einem Texteditor oder einer Tabellenkalkulation (MS Excel, LO Calc, ...) bearbeiten. Der Dateiname kann frei gewählt werden.

  4. Testen mit INDEX.HTML oder QUICKTEST.HTML (am besten auf http://localhost/ oder im privaten Webspace)

Optional: Im Ordner /EXTRAS gibt es Erweiterungen um bei Bedarf zusätzliche Funktionen zu aktivieren. (z.B. Filtern von Ergebnissen, Vorabfrage, Einbinden per iframe)

VORAUSSETZUNG

  • ein bisschen Webspace (ein günstiges Shared-Hosting-Paket reicht vollkommen aus)
  • kein PHP oder MySQL / MariaDB nötig (nur optional für Statistik)
  • kein npm, yarn oder eine andere Paketverwaltung nötig
  • Wissen, wie man eine Textdatei und/oder eine Tabellenkalkulation öffnet

Mat-o-Wahl und DSGVO

  • Alle Verarbeitungen passieren innerhalb des Browsers des Nutzers
  • keine Datenerhebung auf dem Server (nur optional für eine Statistik - Ausnahme: Standardmäßige Erfassung der Zugriffe durch den Webhosting-Anbieter, z.B. IP-Adresse und Uhrzeit)
  • kein Aufruf von externen Dateien (z.B. Content Delivery Network / CDN, Bootstrap, jQuery, kein Social Media-Plugin) - alles inklusive

LIZENZ

GPL 3 (siehe Verzeichnis /SYSTEM oder http://choosealicense.com/licenses/gpl-v3/)

  • Quellcode, Lizenz und größere Änderungen müssen kenntlich gemacht werden.
  • Änderungen, Weitergabe, sowie kommerzielle und private Nutzung erlaubt.
  • Keine Garantie für Softwareschäden.

HILFE / KONTAKT / ÄNDERUNGEN

Wenn Sie den Mat-O-Wahl einsetzen, würde ich mich über eine kurze Mitteilung von Ihnen freuen.

mathias . steudtner (a) mailbox . org

Mat-O-Wahl (*) - A simple to handle, free "Voting Advice Application" / "Electoral Compass" for everybody

LIVE-DEMO

https://www.mat-o-wahl.de/ -> Try It (EN) 🍔

USE / INSTALLATION

  1. Download and unpack ZIP archive (Github -> top right -> Code -> Download ZIP)

  2. Edit /DATA/DEFINITION.JS with a text-editor (best use one with syntax-highlighting).

  3. Edit CSV-text file for questions and answers with a text-editor or spread-sheet-software (MS Excel. LO Calc, ...)

  4. Test settings using INDEX.HTML or QUICKTEST.HTML (works best on http://localhost/ or your private webspace)

Optional: You can find some extensions in the folder /EXTRAS. It adds some more functionality to the program, if needed. (e.g. filter of results, pre-question, include the program within an iframe)

PREREQUISITES

  • some web-space (a cheap shared-hosting plan is sufficient)
  • no PHP or MySQL / MariaDB needed (optional for statistics)
  • no npm or any other packaging manager needed
  • knowing, how to open a text-file and/or a spread-sheet-software

Mat-o-Wahl and GDPR

  • All evaluations happen inside the user's browsers
  • No data is collected on a server (optional for statistics - Exception: default access-logging by your webhosting-provider, i.e. IP-address and time)
  • No external files (e.g. Content Delivery Network / CDN, Bootstrap, jQuery, no Social Media-plugin) - all included

LICENSE

GPL 3 (see folder /SYSTEM or http://choosealicense.com/licenses/gpl-v3/)

  • Required: Disclose Source, License and copyright notice, State Changes
  • Permitted: Commercial Use, Distribution, Modification, Patent Use, Private Use
  • Forbidden: Hold Liable

HELP / CONTACT / CHANGELOG

If you should find Mat-O-Wahl useful, I would be happy about a short notice from you by email.

mathias . steudtner (a) mailbox . org

(*) derived from the German project "Wahl-O-Mat" (Wahl-Automat) / "Vote-Machine"