REALTYNA - SALES DEPARTMENT

Last update: Feb 10th, 2020

Contents of this Manual are applicable to the MLS Agent Mapping Add-On. Details of this Manual may be different based on the customizations you have or your software.

Introduction

This Manual contains information about the MLS Agent Mapping Add-On, an extension for the WPL MLS Integration plugin.

This Add-On is a powerful extension that enables real estate WordPress websites to add Agent mapping functionality to the MLS add-on. The result is that all the MLS properties represented by the agents of the brokerage, will be assigned to those relevant agents automatically on the website.

System Requirements

To use the MLS Agent Mapping Add-on you will need the following:

1. WPL MLS add-on

2. Adding MLS Agents to a real estate website

3. Adding the MLS Agent Field in the MLS Server form

4. Adding the MLS Agent ID for each agent in the relevant field in the respective profile

Installation

If you have the Installation Package of the MLS Agent Mapping Add-On, you can upload it from the following path: WordPress->WPL dashboard->Install Addon form.

Glossary

Below are a list of terms and their definitions used throughout this manual:

MLS Agent Field: Each MLS provider has one field for identifying the agent who represents a listing. We call this field MLS Agent Field.  

MLS Agent ID: Each agent in the MLS database is associated with a unique Agent ID. In fact, the Agent ID is the value of the MLS Agent Field, representing each agent. We call this ID, the MLS Agent ID.

Configuring the Add-On

After the installation, for activating the mapping feature of the add-on,  during the MLS Integration and mapping process, you need to find the MLS Agent Field in the MLS database and put in the relevant MLS Server field. 

WPL Backend -> MLS Add-on menu -> add new MLS Server or edit the added MLS Server -> in the Advanced tab you’ll find the MLS Agent Field. 

In this sample screenshot, which is related to the FlexMLS, the MLS Agent Field is called LA1_LoginName. Then click on ‘Save’.

Open

• MLS Agent Field: You can add a proper MLS field here to match the Agent of a MLS listing with the listing in your website. It means it will be mapped with a ‘user_id’ field/column of a listing; that is the main Agent/User for a listing.

• MLS Multi Agent Fields: As you see we have added a sample MLS field there; it is for when you have WPL Multi Agent add-on, and wants to be matched with MLS script. In this way, you can add relevant MLS fields in this field.

In other words, you are able to enter several fields like: LA1_CoListAgent1, LA1_CoListAgent2, LA1_CoListAgent3, …

Configuring the Agent ID

To configure the Agent ID for the existing agents in the system, first you need to have the agent id for each agent. So you can add it to their profile.

For this purpose, you can follow: WPL backend -> User Manager menu -> you will see the added users/agents -> click on the agent’s username.

Open

The admin can load each agent’s profile page for adding their MLS Agent ID in the relevant field. 

And then, you have to finalize the data by the Finalize button at the bottom of the page.

Moreover, if you have several RETS connections in your website and there is a different MLS Agent ID for each user per RETS, You can put each Agent ID for respective user like => ,12345,32651,56556,69445,

Note: Take care of comma {,} that must be added in the first and in the end of Agent IDs.

Changing the name of the MLS Agent ID field of the agents’ profile

Since we generate the form fields from the powerful WPL Flex feature, you can change the name or position of this field, you can follow: WPL backend -> Flex menu -> select the User tab -> You’ll see the user’s fields.

then , you can click the edit button to change the field name or change the position of this field.