refactor: add tune field to be sent to the API

Author: guemidiborhane

mawaqit/Main.qml

@@ -40,6 +40,7 @@ Item {
   readonly property string city:              cfg.city              ?? defaults.city              ?? "London"
   readonly property string country:           cfg.country           ?? defaults.country           ?? "UK"
   readonly property int    method:            cfg.method            ?? defaults.method            ?? 3
+  readonly property string tune:              cfg.tune              ?? defaults.tune              ?? ""
   readonly property int    school:            cfg.school            ?? defaults.school            ?? 0
   readonly property bool   showNotifications: cfg.showNotifications ?? defaults.showNotifications ?? true
   readonly property bool   playAzan:          cfg.playAzan          ?? defaults.playAzan          ?? false
@@ -56,6 +57,7 @@ Item {
   onCityChanged:    if (lastFetchDate) Qt.callLater(forceRefresh)
   onCountryChanged: if (lastFetchDate) Qt.callLater(forceRefresh)
   onMethodChanged:  if (lastFetchDate) Qt.callLater(forceRefresh)
+  onTuneChanged:    if (lastFetchDate) Qt.callLater(forceRefresh)
   onSchoolChanged:  if (lastFetchDate) Qt.callLater(forceRefresh)
 
   readonly property var prayerKeys: {
@@ -251,7 +253,7 @@ Item {
     const from  = Qt.formatDate(today, "dd-MM-yyyy")
     const toD   = new Date(today); toD.setDate(toD.getDate() + 6)
     const to    = Qt.formatDate(toD, "dd-MM-yyyy")
-    const url   = `https://api.aladhan.com/v1/timingsByCity/${from}?city=${encodeURIComponent(city)}&country=${encodeURIComponent(country)}&method=${method}&school=${school}&days=7`
+    const url   = `https://api.aladhan.com/v1/timingsByCity/${from}?city=${encodeURIComponent(city)}&country=${encodeURIComponent(country)}&method=${method}&school=${school}&days=7&tune=${encodeURIComponent(tune)}`
     Logger.d("Mawaqit", "Fetching week from", from, "to", to)
 
     const xhr = new XMLHttpRequest()
@@ -297,7 +299,7 @@ Item {
 
   function fetchSingleDay() {
     if (_xhr) return
-    const url = `https://api.aladhan.com/v1/timingsByCity?city=${encodeURIComponent(city)}&country=${encodeURIComponent(country)}&method=${method}&school=${school}`
+    const url = `https://api.aladhan.com/v1/timingsByCity?city=${encodeURIComponent(city)}&country=${encodeURIComponent(country)}&method=${method}&school=${school}&tune=${encodeURIComponent(tune)}`
     const xhr = new XMLHttpRequest()
     _xhr = xhr
     xhr.onreadystatechange = function() {

mawaqit/Settings.qml

@@ -36,6 +36,7 @@ ColumnLayout {
     return !match || match.key === "99"
   }
   property string valueMethodCustomInput: valueMethodCustom     ? String(root.valueMethod)         : ""
+  property string valueTune:              cfg.tune              ?? defaults.tune              ?? ""
   property int    valueSchool:            cfg.school            ?? defaults.school            ?? 0
   property bool   valueShowCountdown:     cfg.showCountdown     ?? defaults.showCountdown     ?? true
   property bool   valueShowNotifications: cfg.showNotifications ?? defaults.showNotifications ?? true
@@ -133,6 +134,15 @@ ColumnLayout {
     onSelected: key => root.valueHijriDayOffset = parseInt(key)
   }
 
+  NTextInput {
+      Layout.fillWidth: true
+      label: pluginApi?.tr("settings.tune.label")
+      description: pluginApi?.tr("settings.tune.desc")
+      placeholderText: "0,0,0,0,0,0,0,0,0"
+      text: root.valueTune
+      onTextChanged: root.valueTune = text
+  }
+
   NDivider { Layout.fillWidth: true }
 
   // ── Calendar ──────────────────────────────────────────────────────────────
@@ -284,6 +294,7 @@ ColumnLayout {
     pluginApi.pluginSettings.school            = root.valueSchool
     pluginApi.pluginSettings.hijriDayOffset    = root.valueHijriDayOffset
     pluginApi.pluginSettings.weekStartDay      = root.valueWeekStartDay
+    pluginApi.pluginSettings.tune              = root.valueTune.trim()
     pluginApi.saveSettings()
     Logger.d("Mawaqit", "Settings saved")
   }

mawaqit/i18n/en.json

@@ -105,6 +105,10 @@
     "methodCustom": {
       "label": "Custom Method ID",
       "desc": "Enter the numeric method ID from the Aladhan API (e.g. 19 for Algeria / MESRS)."
+    },
+    "tune": {
+      "label": "Timing Offsets (tune)",
+      "desc": "Comma-separated minute offsets for: Imsak, Fajr, Sunrise, Dhuhr, Asr, Maghrib, Sunset, Isha, Midnight. Leave blank for no adjustment. Example: 0,2,0,0,0,1,0,0,0"
     }
   },
   "error": {