Weather Informer

Weather Manager is an advanced DLE weather plugin that displays current weather and a 5-day forecast for one or multiple cities, with flexible template support and a full admin panel.

Plugin Files

File	Purpose
`engine/modules/weather_manager.php`	Main plugin logic: config loading, shortcode parsing, current weather, forecast, placeholders, and template rendering.
`engine/inc/weather_manager.php`	Admin panel interface for settings, city management, usage help, and placeholder reference.
`engine/data/weather_manager.php`	Stored plugin configuration, city list, API key, units, language, and cache settings.
`templates/<skin>/weather.tpl`	Main frontend design template loaded automatically when shortcode body is empty.
`templates/Green/modules/rightside.tpl`	Example integration point in the Green theme sidebar.

Installation & Setup

Open the admin panel at /admin.php?mod=weather_manager.
Enter your OpenWeather API key.
Choose units, language, and cache lifetime.
Add one or more cities.
Edit templates/<skin>/weather.tpl if you want a custom design.
Insert shortcode into any template file.

If the weather block appears empty, temporarily print {weather-error} inside your template to see the exact API error message.

Shortcode Usage

Single City

[weather-block city="tbilisi"][/weather-block]

Multiple Cities

[weather-block cities="tbilisi,batumi"][/weather-block]

With Limit

[weather-block cities="tbilisi,batumi,kutaisi" limit="2"][/weather-block]

Inline Template

[weather-block city="tbilisi"]
<div>
  <strong>{weather-city}</strong>
  <span>{weather-temp}</span>
</div>
[/weather-block]

Current Weather Placeholders

Placeholder	Description
`{weather-city}`	City title
`{weather-country}`	Country code
`{weather-temp}`	Current temperature
`{weather-feels-like}`	Feels-like temperature
`{weather-temp-min}`	Minimum temperature
`{weather-temp-max}`	Maximum temperature
`{weather-description}`	Weather description
`{weather-humidity}`	Humidity
`{weather-pressure}`	Pressure
`{weather-wind}`	Wind speed
`{weather-clouds}`	Cloudiness
`{weather-visibility}`	Visibility
`{weather-icon-url}`	Current icon URL
`{weather-updated}`	Updated date/time
`{weather-error}`	Error message from API

Forecast Placeholders

Forecast placeholders are available for five days. Replace the day number from 1 to 5.

Placeholder	Description
`{forecast-1-day}`	Weekday name
`{forecast-1-date}`	Forecast date
`{forecast-1-temp}`	Forecast temperature
`{forecast-1-temp-min}`	Forecast min temperature
`{forecast-1-temp-max}`	Forecast max temperature
`{forecast-1-description}`	Forecast description
`{forecast-1-icon-url}`	Forecast icon URL
`{forecast-1-humidity}`	Forecast humidity
`{forecast-1-wind}`	Forecast wind speed
`{forecast-2-} ... {forecast-5-}`	Same structure for days 2 through 5

Admin Panel Overview

General Settings for API key, units, language, cache, default cities, and limits
City Editor for adding and editing cities
Configured Cities table with edit and delete actions
Placeholder Reference built directly into the panel
Usage Help with ready shortcode examples

Template Workflow

Default frontend rendering uses templates/<skin>/weather.tpl.

If you leave shortcode body empty, the plugin automatically loads that template.

[weather-block cities="tbilisi,batumi"][/weather-block]

If you write custom HTML inside the shortcode, that inline template is used instead.

Technical Notes

Current weather is loaded from OpenWeather data/2.5/weather.
Forecast is loaded from OpenWeather data/2.5/forecast.
Forecast data is grouped by day and the plugin picks the item closest to midday.
Both current and forecast responses are cached using DLE cache variables.