Merge branch 'devel' into MaYor-dev

1 files changed, 423 insertions, 213 deletions

diff --git a/egyéb/nextcloud/mayor-nextcloud.cfg.php b/egyéb/nextcloud/mayor-nextcloud.cfg.php
index 205f6714..4e1f82de 100644
--- a/egyéb/nextcloud/mayor-nextcloud.cfg.php
+++ b/egyéb/nextcloud/mayor-nextcloud.cfg.php
@@ -1,232 +1,305 @@
 <?php 
 
 //////////////////////// Figyelem! Az alábbi config érvényes a Mayor-Nextcloud scripthez, nem a "mayor-nextcloud.php" fejléce!!  ////////////////////////////
-
-
-$db = array();
-$m2n = array();
-
-$db['host'] = "localhost";
-$db['port'] = "3306";
-$db['user'] = "root";
-$db['pass'] = "";
-$db['m2n_db'] = "mayor_to_nextcloud";
-$db['m2n_prefix'] = "m2n_";
-$db['nxt_dbname'] = "Nextcloud";
-$db['nxt_prefix'] = "oc_";
-//$db['mayor_host'] = ""; 
-//$db['mayor_port'] = "";
-//$db['mayor_user'] = ""; 
-//$db['mayor_pass'] = "";
-
-$m2n['min_evfolyam'] = 1;
-$m2n['isk_rovidnev'] = "rovid";  
-$m2n['csoport_prefix'] = "(tk) ";
-$m2n['default_email'] = "indulo@iskola.hu";
-$m2n['default_passw'] = "EHYmGktzrdfS7wxJR6DFqxjJ";
-$m2n['default_quota'] = "10GB";
-$m2n['diak_quota']    = "2GB"; 
-$m2n['min_osztalyok'] =  array(); 	//pl:  array('9.a','11.a');
-$m2n['csoportnev_hossz'] = 40;
-$m2n['felhasznalo_hossz'] = 45;
-$m2n['default_lang']  = "hu";
-$m2n['manage_groupdirs'] = false;
-$m2n['groupdir_prefix'] = "Iskolai Távoktatás";
-$m2n['mindenki_csop'] = "naplós_felhasználók";
-$m2n['mindenki_tanar'] = "naplós_tanárok";
-$m2n['mindenki_diak'] = "naplós_diákok";
-$m2n['zaras_tartas'] =  "2018-06-14";	// Ha nem kell, akkor állítsd át "1970-01-01"-re.
-$m2n['megfigyelo_user'] = "naplo_robot";
-$m2n['kihagy'] = array();   //pl:  array('Trap.Pista', 'Ebeed.Elek', '22att')
-$m2n['verbose'] = 3 ;  
+$cfg = array();
+
+$cfg['db_host'] = "localhost";
+$cfg['db_port'] = "3306";
+$cfg['db_user'] = "root";
+$cfg['db_pass'] = "";
+$cfg['db_m2n_db'] = "mayor_to_nextcloud";
+$cfg['db_m2n_prefix'] = "m2n_";
+$cfg['db_nxt_dbname'] = "Nextcloud";
+$cfg['db_nxt_prefix'] = "oc_";
+//$cfg['db_mayor_host'] = ""; 
+//$cfg['db_mayor_port'] = "";
+//$cfg['db_mayor_user'] = ""; 
+//$cfg['db_mayor_pass'] = "";
+
+$cfg['min_evfolyam'] = 7;
+$cfg['isk_rovidnev'] = "rovid";  
+$cfg['csoport_prefix'] = "(tk) ";
+$cfg['default_email'] = "indulo@iskola.hu";
+$cfg['default_passw'] = "EHYmGktzrdfS7wxJR6DFqxjJ";
+$cfg['always_set_diak_quota'] = false;
+$cfg['default_quota'] = "10GB";
+$cfg['diak_quota']    = "2GB"; 
+$cfg['min_osztalyok'] =  array(); 	//pl:  array('9.a','11.a');
+$cfg['csoportnev_hossz'] = 40;
+$cfg['felhasznalo_hossz'] = 45;
+$cfg['default_lang']  = "hu";
+$cfg['manage_groups'] = false;
+$cfg['manage_groupdirs'] = false;   //Foglalkozzon-e a script a tankörmappákkal
+$cfg['groupdir_users'] = array("naplo_robot","123abcd");  //Ha a tömb üres, akkor az összes tanárral dolgozik.
+$cfg['groupdir_prefix'] = "Iskolai Távoktatás";
+$cfg['mindenki_csop'] = "naplós_felhasználók";
+$cfg['mindenki_tanar'] = "naplós_tanárok";
+$cfg['mindenki_diak'] = "naplós_diákok";
+$cfg['allapot_tartas'] =  "2018-06-14";	// Ha nem kell, akkor állítsd át "1970-01-01"-re.
+$cfg['megfigyelo_user'] = "naplo_robot";
+$cfg['kihagy'] = array();   //pl:  array('Trap.Pista', 'Ebeed.Elek', '22att')
+$cfg['verbose'] = 3 ;  
+
+
+$cfg['ldap_server'] = "ldaps://windows.iskola.hu:636";      //Jelszóváltoztatást csak TLS/SSL porton enged a windows!
+$cfg['ldap_reqCert'] = "allow";                             // Ellenőrizze-e a certet: "true" "allow" "never"
+$cfg['ldap_baseDn']   =   "DC=ad,DC=iskola,DC=hu";
+$cfg['ldap_rootBindDn'] = "CN=LDAP_ADATCSERE_ADMIN,CN=Users,DC=ad,DC=iskola,DC=hu";
+$cfg['ldap_rootBindPw'] = "<password>";
+$cfg['ldap_pageSize']   = 100;
+$cfg['ld_username']       = "sAMAccountName";
+$cfg['ld_oId']            = "serialNumber";
+$cfg['ld_employeeId']     = "employeeNumber";
+$cfg['ld_osztalyJel']     = "department";
+$cfg['ld_viseltNevElotag'] = "initials";
+$cfg['ld_viseltCsaladinev'] = "sn";
+$cfg['ld_viseltUtonev']   = "givenName";
+$cfg['ld_lakhelyOrszag']  = "co";
+$cfg['ld_lakhelyHelyseg'] = "l";
+$cfg['ld_lakhelyIrsz']    = "postalCode";
+$cfg['ld_lakHely']        = "streetAddress";
+$cfg['ld_telefon']        = "homePhone";
+$cfg['ld_mobil']          = "mobile";
+$cfg['ld_statusz']        = "company";
+$cfg['ld_beoszt']         = "title";
+$cfg['ld_nxtQuota']       = "description";
 
 $occ_path = "/var/www/nextcloud/"; 
 $occ_user = "www-data";
 
 
