README

This tile displays a weather forecast.

This tile can be used on the Laravel Dashboard.

Requirements

• PHP 8.3 or higher
• Laravel Dashboard v4
• Livewire v4

Installation

You can install the package via composer:

composer require roelgonzalez/laravel-dashboard-weather-forecast-tile

In the dashboard config file, you must add this configuration in the tiles key.

// in config/dashboard.php

return [
    // ...
    'tiles' => [
        'weather_forecast' => [
            'open_weather_map_key' => env('OPEN_WEATHER_MAP_KEY'),
            'open_weather_map_city' => 'Antwerp',
            'units' => 'metric', // 'metric' or 'imperial' (metric is default)
            'locale' => 'en_US',
        ],
    ],
];

In app\Console\Kernel.php you should schedule the RoelGonzalez\WeatherForecastTile\FetchDataFromApiCommand to run every minute.

// in app/console/Kernel.php

protected function schedule(Schedule $schedule)
{
    // ...
    $schedule->command(\RoelGonzalez\WeatherForecastTile\FetchDataFromApiCommand::class)->everyMinute();
}

Usage

In your dashboard view you use the livewire:weather-forecast-tile component.

<x-dashboard>
  <livewire:weather-forecast-tile position="a1" />
</x-dashboard>

Customizing the view

If you want to customize the view used to render this tile, run this command:

php artisan vendor:publish --provider="RoelGonzalez\WeatherForecastTile\WeatherForecastTileServiceProvider" --tag="dashboard-weather-forecast-tile-views"

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 open a GitHub security advisory in this repository instead of using the issue tracker.

Credits

• Spatie
• Time and Weather tile
• All Contributors

License

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