README

Um componente Blade de clima/previsão do tempo utilizando a API Open-Meteo para Laravel.

Instalação

A maneira preferida de instalar esta extensão é através do [composer] composer.

Ou corre

$ composer require dynamikasolucoesweb/laravel-weather "*"

ou adicione

"dynamikasolucoesweb/laravel-weather": "*"

à seção require do seu arquivo composer.json.

Assets & Customização

Publique os assets usando o comando:

$ php artisan vendor:publish --tag=weather-assets

Isso copiará os arquivos para public/vendor/dynamikasolucoesweb/weather.

Uso

Basta chamar o componente Blade em suas views passando as coordenadas (latitude e longitude) desejadas. O componente aceita configurações adicionais para definir o tema visual, a quantidade de dias da previsão ou alternar para o layout compacto.

<x-weather-widget lat="-27.4138" lng="-49.6008" dias="4" theme="dark" />

<x-weather-widget lat="-27.4138" lng="-49.6008" compact="true" theme="light" />

⚙️ Parâmetros Disponíveis

⚡ Performance & Cache

O componente utiliza nativamente o driver de cache configurado no seu Laravel (Cache::remember) para mitigar o número de requisições externas e otimizar o carregamento da página:

• Gerenciamento de Chaves: O cache gera chaves dinâmicas baseadas na combinação exclusiva da latitude, longitude e quantidade de dias pesquisados.
• Duração Customizável: Por padrão, os dados climáticos expiram a cada 15 minutos (900 segundos), mas podem ser customizados diretamente na chamada do componente através do atributo cacheDuration.

Features

Modo Compacto Inteligente: Oferece dois layouts nativos (Modo Completo Scrollable com previsão estendida e Modo Compacto Minimalista para barras laterais ou cabeçalhos).

Fallback Seguro: Caso a API externa fique indisponível ou ocorram problemas de rede, o widget trata o erro sem quebrar o restante da aplicação.

Suporte a SSL Local: Ignora automaticamente verificações rígidas de certificados cURL HTTPS em ambientes locais (local) para evitar problemas comuns de ambiente de desenvolvimento.

Ícones Dinâmicos: Mapeamento completo e responsivo integrado aos pacotes de estilização baseados na biblioteca Weather Icons.

Authors

Giordani da Silveira dos Santos - giordani@dynamika.com.br

This project is under BSD-3-Clause license.