This plugin embeds yacht listings from the SmartBroker service into your WordPress site. Requires a SmartBroker subscription.
This plugin embeds yacht brokerage listings from the SmartBroker service
into your WordPress site.
In order to use this plugin, you’ll require a paid-for account with SmartBroker – please see our
pricing page for more details.
SmartBroker is a system for creating, managing and sharing yacht sales listings.
If you’re installing this plugin for testing purposes, there’s a demo server with dummy data available – see installation instructions for further details.
Getting a SmartBroker system up and running requires three elements to work together:
If you’re reading this, you’ve probably already got a WordPress site up-and running. If not, it’s a common option available with many hosting packages. Ask you hosting provider if it’s included in
current package, or alternatively, we can provide a WordPress site for you, hosted at a domain of your choice – just drop an email to email@example.com.
Install the plugin by logging into your WordPress site and going to Admin -> Plugins -> Add New
Search for SmartBroker, and then follow the instructions to install the plugin.
To complete the installation:
If you don’t have a SmartBroker server yet, use the default
The SmartBroker search page ID and SmartBroker listing page ID should already be set by the plugin. Various options are available to customise these pages – see Shortcode options below for details.
Set the display currency (if in doubt, start with ‘EUR’).
Once you have followed the installation instructions, you’ve got a fully working SmartBroker system!
To search your listings, go to your search page.
Note that depending on the configuration of your menus in WordPress, the search page may not be immediately visible. If necessary, have a look through the ‘Pages’ section of your site for a page named ‘Search’ and add this to your menu system.
To add a slideshow of featured listings to your site, add the shortcode to any WordPress page or post.
If none of your listings have the status ‘Featured’, the featured listings slideshow will select 5 random listings to show.
The SmartBroker plugin includes a customisable widget, SmartBroker search. To use this widget, go to Admin -> Appearance -> Widgets and add the SmartBroker search widget to the relevant sidebar.
You can also set default size and price variable for this widget.
If you’re using the search widget in a sidebar, you may wish to change the template for the ‘Search’ page – otherwise you’ll end up with two search boxes on one page. Edit the search page and look for a fullwidth template in the Page Attributes section.
Shortcode options are added in the following format:
Note: All of the following options apply only to the
Price and size defaults
Size units (commonly ft or m) are based on the settings in on SmartBroker server.
Price units are based on the Currency setting in Admin -> Settings -> SmartBroker
The maximum and minimum values of the size and price selectors are set automatically by SmartBroker, based on the range of values available in your live listings.
For example, the following shortcode will pre-set to the size range 15-30 feet (assuming your SmartBroker system has the LOA item dimension set to ft):
[sb_search_box size_low=’15’ size_high=’30’]
You can set the number of results returned per page on [sb_seach_page] using the shortcode:
Normally the plugin will pull results from the SmartBroker server listed in Admin -> Settings -> SmartBroker. However, as of plugin v6.1.0 this can be over-ridden on a search page using the shortcode:
Where http://example.com is the alternate SmartBroker server you’d like to poll.
If your SmartBroker server supports parent types (which is available as a hidden option on all SmartBroker servers above v6.1.0), you can pre-filter search results by specifying a parent_type id:
Where 4 is the ID number of the parent type you’d like to return. This is typically used if the SmartBroker server has a wide variety of listings (commercial, superyachts, leisure boats, river vessels etc.) and you only want a sub-set returned.
An example customised search page will look like:
All the theming of the plugin is handled by the main WordPress theme, so font and colours should match existing pages. However, some tweaking may be necessary to get the pages looking just how you’d like
All SmartBroker elements are including with a wrapper (#sb_wrapper). This allows you to style just the plugin elements without touching the existing site.
To add custom CSS rules to your plugin, go to Admin -> Settings -> SmartBroker and edit the Custom CSS element.
If you’re a SmartBroker subscriber, we can help you with any visual edits or tweaks you may need – please get in touch.
Listings held of your SmartBroker server are automatically fed to your WordPress site live – once you add a boat to your server, it’s immediately available on your site.
However, a couple of basic details need to be complete before a listing will appear correctly:
A brief overview of the service is available at http://www.smart-broker.co.uk
The search box and results page
A sample boat listing with broker’s notes, specifications, photos, videos and contact form
The featured boats shortcode
Adding the SmartBroker search widget to a sidebar (with default size and price values)
A sample homepage showing the featured boats shortcode as well as the search widget
SmartBroker Server v6: Editing a listing
This update is required if using SmartBroker server v6, and will not work with server versions prior to v6. Do not update your plugin without first checking your server version.
This upgrade is required to update links to new SmartBroker file structure.
This upgrade secures the data feed from WordPress to SmartBroker. Users of v1.0 should upgrade as soon as possible.