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

• Weitere Informationen und Dokumentation online unter https://www.mat-o-wahl.de
• oder per E-Mail (siehe unten).
• Änderungen zu den Vorgängerversionen finden sich im Changelog https://github.com/msteudtn/Mat-O-Wahl/blob/master/system/changelog.md

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

mathias . steudtner (a) gmx . net

---

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

• You can find further information and documentation on-line at https://www.mat-o-wahl.de
• or via email (see below)
• Changes to earlier versions in the changelog https://github.com/msteudtn/Mat-O-Wahl/blob/master/system/changelog.md

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

mathias . steudtner (a) gmx . net

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