WP-Property: Agents
Welcome to the WP-Property: Agents wiki!
Agents is WP-Property Add-on which allows you to create new Real Estate agent accounts, associate them with properties. Multiple agents can be assigned to any given property and the agent information can be displayed in a widget placed on a property page. Furthermore, properties can be queried by the agent(s) to create agent-specific property listings pages.
Get Stared
To add a new agent, choose the “Agents” tab on the Properties menu in the WordPress Dashboard. You can add more fields to the Agent list with the Settings>Agents tab in the same Properties menu.
- Widget bio will be used on the properties that the agent is associated with if the Agent widget is activated.
- Full Bio is shown on the Agents page that has shortcodes for each agents properties.
- Flyer Writeup is shown on the PDF Flyer of the property assigned to the Agent.
To add additional agent attributes, visit the WP-Property Settings page and look on the Agents tab.
To display the agent information on a property page, add the Property Agents widget into the widget area for the property.
In addition to the Property Agents widget, agent information can be displayed using shortcodes as well.
To display agent information, we use the [agent_card] shortcode. Unless displayed on a property page, the shortcode will not work by itself, and requires at least the user_id argument to be passed into it, telling the shortcode which agent to show. So, in it’s most basic form the shortcode can be used as follows:
[agent_card user_id=5]
However, if you are displaying the shortcode on a property page, within property content, or a even a text widget, the feature will automatically figure out if the given property has any agents, and get their IDs automatically.
Show Agent information on PDF Flyer
Fill Flyer Writeup on Agent profile in order to show that info on PDF Flyer
Shortcodes and Widgets
The shortcode also allows you to set which fields to display. The attributes are passed in a comma separated value (CSV) format, and the order is respected when displaying the information. For example, to display the agent’s picture, followed by their display name, biography and phone number:
[agent_card user_id=5 fields=agent_image,display_name,full_bio,phone_number]
Since the order of the agent attributes cannot be set in the Agent Widget, an easy work-around is to use a Text Widget to render the agent_card shortcode. Be advised, by default WordPress does not execute shortcodes in Text Widgets, but a lot of themes add this functionality ( e.g. Denali Theme ). The functionality can also be added via a plugin, such as the Advanced Text Widget.
[property_overview wpp_agents=5]
As you can see, the combination of these two features gives you quite a bit of flexibility in regards to deploying WP-Property to satisfy your unique business process.
Cheet Sheet for [agent_card] Shortcode
| Attribute | Description |
|---|---|
| agent_id | Sets agent. |
| agent_image | Switches Agent Image displaying. |
| display_name | Switches agent's name displaying. |
| user_email | Switches user's email displaying. |
| widget_bio | Switches widget bio text displaying. |
| full_bio | Switches full bio text displaying. |
| flyer_content | Switches flyer writeup text displaying. |
| phone_number | Switches phone number displaying. | </tbody> </table> ### Advanced Agent Capabilities When used in conjunction with the [WP-Property: Power Tools](https://wp-property.github.io/addons/power-tools/) Add-on, you can set up some unique configurations. In this scenario the requirement is to only allow agents to see and edit their own properties.