+/*
+Nextcloud(13+) - Mayor script
 
+Ezen script segítségével a Mayor-naplóból tudunk felhasználókat és csoportokat importálni a Nextcloud felhőbe,
+létrehozva ezzel a saját, iskolai felhőszolgáltatásunkat.
 
-$m2n['infotxt_szöveg'] = <<<EOT
-
-                    FONTOS INFORMÁCIÓK!
-
-Ez a mappa, és a benne lévő mappák, a távoktatás segítésére, egyszerűsítésére szolgálnak.
-
-Fontos tudni, hogy ha megosztunk egy, a mi mappánkon belüli fájlt, vagy mappát, egy másik felhasználóval a felhőben, akkor a megosztott fájl, vagy mappa, a másik felhasználónak a kezdőoldalán jelenik meg, a fájlok között.
-Egy idő után, ha az illető, már nagyon sok megosztást fogadott, a rengeteg fájl már számára egy átláthatatlan mappa-tengert fog képezni, és nagyon nehéz lesz benne eligazodnia.
+Ez a script lényegében annyit csinál, hogy a mysql-ből lekérdezi a mayor diák-tankör-tanár kapcsolatokat,
+majd a tankörök nevei alapján létrehozza a csoportokat és a felhasználókat a Nextcloud szerveren,
+majd belépteti ezen csoportokba a diákokat, és tanárokat,  megspórolva ezzel a kézi (egyesével történő) feltöltést,
+és egy csomó időt az adminisztrátornak.
 
+Támogatja a külön, illetve az egy, közös szerverre történő telepítését a mayornak és a nextcloud-nak. **(lásd: Szeparációs lehetőségek rész.)
+A Nextcloud 13-mas és újabb verzióival használható.
 
-Ezen probléma kivédésére született ez, az alábbi megoldás:
+FONTOS!
+  Legalább "php7.0" és "Apache 2.4" kell hozzá!
+ 
 
-A tanátoknak a szerver automatikusan létrehoz egy, a távoktatásra használatos gyűjtőmappát, ebbe a mappába létrehozza a tanár által tanított (e-napló szerint) tanköröknek megfelelő mappákat automatikusan.
 
+Beállítása az alábbiak szerint: (egy lehetséges elrendezés)
 
-A használati szabályok:
-1) A tanár ezekbe a mappákba helyezi/helyezheti el a diákoknak szánt fájlokat.
-2) A tanár ezeket a mappákat osztja meg a diákcsoportokkal.
-3) A diák ezekben a mappákban helyezi el a nyilvánosan visszaküldendő fájlokat, képeket. (Ezt a mappát, a tankör összes tagja látja, amelyik tankörrel megosztottuk.)
-4) A diák, a privát módon visszaküldendő fájlokat, a tanárral való megegyezés szerint, lehetőleg ne ebbe a mappába helyezze el, azt egyszerűen ossza meg a tanárával.
-5) A Tankörmappákban a  fájlok rendjét a tanár határozza/határozhatja meg.
-6) A tankörmappák gyűjtőmappájában a rendet a szerver tartja, oda egyéb fájl, nem helyezhető.  Ha mégis kerülne oda egyéb fájl akkor, arról a szerver, a tanárt először értesíti, majd később a fájt automatikusan törli.
+-(I.)   Először telepítsünk föl egy Nextcloud(legalább 13-mas verzió) szervert egy Debian (9-es vagy magasabb verzió) szerverre,
+        a Nextcloudnak szüksége van e-mail küldés (smtp) szolgáltatásra is. (ez lehet külső, pl.: google)
+        Bővebb leírást a telepítésről az interneten "Nextcloud Admin Manual"-ra keresve találunk.
 
+-(II.)  Helyezzük el a "mayor-nextcloud.php"-t biztos, védett helyre,a nextcloud szerveren, akár a /etc/ mappába, akár a /root könyvtárba,
+        ezt később "root"-ként kell majd futtatnunk, és mysql jelszó is lehet/van benne, 
+        ezért ennek megfelelően védeni kell. Állítsuk be a tulajdonost, és korlátozzuk a jogosultságokat! (chown root; chmod 600)
 
+-(III.) Majd töltsük ki a konfigurációs fájlt (mayor-nextcloud.cfg.php) az alább felsorolt beállítások szerint!
+        (Ennek is állísunk (ugyanolyan)szigorú jogosultságokat, mint a fenti esetben! )
 
-Legyen egy gyakorlati példa:
-A tanár mappalistájában létrejön a gyűjtőmappa mondjuk: "Iskolai Távoktatás" névvel.
-Ezen, a "Iskolai Távoktatás" nevű mappán belül létrejön mondjuk, egy "(tk) 10.b fizika" és egy "(tk) 10.b osztályfőnöki" mappa.
+-(IV.)  Ezután, a script, az első futtatásnál automatikusan telepíti magát. 
+        Ez azt jelenti, hogy létrehoz egy mysql adatbázist saját magának, ahol később nyilvántartja, hogy melyek azoka felhasználók, amelyeket ő hozott létre. 
+        Így később, a folyamatos nyilvántartás révén a script a saját maga által létrehozott felhasználókat veszi csak figyelembe,
+        a többi, a más által létrehozott Nextcloud felhasználókhoz alapvetően nem nyúl.
+        Ez később felülbírálható, ha a script nyilvántartási adatbázisába kézzel felvesszük az adott felhasználó nevét.
 
-A tanár szabadon használhatja a   "(tk) 10.b fizika"   és a   "(tk) 10.b osztályfőnöki" mappákat, azokat szabadon megoszthatja, bele fájlokat helyezhet, belőlük fájlokat törölhet, ha engedélyezi a szerkesztést, akkor a diák is helyezhet bele fájlokat, vagy szerkesztheti*** a fájlokat.
-Ha a tankörmappát megosztja a diákkal/tankörrel, akkor a diáknak nem egy csomó fájl, és nem is az "Iskolai Távoktatás" mappa fog megjelenni a kezdőoldalán, hanem az adott tankörmappa. Tehát, ha a tanár a "(tk) 10.b fizika" mappát osztja meg, akkor a diák, a kezdőoldalán a "(tk) 10.b fizika" mappát fogja találni, és benne a tanár által hozzáadott fájlokat.
 
 
-Viszont a "Iskolai Távoktatás" nevű mappában csak! a  "(tk) 10.b fizika"   és a   "(tk) 10.b osztályfőnöki" mappák lehetnek, más fájl, vagy mappa, nem! 
-Ha mégis kerülne oda egyéb fájl, vagy mappa, akkor arról először értesíti a tanárt, majd a 3. értesítést követően, a nem odaillő fájlokat, vagy mappákat automatikusan törli.
 
-Ez szintén vonatkozik a korábban itt levő, de átnevezett mappákra is, tehát, ha a "(tk) 10.b fizika" mappát a tanár véletlenül átnevezné, akkor onnantól azt is "idegen" mappának fogja tekinteni.
+-(V.)  	A mayor-nextcloud script működése néhány mondatban:
+	
+	Első lépésben lekérdezi a feltételeknek megfelelő tanköröket a mayorból, (tankör-osztály évfolyama, tankör aktív-e a dátumok apaján)
+	  majd ez alapján ellenőrzi, hogy a Nextcloud-ban már szerepelnek-e ezen tankörneveknek megfelelő csoportok.
+	  Ha új tankör van a mayorban, akkor azt a Nextcloud-ban is létrehozza, ha egy tankört töröltek a mayorból, akkor azt a csoportot Nextcloud-ból is törli.
+	Fontos!
+	A csoport prefix-szel, például: "(tk) "-val kezdődő csoportokat magáénak tekinti, és ha nem találja a mayorban, akkor automatikusan töröli!
+	
+	Második lépésben lekérdezi a felhasználókat a mayorból, (jogviszony státusz, évfolyam, kapcsolódó tankörök)
+	  csak azokat a tanárokat, illetve diákokat veszi figyelembe, akinek a státusza nem "jogviszonya lezárva", vagy nem "felvételt nyert".
+ 	Ha az illető még nem rendelkezik felhasználónévvel a Nextcloud-ban, akkor létrehozza, 
+	- ha a mayorban, az "intezmeny_xxx.diak", illetve az "intezmeny_xxx.tanar" táblákon van beállított e-mail címe, akkor azt használja,
+	- ha nincs, akkor az alapértelmezettet állítja be a Nextcloud-ba, valamint ekkor állítódik be az alapértelmezett qvóta, és a felhasználó valódi neve is.
+	  (Ezeket később Rendszergazdai, és Felhasználói oldalról változtatni lehet, értelemszerűen.)
+	Ha az illető már rendelkezik felhasználónévvel, de az le volt tiltva, akkor újra engedélyezi.
 
-Ugyanez történik akkor is, ha a tanár, (a naplóban) kikerül a tankörből, tehát nem tanítja tovább, vagy a tankör ugrik egyet évkezdéskor, és a "(tk) 10.b fizika"-ból "(tk) 11.b fizika" lesz, ekkor a, még ottmaradó "(tk) 10.b fizika" mappát szintén idegennek fogja tekinteni.
+	Ezután egyezteti a tankör-csoport összerendeléseket, ha az illető új tankörbe került be, akkor belépteti a megfelelő csportba, 
+	  ha kikerült egy tankörből, akkor a csoportból is kilépteti.
 
-Természetesen a tanárnak lehetősége van az idegennek minősített mappákat, és azok tartalmát a "Iskolai Távoktatás" mappán kívülre, a saját mappái közé áthelyezni,  vagy az idegennek minősített mappák tartalmát egy másik, már "elfogadott" tankörmappába tenni.
-(Ez utóbbit kell tenni, vagyis a tanárnak kézzel áthelyezni a fájlokat az egyik tankörmappából, az új tankörmappába, amikor évváltás van, és a tankör ugrik egyet "(tk) 10.b fizika"  --> "(tk) 11.b fizika". )
+	Végül ellenőrzi a kiléptetndő felhasználókat.
+	Ha velekinek a státusza a mayorban "jogviszonya lezárva"-ra változott, vagy a felhasználónevét a mayorból törölték, akkor 	
+	- ha még nem lépett be soha a Nextcloudba, akkor a felhasználót fizikailag törli.
+	- ha már használta a fiókját, akkor csak letiltja, azért, hogy a fájljai ne vesszenek el automatikusan. 
+	(Ez, utóbbi esetben a Rendszergazdának kell külön elvégezni a törlést.)
+ 
 
 
 
+- (VI.)  További Információk:
 
-*** Tipp:
-1)
-Ha szeretnénk biztosra menni, és elkerülni, hogy a diák, a tanár által, az egész tankörnek küldött fájlokba véletlenül beleszerkesszen, hozzunk létre egy egy "beadás", vagy  hasonló nevű mappát a tankörmappán belül, és csak erre a "beadás" mappára adjuk meg a jogot a diáknak/diákcsoportnak/tankörnek szerkesztésre/módosításra.
+	Esetleg érdemes lehet a scriptet betenni a "cron"-ba (éjszakára), így naponta lefut, és követi napló változásait.
+	(Ez esetben figyelni kell arra, hogy mayorban a tankör-diák, tankör-tanár összerendelések az év végén lejárhatnak, (pl. júni. 15-én)
+	így a script futtatása júni. 16-án kitörli, letiltja az összes létrehozott mayor-os csoportot, és felhasználót a nextcloud-ból, 
+	amely csak a script szept. 1-je után történő futtatásával hozható vissza, 
+	ezért érdemes lehet a script automatikus futtatását átmenetileg júni. 15. és szept. 1. között felfüggeszteni.	)
+	(pl: /etc/crontab -ban
+		01  3   * * *     root    php -f /root/mayor-nextcloud.php						)
 
-2)
-Ha videófájlokat szeretnénk feltölteni nagy mennyiségben, akkor hozzunk létre az adott tankörhöz tartozó tankörmappában egy "Videók" nevű mappát, és abba helyezzük el a videófájlokat. A könnyebb megkülönböztethetőség végett nevezzük át a videófájlokat dátum szerinti, fájlnévre, vagy sorszámozzuk őket, és a sorszámot tüntessük föl a fájl nevében!
 
-EOT;
+	A mayor által ajánlott "Vezetéknév.Keresztnév" típusú felhasználónév formátum, bár hasznos, mert könnyen megjegyezhető,
+	viszont (sajnos) egyáltalán nem POSIX kompatibilis (amely csak az angol ABC betűit +pár kiegészítő karaktert engedélyez)
+	így a legtöbb rendszerrel nem hozható összhangba, ezért szükség van az ékezetes karakterek lecserélésére.
 
- 
-/*
-Nextcloud(13+) - Mayor script
+	A karakterek cseréje az alábbi módon történik:
+	
+		á --> aa 	Á --> Aa
+		ä --> ae	Ä --> Aae
+		é --> ee	É --> Ee	Például:
+		í --> ii	Í --> Ii	Vezetéknév.Keresztnév --> Vezeteekneev.Keresztneev
+		ó --> oo	Ó --> Oo	Bőrönd.Ödön	      --> Booeroend.Oedoen
+		ö --> oe	Ö --> Oe
+		ő --> ooe	Ő --> Ooe	Ha a mayor felhasználónév nem tartalmaz ékezetes betűt,
+		ú --> uu	Ú --> Uu	akkor nem történik csere, a felhasználónév marad az eredeti.
+		ü --> ue	Ü --> Ue
+		ű --> uue	Ű --> Uue
 
-Ezen script segítségével a Mayor-naplóból tudunk felhasználókat és csoportokat importálni a Nextcloud felhőbe,
-létrehozva ezzel a saját, iskolai felhőszolgáltatásunkat.
+	Ezeket a karakter cseréket maga a script végzi, futás közben, a mayor felhasználónevekből,
+	a létrejövő Nextcloud felhasználónév már a lecserélt változat lesz.
 
-Ez a script lényegében annyit csinál, hogy a mysql-ből lekérdezi a mayor diák-tankör-tanár kapcsolatokat,
-majd a tankörök nevei alapján létrehozza a csoportokat és a felhasználókat a Nextcloud szerveren,
-majd belépteti ezen csoportokba a diákokat, és tanárokat,  megspórolva ezzel a kézi (egyesével történő) feltöltést,
-és egy csomó időt az adminisztrátornak.
 
-Támogatja a külön, illetve az egy, közös szerverre történő telepítését a mayornak és a nextcloud-nak. **(lásd: Szeparációs lehetőségek rész.)
-A Nextcloud 13-mas és újabb verzióival használható.
 
-FONTOS!
-    Legalább "php7.0" és "Apache 2.4" kell hozzá!
- 
 
+-(VII.)  További Paraméterek / Kapcsolók:
 
-Beállítása az alábbiak szerint: (egy lehetséges elrendezés)
+      --help                      :  Help kiírása. 
+      --debug                     :  Ugyanaz mint a "--loglevel 100" 
+      --loglevel x                :  A bőbeszédűséget/logolást tudjuk ezzel szabályozni, ekkor ez az érték érvényesül, nem a configban megadott.
+      --config-file               :  Konfig fájl elérési útvonala.
+      --config-print              :  A betöltött konfig kiírása.
+      --set-diak-quota            :  Az összes diák qvótáját átállítja az "$cfg['diak_quota'] = x" -nél megadott értékre,  
+                                       csak kézzel futtatva működik, az automatikus, napi futtatásban nicns benne.
+      --create-groupdir <username>:  A távoktatást segítő könyvtárstruktúrát csak az <username> felhasználónak  hozza létre, 
+                                       egyébként kapcsoló nélküli híváskor, (pl: automatikusan, a napi futásban éjjel), az összes tanárnak egyszerre.
+      --manage-groups <1/0>       :  Ha 1: A felhasználókat csoportokba rendezi a MaYor tankörök szerint, ha 0, nem foglalkozik a csoportokkal.
+      --manage-groupdirs <1/0>    :  Ha 1: tankörmappákat hoz létre a tankör-csoportokhoz, ha 0, nem foglalkozik vele. (kell hozzá a --manage-groups is!)
+    
 
--(I.)   Először telepítsünk föl egy Nextcloud(legalább 13-mas verzió) szervert egy Debian (9-es vagy magasabb verzió) szerverre,
-        a Nextcloudnek szüksége van e-mail küldés (smtp) szolgáltatásra is. (ez lehet külső, pl.: google)
-        Bővebb leírást a telepítésről a "Nextcloud Admin Manual" oldalon találunk.
+  FONTOS!! 
+    A Nextcloud szerver "occ" parancsa elérhető kell legyen a script számára!
+    Az "occ" parancs működését pl. az: (>>> sudo -u www-data php /var/www/nextcloud/occ ) kiadásával ellenőrizzük!
 
--(II.)  Helyezzük el a "mayor-nextcloud.php"-t biztos, védett helyre,a nextcloud szerveren, akár a /etc/ mappába, akár a /root könyvtárba,
-        ezt később "root"-ként kell majd futtatnunk, és mysql jelszó is lehet/van benne, 
-        ezért ennek megfelelően védeni kell. Állítsuk be a tulajdonost, és korlátozzuk a jogosultságokat! (chown root; chmod 600)
-	Majd töltsük ki a konfigurációs fájlt az alább felsorolt beállítások szerint!
 
 
 
--(III.) A "mayor-nextcloud.cfg.php" fajl elején találhatóak a konfigurációs adatok, ezeket a következőképpen módosíthatjuk:
+-(VIII.) A "mayor-nextcloud.cfg.php" fajl elején találhatóak a konfigurációs adatok, ezeket a következőképpen módosíthatjuk:
 
 
-    $db['host'] = "localhost";              //Ez a nextcloud alatt futó mysql elérhetősége.
+    $cfg['db_host'] = "localhost";              //Ez a nextcloud alatt futó mysql elérhetősége.
                                             // (Csak localhost lehet, a scriptet a nextcloud-szerveren kell futtatnunk.)
 
-    $db['port'] = "3306";                   //nextcloud-mysql port
+    $cfg['db_port'] = "3306";                   //nextcloud-mysql port
 
-    $db['user'] = "root";                   //nextcloud-mysql felhasználónév
+    $cfg['db_user'] = "root";                   //nextcloud-mysql felhasználónév
                                             // HA nem a root-ot használjuk, akkor, saját kezűleg kell létrehozni a script saját, nyilvántartó adatbázisát, és a fenti jogokat beállítani rá, 
                                             //  valamint Ha a Nextcloud verziószáma kisebb 14-nél, akkor a használt felhasználónak írási-olvasási-törlési
                                             //  (insert,select,update,delete) joggal kell rendelkeznie a nextcloud adatbázis "..groups" tábláján.
                                             // Ha a Debian-on alapértelmezett root-ot használjuk, akkor mindez automatikusan történik.
 
-    $db['pass'] = "";                       //A nextcloud-mysql jelszó    (A fenti felhasználónévhez tartozó)
+    $cfg['db_pass'] = "";                       //A nextcloud-mysql jelszó    (A fenti felhasználónévhez tartozó)
                                             // érdemes a debian 9.x-en, a root-hoz alapértelmezett "unix_socket" bejelentkezési módot 
                                             // használnunk, ez biztonságosabb, mert ekkor nem kell jelszó, más módon hitelesít, így biztonságosabb.
 
 
 
-    $db['nxt_dbname'] = "nextcloud";        //A Nextcloud által használt adatbázis neve.
-    $db['nxt_prefix'] = "oc_";              //A Nextcloud által használt adatbázisban a táblák prefix-je. (ha van)
+    $cfg['db_nxt_dbname'] = "nextcloud";        //A Nextcloud által használt adatbázis neve.
+    $cfg['db_nxt_prefix'] = "oc_";              //A Nextcloud által használt adatbázisban a táblák prefix-je. (ha van)
 
 
-    $db['m2n_db'] = "mayor_to_nextcloud";   //A mayor->nextcloud script adatbázisa (nyilvántartás). 
+    $cfg['db_m2n_db'] = "mayor_to_nextcloud";   //A mayor->nextcloud script adatbázisa (nyilvántartás). 
                                             // Ennek az adatbázisnak a Nextcloud mysql szerverén kell lennie!
                                             //
                                             // Ebben az adatbázisban könyveli le a script által létrehozott felhasználókat, azért,
                                             //  hogy így meg tudja különböztetni, a saját maga által létrehozottakat, az Adminisztrátor
                                             //  által, kézzel létrehozott felhasználóktól, hogy azokat ne birizgálja.
 
-    $db['m2n_prefix'] = "m2n_";             //A nyilvántartó adatbázisban használt prefix, ha van. (ha nincs, akkor "üres string"-re kell állítani ($db['m2n_prefix'] = "";))
+    $cfg['db_m2n_prefix'] = "m2n_";             //A nyilvántartó adatbázisban használt prefix, ha van. (ha nincs, akkor "üres string"-re kell állítani ($cfg['db_m2n_prefix'] = "";))
 
 
-    //$db['mayor_host'] = "";               //Akkor használatos, ha a mayor alatti mysql szerver egy másik szerveren van, mint a Nextcloud által használt.
-    //$db['mayor_port'] = "";               // ekkor ki kell venni kommentből, és ki kell tölteni a mayor-mysql serverre érvényes adatokkal.
-    //$db['mayor_user'] = "";
-    //$db['mayor_pass'] = "";               //A kiválasztott felhaználónak olvasnia (GRANT SELECT) kell tudnia a mayor-mysql serveren a(z):
+    //$cfg['db_mayor_host'] = "";               //Akkor használatos, ha a mayor alatti mysql szerver egy másik szerveren van, mint a Nextcloud által használt.
+    //$cfg['db_mayor_port'] = "";               // ekkor ki kell venni kommentből, és ki kell tölteni a mayor-mysql serverre érvényes adatokkal.
+    //$cfg['db_mayor_user'] = "";
+    //$cfg['db_mayor_pass'] = "";               //A kiválasztott felhaználónak olvasnia (GRANT SELECT) kell tudnia a mayor-mysql serveren a(z):
                                             // intezmeny_xxx, mayor_parent, naplo_xxx_yyyy adatbázisokból.
 	
                                             //Ha a mayor-mysql sezvere fizikailag (vagy virtuálisan) másik szerveren van, akkor érdemes egy "ssh-tunnel"-lel 
                                             // áthozni a portját a nextcloud-serverre. (ez a legbiztonságossabb)
 
 
-    $m2n['isk_rovidnev'] = "rovid";         //A mayor-ban használt "iskola rövidneve" megnevezés.
+    $cfg['isk_rovidnev'] = "rovid";         //A mayor-ban használt "iskola rövidneve" megnevezés.
 
-    $m2n['min_evfolyam'] = 10;              //A minimális évfolyam, amelytől fölfelé engedélyezzük a felhő használatát a diákoknak.
+    $cfg['min_evfolyam'] = 10;              //A minimális évfolyam, amelytől fölfelé engedélyezzük a felhő használatát a diákoknak.
 
-    $m2n['csoport_prefix'] = "(tk) ";       //A Nextcloud-ban ezzel az előtaggal jelennek majd meg mayor-ból importált csoportok, a jobb átláthatóság érdekében.
+    $cfg['csoport_prefix'] = "(tk) ";       //A Nextcloud-ban ezzel az előtaggal jelennek majd meg mayor-ból importált csoportok, a jobb átláthatóság érdekében.
 
 
 
-    $m2n['default_email'] = "rendszergazda@iskola.hu";  //Ha a mayor napló "intezmeny_xxx.diak", vagy az "intezmeny_xxx.tanar" táblákban nincs kitöltve az 
+    $cfg['default_email'] = "rendszergazda@iskola.hu";  //Ha a mayor napló "intezmeny_xxx.diak", vagy az "intezmeny_xxx.tanar" táblákban nincs kitöltve az 
                                                         // e-mail, akkor ezt használja alapértelmezetten. 
                                                         // (ide megy a jelszó-emlékeztető, amíg a felhasználó birtokba nem veszi a Nextcloud fiókját, és ben nem állít sajátot)
 
-    $m2n['default_passw'] = "EHYmGktzrdfS7wxJR6DF11jJ"; //Az induló jelszó a Nextcloud-ban a felhasználóknak. (érdemes erőset/hosszút megadni, a botnet-ek/hackerek miatt)
+    $cfg['default_passw'] = "EHYmGktzrdfS7wxJR6DF11jJ"; //Az induló jelszó a Nextcloud-ban a felhasználóknak. (érdemes erőset/hosszút megadni, a botnet-ek/hackerek miatt)
 
-    $m2n['default_quota'] = "10GB";                     //Az általános indulási fájl-kvóta a Nextcloud-ban. (A wbes felületen később módosítható.)
+    $cfg['default_quota'] = "10GB";                     //Az általános indulási fájl-kvóta a Nextcloud-ban. (A wbes felületen később módosítható.)
                                                         // Amikor új felhasználót ad hozzá, akkor az itt megadott méretre állítja a qvótáját.
                                                         // Midel a diákoknak külön qvótát lehet beállítani, ezért ez értelemszerűen már csak a tanárokra vonatkozik.
     
-    $m2n['diak_quota'] = "2GB";                         //A diákok! indulási kvótája
+    $cfg['diak_quota'] = "2GB";                         //A diákok! indulási kvótája
                                                         // amikor új diákot ad hozzá, ezt a qvótát állítja be a számára.
+                                                        //Lehetőség van az összes diák kvótáját egyszerre, az itt beállított értékre állítani,
+                                                        // de ez nem fut automatikusan éjjelente, ezt kézzel kell, --set-diak-qupta kapcsoló kiadásával.
 
-    $m2n['default_lang']  = "hu";                       //Az alapértelmezett nyelv (később minden felhasználó átállíthatja magának)
+    $cfg['default_lang']  = "hu";                       //Az alapértelmezett nyelv (később minden felhasználó átállíthatja magának)
 
-    $m2n['min_osztalyok'] =  array( );                  //Ide lehet felsorolni az osztályokat, ha konkrét osztályokat akaruni importálni,
-                                                        // ez logikai (megengedő) VAGY kapcsolatban van a $m2n['min_evfolyam'] -mal.
+    $cfg['min_osztalyok'] =  array( );                  //Ide lehet felsorolni az osztályokat, ha konkrét osztályokat akaruni importálni,
+                                                        // ez logikai (megengedő) VAGY kapcsolatban van a $cfg['min_evfolyam'] -mal.
                                                         //  Tehát ha beállítunk egy minimális évfolyamot, a listában felsorolt osztályok akkor is importálódnak,
                                                         //  ha a min_évfolyam-nál kisebbek.   //pl:  array('9.a','11.a');
 
-    $m2n['csoportnev_hossz'] = 40;                      // Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a csoport neve. (csak a script kinézete/átláthatósága végett)
+    $cfg['csoportnev_hossz'] = 40;                      //Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a csoport neve. 
+                                                        // (csak a script kinézete/átláthatósága végett)
 
-    $m2n['felhasznalo_hossz'] = 45;                     // Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a felhasználó valódi neve. (csak a script kinézete/átláthatósága végett)
+    $cfg['felhasznalo_hossz'] = 45;                     //Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a felhasználó valódi neve. 
+                                                        // (Ssak a script szép kinézete, átláthatósága végett.)
 
-    $m2n['mindenki_csop'] = "naplós_felhasználók";      //Legyen egy olyan csoport, amiben "mindenki benne van".
+    $cfg['mindenki_csop'] = "naplós_felhasználók";      //Legyen egy olyan csoport, amiben "mindenki benne van".
                                                         // ebbe a "mindenki" csoportba minden, a script által létrehozott felhasználó bekerül.
-														
-    $m2n['mindenki_tanar'] = "naplós_tanárok";          //Legyen egy olyan csoport, amiben minden tanár benne van
+
+    $cfg['mindenki_tanar'] = "naplós_tanárok";          //Legyen egy olyan csoport, amiben minden tanár benne van
                                                         // ebbe a "minden_tanár" csoportba a naplóbeli tanárok kerülnek.
-														
-    $m2n['mindenki_diak'] = "naplós_diákok";            //Legyen egy olyan csoport, amiben "minden diák" benne van.
+
+    $cfg['mindenki_diak'] = "naplós_diákok";            //Legyen egy olyan csoport, amiben "minden diák" benne van.
                                                         // ebbe a "minden_diák" csoportba a naplóbeli diákok kerülnek.
 
-    $m2n['zaras_tartas'] =  "2018-06-19";               //A jelölt napon befejezett, de nem lezárt tanév adatainak megtartása. (pl. szeptemberig) 
-                                                        // Ha már nem kell, akkor állítsd "1970-01-01"-ra !;
+    $cfg['allapot_tartas'] =  "2018-06-19";             //A jelölt nap állapotának megtartása/betöltése minden futtatáskor. (hasznos lehet a nyári szütnetben)
+                                                        // Csak az AKTÍV vagy LEZÁRT állapotú szemeszereket nézi.
+                                                        //A szerveren lévő legelső, vagy legutolsó, (aktív vagy lezárt) szemeszter előtti, illetve utáni nap nem állítható be.
+                                                        //Ha már nem kell, vagy, ha mindíg az aktuális (aznapi) dátumot szeretnéd használni, 
+                                                        // akkor állítsd üresre, vagy  "1970-01-01"-ra!;
+
+    $cfg['manage_groupdirs'] = false;                   //Ha szerenénk, hogy a script létrehozza a távoktatást segítő tankörmappákat, állítsuk "true"-re!
 
-    $m2n['manage_groupdirs'] = false;                   //Ha szerenénk, hogy a script létrehozza a távoktatást segítő tankörmappákat, állítsuk "true"-re!
+    $cfg['groupdir_users'] = array("123abcd", );        //Ha csak egyes tanároknak szeretnénk bekapcsolni a tankörmappákat,
+                                                        // ha minden tanárnak, akkor állítsuk üresre a tömböt!   / = array();/
 
-    $m2n['groupdir_prefix'] = "Iskolai Távoktatás";     //A távoktatást segítő mappák gyüjtőmappája/gyökérkönyvtára.
-							
-    $m2n['verbose'] = 3                                 //Log bőbeszédűség      (A leg informatívabb(tömörebb), talán a 3-mas fokozat.)
+    $cfg['groupdir_prefix'] = "Iskolai Távoktatás";     //A távoktatást segítő mappák gyüjtőmappája/gyökérkönyvtára.
+
+    $cfg['manage_groups'] = true;                       //Foglalkozzon-e a tankörökkel/csoportokkal?  Ha true -> igen, ha false, akkor csak a felhasználókat 
+                                                        // egyezteti a mayorral
+    $cfg['manage_groupdirs'] = false;                   //A tankör-cspoprt mappákat kezelje-e vagy sem.  
+ 
+    $cfg['verbose'] = 3                                 //Log bőbeszédűség      (A leg informatívabb(tömörebb), talán a 3-mas fokozat.)
                                                         // 0: csak fatális hibák, 1: fontosabbak, 2: csop./felh. elvétel, 3: csop./felh. hozzáadás, 
                                                         // 4: csop./felh. állapot, 5: részletesebben, 6: sql query + bash parancsok kiírása is
 
@@ -236,101 +309,28 @@ Beállítása az alábbiak szerint: (egy lehetséges elrendezés)
 
     $occ_user = "www-data";                             //A Nextcloud-servert futtató (Apache által használt) felhasználónév
 
-    $m2n['kihagy'] = array();                           //Lehetőség van egy-egy felhasználó kezelésének letiltására, ezt felsorolásként tehetjük meg.
+    $cfg['kihagy'] = array();                           //Lehetőség van egy-egy felhasználó kezelésének letiltására, ezt felsorolásként tehetjük meg.
                                                         // Ekkor a script nem fog foglalkozni, az adott felhasználóval a továbbiakban.
-														//pl:  array('Trap.Pista', 'Ebeed.Elek', '22att')
-														
-	$m2n['megfigyelo_user'] = "naplo_robot";            //Lehetőség van egy úgymond "megfigyelő" felhasználó létrehozására.
-														// ez a felhasználó be lesz léptetve az összes csoportba, így az összes üzenetet megkapja, 
+                                                        //pl:  array('Trap.Pista', 'Ebeed.Elek', '22att')
+                                                        
+    $cfg['megfigyelo_user'] = "naplo_robot";            //Lehetőség van egy úgymond "megfigyelő" felhasználó létrehozására.
+                                                        // ez a felhasználó be lesz léptetve az összes csoportba, így az összes üzenetet megkapja, 
                                                         // és az összes tankörben megosztott fájlt látja, amit a csoportokkal/tankörökkel megosztottak.
+                                                        //EZ a felhasználó nem egyezik meg a MaYor "mayoradmin" felhasználójával (nem lesz automatikusan rendszergazda)!
+                                                        // de megadható ugyanazon felhasználónév, és lejszó, mint a MaYor "mayoradmin"-nak
 
 
-    CONFIG FILE: "mayor-nextcloud.cfg.php";				//Lehetőség van a konfig exportálására egy külön fájlba, 
+    CONFIG FILE: "mayor-nextcloud.cfg.php";             //Lehetőség van a konfig exportálására egy külön fájlba, 
                                                         // így a mayor-nextcloud scriptet nem kell szerkeszteni, ha frissítés érkezik hozzá.
                                                         // Ez alapértelmezetten a maxor-nextcloud.php -val kell egy könyvtárba legyen.
                                                         
 
 
-    FONTOS!! 
-        A Nextcloud szerver "occ" parancsa elérhető kell legyen a script számára!
-        Az "occ" parancs működését pl. az: (>>> sudo -u www-data php /var/www/nextcloud/occ ) kiadásával ellenőrizzük!
-
-
 		
-	További Paraméterek / Kapcsolók:
-	
-		--loglevel x     :  A scriptbőbeszédűségét, logolását tudjuk ezzel szabályozni, ekkor ez az érték érvényesül, nem a configban megadott.
-
-    --set-diak-quota :  Az összes diák qvótáját átállítja az "$m2n['diak_quota'] = x" -nél megadott értékre
-
-    --create-groupdir <username>:  A távoktatást segítő könyvtárstruktúrát csak az <username> felhasználónak  hozza létre.
-
 
 
 
 
-
-	További Információk:
-
-	Esetleg érdemes lehet a scriptet betenni a "cron"-ba (éjszakára), így naponta lefut, és követi napló változásait.
-	(Ez esetben figyelni kell arra, hogy mayorban a tankör-diák, tankör-tanár összerendelések az év végén lejárhatnak, (pl. júni. 15-én)
-	így a script futtatása júni. 16-án kitörli, letiltja az összes létrehozott mayor-os csoportot, és felhasználót a nextcloud-ból, 
-	amely csak a script szept. 1-je után történő futtatásával hozható vissza, 
-	ezért érdemes lehet a script automatikus futtatását átmenetileg júni. 15. és szept. 1. között felfüggeszteni.	)
-	(pl: /etc/crontab -ban
-		01  3   * * *     root    php -f /root/mayor-nextcloud.php						)
-
-
-	A mayor által ajánlott "Vezetéknév.Keresztnév" típusú felhasználónév formátum, bár hasznos, mert könnyen megjegyezhető,
-	viszont (sajnos) egyáltalán nem POSIX kompatibilis (amely csak az angol ABC betűit +pár kiegészítő karaktert engedélyez)
-	így a legtöbb rendszerrel nem hozható összhangba, ezért szükség van az ékezetes karakterek lecserélésére.
-
-	A karakterek cseréje az alábbi módon történik:
-	
-		á --> aa 	Á --> Aa
-		ä --> ae	Ä --> Aae
-		é --> ee	É --> Ee	Például:
-		í --> ii	Í --> Ii	Vezetéknév.Keresztnév --> Vezeteekneev.Keresztneev
-		ó --> oo	Ó --> Oo	Bőrönd.Ödön	      --> Booeroend.Oedoen
-		ö --> oe	Ö --> Oe
-		ő --> ooe	Ő --> Ooe	Ha a mayor felhasználónév nem tartalmaz ékezetes betűt,
-		ú --> uu	Ú --> Uu	akkor nem történik csere, a felhasználónév marad az eredeti.
-		ü --> ue	Ü --> Ue
-		ű --> uue	Ű --> Uue
-
-	Ezeket a karakter cseréket maga a script végzi, futás közben, a mayor felhasználónevekből,
-	a létrejövő Nextcloud felhasználónév már a lecserélt változat lesz.
-
-		
-
-	A mayor-nextcloud script működése néhány mondatban:
-	
-	Első lépésben lekérdezi a feltételeknek megfelelő tanköröket a mayorból, (tankör-osztály évfolyama, tankör aktív-e a dátumok apaján)
-	  majd ez alapján ellenőrzi, hogy a Nextcloud-ban már szerepelnek-e ezen tankörneveknek megfelelő csoportok.
-	  Ha új tankör van a mayorban, akkor azt a Nextcloud-ban is létrehozza, ha egy tankört töröltek a mayorból, akkor azt a csoportot Nextcloud-ból is törli.
-	Fontos!
-	A csoport prefix-szel, például: "(tk) "-val kezdődő csoportokat magáénak tekinti, és ha nem találja a mayorban, akkor automatikusan töröli!
-	
-	Második lépésben lekérdezi a felhasználókat a mayorból, (jogviszony státusz, évfolyam, kapcsolódó tankörök)
-	  csak azokat a tanárokat, illetve diákokat veszi figyelembe, akinek a státusza nem "jogviszonya lezárva", vagy nem "felvételt nyert".
- 	Ha az illető még nem rendelkezik felhasználónévvel a Nextcloud-ban, akkor létrehozza, 
-	- ha a mayorban, az "intezmeny_xxx.diak", illetve az "intezmeny_xxx.tanar" táblákon van beállított e-mail címe, akkor azt használja,
-	- ha nincs, akkor az alapértelmezettet állítja be a Nextcloud-ba, valamint ekkor állítódik be az alapértelmezett qvóta, és a felhasználó valódi neve is.
-	  (Ezeket később Rendszergazdai, és Felhasználói oldalról változtatni lehet, értelemszerűen.)
-	Ha az illető már rendelkezik felhasználónévvel, de az le volt tiltva, akkor újra engedélyezi.
-
-	Ezután egyezteti a tankör-csoport összerendeléseket, ha az illető új tankörbe került be, akkor belépteti a megfelelő csportba, 
-	  ha kikerült egy tankörből, akkor a csoportból is kilépteti.
-
-	Végül ellenőrzi a kiléptetndő felhasználókat.
-	Ha velekinek a státusza a mayorban "jogviszonya lezárva"-ra változott, vagy a felhasználónevét a mayorból törölték, akkor 	
-	- ha még nem lépett be soha a Nextcloudba, akkor a felhasználót fizikailag törli.
-	- ha már használta a fiókját, akkor csak letiltja, azért, hogy a fájljai ne vesszenek el automatikusan. 
-	(Ez, utóbbi esetben a Rendszergazdának kell külön elvégezni a törlést.)
- 
-
-
-
 	** Szeparációs lehetőségek:
 		Biztonsági megfontolásokból nem javasolt a Nextcloud-ot és a mayort ugyanazon Apache szerver és ugyanazon "DocumentRoot" alól futtatni.
 		Szétválasztásukra többféle lehetőség van:
@@ -358,10 +358,220 @@ Beállítása az alábbiak szerint: (egy lehetséges elrendezés)
 		ahol a felhasználónév váltást a mod_suexec modul végzi, a php futtatását pedig a mod_fcgid. )
 		(Természetesen vannak még más megoldások is, mint pl. a php_fpm, de azokat nem javaslom. )
 
+*/
+
+
+
+
+
+$cfg['infotxt_szöveg'] = <<<EOT
+
+                    FONTOS INFORMÁCIÓK!
+
+Ez a mappa, és a benne lévő mappák, a távoktatás segítésére, 
+egyszerűsítésére szolgálnak.
+
+Fontos tudni, hogy ha megosztunk egy, a mi mappánkon belüli fájlt, 
+vagy mappát, egy másik felhasználóval a felhőben, akkor a megosztott 
+fájl, vagy mappa, a másik felhasználónak a kezdőoldalán jelenik meg, 
+a fájlok között.
+
+Egy idő után, ha az illető, már nagyon sok megosztást fogadott, 
+a rengeteg fájl már számára egy átláthatatlan mappa-tengert fog képezni,
+és nagyon nehéz lesz benne eligazodnia.
+
+
+Ezen probléma kivédésére született ez, az alábbi megoldás:
+
+A tanátoknak a szerver automatikusan létrehoz egy, a távoktatásra 
+használatos gyűjtőmappát, utána ebbe a mappába létrehozza a tanár által 
+tanított (e-napló szerint) tanköröknek megfelelő mappákat automatikusan.
+
+
+
+A működési szabályok:
+
+1) A tanár ezekbe a mappákba helyezheti el a diákoknak szánt fájlokat.
+   (Ha akarja, ez nem kötelező, csak segítség.)
+
+2) A tanár ezeket a mappákat osztja meg a diákcsoportokkal.
+
+3) A diák ezekben a mappákban helyezi el a nyilvánosan visszaküldendő 
+   fájlokat, képeket. (Ezt a mappát, a tankör összes tagja látja,
+   amelyik tankörrel, vagy csoporttal megosztottuk.
+   A megosztást nekünk, kézzel kell elvégezni, az nem történik 
+   meg automatikusan.)
+
+4) A diák, a privát módon visszaküldendő fájlokat, a tanárral való 
+   megegyezés szerint, lehetőleg ne ebbe a mappába helyezze el,
+   hanem azt egyszerűen ossza meg a tanárával, vagy valamilyen 
+   más módon juttassa vissza.
+
+5) A Tankörmappákban, a fájlok rendjét a tanár határozhatja meg,
+   viszont, amelyik mappára engedélyezve van a diák(ok) részére a 
+   feltöltés/szerkesztés/törlés, ott már értelemszerűen nem csak a 
+   tanár dönt a fájlok sorsáról.
+
+6) A tankörmappák gyűjtőmappájában a rendet a szerver tartja, 
+   oda egyéb fájl, mappa nem helyezhető.  
+   Ha mégis kerülne oda egyéb fájl akkor, azt a szerver, átnevezi,
+   és a tanárnak értesítést küld, egészen addig, amíg az "idegen" 
+   fájlok tekintetében helyre nem áll a rend.
+   Az átnevezéskor, a szerver, a fájl nevét kiegészíti egy
+   "számsorozat.please-remove" utótaggal. Ezt az utótagot, a fájl,
+   a gyűjtőmappából történő áthelyezése után már kézzel eltávolíthatjuk,
+   így visszakapjuk az eredeti fájlunkat, mappáinkat. 
+   (Az "Átnevezés" gomb segítségével. (Jobb-Egér kattintással.))
+
+7) A szerver, a tankörök egyeztetését, a naplóval, minden nap egyszer,
+   éjfél és hajnali 5 óra között végzi el. Tehát, az iskolatitkárok 
+   által elvégzett módosítások, így a tankör-csoportok összerendezése,
+   a tankörök, valamint a tanárok és diákok jogviszonyában beálló 
+   változás, csak másnap reggelre lép érvénybe.
+
+
+
+
+Legyen egy gyakorlati példa:
+
+A tanár mappalistájában létrejön a gyűjtőmappa mondjuk: 
+"Iskolai Távoktatás" névvel.
+Ezen, a mappán belül létrejön mondjuk, egy "(tk) 10.b fizika" 
+és egy "(tk) 10.b osztályfőnöki" tankörmappa.
+(Vagyis, a tanár, az e-naplóban ezen tankörök tagja.)
+
+Ezen mappák mellé létrejön még a "(tk) 10.b fizika_beadás" és a
+"(tk) 10.b osztályfőnöki_beadás" mappa is. Ezek a mappák a diákok 
+által visszaküldendő fájlok gyűjtésére szolgálhatnak.
+
+
+A tanár szabadon használhatja a   "(tk) 10.b fizika"   és a   
+"(tk) 10.b osztályfőnöki" mappákat, azokat szabadon megoszthatja, 
+bele fájlokat helyezhet, belőlük fájlokat törölhet, stb., 
+ha engedélyezi a szerkesztést, akkor a diák is helyezhet bele 
+fájlokat, vagy szerkesztheti*** a benne lévő fájlokat.
+
+Ha a tankörmappát megosztja a diákkal/ egész tankörrel,
+akkor a diáknak így már nem egy csomó fájl, rendezetlenül, 
+és nem is az "Iskolai Távoktatás" nevű mappa fog megjelenni 
+a kezdőoldalán, hanem az adott tankörmappa. 
+
+Tehát, ha a tanár a "(tk) 10.b fizika" mappát osztja meg, 
+akkor a diák, a kezdőoldalán a "(tk) 10.b fizika" mappát fogja 
+találni, és benne a tanár által hozzáadott fájlokat.
+
+
+Viszont az "Iskolai Távoktatás" nevű mappában csak(!!) a  
+"(tk) 10.b fizika"   és a   "(tk) 10.b osztályfőnöki" mappák lehetnek,
+valamint a beadásra szolgáló társmappák, illetve az INFO.txt.
+Más fájl, vagy mappa, nem! 
+
+ 
+Ha mégis kerülne oda egyéb fájl, vagy mappa, akkor arról először 
+értesíti a tanárt, majd, a nem odaillő fájlokat, vagy mappákat 
+automatikusan eltávolításra megjelöli.
+
+Ez szintén vonatkozik a korábban itt levő, de átnevezett mappákra is, 
+tehát, ha a "(tk) 10.b fizika" mappát a tanár véletlenül átnevezné, 
+valami másra, akkor onnantól azt is "idegen" mappának fogja tekinteni.
+
+Ugyanez történik akkor is, ha a tanár, (a napló szerint) kikerül a 
+tankörből, tehát nem tanítja tovább, vagy a tankör ugrik egyet 
+évkezdéskor, és a "(tk) 10.b fizika"-ból "(tk) 11.b fizika" lesz, 
+ekkor, a, még ottmaradó "(tk) 10.b fizika" mappát szintén 
+idegennek fogja tekinteni.
+
+Ilyenkor a tanárnak szükséges, kézzel, az idegennek minősített mappákat 
+kiüríteni, és az egész mappát, vagy csak azok tartalmát 
+az "Iskolai Távoktatás" mappán kívülre, a saját mappái közé áthelyezni, 
+vagy az idegennek minősített mappák tartalmát egy másik, az "elfogadott" 
+tankörmappák valamelyikébe átrakni.
+Majd a kiürült, előző mappát kézzel kell törölnie!
+
+(Ez utóbbit kell tenni, vagyis a tanárnak, kézzel áthelyezni a 
+fájlokat az egyik tankörmappából, az új tankörmappába, amikor 
+évváltás van, és a tankör ugrik egyet: 
+"(tk) 10.b fizika"  --> "(tk) 11.b fizika". )
+
+
+
+
+
+*** Tippek/Megjegyzések:
+
+1)
+Ha szeretnénk biztosra menni, és elkerülni, hogy a diák, 
+a tanár által, az egész tankörnek küldött fájlokba véletlenül 
+beleszerkesszen, vagy esetleg töröljön belőlük, akkor vonjuk meg a
+szerkesztési/létrehozási/törlési jogokat, és ezt ellenőrizzük is 
+minden megosztáskor, hogy valóban a megfelelő jogok vannak-e beállítva
+a megosztott mappán!
+
+A szerver létrehoz egy "_beadás", végződésű mappát is, a tankörmappák 
+mellé, hogy ezeket használhassuk a visszaküldendő fájlok gyűjtésére, így
+csak erre a "_beadás" mappára kell jogot adnunk a diáknak/tankörnek 
+a szerkesztésre/módosításra/törlésre/stb..
+
+
+
+2)
+Ha videó fájlokat szeretnénk feltölteni nagy mennyiségben, 
+akkor hozzunk létre az adott tankörhöz tartozó tankörmappában egy 
+"Videók" nevű mappát, és abba helyezzük el a videó fájlokat. 
+A könnyebb megkülönböztethetőség végett nevezzük át a videó fájlokat 
+dátum szerinti fájlnévre, vagy sorszámozzuk őket, 
+és a sorszámot tüntessük föl a fájl nevében!
+
+
+3) A létrejövő mappák megosztási beállításait nekünk kell 
+finomhangolnunk, mert nem jönnek automatikusan létre a 
+feltöltési/szerkesztési/törlési/stb. engedélyek. 
+A megosztás pillanatában, a fogadó félnek, csak az olvasási 
+jogosultsága jön létre automatikusan.
+
+Tehát, minután megosztottuk egy tankörrel, kattintsunk rá a 
+fektetett "V" betűhöz hasonlító ikonra, és a megosztási beállításoknál,
+a "..."-ra kattintva engedélyezzük a 
+feltöltést/szerkesztést/törlést/továbbadást/stb. a csoport tagjainak,
+igényünknek megfelelően! 
+
+(Magát a megosztást is nekünk, kézzel kell megtennünk, 
+mert azt sem állítja be a szerver automatikusan.)
+
+Alapesetben, gyakorlatilag csak annyi a dolgunk, hogy például, 
+a "(tk) 10.b fizika" mappát megosszuk a "(tk) 10.b fizika" tankörrel.
+Ha a beadást is szeretnénk itt összegyűjteni, akkor 
+a "(tk) 10.b fizika_beadás" mappát is meg kell osszuk 
+a "(tk) 10.b fizika" tankörrel, ügyelve arra, hogy csak 
+a "(tk) 10.b fizika_beadás" mappára kerüljön a diákok számára 
+létrehozási/szerkesztési/törlési jogosultság.
+
+
+
+4)
+Ha egy rossz helyen lévő fájl miatt értesítést kapunk, akkor a 
+legfontosabb, hogy a fájl onnan, a távoktatás gyűjtőmappájából,
+elkerüljön, tehát ne másoljuk, hanem helyezzük át, a saját, egyéb
+mappáinkba / egyéb fájlaink közé! 
+
+Utána, ha ez megtörtént, nevezzük vissza, az eredeti nevére,
+vagyis töröljük ki a nevéből a szerver által odarakott:
+"számsorozat.please-remove" utótagot, a "Átnevezés" gomb segítségével!
+
+
+5)
+Az INFO.txt, vagyis, ez a leírás, minden éjjel frissítődik, illetve újra
+létrehozódik a szerveren, hogy mindig a legfrissebb információkat 
+tartalmazza, tehát nem szükséges törölni. Ám erre is igaz, hogy 
+ha véletlenül átnevezzük, akkor már idegennek fogja tekinteni
+a rendszer. Ekkor, az "idegen" változatát már törölnünk szükséges!
+
+
+EOT;
+
+
 
-	
 
-*/
 
 ?>