About this plugin
pl, a Polish portal with free land-for-sale listings and land analyses. pl on their own site.
Two modes:
- By location (TERYT) – pick a voivodeship, then county, then municipality from a list, and the plugin fetches matching, up-to-date listings.
- Selected offers (links) – paste the URLs of specific tuziemia.pl offers and the plugin shows exactly those.
Listings are added with the “tuziemia – oferty działek” block in the block editor (with a live preview and a settings panel) or with the [tuziemia_oferty] shortcode.
pl and show them on your site with this plugin.
Features
- Cascading location picker (16 voivodeships, 380 counties, 2479 municipalities) – the TERYT dataset is bundled with the plugin, so choosing a location needs no external request.
- Link mode for individual offers.
- Responsive card grid (1-4 columns), dark mode.
- Sorting (newest / price / area); filters: KOWR pre-emption, State Forests, archived offers, free-text search.
- Optional seller contact details, description, location, date added, section heading, custom button label.
- Configurable offer-title template (static text + placeholders).
- Response caching (1 hour by default) with a one-click cache clear.
- Fully translatable (text domain: tuziemia-oferty ).
Offer title template
org data).
- Type static text normally.
- Insert variables in braces: {lokalizacja}, {gmina}, {powiat}, {wojewodztwo}, {powierzchnia}, {cena}, {cena_za_ha}, {numer_dzialki}.
- A fragment in square brackets [... ] is shown only when the variable inside it has a value, so no empty brackets or dangling dashes are left.
Default: Działka na sprzedaż[ - {lokalizacja}][ ({powierzchnia})]
SEO
- Server-side rendering – offer HTML is in the page source, not loaded by JavaScript, so search engines can read it.
- schema.org structured data (JSON-LD) – the list is output as an ItemList of Product / Offer (price in PLN, area in hectares, location, availability). Can be turned off in the settings.
- Semantic HTML – each offer is an <article> with an <h3> heading, a <time datetime> element and a descriptive image alt.
- Followed links to tuziemia.pl by default (can be switched to nofollow ).
- Performance – no front-end JavaScript, a small plugin-scoped stylesheet, lazy-loaded images.
Shortcode
[tuziemia_oferty teryt="1407032" limit="12" columns="3" sort="createdAt"]
2899"]
Attributes: teryt, urls, limit, columns, sort ( createdAt|price|area ), sort_desc, kowr, lasy, archiwum, search, heading, show_description, show_meta, show_contact, cta.
External services
pl (a portal with free land-for-sale listings and land analyses) to fetch offer data for display.
- When: when a page or post that contains this plugin’s block or shortcode is rendered (the result is cached, 1 hour by default), and in the block editor while previewing.
- What is sent: only the query parameters entered by the site administrator – the TERYT code (voivodeship / county / municipality) or the parcel identifier extracted from a provided link, plus sorting and filtering parameters. The plugin does not send any visitor personal data or credentials.
- Endpoints called: https://tuziemia.pl/api/offers and https://tuziemia.pl/api/offer-details.
- Service provider: tuziemia.pl.
- Terms of service: https://tuziemia.pl/regulamin
- Privacy policy: https://tuziemia.pl/polityka-prywatnosci
The service base URL can be changed with the tuziemia_oferty_api_base filter or the TUZIEMIA_OFERTY_API_BASE constant.