Погодный информер для NGCMS - Установка и настройка

Плагин "Погодный информер" позволяет отображать актуальные данные о погоде на вашем сайте, работающем на системе управления NGCMS. Плагин использует API сервиса OpenWeatherMap для получения данных и предоставляет гибкие возможности для интеграции в различные части сайта.

Основные возможности

• Отображение текущей погоды для любого города мира
• Поддержка единиц измерения (Цельсий/Фаренгейт)
• Кеширование данных для снижения нагрузки
• Гибкая система шаблонов
• Полная интеграция с TWIG
• Простая настройка через админ-панель

Установка плагина

1. Загрузка плагина

Скачайте архив с плагином и распакуйте его в папку

/engine/plugins/

/engine/plugins/weather/
├── config.php
├── weather.php
├── version
└── tpl/
    └── weather.tpl
    └── lang/
        └── russian/
            └── config.ini

2. Установка через админ-панель

1. Зайдите в админ-панель вашего сайта
2. Перейдите в раздел "Плагины"
3. Найдите в списке "Погодный информер"
4. Нажмите кнопку "Установить"

Настройка плагина

1. Получение API ключа

Для работы плагина необходим API ключ от сервиса OpenWeatherMap:

1. Перейдите на сайт openweathermap.org
2. Зарегистрируйте аккаунт (если его нет)
3. В разделе API Keys создайте новый ключ
4. Скопируйте полученный ключ

2. Настройка в админ-панели

1. В админ-панели перейдите в "Конфигурация" → "Плагины"
2. Найдите "Погодный информер" и нажмите "Настроить"
3. Заполните поля:
   • API ключ OpenWeatherMap - вставьте полученный ключ
   • Время кеширования - рекомендуемое значение 3600 (1 час)
4. Сохраните изменения

Использование плагина

Базовый вызов

Для вывода погоды добавьте в TWIG-шаблон:

   {{ callPlugin("weather.show", {city: "Moscow", units: "metric"}) }}

Параметры вызова

city

units

template

Примеры использования

1. Погода в Москве

{{ callPlugin("weather.show", {city: "Moscow"}) }}

2. Погода в Лондоне в Фаренгейтах

{{ callPlugin("weather.show", {city: "London", units: "imperial"}) }}

3. Использование альтернативного шаблона

{{ callPlugin("weather.show", {template: "weather_compact"}) }}

Создание собственных шаблонов

Вы можете создавать собственные шаблоны для отображения погоды. Для этого:

1. Создайте новый файл с расширением

   .tpl

   в папке

   /engine/plugins/weather/tpl/

2. Используйте доступные переменные для отображения данных
3. Укажите имя вашего шаблона в параметре

   template

   при вызове плагина

Доступные переменные в шаблоне

{{ weather.city }}

{{ weather.temp }}

{{ weather.units }}

{{ weather.icon }}

{{ weather.description }}

{{ weather.humidity }}

{{ weather.wind }}

{{ tpl_url }}

Пример простого шаблона

Создайте файл

/engine/plugins/weather/tpl/weather_compact.tpl

<div class="weather-compact">
    <img src="{{ weather.icon }}" alt="{{ weather.description }}">
    <span>{{ weather.temp }}{{ weather.units }}</span>
</div>

<style>
.weather-compact {
    display: flex;
    align-items: center;
    gap: 10px;
    font-size: 14px;
}
.weather-compact img {
    width: 30px;
    height: 30px;
}
</style>

Решение проблем

1. Не отображается погода

• Проверьте правильность API ключа
• Убедитесь, что введено корректное название города
• Проверьте, есть ли доступ к API OpenWeatherMap с вашего сервера

2. Ошибка "Class 'template' not found"

Убедитесь, что используете последнюю версию плагина, где эта ошибка исправлена.

3. Данные не обновляются

• Попробуйте очистить кеш в админ-панели
• Временно установите время кеширования = 0 в настройках плагина

Заключение

Плагин "Погодный информер" предоставляет простой и гибкий способ отображения актуальных данных о погоде на вашем сайте. Благодаря интеграции с TWIG вы можете легко кастомизировать внешний вид виджета под дизайн вашего сайта.

Для получения дополнительной помощи обращайтесь на форум поддержки NGCMS.

Можешь почитать и вот эту статейку "Выводим блок по времени на TWIG"