add ICS documentation for alba_bs_de (#1223)

mampfes · Oct 5, 2023 · 86e1327 · 86e1327
1 parent 38cc850
commit 86e1327
Show file tree

Hide file tree

Showing 5 changed files with 41 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -410,6 +410,7 @@ Waste collection schedules in the following formats and countries are supported.
 - [Abfallzweckverband Rhein-Mosel-Eifel (Landkreis Mayen-Koblenz)](/doc/source/abfall_io.md) / azv-rme.de
 - [AHE Ennepe-Ruhr-Kreis](/doc/source/ahe_de.md) / ahe.de
 - [ALBA Berlin](/doc/source/abfall_io.md) / berlin.alba.info
+- [ALBA Braunschweig](/doc/ics/alba_bs_de.md) / alba-bs.de
 - [Altmarkkreis Salzwedel](/doc/ics/abfall_app_net.md) / altmarkkreis-salzwedel.de
 - [Altötting (LK)](/doc/source/jumomind_de.md) / lra-aoe.de
 - [ART Trier](/doc/source/art_trier_de.md) / art-trier.de
@@ -554,8 +555,8 @@ Waste collection schedules in the following formats and countries are supported.
 - [Landkreis Rhön Grabfeld](/doc/source/landkreis_rhoen_grabfeld.md) / abfallinfo-rhoen-grabfeld.de
 - [Landkreis Rosenheim](/doc/source/awido_de.md) / abfall.landkreis-rosenheim.de
 - [Landkreis Rotenburg (Wümme)](/doc/source/abfall_io.md) / lk-awr.de
-- [Landkreis Roth](/doc/source/c_trace_de.md) / landratsamt-roth.de
 - [Landkreis Roth](/doc/source/awido_de.md) / landratsamt-roth.de
+- [Landkreis Roth](/doc/source/c_trace_de.md) / landratsamt-roth.de
 - [Landkreis Schweinfurt](/doc/source/awido_de.md) / landkreis-schweinfurt.de
 - [Landkreis Schwäbisch Hall](/doc/source/cmcitymedia_de.md) / cmcitymedia.de
 - [Landkreis Schwäbisch Hall](/doc/source/lrasha_de.md) / lrasha.de

diff --git a/doc/ics/alba_bs_de.md b/doc/ics/alba_bs_de.md
@@ -0,0 +1,25 @@
+# ALBA Braunschweig
+
+ALBA Braunschweig is supported by the generic [ICS](/doc/source/ics.md) source. For all available configuration options, please refer to the source description.
+
+
+## How to get the configuration arguments
+
+- Goto <https://alba-bs.de/service/abfuhrtermine.html> and select your location.  
+- Copy the link of `ICS-Kalender-Datei` (you may need to click it first and then copy the link from the opened popup)
+- Replace the `url` in the example configuration with this link.
+- Replace the year in the `url` with `{%Y}`.  
+  This will be replaced by the current year.
+- You can remove the cHash parameter from the url.
+
+## Examples
+
+### Hauptstrasse 1 C
+
+```yaml
+waste_collection_schedule:
+  sources:
+    - name: ics
+      args:
+        url: https://alba-bs.de/service/abfuhrtermine/ajax-kalender.html?tx_mfabfallkalender_mfabfallkalender%5Baction%5D=makeical&tx_mfabfallkalender_mfabfallkalender%5Bcontroller%5D=Abfallkalender&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-hausnr%5D=1&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-hausnrzusatz%5D=C&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-month%5D=6&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-strasse%5D=Hauptstra%C3%9Fe&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-thisyear%5D={%Y}
+```
diff --git a/doc/ics/yaml/alba_bs_de.yaml b/doc/ics/yaml/alba_bs_de.yaml
@@ -0,0 +1,12 @@
+title: ALBA Braunschweig
+url: https://alba-bs.de
+howto: |
+   - Goto <https://alba-bs.de/service/abfuhrtermine.html> and select your location.  
+   - Copy the link of `ICS-Kalender-Datei` (you may need to click it first and then copy the link from the opened popup)
+   - Replace the `url` in the example configuration with this link.
+   - Replace the year in the `url` with `{%Y}`.  
+     This will be replaced by the current year.
+   - You can remove the cHash parameter from the url.
+test_cases:
+   Hauptstrasse 1 C:
+       url: "https://alba-bs.de/service/abfuhrtermine/ajax-kalender.html?tx_mfabfallkalender_mfabfallkalender%5Baction%5D=makeical&tx_mfabfallkalender_mfabfallkalender%5Bcontroller%5D=Abfallkalender&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-hausnr%5D=1&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-hausnrzusatz%5D=C&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-month%5D=6&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-strasse%5D=Hauptstra%C3%9Fe&tx_mfabfallkalender_mfabfallkalender%5Bmf-trash-thisyear%5D={%Y}"
diff --git a/doc/source/ics.md b/doc/source/ics.md
@@ -32,6 +32,7 @@ This source has been successfully tested with the following service providers:
 - [Abfallwirtschaftsbetrieb Landkreis Karlsruhe](/doc/ics/awb_landkreis_karlsruhe_de.md) / awb-landkreis-karlsruhe.de
 - [Abfallwirtschaftsbetrieb München](/doc/ics/awm_muenchen_de.md) / awm-muenchen.de
 - [Abfallwirtschaftsgesellschaft Landkreis Schaumburg](/doc/ics/aws_shg_de.md) / aws-shg.de
+- [ALBA Braunschweig](/doc/ics/alba_bs_de.md) / alba-bs.de
 - [Altmarkkreis Salzwedel](/doc/ics/abfall_app_net.md) / altmarkkreis-salzwedel.de
 - [AVL - Abfallverwertungsgesellschaft des Landkreises Ludwigsburg mbH](/doc/ics/avl_ludwigsburg_de.md) / avl-ludwigsburg.de
 - [Awista Starnberg](/doc/ics/awista_starnberg_de.md) / awista-starnberg.de