1. Do you have your Euroalert.net API key?

If you do not have an API key yet, register with Condelway to get one. This key will grant you a connection to the Euroalert.net API for your website and therefore allow you to use our free EU Calls for Proposals widget. If you already have one, continue to the next step.

2. Copy the following code where you wish to place the widget

<div id="area-to-display-eu-programmes"></div>
<script type="text/javascript" src="http://cdn.condelway.com/api/js/euroalertfreev2.js"></script>
<script type="text/javascript">
var EConfigProgrammes = new EuroalertConfig ('euroalert-api-key', 'area-to-display-eu-programmes', Euroalert.DataType.Programmes);
/*
 Optional properties to configure the widget.
 Delete slashes // from those configurations you wish to use.
*/

// EConfigProgrammes.Pager = true;
// EConfigProgrammes.Debug = false;
// EConfigProgrammes.SetFilter (
//	Euroalert.FilterType.Category,
//	Euroalert.Category.Economy,
//	Euroalert.Category.Environment,
//	Euroalert.Category.Social
//	);
 EuroalertFree.Execute(EConfigProgrammes);
</script>

The void area is identified by "area-to-display-eu-news" (Where the EU programmes and initiatives will be shown) can be placed wherever you choose within your website.

The first script imports the Javascript client that connects the Euroalert.net API to your website and the second one contains the configuration for your particular use. These are the configuration options available:

• euroalert-api-key: Key linked to your website(s) url(s) that you can obtain by following the instructions provided in step 1.
• area-to-display-eu-programmes: the area name where widget contents will be shown.
• EConfigProgrammes.Pager=[true/false]: show or hide the page navigator at the foot of the widget. The default value is false.
• EConfigProgrammes.Debug=[true/false]: Show or hide error messages sent by the API client. The default value is false. Activate these alert messages during configuration in order to help you debug your results but remember to deactivate them when you have finished.
• EConfigProgrammes.SetFilter(filtertype , filtervalue1, filtervalue2, [...], filtervalueN): Lets you filter, by category, the contents shown by your widget. The first thing is to set up the type of filter you would like to use. Then choose your category values. Only one filter category is required, thereafter you can use as may as you would like.
• EConfigProgrammes.Mode = Euroalert.Output.WidgetWide: show an expanded version of your widget which includes a short description of all the information items shown.
• EConfigProgrammes.Graphics = [true/false]: Navigate the pages using an icon. The default value is false and thus, if you do not use this option, the buttons are shown in text-mode.

We have many other options coming, to improve the customisation of your widget. We will inform you of all new options via the Euroalert.net blog.

3. Personalise your widget

The API client (step 2) automatically imports the rules which define the default layout of the EU programmes and initiatives widget. We have defined these rules which can be downloaded in the previous link, so that the installation is made easier. You can also personalise your widget coding your own rules:

<style type="text/css">
	#area-to-display-eu-programmes .euroalert-free-widget {
		width: 200px;
	}
</style>

These personalised rules can be included in your own style sheets or within the header of the pages of your site. The example rule modifies the width of the EU current news widget but you can make the the modifications that you need, to size and colour, whilst respecting Euroalert.net logos and links. If you need more flexibility for integration you can find subscriptions with different licenses from €30 per month.

Examples, help and other widgets

Examples of other websites which use our free European Union information widgets:

• Gateway S.C.S. corporate website - EU News, EU Calls for Proposals y EU Programmes
• Canarias BioRegion
• UI3 - Unidad de innovación Internacional de la Plataforma INES
• Euroalert.net blog
• Open Economy
• Micropyme project
• La Oreja de Europa

Although we do not provide support for this free version, if you have any doubts contact us at issues@euroalert.net and we will try to help. If you find a bug or you have any suggestions to improve the service please take the time to inform us.

Get other free Euroalert.net widgets for your website and choose from a great variety of contents from the platform.

Values for Widget configuration

To customise your widget, choose from the following categories:

• IT: Display Information Technology related contents only
• AgroFish: Display Agriculture & Fisheries related contents only
• Employment: Display Employment related contents only
• Social: Display Social Affairs related contents only
• Education: Display Education & Training related contents only
• Environment: Display Environment related contents only
• Health: Display Health related contents only
• Economy: Display Economy related contents only
• RDI: Display Research, Development & Innovation related contents only
• Transport: Display Transport related contents only
• Enterprise: Display Industry related contents only
• Energy: Display Energy related contents only
• Institutional: Display European Union related contents only
• Consumers: Display Consumers related contents only
• Youth: Display Youth related contents only
• Culture: Display Culture related contents only

If none of these filters meet your requirements, contact us