WP Manifestindependent plugin directory
manifest / utilities / openvote

Open Vote

E-Voting WordPress Plugin – system e-głosowania

by Tomasz Kalinowski · github.com/t7jk/openvote · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/t7jk/openvote/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/t7jk/openvote ↗

Open Vote (Otwarte Głosowanie)

Wtyczka WordPress do przeprowadzania elektronicznych głosowań wśród zarejestrowanych użytkowników: głosowania wielopytaniowe, grupy docelowe, zaproszenia e-mail, masowa wysyłka wiadomości (Komunikacja), ankiety i wyniki (jawne lub anonimowe).

Autor: Tomasz Kalinowski
Licencja: GPL v2 lub późniejsza
Wymagania: WordPress 6.4+, PHP 8.1+

Do czego służy wtyczka

  • Głosowania — tworzenie głosowań z wieloma pytaniami (1–24), określonym czasem trwania i grupami docelowymi.
  • Grupy — przypisywanie użytkowników do grup (np. według miasta); grupy docelowe decydują, kto może głosować.
  • Koordynatorzy — rola wtyczki: zarządzanie głosowaniami i grupami bez dostępu do pełnej Konfiguracji.
  • Zaproszenia e-mail — automatyczna wysyłka zaproszeń po starcie głosowania (WordPress, SMTP, SendGrid, Brevo, Freshmail, GetResponse).
  • Komunikacja — masowa wysyłka wiadomości e-mail do wybranych grup (ogłoszenia, powiadomienia), z kodami {Nadawca}, {Skrót nazwy}, {moja_grupa}, {grupa_docelowa}.
  • Ankiety — formularze z pytaniami, zbieranie odpowiedzi, publiczna strona zgłoszeń z opcją ukrywania danych wrażliwych.
  • Wyniki — zbiorcze wyniki i listy głosujących/nieobecnych, eksport do PDF; tryb jawny lub anonimowy.

Instalacja

  1. Pobierz najnowszy plik ZIP lub sklonuj repozytorium do wp-content/plugins/.
  2. W katalogu wtyczki: composer install (TCPDF i zależności), npm run build w blocks/openvote-poll/ (blok Gutenberg).
  3. W panelu WordPress: Wtyczki → Aktywuj „Open Vote”.
  4. Po aktywacji: Open Vote → Konfiguracja — ustaw slug strony głosowania, e-mail nadawcy i metodę wysyłki.

Podręcznik (skrót)

1. Przepływ pracy

  1. Administrator tworzy grupy i przypisuje użytkowników (ręcznie, „Auto” według pola Miasto, lub przez rejestrację).
  2. Administrator lub Koordynator tworzy głosowanie (tytuł, grupy docelowe, pytania i odpowiedzi), potem klika „Wystartuj głosowanie”.
  3. System wysyła zaproszenia e-mail; uprawnieni użytkownicy wchodzą na stronę głosowania i oddają głos.
  4. Po zakończeniu wyniki są dostępne w zakładce „Zakończone głosowania” oraz w panelu (Wyniki, PDF).

2. Role

  • Administrator WordPress — pełny dostęp, w tym Konfiguracja.
  • Koordynator (rola wtyczki) — nadawana w Open Vote → Koordynatorzy; zarządza głosowaniami i grupami, bez Konfiguracji.
  • Subskrybent — może tylko głosować, jeśli jest w grupie docelowej i ma kompletny profil.

3. Grupy

  • Open Vote → Grupy: dodawanie grup, przypisywanie użytkowników (ręcznie lub „Synchronizuj wszystkie grupy-miasta”).
  • Pole „Miasto” (lub inne z Mapowania pól) służy do auto-przypisywania do grup o tej samej nazwie.

4. Głosowania

  • Tytuł, opis, czas trwania, tryb dołączania (Otwarte/Zamknięte), tryb głosowania (Jawne/Anonimowe), grupy docelowe, pytania i odpowiedzi.
  • Statusy: Szkic → Rozpoczęte (po „Wystartuj”) → Zakończone.

5. Zaproszenia i limity

  • Zaproszenia: przy każdym głosowaniu link „Zaproszenia” — kolejka wysyłki, przycisk „Wyślij zaproszenia” / „Wyślij ponownie”.
  • W Konfiguracji (Warunki wysyłki e-maili) ustawia się limity na 15 min, godzinę i dobę dla Brevo (free), WordPress, SMTP. Do limitu wliczane są tylko e-maile faktycznie dostarczone.

6. Komunikacja (masowa wysyłka)

  • Open Vote → Komunikacja: lista wysyłek (Szkic / Wysłano), „Nowa wysyłka” — tytuł, treść, grupy docelowe.
  • Kody w treści: {Nadawca}, {Skrót nazwy}, {moja_grupa}, {grupa_docelowa}.
  • Wysłanej wiadomości nie można edytować; dostępny jest Podgląd (wyszarzony), Duplikuj, Kasuj.

7. Konfiguracja (Administrator)

  • Slug strony głosowania, strona ankiet, strona zgłoszeń.
  • E-mail nadawcy, metoda wysyłki (WordPress, SMTP, SendGrid, Brevo, Freshmail, GetResponse), warunki wysyłki (limity).
  • Mapowanie pól użytkownika (Imię, Nazwisko, Nickname, E-mail, Grupa/Miasto, Telefon itd.) — wymagane do głosowania i do wyświetlania na stronie zgłoszeń.

8. Ankiety i zgłoszenia

  • Ankiety: Open Vote → Ankiety; tworzenie formularzy, zbieranie odpowiedzi, statusy (oczekuje / nie spam / spam).
  • Strona zgłoszeń — publiczny widok zatwierdzonych zgłoszeń; pola oznaczone jako „wrażliwe” są ukrywane.

Komendy deweloperskie

npm run build        # kompilacja bloku Gutenberg (openvote-poll)
npm run start        # tryb watch
composer install     # zależności PHP (TCPDF)
./make-install-zip.sh # budowa pliku ZIP wtyczki

Kod źródłowy

https://github.com/t7jk/openvote

Pełny podręcznik użytkownika jest dostępny w panelu WordPress: Open Vote → Podręcznik.