From 2d353799d8510152bae1cf48585e4a0dbef06a2f Mon Sep 17 00:00:00 2001
From: Alexei Karpenko <karpen_ko@hotmail.com>
Date: Wed, 30 Sep 2026 12:37:40 +0200
Subject: [PATCH] Ferien import: added comments

---
 .../api/frontend/v1/education/Ferien.php            | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/application/controllers/api/frontend/v1/education/Ferien.php b/application/controllers/api/frontend/v1/education/Ferien.php
index 97306c8d1..dc5547690 100644
--- a/application/controllers/api/frontend/v1/education/Ferien.php
+++ b/application/controllers/api/frontend/v1/education/Ferien.php
@@ -305,9 +305,7 @@ class Ferien extends FHCAPI_Controller
 	}
 
 	/**
-	 * 
-	 * @param
-	 * @return object success or error
+	 * Import Ferien from external source
 	 */
 	public function importFerien()
 	{
@@ -353,7 +351,10 @@ class Ferien extends FHCAPI_Controller
 					$importedFerien[$headers[$idx]] = $value;
 				}
 
+				// map Ferien so they can be imported
 				$ferien = $this->_mapImportFerien($importedFerien);
+
+				// do not import Ferien if no successfull import or not in date range
 				if (
 					!$ferien
 					|| ($filterVonDatum != null && new DateTime($filterVonDatum) > new DateTime($ferien['bisdatum']))
@@ -452,9 +453,9 @@ class Ferien extends FHCAPI_Controller
 	}
 
 	/**
-	 * 
-	 * @param
-	 * @return object success or error
+	 * Map ferien from external source to internal format 
+	 * @param $importedFerien from external source
+	 * @return array imported Ferien, in fhcomplete format
 	 */
 	private function _mapImportFerien($importedFerien)
 	{