{"id":22,"date":"2026-09-16T10:28:32","date_gmt":"2026-09-16T10:28:32","guid":{"rendered":"https:\/\/docs.latw.ai\/uncategorized\/shortcode-and-block-reference\/"},"modified":"2026-09-16T10:28:32","modified_gmt":"2026-09-16T10:28:32","slug":"shortcode-and-block-reference","status":"publish","type":"post","link":"https:\/\/docs.latw.ai\/pl\/esti-to-wordpress\/shortcode-and-block-reference\/","title":{"rendered":"Shortcode and Block Reference"},"content":{"rendered":"

Shortcode and block reference<\/h1>\n

The [osfec_offers]<\/code> shortcode and the Offers<\/strong> block render through exactly the same code, so they accept the same
\noptions and always produce the same markup.<\/p>\n

[osfec_offers type=\"mieszkanie\" city=\"Bia\u0142ystok\" limit=\"12\" filters=\"yes\"]<\/code><\/pre>\n
Attributes<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Attribute<\/th>\nValues<\/th>\nDefault<\/th>\nWhat it does<\/th>\n<\/tr>\n<\/thead>\n
type<\/code><\/td>\nAn offer type slug, e.g. mieszkanie<\/code>, dom<\/code>, dzialka<\/code><\/td>\nempty<\/td>\nOnly offers of that type<\/td>\n<\/tr>\n
city<\/code><\/td>\nA city name or its slug, e.g. Bia\u0142ystok<\/code> or bialystok<\/code><\/td>\nempty<\/td>\nOnly offers in that city<\/td>\n<\/tr>\n
transaction<\/code><\/td>\nsale<\/code>, rent<\/code>, purchase<\/code>, lease<\/code><\/td>\nempty<\/td>\nOnly that transaction<\/td>\n<\/tr>\n
agent<\/code><\/td>\nEsti agent ID (number) or agent name<\/td>\nempty<\/td>\nOnly that agent’s offers<\/td>\n<\/tr>\n
limit<\/code><\/td>\nA positive integer<\/td>\nOffers per page<\/strong> from the settings (12)<\/td>\nHow many offers to show<\/td>\n<\/tr>\n
sort<\/code><\/td>\ndate<\/code>, price_asc<\/code>, price_desc<\/code>, area_asc<\/code>, area_desc<\/code><\/td>\ndate<\/code><\/td>\nOrder of the list<\/td>\n<\/tr>\n
filters<\/code><\/td>\nyes<\/code> \/ no<\/code><\/td>\nno<\/code><\/td>\nPrints the filter bar above the list<\/td>\n<\/tr>\n
columns<\/code><\/td>\n0<\/code>\u20136<\/code><\/td>\n0<\/code><\/td>\n0<\/code> keeps the stacked list; anything else lays the cards out in a grid<\/td>\n<\/tr>\n
more<\/code><\/td>\nno<\/code>, yes<\/code>, or any text<\/td>\nno<\/code><\/td>\nAdds a link to the offer archive under the list. yes<\/code> prints “View all offers”, any other text becomes the label<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Unknown attributes are ignored. There is no pagination on the shortcode or block: it shows limit<\/code> offers and stops.
\nPagination lives on the archive.<\/p>\n
Notes on individual attributes<\/h3>\n
type<\/code><\/strong> takes the slug, not the label. It is the type name with its bracketed variant removed and simplified:
\nMieszkanie<\/code> \u2192 mieszkanie<\/code>, Dzia\u0142ka (Rolna)<\/code> \u2192 dzialka<\/code>. The Property type<\/strong> dropdown in the filter bar lists the
\nvalues your catalogue actually contains.<\/p>\n
city<\/code><\/strong> accepts either the raw Esti spelling (Bia\u0142ystok<\/code>) or its slug (bialystok<\/code>); both resolve to the same
\noffers. An unknown city matches nothing rather than everything.<\/p>\n
agent<\/code><\/strong> is matched by ID when it is numeric and by name otherwise. The ID is the stable one \u2014 names change.<\/p>\n
columns<\/code><\/strong> is capped at 6. The grid collapses to two columns below 980px and to one below 600px, so a columns=\"4\"<\/code>
\nlist is still readable on a phone.<\/p>\n
more<\/code><\/strong> builds its link from the attributes in play, so a block filtered to Bia\u0142ystok links to the archive already
\nfiltered to Bia\u0142ystok.<\/p>\n
How attributes and visitor filters interact<\/h2>\n
Attributes are defaults<\/strong>. When the same parameter arrives in the URL \u2014 because a visitor used a filter bar, or
\nfollowed a pre-filtered link \u2014 the URL wins:<\/p>\n
[osfec_offers city=\"Bia\u0142ystok\" filters=\"yes\"]\n\n\/landing-page\/                    \u2192 offers in Bia\u0142ystok\n\/landing-page\/?city=suprasl       \u2192 offers in Supra\u015bl<\/code><\/pre>\n
This applies to type<\/code>, city<\/code>, transaction<\/code>, agent<\/code> and sort<\/code>. limit<\/code>, columns<\/code>, filters<\/code> and more<\/code> are never
\noverridden by the URL.<\/p>\n
URL parameters<\/h2>\n
The archive, and any list rendered with filters=\"yes\"<\/code>, filter through plain GET parameters. Ordinary parameters, on
\npurpose: results stay linkable, bookmarkable, cacheable and indexable, and the browser’s back button works.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nValues<\/th>\nExample<\/th>\n<\/tr>\n<\/thead>\n
type<\/code><\/td>\ntype slug<\/td>\n?type=dzialka<\/code><\/td>\n<\/tr>\n
city<\/code><\/td>\ncity name or slug<\/td>\n?city=bialystok<\/code><\/td>\n<\/tr>\n
transaction<\/code><\/td>\nsale<\/code>, rent<\/code>, purchase<\/code>, lease<\/code><\/td>\n?transaction=sale<\/code><\/td>\n<\/tr>\n
agent<\/code><\/td>\nagent ID or name<\/td>\n?agent=42<\/code><\/td>\n<\/tr>\n
price_min<\/code> \/ price_max<\/code><\/td>\nnumber<\/td>\n?price_min=200000&price_max=500000<\/code><\/td>\n<\/tr>\n
area_min<\/code> \/ area_max<\/code><\/td>\nnumber<\/td>\n?area_min=40<\/code><\/td>\n<\/tr>\n
rooms<\/code><\/td>\nnumber (exact match)<\/td>\n?rooms=3<\/code><\/td>\n<\/tr>\n
sort<\/code><\/td>\ndate<\/code>, price_asc<\/code>, price_desc<\/code>, area_asc<\/code>, area_desc<\/code><\/td>\n?sort=price_asc<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Combine them freely; every criterion must match:<\/p>\n
\/offers\/?type=mieszkanie&city=bialystok&price_max=600000&sort=price_asc<\/code><\/pre>\n
Rules worth knowing:<\/p>\n
    \n
  • Anything not on this list is ignored.<\/li>\n
  • Numbers tolerate spaces and a comma as the decimal separator, and are read as positive values.<\/li>\n
  • rooms<\/code> is an exact match, not a minimum.<\/li>\n
  • An unrecognised sort<\/code> value falls back to newest first.<\/li>\n
  • A parameter whose control is hidden in Settings \u2192 Archive filters<\/strong> still works in the URL. Hiding a control does
    \nnot disable the filter.<\/li>\n
  • Whether a hidden filter shows up in the form of a shortcode-rendered filter bar depends on the same setting, so a link
    \nis the way to apply it.<\/li>\n<\/ul>\n
    Where the values come from<\/h2>\n
    Type and city values are data from Esti<\/strong>, not interface text, so they stay in the original language \u2014 usually Polish.
    \nThe dropdowns in the filter bar are the authoritative list of what your catalogue contains; they are rebuilt from the
    \nimported offers and refreshed within six hours of a change.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Shortcode and block reference The [osfec_offers] shortcode and the Offers block render through exactly the same code, so they accept the same options and always produce\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_latwm_translated_slug":"","footnotes":""},"categories":[2],"tags":[],"class_list":["post-22","post","type-post","status-publish","format-standard","hentry","category-esti-to-wordpress"],"_links":{"self":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/22","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/comments?post=22"}],"version-history":[{"count":1,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/22\/revisions"}],"predecessor-version":[{"id":48,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/22\/revisions\/48"}],"wp:attachment":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/media?parent=22"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/categories?post=22"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/tags?post=22"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}