Title: SmartBroker Author: phuvf Published: 19 Avril 2012 Last modified: 23 Sgiugn 2019 --- Search plugins ![](https://ps.w.org/smartbroker/assets/banner-772x250.png?rev=534422) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/smartbroker/assets/icon-256x256.png?rev=1086431) # SmartBroker By [phuvf](https://profiles.wordpress.org/phuvf/) [Download](https://downloads.wordpress.org/plugin/smartbroker.6.3.0.4.zip) * [Details](https://lmo.wordpress.org/plugins/smartbroker/#description) * [Reviews](https://lmo.wordpress.org/plugins/smartbroker/#reviews) * [Installation](https://lmo.wordpress.org/plugins/smartbroker/#installation) * [Development](https://lmo.wordpress.org/plugins/smartbroker/#developers) [Support](https://wordpress.org/support/plugin/smartbroker/) ## Description This plugin embeds yacht brokerage listings from the SmartBroker service ([http://www.smart-broker.co.uk](http://www.smart-broker.co.uk/)) into your WordPress site. In order to use this plugin, you’ll require a paid-for account with SmartBroker – please see our [pricing page](http://www.smart-broker.co.uk/?page_id=95) 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. ### IMPORTANT NOTE June 2019: SmartBroker is no longer actively maintained. Existing customers will continue to be supported, but no new installations will be considered. ## Screenshots * [[ * 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 ## Installation Getting a SmartBroker system up and running requires three elements to work together: 1. A WordPress-powered website that you’re going to use to present your brokerage business on the web 2. The SmartBroker WordPress plugin 3. A SmartBroker server which will store your listing data (this is also where you go to add and maintain you listings) #### 1 – The WordPress site 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 [contact@smart-broker.co.uk](https://lmo.wordpress.org/plugins/smartbroker/contact@smart-broker.co.uk?output_format=md). #### 2 – Install and set up the SmartBroker Plugin 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: * Activate the plugin (if required) through the _Plugins_ menu in WordPress * Go to _Admin_ -> _Settings_ -> _SmartBroker_ to configure the plugin * Set the _SmartBroker server address_ to the address of your SmartBroker system( always include the _http://_ part) > If you don’t have a SmartBroker server yet, use the default `http://demo.smart- > broker.co.uk` * 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. #### 2 – Adding featured listings to your site To add a slideshow of featured listings to your site, add the shortcode _[sb\_featured]_ 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. #### 4 – Adding the SmartBroker search widget 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. #### 5 – Shortcode options _Shortcode options are added in the following format: [sb\_search\_page option\_name\ _1=’option\_value\_1′ option\_name\_2=’option\_value\_2′ … ]_ Note: All of the following options apply only to the [sb_search_page] shortcode **Price and size defaults** Size units (commonly _ft_ or _m_) are based on the settings in on SmartBroker server. * size_low – the default value of the lower size input (integers only) * size_high – the default value of the upper size input (integers only) Price units are based on the _Currency_ setting in _Admin_ -> _Settings_ -> _SmartBroker_ * price_low – the default value of the lower price input (integers only) * price_high – the default value of the upper price input (integers only) 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’]_ For [sb_search_page], the example note for the keyword search box can be customised using: * keyword_examples (default: “e.g. roller furling, fridge”) You can set the number of results returned per page on [sb_seach_page] using the shortcode: * results_per_page (default: 10) 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: * server_override=’http://example.com’ 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: * parent_type=’4′ 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: **[sb_search_page size_low=”15″ size_high=”30″price_low=”30000″ price_high=”80000″ keyword_examples=”e.g. bow thruster” results_per_page=”20″]** #### 6 – Theming 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 them to. 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](https://lmo.wordpress.org/plugins/smartbroker/contact@smart-broker.co.uk?output_format=md). #### 7 – Getting your listings from your SmartBroker server to your WordPress site 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: * The listing must have a length (sometimes listed as _LOA_) * The listing must have a price * The listing must have a primary photo * The listing must not be listed as _offline_ ## FAQ Huh, what, SmartBroker? – never heard of it! A brief overview of the service is available at [http://www.smart-broker.co.uk](http://www.smart-broker.co.uk/) ## Reviews There are no reviews for this plugin. ## Contributors & Developers “SmartBroker” is open source software. The following people have contributed to this plugin. Contributors * [ phuvf ](https://profiles.wordpress.org/phuvf/) [Translate “SmartBroker” into your language.](https://translate.wordpress.org/projects/wp-plugins/smartbroker) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/smartbroker/), check out the [SVN repository](https://plugins.svn.wordpress.org/smartbroker/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/smartbroker/) by [RSS](https://plugins.trac.wordpress.org/log/smartbroker/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 6.3.0.4 * Fixed bug causing contact from mis-reporting #### 6.3 * New simpler gallery system * Support for mono and stereo VR images * Support for embedded videos * Code tidy and performance improvements * Prettylinks fix #### 6.1.10 * Added ability to create custom XML sitemap (in /sb_sitemap.xml) and add line to robots.txt as required #### 6.1.7 * Added trim() to sb_config so we don’t get tripped up by rogue whitespace #### 6.1.6 * updates to help when file_get_contents won;t follow redirects #### 6.1.4 * Added extra classes and CSS selectors to allow better control of search results when using custom CSS rules #### 6.1.3 * Fixed small bug if URL of listing page contained ‘&server=’ but no server address( now defaults back to original correctly). * Added ‘position: relative’ to ‘Contact us’ button on listing page as some themes played up badly! #### 6.1.2 * Added pretty URLs. If you’re using a Permalink scheme (anything other than ‘Default’), links to listings will be re-written similar to (site_url)/boat/131243/ybs/Maxi +1100/ for better SEO. #### 6.1.1 * Fixed spaces around commas on listing results #### 6.1.0 * Added ability to pre-filter search results by parent_type * Added ability to override default SmartBroker server for specific search pages #### 6.0.3 * Added ability to hide price, ‘currently lying’ and tax-status tags * Now loads tax label (e.g. VAT, BTW) and inc/exc text (e.g. Paid, Not paid) from SmartBroker server #### 6.0.2 * Added options to allow white-labelling of system. See file ‘white_label_settings. php’ for details. #### 6.0 * Update to match SmartBroker server v6. Note that this version of the plugin will not work with server versions prior to v6. Do not update your plugin without checking your server version first. #### 4.0 * Added ‘Clean’ theme options to integrate more easily with WP themes * Update of Readme.txt to help first-time users * Removed support for [sb_featured] #### 3.1.3 * Small bug fix – occasionally ‘Find out more’ form would not display correctly #### 3.1.2 * Changed links within plugin so it now works with sites located in subdirectories( e.g. http://www.example.com/wordpress) #### 3.1.1 * Changed from ‘count() to count($xml) as $xml->count() only available in PHP >= 5.3 * Renamed JavaScript UI function ‘slider’ to ‘sb_slider’ to avoid potential conflicts with theme scripts #### 2.0 * Added search_page_v2 with the following features: * Search by keyword(s) * Now loads boat types from backend to match system * Loads available builders from backend * Added pagination * Updated other shortcodes widget to use seach_page_v2 in place of search_page * Customisable slider ranges * Enquiries form now has a hidden honeypot field to reduce spam enquiries. * Featured boats widget now selects 10 boats at random rather than loading entire boat list. * Note: The original search page is now depreciated. Please move to search v2 when making any updates. #### 1.2.4 * Switched jQuery to noConflict mode to avoid clashes with other libraries * Fixed error with photo counting where no photos exist #### 1.2.3 * Updated instructions on how to find the authentication token #### 1.2.2 * Updated verification token details for demo.smartbroker.co.uk in Admin->Settings- >SmartBroker #### 1.2.1 * Fixed photo issue caused when boat model contains backslash (/) (requires SmartBroker v1.1.3 or above to function correctly) * Added pagination for search results where > 10 results returned * Re-aligned boat specification table to vertical-align: top #### 1.2 * Plugin will now use cURL to load XML files if allow_url_fopen = false * Updated XML links to reflect new back-end file structure #### 1.1.2 * Fixed error relating to ‘VAT paid’ & ‘VAT not paid’ messages * Removed authentication requirement for demo.smart-broker.co.uk server #### 1.1.1 * Fixed JavaScript error caused if page has no shortcodes at all * Switched to using googleapis.com theme repository #### 1.1 * Changed xml requests to use https * Added [sb_search_box_small] & [sb_search_by_ref] shortcodes * Added optional settings for [sb_search_box] and [sb_search_box_small] #### 1.0 * Initial release ## Meta * Version **6.3.0.4** * Last updated **7 years ago** * Active installations **10+** * WordPress version ** 3.3.0 or higher ** * Tested up to **4.9.29** * Language * [English (US)](https://wordpress.org/plugins/smartbroker/) * Tags * [boats](https://lmo.wordpress.org/plugins/tags/boats/)[yachts](https://lmo.wordpress.org/plugins/tags/yachts/) * [Advanced View](https://lmo.wordpress.org/plugins/smartbroker/advanced/) ## Ratings No reviews have been submitted yet. [Add my review](https://wordpress.org/support/plugin/smartbroker/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/smartbroker/reviews/) ## Contributors * [ phuvf ](https://profiles.wordpress.org/phuvf/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/smartbroker/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://www.smart-broker.co.uk)