Skip to content
Tutorials/Widgets and integrationsBeginner11 min read

Design and install a WordPress football widget

Customise the football widget, register one website, verify its installation key and publish scheduled, live, results and prediction shortcodes.

Flow / From saved design to one verified website
  1. Step 1: Design

    Customise inside your account

  2. Step 2: Register

    One website per account

  3. Step 3: Install

    WordPress plugin and widget key

  4. Step 4: Publish

    Choose the right shortcode

Use an eligible plan and a saved design

Football widget installation is available with active Growth and Pro access, not Starter or the Starter trial. The public Widgets page explains the product, while the designer in your account saves designs and installation settings.

Customise the supplied football widget rather than building a separate iframe. Save your design before copying its ID. Preview desktop and mobile views, check your competition selection and confirm that the saved design is the one your shortcode references.

Register the exact website URL

Each account's widget licence permits one registered website. Enter the actual WordPress home URL, including its www choice or subdirectory. This installation restriction is distinct from ordinary REST API website display permissions.

Generate a widget installation key in your account. It is not your customer REST key. Keep it in WordPress server-side settings and do not paste it into a shortcode, a page's HTML or public JavaScript.

Install the plugin and verify the connection

Download the WordPress plugin from your account, install the ZIP through Plugins, activate it and open Settings → FootballAPI Widgets. The settings page provides the connection controls and shortcode helper.

Save the widget key and verify the registered website. Verification needs a publicly reachable HTTPS WordPress REST endpoint without a login wall, challenge page or redirect at that endpoint. The verification proof does not expose the installation key. If you replace or revoke the key, update WordPress and verify again.

  • Only WordPress administrators with the required settings permission should edit the connection.
  • A blank key field can mean the existing key is safely retained, not that it has been removed.
  • Changing the website home URL invalidates the previous website binding.

Choose a default view with a separate shortcode

Replace YOUR-DESIGN-ID with the ID of a design saved in your own account. Add only the shortcode needed for each page, or use the general widget shortcode for the default view stored with the design.

These shortcodes choose the starting view; they do not create separate API subscriptions. Data visibility still depends on the active installation, saved design, selected date and actual available records.

text
[footballapi_widget design="YOUR-DESIGN-ID"]
[footballapi_scheduled design="YOUR-DESIGN-ID"]
[footballapi_results design="YOUR-DESIGN-ID"]
[footballapi_live design="YOUR-DESIGN-ID"]
[footballapi_predictions design="YOUR-DESIGN-ID"]

Understand the one-site protection boundary

The delivery service checks the registered website, widget key, design ownership and eligible account access. Rotation invalidates the old key, and a design belonging to another account is rejected.

Website binding is not DRM: it cannot stop someone copying already displayed HTML or a determined server-side proxy. Keep WordPress and its backups secure, revoke exposed keys promptly and do not describe the installation as impossible to copy.

All 51 tutorials