Source for file class.BUCHUNGEN.php

Documentation is available at class.BUCHUNGEN.php

  1. <?php
  2. error_reporting(E_ALL);
  3.  
  4. /**
  5.  * Stellt die Verbindung zur Datenbank 'buchungen' her.
  6.  * Stellt Methoden zum Einfügen, Löschen und Bestätigen von Buchungen zur
  7.  *
  8.  * @author Kay Koch
  9.  * @package src
  10.  * @since 1.12.04
  11.  * @subpackage foundation_tables
  12.  * @version 1
  13.  */
  14.  
  15. if (0 > version_compare(PHP_VERSION, '5')) {
  16.     die('This file was generated for PHP 5');
  17. }
  18.  
  19. /**
  20.  * Basisklasse aller Klassen mit Datenbankzugriff.
  21.  *
  22.  * stellt Methoden und Objekte zur Fehlermeldung und zum Datenbankzugriff zur
  23.  *
  24.  * @author Kay Koch
  25.  * @since 1.12.04
  26.  * @version 1.1
  27.  */
  28. require_once ('src/foundation/tables/class.PARENTTABLES.php');
  29.  
  30. /* user defined includes */
  31. // section -64--88-122--2-10f41e9:1009dd996d0:-7fbe-includes begin
  32. // section -64--88-122--2-10f41e9:1009dd996d0:-7fbe-includes end
  33.  
  34. /* user defined constants */
  35. // section -64--88-122--2-10f41e9:1009dd996d0:-7fbe-constants begin
  36. // section -64--88-122--2-10f41e9:1009dd996d0:-7fbe-constants end
  37.  
  38. /**
  39.  * Stellt die Verbindung zur Datenbank 'buchungen' her.
  40.  * Stellt Methoden zum Einfügen, Löschen und Bestätigen von Buchungen zur
  41.  *
  42.  * @access public
  43.  * @author Kay Koch
  44.  * @package src
  45.  * @since 1.12.04
  46.  * @subpackage foundation_tables
  47.  * @version 1
  48.  */
  49. class src_foundation_tables_BUCHUNGEN extends src_foundation_tables_PARENTTABLES {
  50.     // --- ATTRIBUTES ---
  51.  
  52.     
  53.     /**
  54.      * Beinhaltet den Datenbanknamen (buchungen)
  55.      *
  56.      * @access protected
  57.      * @var string 
  58.      */
  59.     protected $dbTableName= 'buchungen';
  60.  
  61.     /**
  62.      * Array mit Daten der (nicht) bestätigten Buchung
  63.      *
  64.      * @access private
  65.      * @var array 
  66.      */
  67.     private static $data= array ();
  68.  
  69.     // --- OPERATIONS ---
  70.  
  71.     
  72.     /**
  73.      * Fügt einen neue Datensatz in die Datenbank ein
  74.      *
  75.      * @access public
  76.      * @author Kay Koch, <kay.koch@gmx.de>
  77.      * @param array 
  78.      * @return boolean 
  79.      */
  80.     public function insertBuchung($buchung) {
  81.         $returnValue= (bool) false;
  82.  
  83.         // section -64--88-122--2-10f41e9:1009dd996d0:-7fad begin
  84.         $buchung['pwd']= $this->createPWD(); // Password erstellen
  85.         $sql= "INSERT IGNORE INTO $this->dbTableName
  86.                                 SET see_id = '" . $buchung['see_id'] . "',
  87.                                     name = '" . $buchung['name'] . "',
  88.                                     vorname = '" . $buchung['vorname'] . "',
  89.                                     email = '" . $buchung['email'] . "',
  90.                                     telefon = '" . $buchung['telefon'] . "',
  91.                                     verein_nr = '" . $buchung['verein_nr'] . "',
  92.                                     brevet = '" . $buchung['brevet'] . "',
  93.                                     datum = '" . $buchung['datum'] . "',
  94.                                     stunde = '" . $buchung['stunde'] . "',
  95.                                     anzahl = " . $buchung['anzahl'] . ",
  96.                                     anzahlZahler = " . $buchung['anzahlZahler'] . ",
  97.                                     orderDatum = now(),
  98.                                     pwd = '" . $buchung['pwd'] . "'";
  99.         try {
  100.             if (!$buchung['buch_id']= $this->insert($sql)) // Buchung eintragen
  101.                 throw new Exception(8);
  102.             // Wenn weniger als 2 Plätze übrigbleiben, alle abziehen
  103.             if (($buchung['restPlaetze'] - $buchung['anzahl']) < 2)
  104.                 $buchung['anzahl']= $buchung['restPlaetze'];
  105.             // Frei Plätze aktualisieren
  106.             if (!$this->oNF->decrease($buchung['see_id'], $buchung['datum'], $buchung['stunde'], $buchung['anzahl']))
  107.                 throw new Exception(9);
  108.             // PDF erstellen
  109.             if (!$this->oPDF->createUserPDF($buchung, $this->getSea()))
  110.                 throw new Exception(10);
  111.             // Mail verschicken
  112.             $oMail= src_mail_MAIL :: singleton();
  113.             if (!$oMail->sendUserMail($buchung, $this->getSea()))
  114.                 throw new Exception(11);
  115.             $returnValue= true;
  116.         } catch (Exception $e) {
  117.             src_tools_ERROR :: setError($e, __METHOD__);
  118.         }
  119.         // section -64--88-122--2-10f41e9:1009dd996d0:-7fad end
  120.  
  121.         return (bool) $returnValue;
  122.     }
  123.  
  124.     /**
  125.      * Markiert eine Buchung als abgerufen
  126.      *
  127.      * @access public
  128.      * @author Kay Koch, <kay.koch@gmx.de>
  129.      * @param int 
  130.      * @param string 
  131.      * @return boolean 
  132.      */
  133.     public function setAsTaken($buch_id, $pwd) {
  134.         $returnValue= (bool) false;
  135.  
  136.         // section -64--88-122--2-10f41e9:1009dd996d0:-7fa8 begin
  137.         try {
  138.             if (!isset (self :: $data[$buch_id]))
  139.                 throw new Exception(12);
  140.             if (!(self :: $data[$buch_id]['pwd'] == $pwd))
  141.                 throw new Exception(12);
  142.             if (!self :: $data[$buch_id]['istAbgeholt']) { // Buchung ist noch nicht abgeholt
  143.                 $sql= "UPDATE $this->dbTableName SET istAbgeholt='1' WHERE buch_id = '$buch_id' AND pwd = '$pwd' LIMIT 1";
  144.                 if (!$this->update($sql)) // als abgeholt markieren
  145.                     throw new Exception(13);
  146.             }
  147.             self :: $data[$buch_id]['istAbgeholt']= 1;
  148.             $returnValue= true;
  149.         } catch (Exception $e) {
  150.             src_tools_ERROR :: setError($e, __METHOD__);
  151.         }
  152.         // section -64--88-122--2-10f41e9:1009dd996d0:-7fa8 end
  153.  
  154.         return (bool) $returnValue;
  155.     }
  156.  
  157.     /**
  158.      * liefert im Erfolgsfall TRUE
  159.      *
  160.      * @access public
  161.      * @author Kay Koch, <kay.koch@gmx.de>
  162.      * @param int 
  163.      * @param string 
  164.      * @return boolean 
  165.      */
  166.     public function deleteBuchung($buch_id, $pwd) {
  167.         $returnValue= (bool) false;
  168.  
  169.         // section -64--88-122--2-933bcb:100f60e4e57:-7ffc begin
  170.         try {
  171.             if (!isset (self :: $data[$buch_id]))
  172.                 throw new Exception(12);
  173.             if (!(self :: $data[$buch_id]['pwd'] == $pwd))
  174.                 throw new Exception(12);
  175.             $this->cleanEntries(self :: $data[$buch_id]); // Plätze freimachen und PDF löschen
  176.             $sql= "DELETE FROM $this->dbTableName WHERE buch_id = '$buch_id' AND pwd = '$pwd'";
  177.             if (!$this->delete($sql)) // Buchung löschen
  178.                 throw new Exception(14);
  179.             unset (self :: $data[$buch_id]); // Buchung aus array löschen
  180.             $returnValue= true;
  181.         } catch (Exception $e) {
  182.             src_tools_ERROR :: setError($e, __METHOD__);
  183.         }
  184.         // section -64--88-122--2-933bcb:100f60e4e57:-7ffc end
  185.  
  186.         return (bool) $returnValue;
  187.     }
  188.  
  189.     /**
  190.      * säubert Datenbank von nicht abgeholten Buchungen
  191.      *
  192.      * @access public
  193.      * @author Kay Koch, <kay.koch@gmx.de>
  194.      * @return boolean 
  195.      */
  196.     public function cleanBuchungen($all= false) {
  197.         $returnValue= (bool) false;
  198.  
  199.         // section -64--88-122--2-933bcb:100f60e4e57:-7f8f begin
  200.         $whereit= ($all) ? "" : "AND now() > DATE_ADD(orderDatum, INTERVAL 1 DAY) ";
  201.         $sql= "DELETE FROM $this->dbTableName WHERE istAbgeholt ='0' " . $whereit;
  202.         $this->delete($sql); // Buchungen löschen
  203.         $this->updateData();
  204.         // section -64--88-122--2-933bcb:100f60e4e57:-7f8f end
  205.  
  206.         return (bool) $returnValue;
  207.     }
  208.  
  209.     /**
  210.      * erstellt ein Passwort
  211.      *
  212.      * @access private
  213.      * @author Kay Koch, <kay.koch@gmx.de>
  214.      * @return string 
  215.      */
  216.     private function createPWD() {
  217.         $returnValue= (string) '';
  218.  
  219.         // section -64--88-122--2-1328c7a:1027db0d532:-7ff1 begin
  220.         $pwdLength= 5; // Länge des Passwortes
  221.         while ($pwdLength-- > 0) {
  222.             $returnValue .= chr(rand(97, 122));
  223.         }
  224.         // section -64--88-122--2-1328c7a:1027db0d532:-7ff1 end
  225.  
  226.         return (string) $returnValue;
  227.     }
  228.  
  229.     /**
  230.      * liefert eine Buchung
  231.      *
  232.      * @access public
  233.      * @author Kay Koch, <kay.koch@gmx.de>
  234.      * @param void 
  235.      * @param string 
  236.      * @return array 
  237.      */
  238.     public function getBuchung($buch_id, $pwd) {
  239.         $returnValue= array ();
  240.  
  241.         // section -64--88-122--2-1328c7a:10292f82497:-7ff9 begin
  242.         if (isset (self :: $data[$buch_id]) AND self :: $data[$buch_id]['pwd'] == $pwd)
  243.             $returnValue= self :: $data[$buch_id];
  244.         // section -64--88-122--2-1328c7a:10292f82497:-7ff9 end
  245.  
  246.         return (array) $returnValue;
  247.     }
  248.  
  249.     /**
  250.      * nichtabgeholte Buchungen werden aus Datenbank gelöscht
  251.      *
  252.      * @access private
  253.      * @author Kay Koch, <kay.koch@gmx.de>
  254.      * @param array 
  255.      * @return void 
  256.      */
  257.     private function cleanEntries($buchung) {
  258.         // section -64--88-122--2-1328c7a:10297cab611:-7ff7 begin
  259.         // Plätze wieder frei machen
  260.         $this->oNF->increase($buchung['see_id'], $buchung['datum'], $buchung['stunde'], $buchung['anzahl']);
  261.         // PDF-Dokument löschen
  262.         $this->oPDF->deleteUserPDF($buchung['buch_id'] . $buchung['pwd']);
  263.         // section -64--88-122--2-1328c7a:10297cab611:-7ff7 end
  264.     }
  265.  
  266.     /**
  267.      * liefert den Pfad eines PDF-Dokuments aufgrund der Buch_id
  268.      *
  269.      * @access public
  270.      * @author Kay Koch, <kay.koch@gmx.de>
  271.      * @param string 
  272.      * @return string 
  273.      */
  274.     public function getPDFLocation($filename) {
  275.         $returnValue= (string) '';
  276.  
  277.         // section -64--88-122--2-1328c7a:102988386a1:-7ffe begin
  278.         try {
  279.             $returnValue= $this->oPDF->getPDFPath($filename);
  280.             if (!file_exists($returnValue))
  281.                 throw new Exception(17);
  282.         } catch (Exception $e) {
  283.             src_tools_ERROR :: setError($e, __METHOD__);
  284.         }
  285.         // section -64--88-122--2-1328c7a:102988386a1:-7ffe end
  286.  
  287.         return (string) $returnValue;
  288.     }
  289.  
  290.     /**
  291.      * liefert alle Buchungen innerhalb der nächsten $interval Tage
  292.      *
  293.      * @access public
  294.      * @author Kay Koch, <kay.koch@gmx.de>
  295.      * @param int 
  296.      * @return array 
  297.      */
  298.     public function getOldBuchungen() {
  299.         $returnValue= array ();
  300.  
  301.         // section -64--88-122--2-1328c7a:102a6f94cac:-7fe7 begin
  302.         // auslesen aller alten Buchungen
  303.         $weekLimit= $this->getFlags()->getWhereWeekLimit();
  304.         $sql= "SELECT * FROM " . $this->dbTableName . $weekLimit . " AND istAbgeholt='1' ORDER by see_id,datum ASC";
  305.         $arrOldBuchungen= $this->select($sql);
  306.         foreach ($arrOldBuchungen as $buchung) {
  307.             $buchung['name']= substr($buchung['name'] . "," . $buchung['vorname'], 0, 16); // Länge auf 18 Buchstaben begrenzen
  308.             $returnValue[$buchung['see_id']][$buchung['datum']][$buchung['stunde']][]= array (
  309.                 "name" => $buchung['name'],
  310.                 "verein" => $buchung['verein_nr'],
  311.                 "anzahl" => $buchung['anzahl'],
  312.                 "anzahlZahler" => $buchung['anzahlZahler']
  313.             );
  314.         }
  315.         // section -64--88-122--2-1328c7a:102a6f94cac:-7fe7 end
  316.  
  317.         return (array) $returnValue;
  318.     }
  319.  
  320.     /**
  321.      * liefert einen link zum pdf-Dokument
  322.      *
  323.      * @access public
  324.      * @author Kay Koch, <kay.koch@gmx.de>
  325.      * @param string 
  326.      * @return string 
  327.      */
  328.     public function getPDFLink($filename) {
  329.         $returnValue= (string) '';
  330.  
  331.         // section -64--88-122--2-5a4368f4:103efc100ac:-7fad begin
  332.         try {
  333.             $filepath= $this->oPDF->getPDFPath($filename);
  334.             if (!file_exists($filepath))
  335.                 throw new Exception(17);
  336.             $returnValue= "<a href='$filepath'>Link zur Reservierung</a>";
  337.         } catch (Exception $e) {
  338.             src_tools_ERROR :: setError($e, __METHOD__);
  339.         }
  340.         // section -64--88-122--2-5a4368f4:103efc100ac:-7fad end
  341.  
  342.         return (string) $returnValue;
  343.     }
  344.  
  345.     /**
  346.      * löscht alte Buchungen
  347.      *
  348.      * @access public
  349.      * @author Kay Koch, <kay.koch@gmx.de>
  350.      * @param int 
  351.      * @return boolean 
  352.      */
  353.     public function deleteOldBuchungen() {
  354.         $returnValue= (bool) false;
  355.  
  356.         // section -64--88-122--2--6176e79b:103fa06a375:-7fbd begin
  357.         // lädt buch_id und Passwort aller alten Buchungen bis zum nächsten Update
  358.         $weekLimit= $this->getFlags()->getWhereWeekLimit();
  359.         $sql= "SELECT buch_id,pwd FROM " . $this->dbTableName . $weekLimit;
  360.         $arrOldBuchungen= $this->select($sql);
  361.         // löscht die pdf-Dokumente der alten Buchungen
  362.         foreach ($arrOldBuchungen as $oldBuchung) {
  363.             $this->oPDF->deleteUserPDF($oldBuchung['buch_id'] . $oldBuchung['pwd']);
  364.         }
  365.         // löscht alle alten, abgeholten  Buchungen bis zum nächsten Update
  366.         #$sql = "DELETE FROM " . $this->dbTableName . $weekLimit;
  367.         #if ($this->delete($sql))
  368.         #    $returnValue = true;
  369.         // section -64--88-122--2--6176e79b:103fa06a375:-7fbd end
  370.  
  371.         return (bool) $returnValue;
  372.     }
  373.     /**
  374.      * aktualisiert die Daten im gegenwertigen Objekt
  375.      *
  376.      * @access public
  377.      * @author Kay Koch, <kay.koch@gmx.de>
  378.      * @return boolean 
  379.      */
  380.     public function updateData() {
  381.         $returnValue= (bool) false;
  382.  
  383.         // section -64--88-122--2--3d9a0b58:1040f000f1b:-7f9c begin
  384.         $sql= "SELECT * FROM  $this->dbTableName";
  385.         self :: $data= $this->select($sql, true, "buch_id");
  386.         // section -64--88-122--2--3d9a0b58:1040f000f1b:-7f9c end
  387.  
  388.         return (bool) $returnValue;
  389.     }
  390.  
  391.     /**
  392.      * Konstruktor
  393.      *
  394.      * lädt alle Buchungen
  395.      * erstellt Objekte der Klassen
  396.      *   nochfrei
  397.      *   mail
  398.      *   pdf
  399.      *
  400.      * @access public
  401.      * @author Kay Koch, <kay.koch@gmx.de>
  402.      * @return void 
  403.      */
  404.     public function __construct() {
  405.         // section -64--88-122--2-7471698e:1046ab3b89c:-7fe7 begin
  406.         parent :: __construct();
  407.         if (empty (self :: $data))
  408.             $this->updateData();
  409.         $this->oNF= new src_foundation_tables_NOCHFREI;
  410.         $this->oPDF= new src_pdf_MYFPDF;
  411.         // section -64--88-122--2-7471698e:1046ab3b89c:-7fe7 end
  412.     }
  413.  
  414.     /**
  415.      * Fügt eine Blockade mit veringerten Informationen ein
  416.      *
  417.      * @access public
  418.      * @author Kay Koch, <kay.koch@gmx.de>
  419.      * @param array 
  420.      * @return boolean 
  421.      */
  422.     private function insertBlockade($blockade) {
  423.         $returnValue= (bool) false;
  424.         // section -64--88-0-1-1328c7a:105f3567fa3:-7ff7 begin
  425.         $sql= "INSERT IGNORE INTO $this->dbTableName
  426.                                 SET see_id = '" . $blockade['see_id'] . "',
  427.                                     name = '" . $blockade['name'] . "',
  428.                                     datum = '" . $blockade['datum'] . "',
  429.                                     stunde = '" . $blockade['stunde'] . "',
  430.                                     anzahl = " . $blockade['anzahl'] . ",
  431.                                     anzahlZahler = " . $blockade['anzahlZahler'] . ",
  432.                                     verein_nr = '" . $blockade['verein_nr'] . "',
  433.                                     istAbgeholt ='1',
  434.                                     block_id = '" . $blockade['block_id'] . "',
  435.                                     orderDatum = now()";
  436.         try {
  437.             if (!$buchung['buch_id']= $this->insert($sql)) // Buchung eintragen
  438.                 throw new Exception(8);
  439.             $returnValue= true;
  440.         } catch (Exception $e) {
  441.             src_tools_ERROR :: setError($e, __METHOD__);
  442.         }
  443.         // section -64--88-0-1-1328c7a:105f3567fa3:-7ff7 end
  444.  
  445.         return (bool) $returnValue;
  446.     }
  447.  
  448.     /**
  449.      * Erstellt Buchungen für eine Blockade
  450.      * in Abhängidkeit der Wiederholungsart
  451.      *
  452.      * @author kaykoch
  453.      * @access private
  454.      * @since 1 - 02.03.2007
  455.      * @uses blockDays Methode für tägliche Wiederholungen
  456.      * @uses blockWeekly Methode für wöchentliche Wiederholungen
  457.      * @uses insertBlockade Methode zum Einfügen der Blockade
  458.      * @param array $data Daten der Blockade
  459.      * @return boolean 
  460.      *
  461.      */
  462.     public function blockDates($data, $reset= false) {
  463.         $returnValue= false;
  464.         if ($reset) {
  465.             $sql= "DELETE FROM $this->dbTableName WHERE `block_id` = '" . $data['block_id'] . "';";
  466.             $returnValue= $this->delete($sql);
  467.         } else {
  468.             switch ($data['wiederholung']) {
  469.                 case 2 : // Anzahl Tage
  470.                     $this->blockDays($data);
  471.                     break;
  472.                 case 1 : // wöchentlich
  473.                     $this->blockWeekly($data);
  474.                     break;
  475.                 default :
  476.                     $this->blockhours($data);;
  477.                     break;
  478.             }
  479.         }
  480.         return $returnValue;
  481.     }
  482.     /**
  483.      *  Wiederholungen, die eine Anzahl von Tagen stattfinden
  484.      *
  485.      * @author kaykoch
  486.      * @access private
  487.      * @since 1 - 02.03.2007
  488.      * @uses blockhours Methode für stündliche Wiederholungen
  489.      * @param array $data Daten der Blockade
  490.      * @return boolean 
  491.      *
  492.      */
  493.     private function blockDays($data) {
  494.         $returnValue= false;
  495.         $startDatum= $data['datum'];
  496.         for ($k= 0; $k < $data['anzahlWiederholung']; $k++) {
  497.             $data['datum']= src_tools_TIME :: addDays2SQL($startDatum, $k);
  498.             $this->blockhours($data);
  499.         }
  500.         return $returnValue;
  501.     }
  502.     /**
  503.      *
  504.      * Wiederholungen, die wöchentlich stattfinden
  505.      *
  506.      * @author kaykoch
  507.      * @access private
  508.      * @since 1 - 02.03.2007
  509.      * @uses blockhours Methode für stündliche Wiederholungen
  510.      * @param array $data Daten
  511.      * @return boolean 
  512.      *
  513.      */
  514.     private function blockWeekly($data) {
  515.         $returnValue= false;
  516.         $data['datum'] = src_tools_TIME :: addDays2SQL($data['datum'],-7);
  517.         $endDatum = $this->getSeen($data['see_id'])->saisonEnde;
  518.         while ($data['datum'] < $endDatum){
  519.             $data['datum'] = src_tools_TIME :: addDays2SQL($data['datum'], 7);
  520.             $this->blockhours($data);
  521.         }
  522.         return $returnValue;
  523.     }
  524.  
  525.     /**
  526.      *
  527.      * Wiederholungen, die mehrere Stunden stattfinden
  528.      *
  529.      * @author kaykoch
  530.      * @access private
  531.      * @since 1 - 02.03.2007
  532.      * @uses insertBlockade Methode zum Einfügen der Blockade
  533.      * @param array $data Daten
  534.      * @return boolean 
  535.      *
  536.      */
  537.     private function blockhours($data) {
  538.         $returnValue= false;
  539.         $startZeit= (int) substr($data['stunde'], 0, 3); // Beginn der Blockade als Int
  540.             for ($i= 0; $i < $data['anzahlStunden']; $i++) {
  541.                 $data['stunde']= src_tools_TIME :: formatHour($startZeit, $i);
  542.                 $this->insertBlockade($data);
  543.             }
  544.         return $returnValue;
  545.     }
  546.  
  547.     /**
  548.      *
  549.      * liefert alle Buchungen, die aus Blockaden stammen
  550.      *
  551.      * wird kein Datum angegeben, werden alle Buchungen geliefert,
  552.      * die sich im für diesen See erlaubten Anmeldezeitraum
  553.      * befinden. Ansonsten nur die an diesem Datum
  554.      *
  555.      * @author kaykoch
  556.      * @access private
  557.      * @since 1 - 02.03.2007
  558.      * @param string $datum Datum der abzuliefernden Buchungen
  559.      * @return boolean 
  560.      *
  561.      */
  562.     public function getBlockedBuchungen($datum = null){
  563.        $returnValue=array();
  564.        if($datum == null){
  565.           $datum = src_tools_TIME::addDays2SQL($this->getFlags()->lastBackupDate,-6);
  566.           $endDatum = src_tools_TIME::addDays2SQL($this->getFlags()->lastBackupDate,$this->getSea()->wochenImVorraus*7+1);
  567.        }else{
  568.           $endDatum = $datum;
  569.        }
  570.        foreach (self::$data as $buchung){
  571.           if($buchung['block_id']==0 OR $buchung['datum'] < $datum OR $buchung['datum'] > $endDatum)
  572.               continue;
  573.           $returnValue[$buchung['see_id']][$buchung['datum']][$buchung['stunde']][] = $buchung;
  574.        }
  575.        return $returnValue;
  576.     }
  577.  
  578. } /* end of class src_foundation_tables_BUCHUNGEN */
  579. ?>

Documentation generated on Sat, 24 Mar 2007 09:58:59 +0100 by phpDocumentor 1.3.1