dpa ElectionsLive and dpa-SportsLive are modularly constructed: Whether surveys, gains and losses, distribution of seats, constituency maps or charts, results, live-blogs - there is a widget for each type of result. All widgets and their graphic elements can be easily incorporated into web articles, or can serve as landing pages for the respective event. They are highly suitable to act as teasers on the front page, to refer to pages specifically dedicated to sporting events or elections.

 

All widgets can be adjusted in regard to shape, colour, and font. They are optimised for desktop websites as well as mobile devices, and can be integrated into apps.


INHALTSVERZEICHNIS

The setup page


The widget configuration is done via a setup page, which you will gain access to after ordering from the dpa shop, or receive from us.


On the setup page you can change various settings and generate your own embed code. This code is integrated into an article or page within the CMS, which can then be published. The widget will be displayed on your website. Please note that some settings are not available for all products.


Language selection

Use the flag icons to select the language. The language of the setup page can be adjusted by clicking on the flags above (German or English). If a widget is provided in multiple languages, the corresponding flags can be found further below. They are used to set the language of the widget.


Widget selection

Depending on the product line (SportsLive, ElectionsLive), each widget can be selected on the setup page (dropdown). Select the widget you wish to configure.


Incorporation

Next, select how you wish to incorporate the widget. Depending on the product, you have up to four options to choose from:

  • iframe, automatic height adjustment (default): The height of the iframe is automatically set to the height of its content via the script dpa.js. After incorporating it into your website, no further adjustments are required. Please switch on the option require if you are working with the Javascript library require.js on your website and enter the name of your require-entity. 

  • iframe, fixed height: If your CMS does not allow the incorporation of scripts or you cannot or do not choose to integrate third-party scripts, a simple iframe is offered here.

  • URL without embed code: If iframes for external content are already created by your CMS, you will receive the blank link to the widget here.

  • AMP-iframe: Here we have prepared the script that can be used to embed the widget on an AMP website.                                                                                                                    Please note: AMP is a third-party source that is not yet fully developed. For information on its use and performance, please contact AMP directly (https://amp.dev/documentation/components/amp-iframe/).


Settings

Width

By default, our widgets are displayed at 100% width in order to adapt to different devices. However, it is possible to manually adjust the width here. Percentage and pixel values can be specified: 80% | 350px

Automatic updates

For products containing live data, such as ElectionsLive or SportsLive, the automatic update frequency can be adjusted. Depending on the product, an interval of 30 to 60 seconds is preset. To turn off automatic updates, enter 0 here.

ElectionsLive: Show widgets with test data

Here the widgets can be displayed with test data. You will generally only find complete test data after the first election simulation. Feel free to contact us if you require data for testing.

ElectionsLive: Result type

Here you define whether to automatically switch from poll numbers to election results on election night.

  • auto (default): Widgets show poll numbers and are automatically set to live 15 minutes before the first results are expected (at 5.45 pm for German elections). They then show "No results available yet", before incorporating first results from approximately 6 pm (depending on the election).

  • poll: Widgets only show poll numbers, they do not automatically switch to live.

  • live: Widgets do not show poll numbers, instead they show "No results available yet" until the first results come in.

ElectionsLive: AutoResetTime

How many minutes before the first "live" result do you want the widget to stop showing poll numbers? The default setting is 15 minutes. If you want poll numbers to be displayed until the first live results are available, enter 0. This only applies if the result type is set to "auto".

ElectionsLive: Number of displayed bars

Here you can control how the bar graphs are displayed. You can choose between three settings:

  • automatic (default): The number of bars is automatically adjusted according to the available space. Figures of the remaining parties are calculated in "other".

  • all: All parties are displayed. If there is not enough space, a horizontal scroll bar appears.

  • fixed number: Depending on the available space, a scroll bar may also appear. If there are more bars than specified, the remaining parties will be calculated in "other". Enter the desired number in the box.

ElectionsLive: Show "other"

If you do not wish to display the "other" parties, e.g. because you would prefer to use the space to display the numbers of one additional party, please remove the tick here.

ElectionsLive: Basis for calculating gains and losses

Here you can select whether the parties' gains and losses in the polls are to be calculated on the basis of the last election result (default) or the previous poll (if available).

SportsLive: Widgets with test data

In the dpa shop you will always find in the preview all available widgets with test data or current data of the last season or event. Feel free to contact us if you need data for testing.

SportsLive: Deeplinks - Livecenter

The settings define whether you start automatically with the default view or whether you start with a specific match, a specific team or, for example, with a specific nation in the case of the Olympics.

  • auto (default): In team sports such as football, the live centre always starts with "LIVE" and with the current matches.
  • Other main navigation points can also be selected here via "Settings".


Example: main navigation point (Live Center):


SportsLive: Configuration - Widgets

The widgets can be configured specifically to your needs and can thus be integrated into your editorial coverage and complement it perfectly.

  • In team competitions such as football, for example, the widgets can start with a specific team and thus always with the current match.
  • You can also configure a specific game here which is then updated live and is also retained for post-reporting via configuration.
  • The embed codes are generated accordingly. You integrate this code into an article or page in your CMS and publish it. The graphics widget will appear on your website.

       

Configuration - how to

The setup page contains a selection option (dropdown) for the different widgets. First select the widget you want to configure.

  • Go to the "Settings" and configure the widget either via the "Choose team" dropdown (always current game of this team) or via the "Match" dropdown (specific game that will be kept): 


Example: select a team

Example: select a match

  • Olympic Games: Configuration - Medals table
    Under "Settings/Max. entries" you can limit the length of the medal table as you wish. Under "Settings/Nation" you can highlight a country in the medal table and have it permanently displayed, regardless of its ranking.


Google Analytics

 

If you are using Google Analytics, simply enter your tracking ID in the box provided. You will find the view count of our widgets in your Google Analytics account under "page views" or "page impressions".


Are views and dwell time within iframes counted if I embed my own ID?

Yes. 

FAQ ElectionsLive

Which colour is ascribed to which party, how can this be adjusted?

The colours linked to the respective parties are already prepared in style.css, which you can download on the setup page under "colours / fonts". Uncomment them, change them according to your wishes and follow the instructions in order to incorporate your own CSS file.

 

In which order are the parties displayed, how can this be adjusted?

The parties are positioned according to their results, ranking from highest to lowest. However, the order can be adjusted as well (e.g. according to the result of the last election), please get in contact.


Can I start the constituency map with strongholds of a certain party?

Yes, via deeplink, see ReadMe.