Jedna wtyczka, jeden shortcode – i Twoi odwiedzający mogą wpłacić darowiznę bezpośrednio z Twojej strony. Bez własnego systemu płatności, bez przechowywania danych, bez skomplikowanej konfiguracji. W wersji 2.0.0 formularz obsługuje dodatkowo przełączane tryby: wpłata jednorazowa i wpłata miesięczna.
WordPress 5.0+ · PHP 7.4+ · Wymaga aktywnej zbiórki na ofiaruje.pl
[ofiaruje_formularz]
Co otrzymujesz?
💳 Gotowy formularz wpłat
Predefiniowane kwoty jako klikalne przyciski plus pole do wpisania własnej kwoty. Minimum 20 PLN egzekwowane po stronie klienta i serwera.
🔒 Zero danych w bazie WordPress
Formularz wysyła dane metodą POST bezpośrednio do ofiaruje.pl. Żadne dane darczyńcy nie są zapisywane w Twojej bazie danych.
🎨 Pełna kontrola wyglądu
Wbudowany panel CSS z podglądem i przyciskiem przywracania domyślnych styli. Dostosuj formularz do identyfikacji wizualnej swojej strony.
🔁 Dwa tryby wpłaty (v2.0.0)
Zakładki „Wpłata jednorazowa” oraz „Wpłata miesięczna” na górze formularza. Dla miesięcznej dostępne są pola: ulica, miasto, kod pocztowy i kraj.
📊 Wbudowany UTM tracking
Jeden przełącznik i pięć pól (source, medium, campaign, term, content) – pełne śledzenie kampanii bez dodatkowych wtyczek analytics.
👁 Opcja anonimowości darczyńcy
Checkbox ukrywający dane darczyńcy na publicznej stronie zbiórki – bez żadnych zmian po Twojej stronie.
💰 Ikony metod płatności
Automatycznie ładowane SVG: BLIK, Visa, Mastercard, Apple Pay, Google Pay, Revolut Pay – wyświetlane pod przyciskiem CTA.
Jak działa formularz?
Darczyńca widzi na stronie
- Zakładki: „Wpłata jednorazowa” oraz „Wpłata miesięczna”
- Przyciski predefiniowanych kwot (np. 50, 100, 200, 500 zł)
- Pole do wpisania dowolnej kwoty (minimum 20 PLN)
- Pola: Imię, Nazwisko, Adres e-mail (wszystkie wymagane)
- Pole Nazwa firmy/organizacji (opcjonalne)
- W trybie miesięcznym: ulica, miasto, kod pocztowy i kraj (domyślnie Polska)
- Checkbox „nie wyświetlaj moich danych na stronie zbiórki"
- Przycisk CTA „Przejdź do płatności →"
- Rząd ikon obsługiwanych metod płatności
Co dzieje się po kliknięciu?
- Formularz waliduje dane po stronie przeglądarki
- Dane są wysyłane metodą POST bezpośrednio do ofiaruje.pl
- Darczyńca trafia na stronę płatności ofiaruje.pl
- Transakcja realizowana jest przez Stripe
- Żadne dane nie są zapisywane w WordPress
Instalacja
- Wejdź do repozytorium na GitHub: github.com/janlekszycki/ofiaruje-donation-form
-
Pobierz paczkę ZIP:
- Releases (zalecane dla stabilnych wydań)
- Code → Download ZIP (bieżąca wersja z gałęzi main)
-
Upewnij się, że archiwum zawiera katalog
ofiaruje-donation-form/. - W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę.
- Wybierz pobrany ZIP i kliknij Zainstaluj teraz.
- Aktywuj wtyczkę.
- Przejdź do Ustawienia → Ofiaruje i podaj ID zbiórki.
[ofiaruje_formularz]
na dowolnej stronie lub wpisie WordPress – formularz pojawi się
automatycznie.
Konfiguracja
Przejdź do Ustawienia → Ofiaruje w panelu WordPress i wypełnij pola:
| Ustawienie | Opis |
|---|---|
| ID Zbiórki wymagane |
Identyfikator zbiórki (_id) z platformy
Ofiaruje.pl. Widoczny w adresie URL:
ofiaruje.pl/f/<ID>
|
| Predefiniowane kwoty (PLN) |
Kwoty oddzielone przecinkami, np. 50,100,200,500.
Minimalna wartość: 20 PLN. Mniejsze kwoty są
automatycznie pomijane.
|
| Adres platformy |
Domyślnie https://ofiaruje.pl – zazwyczaj nie
wymaga zmiany.
|
| UTM tracking |
Przełącznik on/off. Po włączeniu dodaje parametry
utm_*
do adresu formularza (/d?fid=…).
|
| UTM Source |
Domyślnie wordpress. Identyfikuje źródło ruchu.
|
| UTM Medium | Domyślnie plugin. Identyfikuje kanał. |
| UTM Campaign | Opcjonalna nazwa kampanii marketingowej. |
| UTM Term | Opcjonalny parametr kampanii (np. słowo kluczowe). |
| UTM Content | Opcjonalny parametr kampanii (np. wariant kreacji). |
| Własny CSS formularza | Panel edycji CSS z domyślnymi stylami wtyczki. Możesz je dowolnie modyfikować i przywrócić przyciskiem Ustaw domyślne. |
| Ikony płatności pod przyciskiem |
Przełącznik on/off pokazujący rząd ikon: BLIK, Visa, Mastercard,
Apple Pay, Google Pay, Revolut Pay. Ikony SVG ładowane
automatycznie z folderu assets/.
|
| Widoczność typów wpłat | Dwa przełączniki: osobno dla „Wpłata jednorazowa” i „Wpłata miesięczna”. Domyślnie oba tryby są włączone. |
| Domyślny typ wpłaty | Wybór startowego trybu formularza (jednorazowa/miesięczna). Opcja działa tylko wtedy, gdy oba tryby wpłat są włączone. |
Bezpieczeństwo
Brak zapisu danych
Formularz przesyła dane metodą POST bezpośrednio do ofiaruje.pl. Dane darczyńcy nigdy nie trafiają do bazy danych WordPress.
Sanityzacja danych wejściowych
Wszystkie wartości ustawień są sanityzowane
(sanitize_text_field, esc_url_raw,
absint).
Escapowanie wyjścia HTML
Każde wyjście HTML jest zawsze escapowane
(esc_attr, esc_html,
esc_url).
Wymagania
- WordPress 5.0 lub nowszy
- PHP 7.4 lub nowszy
- Aktywna zbiórka na ofiaruje.pl
Gotowy do instalacji?
Wtyczka jest bezpłatna, open-source i dostępna publicznie na GitHub.
Wersja 2.0.0 · Licencja GPL v2