FW Real Estate – Documentation
Agents
The FWRE Agents add-on turns the 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 public directory that says who you are — which is what a first-time visitor checks before they call anybody.
- The right person on the right property. Assign agents to listings; the property page shows the relevant agent's details.
- 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 reviews 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 (for example, "Senior Agent" or "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 images at roughly those proportions avoids odd cropping.
Each agent also carries availability — the days and hours they accept viewings, with each day having its own window. Visitors can only book a viewing inside those hours.
Settings
Agent settings are found under Configuration → Add-ons → Agents.
| Setting | Description |
|---|---|
| Approve new agents automatically | When off, a new agent registration waits for an administrator to approve it. Leave this off on a public site — this setting determines whether anyone can add themselves to 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 the block appears: Hidden, Right column, or Below content. |
| Agents per directory page | How many agents the directory shows per page. |
| Copy property enquiries to the assigned agents | Every enquiry submitted on a property is also sent to its assigned agents. |
Notification Emails
Each notification has its own subject and body, so you can write in your agency's voice. The available notifications are: Registration / approval, Account approved, New booking, Listing favourited, and Listing compared.
The last two are particularly useful: an agent is notified when a visitor shortlists or compares one of their properties. This is an early signal of interest that arrives before any formal enquiry.
What an Agent Sees When Signed In
A signed-in agent accesses their account through a User Section menu item. From there they can edit their own profile and review their activity. Their account section is their own — separate from other agents and from the administrator.
Front-End Surfaces
- An agent directory, reached via an Agents menu item.
- An agent profile page, listing that agent's properties.
- An agent block on the property page, displayed in the position set in configuration.
- A booking calendar on the agent profile, when the agent accepts meeting requests.
- Reviews on the agent's profile page.
- An Agent filter in the search module, so visitors can browse one agent's listings.
Notes
- Agents are site users — the platform's own account system handles sign-in and passwords; this add-on provides the profile layer and the permissions around it.
- Agent fields are CSV columns, so agent assignments travel with properties through spreadsheet imports and exports.
- Without this add-on, the concept of an agent is entirely absent — no directory, no assignment, no agent filter, and no agent column in CSV. Property enquiries then require a property-level email address to have anywhere to go.
- Disabling the add-on hides agents from 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.
