Ofiaruje - Widżet Zbiórek

Plugin WordPress do wyświetlania postępu zbiórki, ostatnich wpłat i darczyńców z API Ofiaruje.

Najważniejsze założenia

• Domyślnie dziedziczy styl motywu WordPress (typografia i kolory).
• Opcjonalnie ładuje własny plik CSS (custom_css_url) po stylu bazowym.
• Każdy kluczowy element można włączać/wyłączać parametrami shortcode.
• Domyślny język interfejsu: polski.

Instalacja

1. Wgraj katalog ofiaruje-fundraiser-widget do wp-content/plugins/.
2. Włącz plugin w panelu WordPress.
3. Wejdź do Ustawienia → Ofiaruje - Widżet Zbiórek.

Shortcode

Podstawowo:

[ofiaruje_fundraiser id="ID_ZBIORKI"]

Pełny przykład:

[ofiaruje_fundraiser
  id="507f1f77bcf86cd799439011"
  donors_limit="10"
  show_title="true"
  show_beneficiary="true"
  show_hero="true"
  show_raised="true"
  show_goal="true"
  show_progress_bar="true"
  show_donors="true"
  donors_label="Ostatnie wpłaty"
  donors_pagination="true"
  donors_page_size="5"
  pagination_prev_label="Poprzednia"
  pagination_next_label="Następna"
  show_count="true"
  show_month_count="true"
  show_fundraiser_button="true"
  fundraiser_button_label="Zobacz zbiórkę na Ofiaruje.pl"
  auto_refresh="300"
  exclude_anonymous="false"
  css_class="moja-klasa-widgetu"
  custom_css_url="https://twoja-domena.pl/widget.css"
  custom_css=".ofiaruje-widget{border-color:#1f2937;}"
]

Parametry shortcode

• id (wymagane) — ID zbiórki.
• donors_limit — liczba ostatnich wpłat (domyślnie 10).
• show_title — tytuł zbiórki.
• show_beneficiary — nazwa beneficjenta.
• show_hero — sekcja hero ze zdjęciem.
• show_progress — parametr kompatybilności (steruje całą sekcją postępu).
• show_raised — wskaźnik zebranej kwoty (działa także dla zbiórek bez celu).
• show_goal — wskaźnik celu (dla zbiórek typu projekt).
• show_progress_bar — pasek postępu (dla zbiórek typu projekt).
• show_donors — lista ostatnich wpłat.
• donors_label — własna etykieta sekcji wpłat (domyślnie: Ostatnie wpłaty).
• donors_pagination — włączenie paginacji listy wpłat.
• donors_page_size — liczba wpłat na stronę (1-100).
• pagination_prev_label — etykieta przycisku poprzedniej strony.
• pagination_next_label — etykieta przycisku następnej strony.
• show_count — łączna liczba wpłat.
• show_month_count — liczba wpłat w bieżącym miesiącu.
• show_fundraiser_button — przycisk do Ofiaruje.pl.
• fundraiser_button_label — tekst przycisku.
• auto_refresh — interwał auto-refresh w sekundach (minimum 60, domyślnie 300).
• exclude_anonymous — ukrywanie anonimowych wpłat.
• css_class — dodatkowa klasa CSS.
• custom_css_url — URL zewnętrznego pliku CSS.
• custom_css — CSS inline dla pojedynczej instancji.

Ustawienia w panelu WordPress

W sekcji Ustawienia → Ofiaruje - Widżet Zbiórek:

• Bazowy URL API
• Czas cache
• Domyślny limit ostatnich wpłat
• Domyślny auto-refresh (sekundy, minimum 60, domyślnie 300)
• URL własnego pliku CSS widgetu
• Domyślny CSS widgetu (edytowany w panelu)
• Edycja bazowego style.css pluginu (widoczny i edytowalny w panelu)

API

Plugin korzysta z:

• GET /v1/fundraisers/:fid
• GET /v1/donations/:fundraiserId?type=countSuccessfulDonations
• GET /v1/donations/:fundraiserId?type=countSuccessfulDonationsFromMonthStart
• GET /v1/donations/:fundraiserId?type=listLastSuccessfulDonations