Basic User Manual

This user-manual is designed as a training tool and reference guide for tech and non-tech users to assist with managing the widget. For a more detailed technical guide can be found on the Advanced Technical Manual page. For more detail please contact Scoop at [email protected].

Introduction to the Scoop Widget

This page provides an overview of the Scoop Widget and describe how it can be used to advantage. More detailed technical information for you, or your web developer, can be found on the Widget Setup page. If you are unsure about any aspect or wish to discuss in more detail please contact Scoop at [email protected].

The SCOOP WIDGET provides rich, customisable content and world-leading directory, planning and marketing tools for your website – free for the first 12 months.

Our CONTENT represents more than 5,800 events, suppliers and attractions and growing at 100 per month; by far the largest in WA. Missing and out of date content will be immediately updated by the Scoop content team.

You can place the widget on MULTIPLE PAGES, representing the best of your region, broken down by location and/or content type (e.g. events, galleries, wineries, aboriginal experiences, tours, accommodation, fishing).

Our content can drive your MARKETING, providing the content and tools your website needs for industry and destination promotion, including the ability to create and share customisable trails and itineraries as part of your web, social media and email marketing strategies.

Currently the Scoop content includes over 6,000 listings, covering all geographic areas within Western Australia, in the following listing types:

Arts & Events – Events; Business Events; Workshops & Short Courses; Clubs & Associations; Art Galleries, Museums & Libraries

Lifestyle & Travel – Accommodation; Food & Drink; Places To Go; Shopping; Things To Do; Wineries

Functions & Venues – Caterers; Function Services; Function Venues

Building & Design – Architects, Builders & Designers; Commercial Designs; Residential Designs; Developers; Developments; Suppliers & Retailers; Product Ranges

Widget components

The widget has six major components:

  1. Primary Filters – this includes (i) the WHERE filter for selecting the location, (ii) the WHAT filter for selecting the type of listing, (iii) the KEYWORDS for performing a keyword listing search, (iv) the SHARE icon for sharing the search results, and (v) the FAVOURITES icon for favouriting listings.
  2. Search Title – a title for the active search (this can be turned off if desired).
  3. Secondary Filters – the range of advanced filters that can be used to further filter listings; these filters change according to the selected WHAT value.
  4. Grid Controls – controls for (i) switching between grid view and map view, (ii) switching the language between EN and CN, and (iii) a count of the number of listings in the active search.
  5. Listing Grid – the area in which the actual listings will display; clicking a listing will open the QUICKVIEW panel for that listing.
  6. Paging Controls – located at the bottom of the grid, these controls can be used to move between pages and limit the number of listings in the grid.

Each of these components can be turned off using widget controls if desired.

How to setup the widget

Setting up the Scoop Widget on your website is a simple two step process:

STEP 1 – Request a content license from Scoop.

STEP 2 – Add the Scoop Widget code snippet to your page(s).

Optionally, you may also choose to add “searchlinks” to your page, to make it easy for your visitors to find your recommendations.

Each of these steps is described in more detail below.

STEP 1 - Request a content license from Scoop

