Vebra Properties lets to turn your Vebra API feed into an interactive search and display listing on your own website with the minimum of fuss.\
Just signup for the Vebra API and once you have your credentials enter them into your Vebra Properties settings. Add a few shortcodes and away you go.
For advanced users you can style your results by overriding our templates and stylesheets or if you're not so sure about this
contact us for our customisation services.
Shortcodes
We built the plugin using fleixible shortcodes for easy installation and customisation. The shortcodes are;
- [vebra_quicksearch] : to display a concise search box
- [vebra_search] : to show full search options
- [vebra_properties] : To display a list of properties or search results
- [vebra_details] : To display full property details including map and carousel of property images
Templates / Customisation
We have provided templates corresponding to each of the shortcodes so you can create your own layouts and content. Simply include your own version of the templates in your theme and these will override the standard set provided;
- vp_quicksearch.php : Change the layout of the quicksearch bar
- vp_search : modify the search layout
- vp_list.php : dictate how property summary details are shown
- vp_detail.php : style the detailed property view
We have tried to make the installation and setup of the plugin as simple as possible whilst building in fleixibility for the more advanced user to be able to fully customise the style and content.
You can download and install Vebra Properties using the built in WordPress plugin installer. If you download Vebra Properties manually, make sure it is uploaded to "/wp-content/plugins/vebra_properties/".
Activate Vebra Properties in the "Plugins" admin panel using the "Activate" link.
Basic setup
Follow the simple steps below to get up and running in minutes;
- Create a new page on your site for the search results and add the [vebra_properties] shortcode to this page.
- Create a new page on your site for the property details and add the [vebra_details] shortcode.
- Enter your API details into the Verbra Properties "Settings" menu.
- Also on the Verbra Properties "Settings" menu set the default property search results page that you created in step 1 and 2.
Once you click save on the settings page Vebra Properties will trigger a schedule to populate wordpress with the properties in your feed. It will also schedule a daily update of properties.
Scheduling
As mentioned once set up wordpress will re-populate the property list daily. This should happen automatically using WordPress's built in schedule service. However, this can be un-reliable especially if your site uses lots of third party plugins so we recommend that you trigger the schedule using a server cron job. Please see the FAQ for further details.
Short codes
This plugin has fleixble short codes to help with filtering and formatting of the content. To add options simple include them in the shortcode as a name value pair e.g. [vebra_list branchid="1" type="For Sale"]. See below for the full set of options available for each short code. Only add attributes to the shortcode if you want to pre-filter results. Any manually entered search criteria will override the attributes set in the shortcode.
[vebra_quicksearch]
- branchid
- area (For Sale, To Let, Commercial)
- location (a string containing the location i.e. Leicester, UK)
[vebra_search]
- branchid
- area ("For Sale", "To Let", "Commercial")
- featured ("yes" or "no")
- bedrooms (minimum number of bedrooms - default "0")
- minprice (number value)
- maxprice (number value)
- type (text description of type i.e. "Detached")
- location (a string containing the location i.e. "Leicester, UK")
- radius (number of miles radius to search)
[vebra_list]
- branchid
- area ("For Sale", "To Let", "Commercial")
- featured ("yes" or "no")
- bedrooms (minimum number of bedrooms - default "0")
- minprice (number value)
- maxprice (number value)
- type (text description of type i.e. "Detached")
- location (a string containing the location i.e. "Leicester, UK")
- radius (number of miles radius to search)
- pagesize (number of properties per page, default "6")
- page (current page, default "1")
- orderby (ordering, default "price desc")
[vebra_details]
- vebraid (the VebraID for the property)
- agentref (the agents reference for the property)