How to Set Up the Venue Directory Client Portal Widget

Modified on Thu, 24 Apr at 4:51 PM

This guide will walk you through the process of installing the venuedirectory Client Portal widget on your website.

Standard Website Setup

Add the following script tag to the <head> or just before the closing </body> tag of your page:

<script src="https://www.myeventsportal.co.uk/widget/scripts/client-search-widget.js" type="text/javascript"></script>

Place the widget markup in the <body> section of your web page. This container is where the widget will be displayed.

Example:

<cp-search-widget widget-key="[WIDGETKEY]" layout="horizontal" button-label="Find"></cp-search-widget>

Replace [WIDGETKEY] with the key provided to you by venuedirectory.

The widget supports the following attributes:

Attribute	Description	Default Value
`widget-key`	(Required) Unique key that identifies your client portal	–
`layout`	Display layout: `horizontal` or `vertical`	horizontal
`country-label`	Label for country field	Country
`destination-label`	Label for destination field	Destination
`venue-label`	Label for venue name field	Venue Name
`delegates-label`	Label for attendees field	Attendees
`group-label`	Label for group field	Group
`supplier-label`	Label for supplier field	Supplier Name
`postcode-label`	Label for postcode field	Postcode
`button-label`	Text displayed on the search button	Search

The widget’s fields are settings-driven and mirror the search bar fields used in the full version of your Client Portal.

You can apply your own CSS to style the widget to match your website’s branding and layout.

Widget Layout

In your WordPress admin, go to Plugins → Add New.
Click Upload Plugin, select the downloaded ZIP file, and install it.
Go to Plugins → Installed Plugins and click Activate next to Venuedirectory Client Portal Widget.

Plugin Activation

Widget Placement

Expand the widget settings:

Widget Config

If you have any issues with setup or need further assistance, please contact our support team.