The Settings Area
Once the allAgents add on has been installed and activated you can find the settings areas in the following locations within WordPress:
For Property Hive Users: 'Property Hive > Settings > AllAgents'
For non-Property Hive Users: 'Settings > AllAgents'
Both show the same settings.
Widgets
When clicking into the settings area the first thing you'll see is the list of existing widgets, if any have been setup. Here you can see the name and the shortcode to use when wanting to embed the reviews onto your site:
From here you can click into edit the widget, or add a new one.
Adding and Editing Widgets
When adding or editing an allAgents widget you can give it a unique name. This is useful if you're setting up multiple widgets (i.e. one per branch) and want to be able to differentiate between them.
You then have the option of either using the allAgents widget, or their API.
allAgents widget
Visit this page and you'll be presented with the widget code to drop in.
API
Using the API approach you have a lot more options regarding appearance and layout:
Note that the API route is only available for allAgents premium members.
Customising The Templates
If you're using the API approach, you really want to customise the output and are comfortable with editing PHP files, you can do so by changing the templates.
Note: We recommend you never edit the template files direct in the plugin.
The add on comes with three templates:
allagents-header.php
allagents-reviews.php
allagents-footer.php
These can be overwritten into your theme, placing them inside a 'propertyhive' folder and editing them accordingly.
As as an example, if we wanted to change the header you could take the file found in:
/wp-content/plugins/propertyhive-allagents/templates/allagents-header.php
... and copy it into your theme in:
/wp-content/themes/your-theme-name/propertyhive/allagents-header.php
... and make the necessary changes there. We would then use that template instead of the default if one existed.