Each website must have a unique content license in order to access the Scoop content. You should email Scoop at [email protected] to request a license be setup for your website. The following information should be provided:

  • Client organisation name (example: Dongara Port Denison Visitor Centre)
  • Client website domain (example:
  • Regions for the widget (example: Dongara, Port Denison, Bookara)
  • Types for the widget (example: Events, Accommodation, Things To Do, Food and Drink)

The Regions and Types that you specify will limit the overarching widget scope for your website. You can further limit the widget on a page by page basis – by Region, Type and other filters – but only within this overarching widget scope. The content license ID that you are assigned must be referenced in the widget code snippet in Step 2.

Further technical information can be found on the Widget Setup page.

STEP 2 - Add the widget code snippet to your page(s)

Each webpage on which the widget is to display requires a unique widget code snippet. The purpose of this small snippet is to embed the widget on the page and provide the widget scope for that specific page.

It is essential to provide a WHERE scope (Region) and a WHAT scope (Type) for the widget but you may also choose to limit the scope of the widget by various FILTERS that are available for each Type. For example, if the Type is “Wineries” then there will be filters available for “Wine Variety” and “Cellar Door Open Days”. If the Type is “Events”, however, there will be filters available for “Date” and “Venue”. Each Type has numerous filters available.

When you specify a FILTER scope for the widget you can specify whether that scope should be “hard” or “soft”. A “soft” filter will be in force when the widget initially loads on the page but can be subsequently overridden by the website visitor. A “hard” filter will also be in force when the widget initially loads on the page but cannot be subsequently overridden by the website visitor.

The screenshot shows the widget with the WHERE set to “Margaret River Region” and the WHAT set to “Wineries”. In addition, two soft filters are in effect – Wine Variety has been set to “Cabernet Sauvignon” and Cellar Door Open has been set to “Open Tuesday”.

How the widget operates and appears can be configured using over 50 widget properties, including which widget components display, how many grid rows display, the widget font family and size, which deeplinking method should be used and whether SEO data should be written by the widget.

Note that you can have widgets on numerous pages on your website, each displaying different content and having different widget properties if you wish. You can even have more than one widget on a given page!

Further technical information, including the widget code snippet, can be found on the Widget Setup page.

OPTIONAL STEP 3 - Add "searchlinks" to your widget

Searchlinks are used to provide your website visitors with a series of pre-filtered searches, saving them from having to individually make selections from the widget filters – you have done the hard work for them! The searchlink buttons can be placed adjacent to the widget and, when clicked, they update the widget to a different search state. In the screenshot you can see a Margaret River Region page that has a series of searchlinks for common searches such as Events, Food & Drink, Things To Do, Accommodation etc.

Further technical information, including the searchlink code snippet, can be found on the Widget Setup page.

Customising the widget appearance

The widget has an “out-of-the-box” appearance but there are are a number of ways in which that appearance can be amended to better reflect your branding and/or functional requirements:

HEADLESS WIDGET – The widget can operate in a “headless” mode which removes all widget components apart from the listing grid. This can great for showing your website visitors a listing “sampler”, particularly when used in conjunction with the ability to restrict the number of rows in the listing grid.

HIDING COMPONENTS – A number of the individual widget components – including primary filters and secondary filters – can be hidden using widget properties. This can be useful if you do not want your website visitors changing these values.

WIDGET VIEW – the widget has 3 views – grid view, map view and trails view. Which view you choose for a particular widget depends on what type of listings you are displaying. If the listings were all in close vicinity location-wise you may choose to display them in the map view (or trails view) rather than in the grid view.

GRID IMAGE SIZE – There are 3 different images sizes for the listing grid – small, medium and large – that can be set using widget properties.

FONTS – You can set the font family and font-size used by the widget to reflect those used on your website. These are set using widget properties.

GENERAL STYLING – The widget is an actual part of your webpage so all the standard CSS techniques can be used by yourself or your developer to impact styling.

The screenshot shows the widget being used in “headless” mode.

Further technical information can be found on the Widget Setup page.

Favourites and Sharing

The widget provides your website visitors with functionality for saving and sharing:

FAVOURITES – Website visitors can save their favourite listings by clicking the heart icon on those listings. Then they can view all of their favourites by clicking on the heart icon at the top-right of the widget. Currently this function uses browser cookies so favourites are only visible on the computer on which they were favourited. In a future release website visitors will be able to register an account and save multiple lists of favourites, viewable on whichever device they want.

SHARING – Website visitors can share entire searches, individual listings and favourites, to email and the popular social media platforms. Further technical information can be found on the Widget Setup page.


You may wish to create a collection of “recommended” listings for your website visitors, for example a regional winery may wish to display their recommended local galleries or beaches. This is a great way to promote not only your business but your entire destination – give your potential visitors another reason to come to your business by also promoting what is great in your local area.

You can do this by using the favourites function to select the intended listings and then using the share link for that collection of favourites as the basis of a widget searchlink. The screenshot shows a “Yallingup Art Gallery Trail”, which was displayed as a result of the website visitor clicking the corresponding searchlink above the widget.

Further technical information can be found on the Widget Setup page.

Making the most from your listing content

You should consider using the Scoop listing content for your digital marketing activities. Use Destination Marketing techniques to attract visitors to your locality, not only because they want to visit your event or business but because they can see what other great things are happening near you. Hotels are using this technique to attract guests to their city or suburb, not only because the hotel has the comfiest pillows but because a major festival or sporting event is happening soon.

SOCIAL MEDIA – You should post to your social media platforms, using the widget share links to drive visitors to your website.

MAILOUTS – You should use the widget share links in your email campaigns to drive visitors to your website.

In the screenshot you can see how Scoop itself utilises listing content to drive its weekly newsletter.

Alternate ways to use the Scoop listing content

There are other, non-widget, ways in which you can exploit the Scoop listing content:

CHATBOT – Scoop has developed a chatbot that guides users through their selection of listing content. We hope to include Natural Language Processing in future versions of the chatbot.

TOUCH SCREEN KIOSK – Scoop is developing a touch screen kiosk solution for navigating and viewing listing content. This will be ideal for Visitor Centres, Libraries, Museums, Hotels and others. Coming soon.

MOBILE APP – Scoop will be developing a mobile app for viewing listing content, making use of mobile features such as location services and sharing. Coming soon.

API – A more advanced method is to access the Scoop listing content using the API (Application Programming Interface) rather than via the widget. This is a complex technical undertaking but opens up a raft of other opportunities for content exploitation.

Get started!

You can get started with the widget in quick time. Once we have confirmed your request we can setup the content license and you can embed the widget on your website – this typically takes under an hour.

If you have any questions please contact us at [email protected].