Description
Official plugin of tuziemia.pl, a Polish portal with free land-for-sale listings and land analyses. It lets real estate agents and bloggers embed a responsive section of current land listings from tuziemia.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” block in the block editor (with a live preview and a settings panel) or with the [tuziemia_oferty] shortcode.
Adding listings on tuziemia.pl is free – add your offers at https://tuziemia.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
In Settings -> Tuziemia Oferty -> Offer title template you decide how each offer heading looks (it is also used for the image alt text and for the schema.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
ItemListofProduct/Offer(price inPLN, 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 imagealt. - 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"]
[tuziemia_oferty urls="https://tuziemia.pl/oferta/140703_2.0015.702, https://tuziemia.pl/oferta/240208_2.0002.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
This plugin relies on the external service tuziemia.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/offersandhttps://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.
Blocks
This plugin provides 1 block.
- tuziemia.pl – oferty działek Oferty działek na sprzedaż z tuziemia.pl – portalu z darmowymi ofertami i analizami działek. Wg lokalizacji (TERYT) lub z wybranych linków.
Installation
- Upload the
tuziemia-ofertyfolder towp-content/plugins/(or install the ZIP via Plugins -> Add New). - Activate the plugin.
- (Optional) Set defaults in Settings -> Tuziemia Oferty.
- Add the “Tuziemia Oferty” block in the editor, or the
[tuziemia_oferty]shortcode in your content.
FAQ
-
Where do the listings come from?
-
From tuziemia.pl, where anyone can add a land listing for free and check land price analyses and transaction data.
-
Are the listings up to date?
-
Yes. Responses are cached (1 hour by default) – you can shorten the cache time or clear it manually in the plugin settings.
-
Is the plugin SEO-friendly?
-
Yes – it renders content server-side, adds schema.org (JSON-LD) markup, uses semantic headings and descriptive
altattributes, and links to tuziemia.pl are followed by default. -
How do I find a municipality’s TERYT code?
-
In the block you pick it from a list (voivodeship -> county -> municipality). In the shortcode you pass the 7-digit code, e.g.
1407032. -
Where do I get a link to a single offer?
-
Copy the offer page URL from tuziemia.pl, e.g.
https://tuziemia.pl/oferta/140703_2.0015.702. -
Does the plugin slow down the site?
-
Data is fetched server-side and cached, so visitors do not wait for external requests after the first load. There is no front-end JavaScript.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Tuziemia Oferty” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Tuziemia Oferty” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- First release: block and shortcode, TERYT mode and link mode, caching, settings, bundled TERYT dataset, schema.org structured data and SEO optimisations.