add ICS documentation for asto.de

README.md

@@ -668,6 +668,7 @@ If your service provider is not listed, feel free to open a [source request issu
 - [ASG Wesel](/doc/source/hausmuell_info.md) / asg-wesel.de
 - [ASO Abfall-Service Osterholz](/doc/source/abfall_io.md) / aso-ohz.de
 - [ASR Stadt Chemnitz](/doc/source/asr_chemnitz_de.md) / asr-chemnitz.de
+- [ASTO (Abfall- Sammel- und Transportverband Oberberg)](/doc/ics/asto_de.md) / asto.de
 - [ATHOS GmbH](/doc/source/app_abfallplus_de.md) / Abfall+ App: athosmobil
 - [Attendorn](/doc/ics/abfuhrtermine_info.md) / attendorn.de
 - [Augsburg](/doc/source/app_abfallplus_de.md) / Abfall+ App: awa

custom_components/waste_collection_schedule/sources.json

@@ -3209,6 +3209,11 @@
       "module": "asr_chemnitz_de",
       "default_params": {}
     },
+    {
+      "title": "ASTO (Abfall- Sammel- und Transportverband Oberberg)",
+      "module": "ics",
+      "default_params": {}
+    },
     {
       "title": "ATHOS GmbH",
       "module": "app_abfallplus_de",

doc/ics/asto_de.md

@@ -0,0 +1,26 @@
+# ASTO (Abfall- Sammel- und Transportverband Oberberg)
+
+ASTO (Abfall- Sammel- und Transportverband Oberberg) 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://www.asto.de/> and navigate to the `Abfallkalender` page.
+- Click on `Digital / Mobil` in the left navigation sidebar, then select your region in the same sidebar.
+- Select your address.
+- Right-click -> copy link address on the `Jahreskalender (iCal)` button.
+- Paste the copied link into the `url` parameter.
+- You can remove the cHash part of the URL, it is not needed.
+- It's recommended to replace the year in the URL with `{%Y}` so it will be automatically updated each year if the URL only changes the year.
+
+## Examples
+
+### Marienheide Am Brandteich
+
+```yaml
+waste_collection_schedule:
+  sources:
+    - name: ics
+      args:
+        url: https://www.asto.de/abfallkalender/{%Y}/abfallkalender-jahresdetail/jahrdetail-digital/staedte-listview/district-detailview/district-ical?tx_cctrashcalendar_fetrashcal%5Baction%5D=iCalExport&tx_cctrashcalendar_fetrashcal%5Bcontroller%5D=District&tx_cctrashcalendar_fetrashcal%5Bdistrict%5D=49364
+```

doc/ics/yaml/asto_de.yaml

@@ -0,0 +1,14 @@
+title: ASTO (Abfall- Sammel- und Transportverband Oberberg)
+url: https://www.asto.de/
+howto: |
+   - Goto <https://www.asto.de/> and navigate to the `Abfallkalender` page.
+   - Click on `Digital / Mobil` in the left navigation sidebar, then select your region in the same sidebar.
+   - Select your address.
+   - Right-click -> copy link address on the `Jahreskalender (iCal)` button.
+   - Paste the copied link into the `url` parameter.
+   - You can remove the cHash part of the URL, it is not needed.
+   - It's recommended to replace the year in the URL with `{%Y}` so it will be automatically updated each year if the URL only changes the year.
+
+test_cases:
+   Marienheide Am Brandteich:
+      url: "https://www.asto.de/abfallkalender/{%Y}/abfallkalender-jahresdetail/jahrdetail-digital/staedte-listview/district-detailview/district-ical?tx_cctrashcalendar_fetrashcal%5Baction%5D=iCalExport&tx_cctrashcalendar_fetrashcal%5Bcontroller%5D=District&tx_cctrashcalendar_fetrashcal%5Bdistrict%5D=49364"

doc/source/ics.md

@@ -180,6 +180,7 @@ This source has been successfully tested with the following service providers:
 - [ALBA Braunschweig](/doc/ics/alba_bs_de.md) / alba-bs.de
 - [Altmarkkreis Salzwedel](/doc/ics/abfall_app_net.md) / altmarkkreis-salzwedel.de
 - [ART Trier](/doc/ics/art_trier_de.md) / art-trier.de
+- [ASTO (Abfall- Sammel- und Transportverband Oberberg)](/doc/ics/asto_de.md) / asto.de
 - [Attendorn](/doc/ics/abfuhrtermine_info.md) / attendorn.de
 - [AVL - Abfallverwertungsgesellschaft des Landkreises Ludwigsburg mbH](/doc/ics/avl_ludwigsburg_de.md) / avl-ludwigsburg.de
 - [AWG Bassum](/doc/ics/awg_bassum_de.md) / awg-bassum.de