FW Real Estate – Documentation

The Featured add-on marks a property as featured: a badge on the listing card, an optional pin to the top of every results page, an expiry date so it un-features itself automatically, and a record of how often the promotion was actually seen and clicked. That last part is what separates it from a simple badge — if you sell featured placement, or you are deciding which properties deserve it, impressions and clicks are the difference between promoting on evidence and promoting on instinct.

Use Cases

• Paid placement. Sell a featured slot with a run-out date; the property drops back to normal on its own when the period ends.
• Editor's picks. New construction, best value, the listing you want walk-ins asking about.
• Home-page highlights. The Latest module and Layout Anywhere can be filtered to featured properties only, so a highlights section maintains itself as you change which properties are featured.
• Proving placement worked. The impressions and clicks columns show what a featured property actually received — exactly what a client asks for after paying for a slot.

Settings

Open Configuration → Add-ons → Featured to reach the add-on's single setting.

• Featured listings on top — when enabled, featured properties appear before all other results in every listing, regardless of the visitor's chosen ordering.

Important: this setting overrides the visitor's own sort choice. A visitor who sorts by price ascending still sees featured properties first — the first row will not be the cheapest. That is the intended behaviour, but it is worth considering before enabling it for a price-sensitive market.

Featuring a Property

There are three ways to feature a property:

1. The star column in the properties list. One click toggles featured status without opening the record.
2. The property form. Set Featured and, optionally, a Featured until date on the record itself.
3. By rule from an import feed. A feed's own settings can name a field and a value — for example, a listing type of Showcase — so every imported listing carrying it arrives already featured. Rules are configured per feed, meaning two feeds can apply different criteria, and the rules take effect only while this add-on is enabled.

Featured until is what makes a paid placement self-managing. When the date passes, the site's scheduled task un-features the property automatically. Leave it empty to keep the property featured until you remove the flag by hand. There is no start date — a property becomes featured the moment you feature it.

Impressions and Clicks

The properties list shows two extra columns for featured properties: how many times each was shown in a listing, and how many times it was clicked through to its detail page. Together they indicate whether a featured slot is earning its place. A property with many impressions and few clicks usually has a photo or price problem — not a placement problem.

On the Front End

• A Featured badge on the listing card, styled by the active design.
• Featured properties appear first in every listing when Featured listings on top is enabled.
• A Featured only filter is available in the Latest module and Layout Anywhere, allowing a page section to display exclusively featured stock.

Notes

• There is no limit on how many properties can be featured, and no warning when you have featured too many. Featuring everything is the same as featuring nothing — the badge only works while it is scarce.
• Featured status is a CSV column, so it can be set in bulk from a spreadsheet.
• Disabling the add-on removes the badge, the ordering, and the filter from the front end. The flags remain in the database and are restored when the add-on is re-enabled.

To install this addon, open the Add-ons panel inside FW Real Estate. See Getting Started → Add-ons for details on free addons, paid addons, and site verification.