IBPSPORTS Football Studio
← Documentation

Widgets

Skip to main content

Ready-made widgets for sidebars and footers: fixtures, results, next and last match, standings, top scorers, teams, a team squad, a player card and upcoming birthdays.

What widgets are

Widgets are small boxes you place in the widget areas of your theme – usually a sidebar or the footer – instead of inside a page. Football Studio adds its own. You choose everything in the widget form: no shortcode to type, no IDs to look up.

A widget shows nothing (not even its title) when it has nothing to display, for example the Birthdays widget on a day without birthdays, or the Standings widget before a tournament is chosen.

Add a widget

  • Widget screen: go to Appearance → Widgets. In the block widget editor, click + in a widget area and search for the widget name (they are listed as IBPSports Football: Fixtures, IBPSports Football: Standings…). In the classic widget screen, drag the widget into an area.
  • Customizer: Appearance → Customize → Widgets works the same way and shows a live preview.
  • Block themes (Site Editor) have no widget areas: use the shortcodes or the Football Studio blocks there instead.

Every widget has a Title field: the heading your theme shows above the widget. Leave it empty for no heading.

[SCREENSHOT: Appearance -> Widgets, block widget editor]
Show: The inserter opened in the Sidebar area with “football” typed in the search, listing the IBPSports Football widgets, and one widget (e.g. Standings) open with its form.
Highlight: The list of IBPSports Football widgets.

All widgets

Widget What it shows Based on
Fixtures Upcoming matches from today, soonest first. [ ibpf-matches]
Results Latest results, newest first. [ ibpf-matches]
Next Match The next fixture of a team or tournament, as a card. [ ibpf-matches]
Last match The latest result of a team or tournament, as a card. [ ibpf-matches]
Standings A compact league table, optionally with your team highlighted and only the rows around it. [ ibpf-standings]
Top Scorers Top players by one statistic: goals, assists, cards… [ ibpf-players-stats-single]
Teams The teams of a tournament. [ ibpf-teams]
Players The squad of a team: shirt number, photo, name and position. Widget only
Player A compact card of one player: photo, name, position, club, nationality and shirt number. Widget only
Birthdays Players whose birthday is today or in the next days, with the age they turn. Widget only

Fixtures, Results, Next Match and Last match

The four match widgets have the same settings; only their defaults differ. Fixtures and Next Match show matches from today on, soonest first. Results and Last match show played matches, newest first.

Setting Default Description
Team All Teams Only the matches of this team.
Tournament All Tournaments Only the matches of this tournament.
Limit 5 (Next Match, Last match: 1) Number of matches, 1-50.
Layout List (Next Match, Last match: Card) List, Card or Table.
Show Date & Time on Show the date and kick-off time.
Show Tournament on Show the tournament name. In the List layout with a Tournament chosen, it is shown once in the header (tournament logo, league name and season) instead of on every match.
Link matches on Link each match to its page.
Link team names on Link team names to their pages.

For a club site, pick your team in Next Match and Last match and put both widgets in the sidebar: visitors always see your next game and your latest result.

[SCREENSHOT: Example: a sidebar with the Next Match and Last match widgets for District United (Acme League demo)]
Show: The two match cards in the sidebar, under their widget titles.
Highlight: Nothing.

Standings

Setting Default Description
Tournament * Select The tournament of the table. The widget stays hidden until one is chosen.
Group 0 Show one group only (its ID). 0 = all groups.
Columns Mini Mini (position, team, played, goals, points), Normal or Custom.
Select columns Normal columns With Custom: tick the columns to show (form, goals for and against, points per game…). The list starts with the Normal columns ticked; it is ignored with Mini and Normal.
Team Logo Team Logo Before the team name: Team Logo, Country flag or None.
Highlight teams None One team whose row is highlighted.
Partial window 0 Rows to show above & below the highlighted team (0 = full table). With 2, a club site shows its team and the two teams above and below it.
Show group header on Show the group name above each table.
Link team names on Link team names to their pages.

* Required setting.

[SCREENSHOT: Example: a sidebar with the Standings widget, Acme League demo, District United highlighted, Partial window 2]
Show: The mini table with five rows and the highlighted team in the middle.
Highlight: The highlighted row.

Top Scorers

Setting Default Description
Stat Metric Top Scorers The statistic to rank by: goals, assists, goals + assists, cards, penalties…
Tournament All Tournaments Count only this tournament.
Team All Teams Only the players of this team, with their stats for this team.
Limit 5 Number of players, 1-50.
Player Image Photo Photo, Team Logo, Nationality (flag) or None.
Show Team on Show the player’s team.
Show Nationality off Show the player’s nationality.
Link player names on Link player names to their pages.

Teams

The teams of a tournament, shown as a panel of crests and names.

Setting Default Description
Tournament * Select The tournament whose teams are listed.
Group 0 Teams of one group only (its ID). 0 = all groups.

Players

The squad of one team for a season, from the team’s Squad (Teams → edit a team). Players marked Left Club are not shown. The shirt number and position are those of the squad for that season.

Setting Default Description
Team * Select The team whose squad is listed.
Season Current active season The season of the squad.
Sort Column Position Position (goalkeepers first, then by shirt number), Shirt Number or Name.
Limit 50 Number of players, 1-100.
Photo on Show the player photo.
Shirt Number on Show the shirt number.
Show Position on Show the position under the name.
Link player names on Link player names to their pages.

[SCREENSHOT: Example: a sidebar with the Players widget for District United (Acme League demo)]
Show: The squad list with shirt numbers, photos, names and positions.
Highlight: Nothing.

Player

Setting Default Description
Player * Select The player of the card.
Photo on Show the player photo.
Shirt Number on Show the shirt number.
Show Position on Show the position.
Show Team on Show the club logo and short name (the full name on hover), or the national team when the player has no club.
Show Nationality on Show the nationality flag before the position (the country name on hover).
Link player names on Link the name to the player page.

Use it for a “Player of the month” box: change the player in the widget when you pick a new one.

Birthdays

Active players whose birthday is today or within the next days, soonest first. Each row shows the date and the age the player turns. Players without a date of birth are left out. Dates use the time zone of your site (Settings → General), and a 29 February birthday shows on 28 February in other years.

Setting Default Description
Days 7 How many days ahead to look. 0 = today only (up to 366).
Team All Teams Only the players of this team.
Limit 10 Number of players, 1-50.
Photo on Show the player photo.
Age on Show the age the player turns.
Show Team on Show the club logo and short name (the full name on hover), or the national team when the player has no club.
Link player names on Link player names to their pages.

[SCREENSHOT: Example: a sidebar with the Birthdays widget, Days 30 (EURO 2024 demo)]
Show: The list of upcoming birthdays with dates, clubs and ages.
Highlight: Nothing.

Change the look

The widgets use the same styles as the shortcodes, so they match the rest of your football pages (see Customise the look). The Players, Player and Birthdays widgets have their own templates, which you can copy to your theme and edit like the shortcode templates: ibpsports-football-studio/widgets/players.php, widgets/player.php and widgets/birthdays.php. See Template overrides.

All widgets and their settings are also listed in Football Settings → Shortcodes, in the Widgets group.

Related articles