FW Real Estate – Documentation

The FWRE Agents add-on turns your site from a catalogue into an agency: agent profiles with photo, company and contact details, a public directory, agents assigned to properties, a bookable viewing calendar, visitor reviews, and an account area where each agent manages their own presence.

Property is bought from people. A listing with a named agent, a face, and a phone number converts better than the same listing with a contact form alone — and once an agent owns their listings, enquiries reach the person who can answer them instead of a shared inbox.

Use Cases

• The people behind the agency. A directory that says who you are — what a first-time visitor checks before they call anybody.
• The right person on the right property. Assign agents to properties; the property page shows their block automatically.
• Bookable viewings. Visitors pick from the agent's own availability rather than emailing to ask when is convenient.
• Reviews. Visitors leave feedback on an agent — social proof attached to a person, not just the site.
• Agents who maintain themselves. Each agent edits their own profile and sees their own activity, so keeping the directory current is not an administrator's job.

The Agent Record

An agent is a site user with a profile: photo, first and last name, company and company logo, phone, email, biography, and a title ("Senior Agent", "Branch Manager") drawn from a dictionary this add-on provides, so titles stay consistent and translatable.

Photos display at approximately 150×150 pixels; company logos at approximately 200×50 pixels. Uploading at roughly those proportions avoids odd cropping.

Two additional fields describe what an agent can help with, both entered as comma-separated values:

• Languages — short language codes separated by commas (e.g. en, fr, de). The profile displays these as full language names ("English, French, German") in the visitor's browsing language.
• Specializations — free text separated by commas (e.g. Residential sales, Lettings), shown as written on the public profile.

Both fields may be left empty. Agents also carry availability — the days and hours they accept viewings, each day its own window. Visitors can only book inside those hours.

Settings

Find these under Configuration → Add-ons → Agents.

• Approve new agents automatically — when off, a new agent registration waits for an administrator to approve it. Leave this off on a public site; it is the setting that decides whether anyone can put themselves on your agency page.
• Agent profile on the site — controls whether the agent block appears on property pages at all.
• Agent block on a listing — where it appears: Hidden, Right column, or Below content.
• Copy property enquiries to the assigned agents — every enquiry on a property also reaches its assigned agents.

Notification Emails

Each notification has its own subject and body, so you can write in your agency's own voice:

• Registration / approval — sent when a new agent registers.
• Account approved — sent when an administrator approves the account.
• New booking — sent when a visitor books a viewing.
• Listing favourited — sent when a visitor shortlists one of the agent's properties.
• Listing compared — sent when a visitor adds one of the agent's properties to a comparison.

The last two are particularly valuable: they notify an agent of interest before any enquiry has been sent — an early signal that a property is getting attention.

What the Agent Sees When Signed In

Each signed-in agent has access to their own profile (to edit) and their own activity on the My Account page — reachable via the [fwre_usersection] shortcode or the User Section block.

Front-End Surfaces

• Agent directory — a page listing all published agents, added with the [fwre_agents] shortcode or the Agents block.
• Agent profile page — shows that agent's details and their properties.
• Agent block on the property page — displayed in the position configured above.
• Booking calendar — shown on the agent profile when the agent accepts meeting requests.
• Reviews — visitors leave feedback directly on the agent's profile page.
• Agent filter in search — visitors can browse the stock of a single agent.

Notes

• Agents are site users — WordPress handles sign-in and passwords; this add-on adds the profile and the permissions around it.
• Agent fields are CSV columns, so assignments round-trip through a spreadsheet alongside properties.
• Without this add-on the entire concept of an agent is absent — no directory, no assignment, no agent filter, and no agent column in CSV. Enquiries then need a property email address to have anywhere to go.
• Disabling the add-on hides agents on the front end; the records are preserved and return when it 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.