Publishing offers on your site

Once offers are imported, three things exist without any work on your part:

• The archive — every offer, with a filter bar and sorting, at /{archive-slug}/ (by default /offers/).
• A page per offer — photo slider, key figures, description, agent card, at /{archive-slug}/{offer-slug}/.
• The Offers block — for putting a hand-picked list of offers on any page you like.

This page is about the third one.

#Adding offers to a page

1. Edit the page in the block editor.
2. Add the Offers block (search for “Offers”).
3. Set its options in the sidebar.

Everything the block does, the shortcode [osfec_offers] also does, with the same option names — handy in a widget, a
page builder or a theme that is not block based.

#Recipes

Three newest offers on the home page, with a link to the full listing:

[osfec_offers limit="3" columns="3" more="yes"]

Apartments in Białystok, six of them, in a two-column grid:

[osfec_offers type="mieszkanie" city="Białystok" limit="6" columns="2"]

A searchable listing on a landing page, not just on the archive:

[osfec_offers filters="yes" limit="12"]

A custom label on the link to the archive:

[osfec_offers limit="3" columns="3" more="See all homesteads"]

The full option list is in the Shortcode and block reference.

#Two things that surprise people

Type and city values are the ones Esti sends. They are Polish, because the data is Polish: type="mieszkanie",
city="Białystok". If a value produces an empty list, check the spelling against the dropdowns in the archive filter
bar — they list exactly the values your catalogue contains.

Visitor filters win over the block’s own settings. A block set to city="Białystok" shows Białystok by default, but
if the visitor picks a different city in a filter bar on the same page, that choice wins. Block options are defaults,
not locks. If you need a list that can never be filtered away, leave filters="no" and do not put a filter bar on that
page.

#Linking to a pre-filtered listing

Filters travel in the address, so any link can carry them. That makes them shareable, bookmarkable, cacheable and
visible to search engines:

/offers/?city=bialystok                       Offers in Białystok
/offers/?type=dzialka&transaction=sale        Plots for sale
/offers/?price_max=500000&sort=price_asc      Up to 500,000, cheapest first

Note that the city in the address is the simplified form — bialystok, not Białystok. The parameter list is in
the Shortcode and block reference.

#Offers in other blocks and page builders

The offer post type is available to the Query Loop block and to loop widgets in page builders such as Elementor, so
you can lay offers out with the theme’s own design instead of the plugin’s cards.

One caveat: offer photos are not in the Media Library. The plugin makes the featured image work anyway by feeding
the Esti photo URL to the theme, so images do appear — but WordPress image sizes, cropping and responsive srcset do
not apply to them.

#Common questions

An offer changed in Esti but not on the site. The site catches up on the next run — every six hours, or immediately
with Sync now on the settings screen.

An offer disappeared from the site. Esti stopped publishing it (sold, archived, export switched off), or your import
filter no longer accepts it. The run details in the Sync log say how many offers were removed.

The offer page shows “Price on request”. The price is hidden in Esti, or is not a positive number. Nothing to fix on
the WordPress side.

A field is missing from the offer page. Empty fields are hidden by design rather than shown blank. Attributes that
arrive from Esti as numeric codes — heating, fencing, ownership — also stay hidden while the value dictionary is
unavailable; the settings screen shows how many dictionary entries are cached.