Get the story telling widget!

Our story telling widget means people can share the story of their care on your site, without leaving your web pages.

Adding this to your page takes only a minute or two (so long as you are allowed to edit your HTML).

Here's what story telling widgets look like roaming in the wild:

Share your experience of NHS Shetland's healthcare services

Improving patient experience at The Barony Practice, Paisley

How to embed the story telling widget on your web page

All you have to do is place this HTML code into your web page, where you want the widget to appear:

<iframe src="https://www.patientopinion.org.uk/widget/YourOpinion" allowTransparency="true" scrolling="no" width="700" height="1000" frameborder="0">You must have a browser that supports iframes to view the Patient Opinion widget</iframe>

This should be enough to get you started, but if you get stuck, do feel free to contact us.

You can adjust the height and width of your widget, subject to a few constraints:

  1. Width can go down to about 480 pixels as a minimum. Below that it will get a bit disorderly.
  2. The height needs to stay above 900 pixels because later in the story-telling process more vertical space is used. For this reason we also recommend that you do not put anything below the widget on the page.
  3. Typically, if you make the widget narrower, you'll also need to increase the height.
  4. It is worth testing the full workflow once you have the widget in place, to make sure nothing is cut off the bottom of each step. But note you will be sending stories to our live site, so please enter "testing" in the story title so we know not to publish your test stories!

Make sure your visitors understand

When people visit your web site, they might not understand that their story is handled by Patient Opinion, and not by you. We recommend you add some text to explain this clearly.

What you say is up to you - but here's a suggestion to get you started:

If you've experienced health care recently, either as a patient yourself or as a carer or friend of someone else, please tell us how it was. What was good? What could have been better?

Your story will be handled confidentially by the non-profit service Patient Opinion. Your story may appear (without your name) on their website. Patient Opinion asks the health service to respond to the feedback you share, but does not reveal your identity.

This service is independent of [your site here] and the NHS. For more information about Patient Opinion and how your story is handled, visit www.patientopinion.org.uk.

Advanced options

The story telling widget has two extra tricks up its sleeve (if a widget has sleeves):

1: Focus the widget on a specific service

If you are using the story telling widget to collect feedback about a specific service (for example, a hospital, a department or a community service) you might want to make sure that service is always offered as a suggestion to users.

To do this, you add the nacs code of the service you want to the widget's web address.

This doesn't stop users from submitting stories about others services too, if they wish.

Here's a worked example:

a) Imagine you want the widget to always suggest the Great Western Ambulance Service, among other service suggestions.

b) Search our site for stories about that service (usually by typing the service name into the search box). Click the link to GWAS shown below a story to arrive at the GWAS service page:

https://www.patientopinion.org.uk/services/RX5

c) See that code "RX5"? That's the nacs code for GWAS.

d) To add the code to your widget, do this:

<iframe src="https://www.patientopinion.org.uk/widget/YourOpinion?nacs=RX5" allowTransparency="true" scrolling="no" width="700" height="900" frameborder="0">You must have a browser that supports iframes to view the Patient Opinion widget</iframe>

We added a question mark (?), then nacs=RX5. Of course, your nacs code will probably be different.

2: Add a campaign code

You may want to know how many stories are being submitted through your widget, or perhaps even show "just the stories you collected" on another page of your site.

To do this you will need Patient Opinion to provide you with a campaign code to add to your widget. Once you have a code, do this:

<iframe src="https://www.patientopinion.org.uk/widget/YourOpinion?cc=yourcode" allowTransparency="true" scrolling="no" width="700" height="900" frameborder="0">You must have a browser that supports iframes to view the Patient Opinion widget</iframe>

Currently, we can provide you with a campaign code, but we haven't yet created a system for you to filter stories to "just the ones you collected". We will, soon.

Still, if you are interested in this option, do contact us.

 3: Add a nacs code and a campaign code!

<iframe src="https://www.patientopinion.org.uk/widget/YourOpinion?nacs=RX5&cc=yourcode" allowTransparency="true" scrolling="no" width="700" height="900" frameborder="0">You must have a browser that supports iframes to view the Patient Opinion widget</iframe>

Simples!