{"id":21330542,"url":"https://github.com/friendsofredaxo/poll","last_synced_at":"2025-07-12T08:32:40.275Z","repository":{"id":20766193,"uuid":"90847216","full_name":"FriendsOfREDAXO/poll","owner":"FriendsOfREDAXO","description":"Erstellt und verwaltet Umfragen in REDAXO 5, bei Bedarf mit E-Mailbestätigung.","archived":false,"fork":false,"pushed_at":"2025-06-21T23:57:34.000Z","size":760,"stargazers_count":37,"open_issues_count":3,"forks_count":2,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-22T00:26:58.305Z","etag":null,"topics":["poll","redaxo","redaxo-addon","yform"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FriendsOfREDAXO.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-05-10T09:36:46.000Z","updated_at":"2025-04-29T07:37:18.000Z","dependencies_parsed_at":"2025-04-28T16:38:03.927Z","dependency_job_id":null,"html_url":"https://github.com/FriendsOfREDAXO/poll","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/FriendsOfREDAXO/poll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Fpoll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Fpoll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Fpoll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Fpoll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FriendsOfREDAXO","download_url":"https://codeload.github.com/FriendsOfREDAXO/poll/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Fpoll/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264962515,"owners_count":23689826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["poll","redaxo","redaxo-addon","yform"],"created_at":"2024-11-21T22:21:13.712Z","updated_at":"2025-07-12T08:32:40.253Z","avatar_url":"https://github.com/FriendsOfREDAXO.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Umfragen\n\nErstellt und verwaltet Umfragen in REDAXO 5, bei Bedarf mit E-Mailbestätigung.\n\n![Screenshot](https://raw.githubusercontent.com/FriendsOfREDAXO/poll/assets/poll.png)\n\n## Installation\n\nInstallationsvoraussetzungen: YForm \u003e4.0, REDAXO ^5.16 \n\n* Ins Backend einloggen und mit dem Installer installieren\n\n## Funktionsweise\n\nDas Poll-AddOn ermöglicht die Erstellung und Verwaltung von Umfragen in REDAXO. Es bietet verschiedene Typen von Umfragen:\n\n* **Direkt**: Benutzer können direkt abstimmen, ohne weitere Überprüfung\n* **Hash**: Jeder Benutzer kann nur einmal abstimmen (Browser-Cookie-basiert)\n* **E-Mail**: Benutzer müssen ihre E-Mail-Adresse angeben und erhalten einen Bestätigungslink\n\n### Ablauf\n\n1. Eine Umfrage erstellen mit den verschiedenen Optionen\n2. Das Umfragemodul auf einer Seite einbinden und dort die entsprechende Umfrage festlegen\n3. Ausgabe in der Modulausgabe anpassen\n4. In YForm das Email-Template anpassen\n\n## Dashboard \u0026 Datenauswertung\n\nDas Poll-AddOn bietet ein umfassendes Dashboard zur Auswertung aller Umfragen:\n\n* Übersicht aller aktiven und inaktiven Umfragen\n* Grafische Darstellung der Ergebnisse mit selbst implementierten Balken- und Kreis-Diagrammen\n* Detaillierte Auswertung jeder einzelnen Frage einer Umfrage\n* Zeitlicher Verlauf der Teilnahmen\n* Anzeige von Freitext-Antworten\n\nDas Dashboard verwendet keine externen Bibliotheken und ist vollständig mit eigenen CSS/JS-Assets implementiert.\n\n## Eigene Module erstellen\n\n### Grundlegendes Modul\n\nHier ist ein Beispiel für ein einfaches Poll-Modul:\n\n```php\n\u003c?php\n// Eingabe\n?\u003e\n\u003cdiv class=\"form-group\"\u003e\n    \u003clabel for=\"poll_id\"\u003eUmfrage auswählen\u003c/label\u003e\n    \u003c?php\n    $select = new rex_select();\n    $select-\u003esetName('REX_INPUT_VALUE[1]');\n    $select-\u003esetId('poll_id');\n    $select-\u003esetSize(1);\n    $select-\u003esetAttribute('class', 'form-control');\n    $select-\u003eaddOption('Bitte wählen', '');\n\n    $polls = Poll\\Poll::query()-\u003ewhere('status', 1)-\u003eorderBy('title')-\u003efind();\n    \n    foreach ($polls as $poll) {\n        $select-\u003eaddOption($poll-\u003egetTitle(), $poll-\u003egetId());\n    }\n    $select-\u003esetSelected('REX_VALUE[1]');\n    echo $select-\u003eget();\n    ?\u003e\n\u003c/div\u003e\n\n\u003c?php\n// Ausgabe\n?\u003e\n\u003cdiv class=\"poll-container\"\u003e\n    \u003c?php\n    if ('REX_VALUE[1]' != '') {\n        $poll = Poll\\Poll::get(intval('REX_VALUE[1]'));\n        if ($poll) {\n            $fragment = new rex_fragment();\n            $fragment-\u003esetVar('poll', $poll);\n            echo $fragment-\u003eparse('addons/poll/poll.php');\n        }\n    }\n    ?\u003e\n\u003c/div\u003e\n```\n\n### Anpassung des vorhandenen Moduls\n\nUm die Ausgabe des Fragments `addons/poll/poll.php` anzupassen, kann man eine eigene Version erstellen:\n\n### Project-AddOn \n1. Die Datei `/redaxo/src/addons/poll/fragments/addons/poll/poll.php` nach `/redaxo/src/addons/project/fragments/addons/poll/poll.php` kopieren\n2. Dann gestalterisch anpassen. \n\n\n#### Theme-AddOn\n1. Die Datei `/redaxo/src/addons/poll/fragments/addons/poll/poll.php` nach `/theme/private/fragments/addons/poll/poll.php` kopieren\n2. Dann gestalterisch anpassen. \n\n## Sprog-Integration (CSV-Liste)\n\nHier sind die für das Sprog-AddOn benötigten Variablen:\n\n```csv\nkey;de_de\npoll_title;Umfrage\npoll_result;Ergebnis\npoll_votes_taken;Anzahl der abgegebenen Stimmen:\npoll_vote_success;Ihre Stimme wurde erfolgreich gespeichert!\npoll_vote_confirm;Bitte bestätigen Sie Ihre Abstimmung über den Link in der E-Mail.\npoll_vote_exists;Sie haben bereits an dieser Umfrage teilgenommen.\npoll_vote_fail;Die Aktivierung Ihrer Stimme ist fehlgeschlagen.\npoll_finished;Diese Umfrage ist beendet.\npoll_answer;Ihre Antwort\npoll_validate_question;Bitte beantworten Sie diese Frage.\npoll_validate_email;Bitte geben Sie eine gültige E-Mail-Adresse ein.\npoll_email_label;E-Mail-Adresse\npoll_email_note;Sie erhalten einen Link zur Bestätigung Ihrer Abstimmung per E-Mail.\npoll_submit_poll;Abstimmen\npoll_comment_legend;Kommentar\npoll_comment_label;Ihr Kommentar (optional)\npoll_datenschutz_checkbox;Ich stimme der Verarbeitung meiner Daten gemäß Datenschutzerklärung zu.\npoll_datenschutz_checkbox_error;Bitte stimmen Sie der Datenverarbeitung zu.\n```\n\n## Changelog\n\nSiehe [CHANGELOG.md](CHANGELOG.md).\n\n## Lizenz\n\n[MIT Lizenz](LICENSE.md)\n\n## Autor\n\n* [@FriendsOfREDAXO](https://github.com/FriendsOfREDAXO/poll/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendsofredaxo%2Fpoll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffriendsofredaxo%2Fpoll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendsofredaxo%2Fpoll/lists"}