Title: wspieraj.org &#8211; Widget Dotacyjny
Author: wspieraj.org
Published: <strong>November 19, 2026</strong>
Last modified: November 19, 2026

---

Search plugins

![](https://ps.w.org/wspieraj-org/assets/banner-772x250.png?rev=3812007)

![](https://ps.w.org/wspieraj-org/assets/icon-256x256.png?rev=3812007)

# wspieraj.org – Widget Dotacyjny

 By [wspieraj.org](https://profiles.wordpress.org/wspierajorg/)

[Download](https://downloads.wordpress.org/plugin/wspieraj-org.1.11.1.zip)

 * [Details](https://wordpress.org/plugins/wspieraj-org/#description)
 * [Reviews](https://wordpress.org/plugins/wspieraj-org/#reviews)
 *  [Installation](https://wordpress.org/plugins/wspieraj-org/#installation)
 * [Development](https://wordpress.org/plugins/wspieraj-org/#developers)

 [Support](https://wordpress.org/support/plugin/wspieraj-org/)

## Description

This is the official plugin for wspieraj.org, a Polish donation widget platform 
for foundations, associations and public benefit organizations. The platform takes
no commission on donations. It is funded by optional contributions that donors may
add when they donate.

The plugin does not turn your site into a fundraising portal. Fundraisers live on
your organization’s own website, so the traffic, search rankings and trust stay 
with your domain, and donors never see fundraisers of other organizations along 
the way.

The settings screen and the donation widget are in Polish, and donations are processed
in Polish złoty (PLN).

#### Features

 * **[wspieraj_form]** shows a simple donation form for your organization’s general
   purposes. The only setup is connecting your account.
 * **[wspieraj_campaign id=”…”]** shows a single fundraiser with its description,
   photos, progress bar, recent donations and the donation form.
 * **[wspieraj_zbiorki]** shows a grid of cards with your active fundraisers. Clicking
   a card opens the fundraiser, the browser’s Back button returns to the grid, and
   every fundraiser has its own address to share with friends.
 * **[wspieraj_1_5]** shows a “donate 1.5% of your income tax” box with your organization’s
   KRS number, taken from the official registry, and a copy button. On a fundraiser
   page it also shows the specific purpose (cel szczegółowy) for the tax form.
 * **A page for a single fundraiser without shortcodes.** Pick a fundraiser in the“
   Zbiórka wspieraj.org” box of the post or page editor. The fundraiser card appears
   below the content, or your theme can place it with `wspieraj_karta_zbiorki()`.
 * **SEO for fundraiser pages.** The plugin fills in the SEO title, meta description
   and the Facebook and X previews of a fundraiser page from the fundraiser itself,
   with a title pattern and an optional description suffix that you set. By default
   it fills in only the fields you leave empty in your SEO plugin. This works with
   no SEO plugin and with Yoast SEO, Rank Math or SEOPress. The data is not saved
   in your database, so a change of the fundraiser title shows up right away.
 * The widget adjusts its height to its content automatically, so there is no height
   to set by hand.

#### How it works

 1. Create a free account at wspieraj.org and set up your fundraisers in the dashboard.
 2. Copy the connection key from the settings of your wspieraj.org dashboard. It is
    generated for you in advance.
 3. Paste the key into the plugin settings on your site.
 4. Insert a shortcode into a post, a page or an Elementor Shortcode widget.

The connection key is not a password. It is an identifier that you can revoke at
any time in the wspieraj.org dashboard, for example when you change the agency that
runs your website.

### External services

This plugin connects to services run by wspieraj.org (AMS SOFTWARE sp. z o.o.) to
show the donation widget and fundraiser data. Without these connections the plugin
has no function, as connecting your site to wspieraj.org is its only purpose.

#### api.wspieraj.org: public REST API

Your WordPress server connects to `https://api.wspieraj.org` in these situations:

 * when you save the connection key in the plugin settings, to check that the key
   is valid and get your organization’s name;
 * when you open the plugin settings page, to list your fundraisers with ready-to-
   copy shortcodes;
 * once a day in the background, to add your site’s address to the list of sites
   to which donors are sent back after a donation (the connection key and the site
   address are sent);
 * when a page with the `[wspieraj_zbiorki]` shortcode is viewed, to get the list
   of active fundraisers for the cards;
 * when a post with the `[wspieraj_campaign]` shortcode, or a fundraiser opened 
   from the `[wspieraj_zbiorki]` grid, is viewed, to get the fundraiser’s title,
   description and image for the Open Graph tags. The preview image address points
   to `api.wspieraj.org`. The image is downloaded by the service where the link 
   is shared (for example Facebook), not by the visitor’s browser.

The plugin sends only the fundraiser identifier or your organization’s identifier
or connection key, together with your site’s address (in the `Origin` header, so
that the wspieraj.org dashboard can show where the key is used). No personal data
about your site’s visitors is sent. Responses are cached on your site for 2 minutes
to limit the number of requests.

#### app.wspieraj.org: the donation widget

When `[wspieraj_form]`, `[wspieraj_campaign]` or a fundraiser opened from `[wspieraj_zbiorki]`
is shown to a visitor, the visitor’s browser (not your WordPress server) loads these
directly from `https://app.wspieraj.org`:

 * an `<iframe>` with the donation form, where the visitor enters the amount and
   the payment details;
 * the `embed.js` script, which adjusts the height of that iframe to its content.

Payments inside the iframe are handled by Tpay, a licensed Polish payment institution.
wspieraj.org does not store card or bank transfer details.

#### images.wspieraj.org: fundraiser photos

On a page with `[wspieraj_zbiorki]`, the visitor’s browser loads the fundraiser 
cover photos from `https://images.wspieraj.org`. If an organization added a photo
by pasting its address, that photo is loaded from the address it provided. As with
any image, the server that hosts the photo receives the visitor’s IP address and
browser details. Nothing else is sent.

Service provider: **AMS SOFTWARE sp. z o.o.**, ul. Józefa Wajzera 19/22, 41-808 
Zabrze, Poland, KRS 0001242326, tax ID (NIP) 6482836354.

The following documents are in Polish:

 * Terms of service: https://wspieraj.org/regulamin
 * Privacy policy: https://wspieraj.org/polityka-prywatnosci
 * Data processing agreement: https://wspieraj.org/umowa-powierzenia

## Screenshots

[⌊The plugin settings page with the connection status and the list of fundraisers
with ready-to-copy shortcodes.⌉⌊The plugin settings page with the connection status
and the list of fundraisers with ready-to-copy shortcodes.⌉[

The plugin settings page with the connection status and the list of fundraisers 
with ready-to-copy shortcodes.

[⌊A grid of fundraisers shown by [wspieraj_zbiorki].⌉⌊A grid of fundraisers shown
by [wspieraj_zbiorki].⌉[

A grid of fundraisers shown by [wspieraj_zbiorki].

[⌊A single fundraiser with its description, progress bar and donation form.⌉⌊A single
fundraiser with its description, progress bar and donation form.⌉[

A single fundraiser with its description, progress bar and donation form.

## Installation

 1. In your WordPress dashboard, go to **Plugins  Add New**, search for “wspieraj.org”,
    click **Install Now** and then **Activate**. For a manual installation, download
    the ZIP file and use **Plugins  Add New  Upload Plugin**.
 2. A **wspieraj.org** item appears in the admin menu. Open it.
 3. In the wspieraj.org dashboard, open **Ustawienia  Wtyczka WordPress** (Settings
    WordPress plugin) and copy the connection key. Paste it into the **Klucz połączenia**(
    connection key) field in the plugin settings and click **Połącz** (Connect).
 4. Paste a shortcode into a post or a page:
 5.  * `[wspieraj_form]` for a simple donation form,
     * `[wspieraj_campaign id="…"]` for a specific fundraiser (copy the identifier 
       from the table on the plugin settings page),
     * `[wspieraj_zbiorki]` for a grid of active fundraisers. Optional attributes: `
       kolumny` (the maximum number of columns, from 1 to 4, default 3) and `limit`(
       the number of fundraisers, default 12), for example `[wspieraj_zbiorki kolumny
       ="2" limit="6"]`.

## FAQ

### Does the plugin take a commission on donations?

No. wspieraj.org takes no commission on donations. It is funded by an optional contribution
that donors can add when they donate.

### Is the plugin available in English?

Not yet. The settings screen and the donation widget are in Polish, because wspieraj.
org serves Polish nonprofits and processes donations in PLN.

### The widget shows an empty area instead of the form.

Check that the plugin is connected (the **wspieraj.org** menu in your dashboard).
Without a connected key, the shortcodes show a message rather than an empty widget.
If the area is completely empty, check whether another plugin, such as a performance
plugin, blocks iframes from other domains.

### A fundraiser is missing from [wspieraj_zbiorki] or from the table in the plugin settings.

Only active fundraisers are shown. Drafts and fundraisers waiting for approval in
the wspieraj.org dashboard are hidden on purpose, so that content nobody has approved
yet is never published.

The `[wspieraj_zbiorki]` grid also shows only the fundraisers whose “show on your
website’s list” switch (**Na liście zbiórek na Twojej stronie**) is on in the dashboard.
The general-purpose fundraiser is off the list by default, because `[wspieraj_form]`
collects donations for the organization. A fundraiser that is off the list still
works with its own shortcode and address.

### I changed a fundraiser, but the page still shows the old content.

Data from wspieraj.org is cached on your site for 2 minutes. With LiteSpeed Cache,
the plugin limits the cache time of a page with `[wspieraj_zbiorki]` to the same
2 minutes. Other page caching plugins (such as WP Rocket, W3 Total Cache or WP Super
Cache) cannot set a cache time for a single page, so exclude the page with `[wspieraj_zbiorki]`
from their cache or shorten its lifetime. Otherwise new fundraisers and amounts 
appear only after you clear the cache.

### A shared fundraiser shows the page name instead of the fundraiser title on Facebook.

With no SEO plugin, and with Yoast SEO, Rank Math or SEOPress, the plugin itself
provides the title, description, address and image of the opened fundraiser. When
an SEO plugin is active, it does so through that plugin’s filters, so the page keeps
a single set of tags. Facebook remembers a preview once it has downloaded it. After
a change, paste the address into the Sharing Debugger (https://developers.facebook.
com/tools/debug/) and click “Scrape Again”.

### Will the plugin overwrite the SEO title or description I wrote myself?

No, not by default. On a page assigned to a fundraiser, the plugin fills in only
the fields that are empty in Yoast SEO, Rank Math or SEOPress. You can switch it
to always use the fundraiser data, or turn it off, in the plugin settings (section
4). On a [wspieraj_zbiorki] grid page with an opened fundraiser, the plugin always
describes the opened fundraiser, as the page’s own fields describe the grid.

### Do I need a developer to add the widget?

No. Pasting a shortcode works in the block editor (Shortcode block), the classic
editor and most page builders, such as Elementor (Shortcode widget).

### Does the plugin keep up with new WordPress versions?

Yes. We test the plugin with every major WordPress release and update “Tested up
to” only after an actual test. If “Tested up to” falls behind a new release for 
a while, it means we have not finished testing yet, not that the plugin has stopped
working.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“wspieraj.org – Widget Dotacyjny” is open source software. The following people 
have contributed to this plugin.

Contributors

 *   [ wspieraj.org ](https://profiles.wordpress.org/wspierajorg/)

[Translate “wspieraj.org – Widget Dotacyjny” into your language.](https://translate.wordpress.org/projects/wp-plugins/wspieraj-org)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wspieraj-org/), check
out the [SVN repository](https://plugins.svn.wordpress.org/wspieraj-org/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/wspieraj-org/) by
[RSS](https://plugins.trac.wordpress.org/log/wspieraj-org/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.11.1

 * Polish typography: single-letter conjunctions and prepositions (a, i, o, u, w,
   z) in fundraiser tile titles and purposes, and in the 1.5% box, no longer end
   a line on their own. The specific purpose that donors copy into their tax return
   is left unchanged.

#### 1.11.0

 * New “Zbiórka wspieraj.org” box in the post and page editor: assign a fundraiser
   to a page without a shortcode. The card shows below the content (can be turned
   off for themes that place it themselves).
 * SEO for pages assigned to a fundraiser: SEO title from a pattern (%tytul_zbiorki%,%
   tytul_strony%, %nazwa_strony%), meta description from the fundraiser’s purpose
   with an optional suffix (%krs% is your KRS number), Facebook and X title, description
   and a 1200×630 image. By default only fields left empty in the SEO plugin are
   filled in. Earlier versions always overwrote them on [wspieraj_campaign] pages;
   choose “always” in the settings to keep that behavior.
 * New [wspieraj_1_5] shortcode: a 1.5% income tax box with the KRS number from 
   the registry, the specific purpose and copy buttons.
 * For developers: `wspieraj_zbiorka_strony()`, `wspieraj_karta_zbiorki()`, `wspieraj_zbiorka_aktywna()`
   and the `wspieraj_zbiorka_strony` filter. The post meta `_wspieraj_zbiorka` and`
   _wspieraj_cel_1_5` and the new settings are available in the WordPress REST API
   for users who can edit them.
 * SEO titles longer than 60 characters drop the site name first and are then shortened
   at a word boundary; descriptions are kept within 155 characters.

#### 1.10.1

 * When a fundraiser hides both the amounts and the donors (e.g. a long-term fundraiser
   for a child), the [wspieraj_zbiorki] tile no longer shows the number of donations
   either.

#### 1.10.0

 * The [wspieraj_zbiorki] grid shows only the fundraisers you keep on the list in
   the wspieraj.org dashboard (the “show on your website’s list” switch). The general-
   purpose fundraiser is off the list by default, as [wspieraj_form] collects donations
   for the organization.
 * The table of fundraisers in the plugin settings also shows fundraisers that are
   off the list, so you can copy their shortcodes.
 * With LiteSpeed Cache, a page with [wspieraj_zbiorki] is cached for 2 minutes 
   instead of LiteSpeed’s default of a week, so new fundraisers and donations show
   up within minutes.
 * Amounts on the cards always use the Polish number format (“18 500 zł”, not “18,500
   zł”), whatever language files are installed on the site.
 * Stricter cleaning of the page address and of the manual organization identifier
   field.

#### 1.9.3

 * When you turn off “show donors the amount raised” for a fundraiser in the dashboard,
   its card shows only the number of donations, without the amount, the goal or 
   the progress bar.

#### 1.9.2

 * Security fix: the page address passed to the widget is now encoded, so parameters
   added to your page’s address can no longer change what the widget shows (for 
   example, a different fundraiser).
 * The page address is now built from the WordPress settings instead of the `Host`
   header sent by the browser.

#### 1.9.1

 * Faster [wspieraj_zbiorki] grid: photos in the first row load immediately instead
   of after scrolling, and their space is reserved, so the page no longer jumps 
   while loading.
 * On a page with the fundraiser grid, the browser connects to the image server 
   earlier.

#### 1.9.0

 * Cards in [wspieraj_zbiorki] show a short “fundraiser goal” under the title, if
   the organization entered one in the wspieraj.org dashboard.
 * The same goal is used as the description in the preview of a shared fundraiser(
   Facebook, Messenger, WhatsApp), instead of the beginning of the long description.

#### 1.8.0

 * The plugin reports your site’s address by itself (once a day, in the background).
   This lets us safely send donors back to your site after a donation, with nothing
   to set up in the wspieraj.org dashboard.

#### 1.7.1

 * Security fix: with SEOPress, the fundraiser title in the page title was not escaped.
   Do not install 1.7.0; update straight to 1.7.1.

#### 1.7.0

 * The preview of a shared fundraiser also works with Rank Math and SEOPress (previously
   only with no SEO plugin or with Yoast SEO).
 * The preview image address carries the cover version in its path instead of a 
   query parameter. Rank Math removed the parameter, so after a cover change Facebook
   could get the old image.

#### 1.6.0

 * Larger, easier to read fundraiser cards: the title, amount and labels are sized
   like on large fundraising sites.
 * Sizes no longer depend on the theme. A theme with a smaller base font size (the
   common `html { font-size: 62.5% }`) used to shrink the cards by more than a third,
   and its heading styles could override the title.

#### 1.5.0

 * Fixed the preview of a shared fundraiser on Facebook and in messaging apps. With
   Yoast SEO, the card showed the page title and no image; now the plugin gives 
   Yoast the title, description, address and image of the opened fundraiser. With
   no SEO plugin, the tags were missing entirely since version 1.2.3 (readable fundraiser
   addresses); this is fixed as well.
 * The preview image is a 1200×630 JPG with its dimensions declared, as Facebook
   recommends. Previously it was a WebP file, which Facebook sometimes ignores.
 * An opened fundraiser has its own canonical address and page title (“Fundraiser
   title – Site name”).

#### 1.4.0

 * A fundraiser card with an end date shows “X days left” (“last day” on the final
   day and “ended” after the date; the fundraiser still accepts donations). A fundraiser
   without an end date shows nothing.

#### 1.3.0

 * New look for the [wspieraj_zbiorki] grid: a larger title instead of a description
   excerpt, the amount as “X zł of Y zł”, a thicker progress bar, the number of 
   donations and the percentage of the goal. A goal that has been exceeded is shown
   as such (for example “111%”).
 * A card without a photo has a placeholder of the same height, so a row of cards
   stays aligned when a fundraiser has no photo.
 * The progress bar uses the color from your organization’s widget settings.
 * The general-purpose fundraiser is shown at the end of the grid, after the specific
   fundraisers.
 * Amounts in the grid refresh every 2 minutes instead of every 15, so a donor returning
   from the payment sees their donation sooner.

#### 1.2.3

 * Fundraiser addresses (grid cards and the shortcode table) now use a readable 
   identifier based on the title (for example “po-miesiacach-walki”) instead of 
   a raw UUID. Previously published addresses keep working, as both formats are 
   recognized.

#### 1.2.2

 * Fixed a frame that was too narrow for [wspieraj_campaign] and for a fundraiser
   opened from [wspieraj_zbiorki]. The container had a fixed width of 820px, although
   the widget inside can use up to 1024px, which left empty space in wider content
   columns.

#### 1.2.1

 * Fixed the settings page showing “not connected” even though a valid key had been
   pasted. This happened when the first key check hit a temporary outage. The page
   now retries on the next visit, without pasting the key again.
 * In the wspieraj.org dashboard, the connection key moved from the widget builder
   to the settings. There is now always exactly one key, ready to use.

#### 1.2.0

 * New [wspieraj_zbiorki] shortcode: a grid of cards with all active fundraisers,
   which opens a single fundraiser and returns to the grid.
 * A connection key, which can be revoked in the wspieraj.org dashboard, replaces
   typing in the organization identifier by hand.
 * Redesigned settings page with the connection status, a list of fundraisers with
   ready-to-copy shortcodes, instructions and troubleshooting.

#### 1.1.0

 * Open Graph tags for a shared fundraiser (title, description and image).
 * The widget height adjusts to its content automatically.
 * Sharing improvements: the system share sheet, WhatsApp, copying the link and 
   a QR code.

#### 1.0.0

 * First release with the [wspieraj_form] and [wspieraj_campaign] shortcodes.

## Meta

 *  Version **1.11.1**
 *  Last updated **2 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [donations](https://wordpress.org/plugins/tags/donations/)[fundraising](https://wordpress.org/plugins/tags/fundraising/)
   [nonprofit](https://wordpress.org/plugins/tags/nonprofit/)[payments](https://wordpress.org/plugins/tags/payments/)
   [widget](https://wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://wordpress.org/plugins/wspieraj-org/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/wspieraj-org/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wspieraj-org/reviews/)

## Contributors

 *   [ wspieraj.org ](https://profiles.wordpress.org/wspierajorg/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wspieraj-org/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://wspieraj.org)