Add option to use period labels in widget instead of direct forecast time

Author: erick-otenyo

forecastmanager/forecast_settings.py

@@ -27,7 +27,10 @@ class ForecastSetting(ClusterableModel, BaseSiteSetting):
                                              related_name="weather_reports_page")
     show_conditions_label_on_widget = models.BooleanField(default=True,
                                                           verbose_name=_("Show conditions label on widget"))
-
+    
+    use_period_labels = models.BooleanField(default=False,
+                                            verbose_name=_("Use Period Labels inplace of forecast time"), )
+    
     edit_handler = TabbedInterface([
         ObjectList([
             InlinePanel('periods', heading=_("Forecast Periods"), label=_("Forecast Period")),
@@ -45,10 +48,11 @@ class ForecastSetting(ClusterableModel, BaseSiteSetting):
             FieldPanel('default_city'),
             FieldPanel('weather_detail_page'),
             FieldPanel('weather_reports_page'),
+            FieldPanel('use_period_labels'),
             FieldPanel('show_conditions_label_on_widget'),
         ], heading=_("Other Settings")),
     ])
-
+    
     @cached_property
     def data_parameter_values(self):
         data_parameters = self.data_parameters.all()
@@ -57,17 +61,17 @@ def data_parameter_values(self):
             params.append({"parameter": param.parameter, "name": param.name, "parameter_type": param.parameter_type,
                            "parameter_unit": param.parameter_unit if param.parameter_unit else " "})
         return params
-
+    
     @property
     def periods_as_choices(self):
         return [(period.id, period.label) for period in self.periods.all()]
-
+    
     @property
     def effective_periods(self):
         return [
             {"label": period.label, "time": period.forecast_effective_time}
             for period in self.periods.all()]
-
+    
     @property
     def weather_conditions_list(self):
         weather_conditions = self.weather_conditions.all()
@@ -78,15 +82,15 @@ class ForecastPeriod(Orderable):
     parent = ParentalKey(ForecastSetting, on_delete=models.CASCADE, related_name="periods")
     forecast_effective_time = models.TimeField(verbose_name=_("Forecast Effective Time"), unique=True)
     label = models.CharField(max_length=100, verbose_name=_("Label"))
-
+    
     class Meta:
         ordering = ["forecast_effective_time"]
-
+    
     panels = [
         FieldPanel('forecast_effective_time'),
         FieldPanel('label'),
     ]
-
+    
     def __str__(self):
         return self.label
 
@@ -106,7 +110,7 @@ class ForecastDataParameters(Orderable):
     parameter_unit = models.CharField(_("Unit of measurement"), max_length=100, null=True, blank=True,
                                       help_text="e.g °C, %, mm, hPa, etc ")
     show_on_home_widget = models.BooleanField(default=True, verbose_name=_("Show on Home Widget"))
-
+    
     panels = [
         FieldPanel('use_known_parameters'),
         FieldPanel('parameter', widget=DataParameterWidget),
@@ -115,24 +119,24 @@ class ForecastDataParameters(Orderable):
         FieldPanel('parameter_unit'),
         FieldPanel('show_on_home_widget'),
     ]
-
+    
     def __str__(self):
         return self.name
-
+    
     @property
     def units(self):
         if self.parameter_unit:
             return self.parameter_unit
-
+        
         if self.parameter_info:
             return self.parameter_info.get("units")
-
+        
         return None
-
+    
     @property
     def parameter_info(self):
         return WEATHER_PARAMETERS_AS_DICT.get(self.parameter)
-
+    
     def parse_value(self, value):
         if self.parameter_type == "numeric":
             return float(value)
@@ -144,16 +148,16 @@ class WeatherCondition(Orderable):
     symbol = models.CharField(max_length=100, verbose_name=_("Weather Symbol"))
     label = models.CharField(max_length=100, unique=True, verbose_name=_("Label"))
     alias = models.CharField(max_length=100, blank=True, null=True, unique=True, verbose_name=_("Alias"))
-
+    
     panels = [
         FieldPanel('symbol', widget=WeatherSymbolChooserWidget),
         FieldPanel('label'),
         FieldPanel('alias'),
     ]
-
+    
     def __str__(self):
         return self.label
-
+    
     @property
     def icon_url(self):
         return static('forecastmanager/weathericons/{}.png'.format(self.symbol))

forecastmanager/migrations/0029_forecastsetting_use_period_labels.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.1 on 2025-07-21 08:18
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('forecastmanager', '0028_forecastsetting_show_conditions_label_on_widget'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='forecastsetting',
+            name='use_period_labels',
+            field=models.BooleanField(default=False, verbose_name='Use Period Labels inplace of forecast time'),
+        ),
+    ]

forecastmanager/static/forecastmanager/weathericons/clearsky_polartwilight.png

@@ -1,6 +1,6 @@
 [metadata]
 name = forecastmanager
-version = 0.5.6
+version = 0.5.7
 description = Integration of Weather City Forecasts Manager in Wagtail Projects.
 long_description = file:README.md
 long_description_content_type = text/markdown