{"id":364149,"date":"2026-09-06T09:36:19","date_gmt":"2026-09-06T09:36:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/tuziemia-oferty\/"},"modified":"2026-09-07T11:11:43","modified_gmt":"2026-09-07T11:11:43","slug":"tuziemia-oferty","status":"publish","type":"plugin","link":"https:\/\/nl.wordpress.org\/plugins\/tuziemia-oferty\/","author":23560543,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"tuziemia - oferty dzia\u0142ek","header_author":"tuziemia.pl","header_description":"Embed land-for-sale listings from tuziemia.pl on your blog, by location (TERYT) or by offer links. Gutenberg block and shortcode, server-side rendered with schema.org structured data for SEO.","assets_banners_color":"f5f0e6","last_updated":"2026-09-07 11:11:43","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/tuziemia.pl","header_author_uri":"","rating":5,"author_block_rating":0,"active_installs":0,"downloads":65,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"tuziemiapl","date":"2026-09-07 11:11:43","revision":3684713},"1.0.1":{"tag":"1.0.1","author":"tuziemiapl","date":"2026-09-07 11:13:37","revision":3684718}},"upgrade_notice":{"1.0.0":"<p>First release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3684739,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3684739,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3684739,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3684739,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"tuziemia-oferty\/offers":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"tuziemia-oferty\/offers","version":"1.0.0","title":"tuziemia.pl - oferty dzia\u0142ek","category":"widgets","icon":"location-alt","description":"Oferty dzia\u0142ek na sprzeda\u017c z tuziemia.pl - portalu z darmowymi ofertami i analizami dzia\u0142ek. Wg lokalizacji (TERYT) lub z wybranych link\u00f3w.","keywords":["tuziemia","nieruchomo\u015bci","dzia\u0142ki","grunt","oferty","teryt","dzia\u0142ka na sprzeda\u017c"],"textdomain":"tuziemia-oferty","supports":{"align":["wide","full"],"html":false,"anchor":true,"spacing":{"margin":true,"padding":true}},"attributes":{"mode":{"type":"string","default":"teryt"},"teryt":{"type":"string","default":""},"urls":{"type":"string","default":""},"limit":{"type":"number","default":12},"columns":{"type":"number","default":3},"sort":{"type":"string","default":"createdAt"},"sortDesc":{"type":"boolean","default":true},"kowr":{"type":"boolean","default":false},"lasy":{"type":"boolean","default":false},"archiwum":{"type":"boolean","default":false},"search":{"type":"string","default":""},"heading":{"type":"string","default":""},"showDescription":{"type":"boolean","default":true},"showMeta":{"type":"boolean","default":true},"showContact":{"type":"boolean","default":false},"ctaText":{"type":"string","default":""}},"editorScript":"file:.\/index.js","style":"tuziemia-oferty"}},"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Offers grid on the site (3 columns).","2":"Block panel - TERYT location picker.","3":"Block panel - link list mode.","4":"Plugin settings screen."}},"plugin_section":[],"plugin_tags":[279377,4528,126269,5070,2199],"plugin_category":[],"plugin_contributors":[279378],"plugin_business_model":[],"class_list":["post-364149","plugin","type-plugin","status-publish","hentry","plugin_tags-land","plugin_tags-listings","plugin_tags-plots","plugin_tags-property","plugin_tags-real-estate","plugin_contributors-tuziemiapl","plugin_committers-tuziemiapl"],"banners":{"banner":"https:\/\/ps.w.org\/tuziemia-oferty\/assets\/banner-772x250.png?rev=3684739","banner_2x":"https:\/\/ps.w.org\/tuziemia-oferty\/assets\/banner-1544x500.png?rev=3684739","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tuziemia-oferty\/assets\/icon-128x128.png?rev=3684739","icon_2x":"https:\/\/ps.w.org\/tuziemia-oferty\/assets\/icon-256x256.png?rev=3684739","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Official plugin of <strong>tuziemia.pl<\/strong>, 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.<\/p>\n\n<p>Two modes:<\/p>\n\n<ol>\n<li><strong>By location (TERYT)<\/strong> - pick a voivodeship, then county, then municipality from a list, and the plugin fetches matching, up-to-date listings.<\/li>\n<li><strong>Selected offers (links)<\/strong> - paste the URLs of specific tuziemia.pl offers and the plugin shows exactly those.<\/li>\n<\/ol>\n\n<p>Listings are added with the <strong>\"tuziemia - oferty dzia\u0142ek\" block<\/strong> in the block editor (with a live preview and a settings panel) or with the <strong><code>[tuziemia_oferty]<\/code> shortcode<\/strong>.<\/p>\n\n<p>Adding listings on tuziemia.pl is free - add your offers at https:\/\/tuziemia.pl and show them on your site with this plugin.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>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.<\/li>\n<li>Link mode for individual offers.<\/li>\n<li>Responsive card grid (1-4 columns), dark mode.<\/li>\n<li>Sorting (newest \/ price \/ area); filters: KOWR pre-emption, State Forests, archived offers, free-text search.<\/li>\n<li>Optional seller contact details, description, location, date added, section heading, custom button label.<\/li>\n<li>Configurable offer-title template (static text + placeholders).<\/li>\n<li>Response caching (1 hour by default) with a one-click cache clear.<\/li>\n<li>Fully translatable (text domain: <code>tuziemia-oferty<\/code>).<\/li>\n<\/ul>\n\n<h4>Offer title template<\/h4>\n\n<p>In <em>Settings -&gt; tuziemia - oferty -&gt; Offer title template<\/em> you decide how each offer heading looks (it is also used for the image <code>alt<\/code> text and for the schema.org data).<\/p>\n\n<ul>\n<li>Type static text normally.<\/li>\n<li>Insert variables in braces: <code>{lokalizacja}<\/code>, <code>{gmina}<\/code>, <code>{powiat}<\/code>, <code>{wojewodztwo}<\/code>, <code>{powierzchnia}<\/code>, <code>{cena}<\/code>, <code>{cena_za_ha}<\/code>, <code>{numer_dzialki}<\/code>.<\/li>\n<li>A fragment in square brackets <code>[ ... ]<\/code> is shown only when the variable inside it has a value, so no empty brackets or dangling dashes are left.<\/li>\n<\/ul>\n\n<p>Default: <code>Dzia\u0142ka na sprzeda\u017c[ - {lokalizacja}][ ({powierzchnia})]<\/code><\/p>\n\n<h4>SEO<\/h4>\n\n<ul>\n<li><strong>Server-side rendering<\/strong> - offer HTML is in the page source, not loaded by JavaScript, so search engines can read it.<\/li>\n<li><strong>schema.org structured data (JSON-LD)<\/strong> - the list is output as an <code>ItemList<\/code> of <code>Product<\/code> \/ <code>Offer<\/code> (price in <code>PLN<\/code>, area in hectares, location, availability). Can be turned off in the settings.<\/li>\n<li><strong>Semantic HTML<\/strong> - each offer is an <code>&lt;article&gt;<\/code> with an <code>&lt;h3&gt;<\/code> heading, a <code>&lt;time datetime&gt;<\/code> element and a descriptive image <code>alt<\/code>.<\/li>\n<li><strong>Followed links<\/strong> to tuziemia.pl by default (can be switched to <code>nofollow<\/code>).<\/li>\n<li><strong>Performance<\/strong> - no front-end JavaScript, a small plugin-scoped stylesheet, lazy-loaded images.<\/li>\n<\/ul>\n\n<h4>Shortcode<\/h4>\n\n<pre><code>[tuziemia_oferty teryt=\"1407032\" limit=\"12\" columns=\"3\" sort=\"createdAt\"]\n\n[tuziemia_oferty urls=\"https:\/\/tuziemia.pl\/oferta\/140703_2.0015.702, https:\/\/tuziemia.pl\/oferta\/240208_2.0002.2899\"]\n<\/code><\/pre>\n\n<p>Attributes: <code>teryt<\/code>, <code>urls<\/code>, <code>limit<\/code>, <code>columns<\/code>, <code>sort<\/code> (<code>createdAt|price|area<\/code>), <code>sort_desc<\/code>, <code>kowr<\/code>, <code>lasy<\/code>, <code>archiwum<\/code>, <code>search<\/code>, <code>heading<\/code>, <code>show_description<\/code>, <code>show_meta<\/code>, <code>show_contact<\/code>, <code>cta<\/code>.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin relies on the external service <strong>tuziemia.pl<\/strong> (a portal with free land-for-sale listings and land analyses) to fetch offer data for display.<\/p>\n\n<ul>\n<li><strong>When:<\/strong> 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.<\/li>\n<li><strong>What is sent:<\/strong> 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 <strong>not<\/strong> send any visitor personal data or credentials.<\/li>\n<li><strong>Endpoints called:<\/strong> <code>https:\/\/tuziemia.pl\/api\/offers<\/code> and <code>https:\/\/tuziemia.pl\/api\/offer-details<\/code>.<\/li>\n<li>Service provider: tuziemia.pl.<\/li>\n<li>Terms of service: https:\/\/tuziemia.pl\/regulamin<\/li>\n<li>Privacy policy: https:\/\/tuziemia.pl\/polityka-prywatnosci<\/li>\n<\/ul>\n\n<p>The service base URL can be changed with the <code>tuziemia_oferty_api_base<\/code> filter or the <code>TUZIEMIA_OFERTY_API_BASE<\/code> constant.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>tuziemia-oferty<\/code> folder to <code>wp-content\/plugins\/<\/code> (or install the ZIP via <em>Plugins -&gt; Add New<\/em>).<\/li>\n<li>Activate the plugin.<\/li>\n<li>(Optional) Set defaults in <em>Settings -&gt; tuziemia - oferty<\/em>.<\/li>\n<li>Add the \"tuziemia - oferty dzia\u0142ek\" block in the editor, or the <code>[tuziemia_oferty]<\/code> shortcode in your content.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20the%20listings%20come%20from%3F\"><h3>Where do the listings come from?<\/h3><\/dt>\n<dd><p>From tuziemia.pl, where anyone can add a land listing for free and check land price analyses and transaction data.<\/p><\/dd>\n<dt id=\"are%20the%20listings%20up%20to%20date%3F\"><h3>Are the listings up to date?<\/h3><\/dt>\n<dd><p>Yes. Responses are cached (1 hour by default) - you can shorten the cache time or clear it manually in the plugin settings.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20seo-friendly%3F\"><h3>Is the plugin SEO-friendly?<\/h3><\/dt>\n<dd><p>Yes - it renders content server-side, adds schema.org (JSON-LD) markup, uses semantic headings and descriptive <code>alt<\/code> attributes, and links to tuziemia.pl are followed by default.<\/p><\/dd>\n<dt id=\"how%20do%20i%20find%20a%20municipality%27s%20teryt%20code%3F\"><h3>How do I find a municipality's TERYT code?<\/h3><\/dt>\n<dd><p>In the block you pick it from a list (voivodeship -&gt; county -&gt; municipality). In the shortcode you pass the 7-digit code, e.g. <code>1407032<\/code>.<\/p><\/dd>\n<dt id=\"where%20do%20i%20get%20a%20link%20to%20a%20single%20offer%3F\"><h3>Where do I get a link to a single offer?<\/h3><\/dt>\n<dd><p>Copy the offer page URL from tuziemia.pl, e.g. <code>https:\/\/tuziemia.pl\/oferta\/140703_2.0015.702<\/code>.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20slow%20down%20the%20site%3F\"><h3>Does the plugin slow down the site?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: block and shortcode, TERYT mode and link mode, caching, settings, bundled TERYT dataset, schema.org structured data and SEO optimisations.<\/li>\n<\/ul>","raw_excerpt":"Embed land-for-sale listings from tuziemia.pl on your blog, by location (TERYT) or by offer links. Gutenberg block and shortcode, SEO-friendly.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/364149","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=364149"}],"author":[{"embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/tuziemiapl"}],"wp:attachment":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=364149"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=364149"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=364149"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=364149"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=364149"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=364149"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}