Wtyczka Ofiaruje dla WordPress

Formularz darowizny ofiaruje.pl
na Twojej stronie WordPress

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.

↓ Pobierz wtyczkę (GitHub Releases) Kod źródłowy na GitHub

WordPress 5.0+  ·  PHP 7.4+  ·  Wymaga aktywnej zbiórki na ofiaruje.pl

Podgląd formularza darowizny wtyczki Ofiaruje osadzonego na stronie WordPress
Formularz Ofiaruje osadzony na stronie WordPress za pomocą shortcode [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?

Widok formularza darowizny Ofiaruje na stronie WordPress

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

  1. Wejdź do repozytorium na GitHub: github.com/janlekszycki/ofiaruje-donation-form
  2. Pobierz paczkę ZIP:
    • Releases (zalecane dla stabilnych wydań)
    • Code → Download ZIP (bieżąca wersja z gałęzi main)
  3. Upewnij się, że archiwum zawiera katalog ofiaruje-donation-form/.
  4. W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę.
  5. Wybierz pobrany ZIP i kliknij Zainstaluj teraz.
  6. Aktywuj wtyczkę.
  7. Przejdź do Ustawienia → Ofiaruje i podaj ID zbiórki.

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.

↓ Pobierz z GitHub Releases Repozytorium GitHub

Wersja 2.0.0  ·  Licencja GPL v2