victoravelar / laravel-dashboard-football-data-advanced

Laravel dashboard tiles to display matches, results, standings and more football data stats.

A collection of tiles to display football data.

Laravel dashboard tiles to display matches, results, standings and more football data stats.

This tile can be used on the Laravel Dashboard.

Installation

You can install the package via composer:

composer require victoravelar/laravel-dashboard-football-data-advanced

Configuration

// in config/dashboard.php

return [
    // other settings
    'tiles' => [
        // other tiles ...
        'football_data_advanced' => [
            /*
            |--------------------------------------------------------------------------
            | Football-data.org API KEY
            |--------------------------------------------------------------------------
            |
            | In order to fetch the data an API key is required, get yours at 
            | https://www.football-data.org/client/register.
            | The API is provided in a FREMIUM model thus the information to be
            | displayed is limited by your own API plan.
            |
            */
            'api_key' => env('FOOTBALL_DATA_API_KEY', ''),

            /*
            |--------------------------------------------------------------------------
            | Future lookup limit.
            |--------------------------------------------------------------------------
            |
            | Sets the limit to look forward for upcoming matches, the max. suggested
            | value is 1 week as the space for displaying is limited and most of the
            | values will not fit the available tile space.
            |
            | The value must be a strtotime valid string without sign.
            |
            | See: https://www.php.net/manual/en/function.strtotime.php
            |
            */
            'future' => '2 days',

            /*
            |--------------------------------------------------------------------------
            | Past lookup limit.
            |--------------------------------------------------------------------------
            |
            | Sets the limit to look backwards for resutls, the max. suggested
            | value is 1 week as the space for displaying is limited and most of the
            | values will not fit the available tile space.
            |
            | The value must be a strtotime valid string without sign.
            |
            | See: https://www.php.net/manual/en/function.strtotime.php
            |
            */
            'past' => '3 days',
            
            /*
            |--------------------------------------------------------------------------
            | Competitions of interest.
            |--------------------------------------------------------------------------
            |
            | The list of competitions that you are interested in.
            |
            | The values for all the competitions can be found here:
            | https://docs.football-data.org/general/v4/lookup_tables.html#_league_codes
            |
            | The leagues available in the free tier are the following: Champions League,
            | Primeira Liga, Premier League, Eredivisie, Bundesliga, Ligue 1, Serie A,
            | La Liga, Championship, Serie A BR, Worldcup, Euro.
            |
            */
            'competitions' => ['PD', 'PL', 'FL1', 'BL1', 'CL', 'SA'],

            /*
            |--------------------------------------------------------------------------
            | Priority Football teams.
            |--------------------------------------------------------------------------
            |
            | A list of the teams you consider a priority across the tracked competitions.
            |
            | You must use the team acronym, ex. use `PSG` for Paris St. Germain.
            |
            */
            'priority' => [
                'FCB',
                'MCI',
                'LIV',
                'PSG',
                'RBL',
            ],
        ],
    ],
];

Usage

This package contains multiple tiles to display information from Football-data.org, the usage will be broken down per tile.

Upcoming matches

This tile displays upcoming football matches from the leagues you selected in dashboard.tiles.football_data_advanced.competitions.

In your dashboard view you use the livewire:fda-upcoming component.

<x-dashboard>
    <livewire:fda-upcoming position="a1" />
</x-dashboard>

Example

Match results

This tile displays football matches resutls from the leagues you selected in dashboard.tiles.football_data_advanced.competitions.

In your dashboard view you use the livewire:fda-results component.

<x-dashboard>
    <livewire:fda-results position="a1" />
</x-dashboard>

Example

League standings

This tile displays the standings for one of your selected leagues, you need to use the league code as parameter for the component.

In your dashboard view you use the livewire:fda-results component.

<x-dashboard>
    <livewire:fda-standings position="a1" competition="PL"/>
</x-dashboard>

Example

Sample dashboard

<x-dashboard>
    <livewire:fda-standings position="a1" competition="PL"/>
    <livewire:fda-results position="b1" /> 
    <livewire:fda-upcoming position="c1"/>
</x-dashboard>

Screenshot

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• All Contributors

License

The MIT License (MIT). Please see License File for more information.

laravel-dashboard-football-data-advanced's Issues

Fix typo on ServiceProvider

Description

There is a typo that prevents laravel from correctly resolving the location of the view files.

Expected result

The path to the views should be correct on Avelar\FootballDataAdvanced\ServiceProvider

Fix configuration key

Description

The existing configuration key exposed in the documentation doesn't match the one used in the code.

Expected change

The documentation should use api_key instead of api-key

Fix date display when using more than 2 days in the future.

Description

When using a lookup window > 2 days in the future, priority upcoming matches are displayed without a date.

Expected solution

The data displayed should contain the same information as the standard matches.

Fix data values on LeagueStandingsTileComponent

Description

The way data is passed down to the livewire view component is not correct.

Expected behaviour

Rather than using array merge, pass a single array with the correct array key values.

// expected keys (values are just descriptive).
return [
'refreshIntervalInSeconds' => $value,
'data' => $arrayOfValues,
'priorityList' => $arrayOfPriorityItemsFromConfig
];

Add command to fetch and store upcoming matches.

Add command to fetch and store match results.