Source for file class.ADMINBLOCKADEN.php

Documentation is available at class.ADMINBLOCKADEN.php

  1. <?php
  2. error_reporting(E_ALL);
  3. /**
  4.  * Verwaltet die Adminitration der Datenbanktabelle 'blockaden'
  5.  *
  6.  * @author Kay Koch, <kay.koch@gmx.de>
  7.  * @package src
  8.  * @subpackage foundation_admin
  9.  */
  10. if (0 > version_compare(PHP_VERSION, '5')) {
  11.    die('This file was generated for PHP 5');
  12. }
  13. /**
  14.  * Parentklasse zur Administration der Tabellen
  15.  *
  16.  * @author Kay Koch, <kay.koch@gmx.de>
  17.  */
  18. require_once ('src/foundation/admin/class.PARENTADMIN.php');
  19. /**
  20.  * Interface zur Administration der Datenbank
  21.  *
  22.  * @author Kay Koch
  23.  * @since 06.2005
  24.  * @version 1.0
  25.  */
  26. require_once ('src/interfaces/interface.ADMININTERFACE.php');
  27. /* user defined includes */
  28. // section -64--88-122--2--78ecc2cb:103d1b5ef00:-7fc5-includes begin
  29. // section -64--88-122--2--78ecc2cb:103d1b5ef00:-7fc5-includes end
  30. /* user defined constants */
  31. // section -64--88-122--2--78ecc2cb:103d1b5ef00:-7fc5-constants begin
  32. // section -64--88-122--2--78ecc2cb:103d1b5ef00:-7fc5-constants end
  33.  
  34. /**
  35.  * Verwaltet die Adminitration der Datenbanktabelle 'blockaden'
  36.  *
  37.  * @access public
  38.  * @author Kay Koch, <kay.koch@gmx.de>
  39.  * @package src
  40.  * @subpackage foundation_admin
  41.  */
  42. class src_foundation_admin_ADMINBLOCKADEN extends src_foundation_admin_PARENTADMIN implements src_interfaces_ADMININTERFACE {
  43.    // --- ATTRIBUTES ---
  44.    
  45.    /**
  46.     * Objekt der aktellen Datenbankklasse
  47.     *
  48.     * @access private
  49.     * @var BLOCKADEN 
  50.     */
  51.    private $oBlock = null;
  52.    /**
  53.     * Array mit den Feldnamen der aktuellen Datebank
  54.     *
  55.     * @access protected
  56.     * @var array 
  57.     */
  58.    protected $arrKeys = array ();
  59.    /**
  60.     * Name des Haupttemplates
  61.     *
  62.     * @access protected
  63.     * @var string 
  64.     */
  65.    protected $pageTemplate = '';
  66.  
  67.    /**
  68.     * Möglichkeiten, Daten zu blockieren
  69.     *
  70.     * @access protected
  71.     * @var array 
  72.     */
  73.    protected $arrKindOfBlocks = array (
  74.       "einmalig",
  75.       "wöchentlich",
  76.       "Anzahl Tage"
  77.    );
  78.  
  79.    protected $arrOldData = array ();
  80.    // --- OPERATIONS ---
  81.    
  82.    /**
  83.     * zeigt alle Einträge einer Tabelle
  84.     *
  85.     * @access public
  86.     * @author Kay Koch, <kay.koch@gmx.de>
  87.     * @return void 
  88.     */
  89.    public function show() {
  90.       // section -64--88-122--2--6176e79b:103fa06a375:-7fad begin
  91.       if ($this->loginOK) {
  92.          $this->todo = "change";
  93.          $this->rows = "";
  94.          $this->arrOldData = $this->oBlock->getRowByID();
  95.          foreach ($this->arrOldData as $this->data) { // alle Seen
  96.             $this->seename = $this->getSeen($this->data['see_id'])->name;
  97.             $this->realstunde = ($this->data['ganzerTag']) ? "ganztägig" : $this->data['stunde'];
  98.             $this->realstunde2 = src_tools_TIME :: sqlT2realT($this->data['datum']);
  99.             $this->data['anzahlStunden'] = ($this->data['ganzerTag']) ? "" : $this->data['anzahlStunden'];
  100.             $this->oVereine->setParams($this->data['verein_nr']);
  101.             $this->data['info'] = (!empty ($this->data['info'])) ? $this->oVereine->name . ", " . $this->data['info'] : $this->oVereine->name;
  102.             switch ($this->data['wiederholung']) {
  103.                case 0 : // einmalig
  104.                   $this->wiederholung = $this->arrKindOfBlocks[$this->data['wiederholung']] . " (" . src_tools_TIME :: sqlT2realT($this->data['datum']) . ")";
  105.                   break;
  106.                case 1 : // wöchentlich
  107.                   $this->wiederholung = $this->arrKindOfBlocks[$this->data['wiederholung']] . " (" . src_tools_TIME :: dayNr2dayName(src_tools_TIME :: sqlT2realT($this->data['datum'], "%w")) . "s)";
  108.                   break;
  109.                case 2 : // anzahl Tage
  110.                   $this->wiederholung = $this->arrKindOfBlocks[$this->data['wiederholung']] . " (bis einschließ. " . src_tools_TIME :: sqlT2realT(src_tools_TIME :: addDays2SQL($this->data['datum'], $this->data['anzahlWiederholung'] - 1)) . ")";
  111.                   break;
  112.             }
  113.             $this->rows .= src_tools_TEMPLATE :: getTemplate("admin_" . $this->pageTemplate . "_row", $this);
  114.          }
  115.          $this->makePage("admin_" . $this->pageTemplate);
  116.       }
  117.       // section -64--88-122--2--6176e79b:103fa06a375:-7fad end
  118.    }
  119.    /**
  120.     * liefert ein Formular zur Änderung bzw. Neueingabe eines Datensatzes
  121.     *
  122.     * Wenn die Tabellenspezifischen Parameter vorhergesetzt wurden wird der
  123.     * Datensatz ausgegeben. Ansonsten erscheint ein leeres Formular
  124.     *
  125.     * @access public
  126.     * @author Kay Koch, <kay.koch@gmx.de>
  127.     * @return void 
  128.     */
  129.    public function change() {
  130.       // section -64--88-122--2--6176e79b:103fa06a375:-7fa9 begin
  131.       if ($this->loginOK) {
  132.          if (!empty ($this->block_id) AND !empty ($this->arrOldData)) {
  133.             $this->data = $this->arrOldData;
  134.             $this->todo = "update";
  135.             $startTime = $this->oSeen->getSeen($this->data['see_id'])->getStartTime($this->data['datum']);
  136.          } else
  137.             if (!empty ($this->data['see_id'])) {
  138.                $this->todo = "insert";
  139.                $startTime = $this->oSeen->getSeen($this->data['see_id'])->getStartTime($this->data['datum']);
  140.             } else {
  141.                $this->todo = "insert";
  142.                $this->checked = "";
  143.                $this->readonly = "";
  144.                $this->data['datum'] = date("Y-m-"). "01";
  145.                $this->data['anzahlZahler'] = "0";
  146.                $this->data['anzahlStunden'] = "1";
  147.                $this->data['stunde'] = $this->oSeen->getMinStartTime();
  148.                $startTime = $this->data['stunde'];
  149.             }
  150.          list ($this->data['jahr'], $m, $d) = split("-", $this->data['datum']);
  151.          $this->vereinOptionList = $this->getVereinOptionList($this->data['verein_nr']);
  152.          $this->seeOptionList = $this->oSeen->getOptionList($this->data['see_id']);
  153.          $this->monthOptionList = src_tools_TIME :: getMonthOL($m);
  154.          $this->dayOptionList = src_tools_TIME :: getDayOL($d);
  155.          $this->nrHourOptionList = src_tools_TIME :: getDayOL($this->data['anzahlStunden'], 5);
  156.          $this->hourOptionList = src_tools_TIME :: getHourOL($this->data['stunde'], $startTime, $this->oSeen->getMaxStartTime());
  157.          $this->repeatOptionList = $this->getRepeatOptionList($this->data['wiederholung']);
  158.          $this->checked = ($this->data['ganzerTag']) ? "checked" : "";
  159.          $this->readonly = ($this->data['ganzerTag']) ? "readonly" : "";
  160.          $this->makePage("admin_" . $this->pageTemplate . "_input");
  161.       }
  162.       // section -64--88-122--2--6176e79b:103fa06a375:-7fa9 end
  163.    }
  164.    /**
  165.     * Aktualisieet den vorher durch setzen der Parameter ausgewählten
  166.     *
  167.     * Die Neuen Daten befinden sich im Übergabefeld $data
  168.     *
  169.     * @access public
  170.     * @author Kay Koch, <kay.koch@gmx.de>
  171.     * @param array 
  172.     * @return void 
  173.     */
  174.    public function update($data) {
  175.       // section -64--88-122--2--6176e79b:103fa06a375:-7f83 begin
  176.       if ($this->loginOK) {
  177.          if ($this->checkData($data)) {
  178.             $this->oVereine->setParams($data['verein_nr']);
  179.             $this->checkHoleDay($data);
  180.             $this->oNF->blockDates($this->arrOldData, true);
  181.             $this->oNF->blockDates($data);
  182.             $oBuchungen = new src_foundation_tables_BUCHUNGEN();
  183.             $oBuchungen->blockDates($this->arrOldData, true);
  184.             $oBuchungen->blockDates($data);
  185.             $this->oBlock->updateRow($data);
  186.             $this->saveRegularyBlockInfo();
  187.             $this->show();
  188.          } else
  189.             $this->change();
  190.       }
  191.       // section -64--88-122--2--6176e79b:103fa06a375:-7f83 end
  192.    }
  193.    /**
  194.     * Löscht den Datensatz der vorher durch Parameter ausgewählt wurde
  195.     *
  196.     * @access public
  197.     * @author Kay Koch, <kay.koch@gmx.de>
  198.     * @return void 
  199.     */
  200.    public function delete() {
  201.       // section -64--88-122--2--6176e79b:103fa06a375:-7f7f begin
  202.       if ($this->loginOK) {
  203.          $this->oNF->blockDates($this->arrOldData, true);
  204.          $oBuchungen = new src_foundation_tables_BUCHUNGEN();
  205.          $oBuchungen->blockDates($this->arrOldData, true);
  206.          $this->oBlock->deleteRow();
  207.          $this->show();
  208.       }
  209.       // section -64--88-122--2--6176e79b:103fa06a375:-7f7f end
  210.    }
  211.    /**
  212.     * Fügt einen neuen Datensatz mit den Werten des Übergabeparameter $data
  213.     *
  214.     * @access public
  215.     * @author Kay Koch, <kay.koch@gmx.de>
  216.     * @param array 
  217.     * @return void 
  218.     */
  219.    public function insert($data) {
  220.       // section -64--88-122--2--6176e79b:103fa06a375:-7f7d begin
  221.       if ($this->loginOK) {
  222.          if ($this->checkData($data)) {
  223.             $this->checkHoleDay($data);
  224.             $this->oBlock->insertRow($data);
  225.             $data['block_id'] = $this->oBlock->block_id;
  226.             $this->oNF->blockDates($data);
  227.             $oBuchungen = new src_foundation_tables_BUCHUNGEN();
  228.             $oBuchungen->blockDates($data);
  229.             $this->show();
  230.          } else {
  231.             $this->data = $data;
  232.             $this->change();
  233.          }
  234.       }
  235.       // section -64--88-122--2--6176e79b:103fa06a375:-7f7d end
  236.    }
  237.    /**
  238.     * überprüft die Korrektheit der eingebenen bzw. geänderten Daten
  239.     *
  240.     * @access public
  241.     * @author Kay Koch, <kay.koch@gmx.de>
  242.     * @param void 
  243.     * @return boolean 
  244.     */
  245.    public function checkData(& $data) {
  246.       $returnValue = (bool) false;
  247.       // section -64--88-122--2--62c31de:1048594e50f:-7fef begin
  248.       try {
  249.          $this->zahlerInfo = "";
  250.          $data['ganzerTag'] = (isset ($data['ganzerTag']) AND $data['ganzerTag'] == 1) ? "1" : "0";
  251.          if (!src_tools_CHECK :: checkID($data['see_id']))
  252.             throw new Exception("19,Seename");
  253.          if (empty ($data['verein_nr']))
  254.             throw new Exception("26,VereinNr");
  255.          if (!src_tools_CHECK :: checkVnum($data['verein_nr']))
  256.             throw new Exception("26,VereinNr");
  257.          if (empty ($data['tag']) or empty ($data['monat']) or empty ($data['jahr']))
  258.             throw new Exception("49,Datum");
  259.          if (!isset ($data['datum']) or empty ($data['datum']))
  260.             $data['datum'] = src_tools_TIME :: formatDate($data['tag'], $data['monat'], $data['jahr']);
  261.          if (!src_tools_CHECK :: checkDatum($data['datum'])) // YYYY-MM-TT
  262.             throw new Exception("51,Datum");
  263.          if (!src_tools_CHECK :: checkHour($data['stunde'] = src_tools_TIME :: time2longTime($data['stunde']))) // hh:mm:ss
  264.             throw new Exception("52,Stunde");
  265.          if (!$this->oSeen->getSeen($data['see_id'])->isInDiveRange($data['datum'], $data['stunde']))
  266.             throw new Exception("111,Datum/Stunde");
  267.          if (!src_tools_CHECK :: checkAnzahl($data['anzahl'])) // int
  268.             throw new Exception("28,Anzahl");
  269.          if (($diff = $this->tooManyDivers($data)) > 0) // Feld
  270.             throw new Exception("41,Anzahl: maximal " . ($data['anzahl'] - $diff) . " Plätze");
  271.          if (!src_tools_CHECK :: checkAnzahl($data['anzahlZahler'])) // int
  272.             throw new Exception("28,Anzahl Zahler");
  273.           if ($data['anzahlZahler'] > $data['anzahl'])
  274.               throw new Exception("29,Anzahl Zahler");
  275.          $returnValue = true;
  276.       } catch (Exception $e) {
  277.          $message = explode(",", $e->getMessage());
  278.          $this->errorMsg = "<b>[" . $message[1] . "] : </b>" . src_tools_ERROR :: getErrTxt($message[0]) . "<br>" . $this->zahlerInfo;
  279.          $this->error = src_tools_TEMPLATE :: getTemplate('error', $this);
  280.       }
  281.       // section -64--88-122--2--62c31de:1048594e50f:-7fef end
  282.       return (bool) $returnValue;
  283.    }
  284.    /**
  285.     * Konstruktor
  286.     *
  287.     * erstellt ein Obejkt der zu beabeitenden Klassen
  288.     * list alle erlaubten Datenbankschlüssel ein
  289.     * liest das Template
  290.     *
  291.     * @access public
  292.     * @author Kay Koch, <kay.koch@gmx.de>
  293.     * @param string 
  294.     * @param int 
  295.     * @param date 
  296.     * @param time 
  297.     * @return void 
  298.     */
  299.    public function __construct($token, $block_id = "") {
  300.       // section -64--88-122--2-66879486:104007981a3:-7f92 begin
  301.       parent :: __construct($token);
  302.       $this->oBlock = new src_foundation_tables_BLOCKADEN();
  303.       $this->oNF = new src_foundation_tables_NOCHFREI();
  304.       $this->oVereine = new src_foundation_tables_VEREINE();
  305.       $this->block_id = $block_id;
  306.       $this->arrOldData = $this->oBlock->getRowByID($block_id);
  307.       $this->setStartParameters($this, $this->oBlock);
  308.       // section -64--88-122--2-66879486:104007981a3:-7f92 end
  309.    }
  310.    /**
  311.     * Erstellt eine Liste mit allen Vereinen
  312.     *
  313.     * @access public
  314.     * @author Kay Koch, <kay.koch@gmx.de>
  315.     * @param void 
  316.     * @return string 
  317.     */
  318.    private function prepareVereinList() {
  319.       $returnValue = (string) "";
  320.       //
  321.       $this->oVereine = new src_foundation_tables_VEREINE();
  322.       $arrVereine = $this->oVereine->getRow();
  323.       foreach ($arrVereine as $arrVerband) {
  324.          foreach ($arrVerband as $verein) {
  325.             $returnValue .= "arrVereine[\"" . $verein['verband_nr'] . "/" . $verein['verein_nr'] . "\"]=\"" . $verein['name'] . "\"\n";
  326.          }
  327.       }
  328.       //
  329.       return (string) $returnValue;
  330.    }
  331.  
  332.    /**
  333.     * Erstellt eine Liste mit allen Vereinen
  334.     *
  335.     * @access public
  336.     * @author Kay Koch, <kay.koch@gmx.de>
  337.     * @param void 
  338.     * @return string 
  339.     */
  340.    private function getVereinOptionList($index = "") {
  341.       $returnValue = (string) "";
  342.       //
  343.       $arrVereine = $this->oVereine->getRow();
  344.       foreach ($arrVereine as $verband_id => $arrVerband) {
  345.          foreach ($arrVerband as $verein_id => $verein) {
  346.             $vereinNr = $verband_id . "/" . $verein_id;
  347.             $selected = ($vereinNr == $index) ? "SELECTED" : "";
  348.             $returnValue .= "<option $selected value='$vereinNr'>" . $verein['stadt'] . " (" . $verein['name'] . ")</option>\n";
  349.          }
  350.       }
  351.       //
  352.       return (string) $returnValue;
  353.    }
  354.  
  355.    /**
  356.     * überprüft, ob die gewählte Anzahl an Tauchern für diesen Termin erlaubt ist
  357.     *
  358.     * @access public
  359.     * @author Kay Koch, <kay.koch@gmx.de>
  360.     * @param array 
  361.     * @return boolean 
  362.     */
  363.    /**
  364.    private function checkMaxFrei($data) {
  365.        $returnValue = (boolean) false;
  366.        //
  367.        $oMaxFrei = new src_foundation_tables_MAXFREI();
  368.        $oMaxFrei->setParams($data['see_id'], $data['datum']);
  369.        $arrMaxFrei = $oMaxFrei->getRow();
  370.        $maxFrei = ($this->oSeen-> $data['see_id']->buchbarProTag ? $arrMaxFrei['sumTag'] : $arrMaxFrei[substr($data['stunde'], 0, 5)]);
  371.        if ($data['anzahl'] > $maxFrei) // Anzahl zu groß
  372.            $this->zahlerInfo = "Die maximale Anzahl zu dieser Zeit beträgt: <b>" . $maxFrei . "</b> Taucher";
  373.        else
  374.            $returnValue = true;
  375.        //
  376.        return (boolean) $returnValue;
  377.    }
  378.    */
  379.  
  380.    /**
  381.     * liefert die Differenz zwischen angeforderten und verfügbaren Plätzen
  382.     * Das Ergebnis ist positiv, wenn zuviele angefordert wurden
  383.     *
  384.     * @access public
  385.     * @author Kay Koch, <kay.koch@gmx.de>
  386.     * @param array 
  387.     * @return boolean 
  388.     */
  389.    private function tooManyDivers($data) {
  390.       // frei Plätze am gewünschten Zeitpunkt
  391.       $arrPlaces = $this->oNF->getEntry($data['see_id'], $data['datum']);
  392.       $stunde = ($this->getSeen($data['see_id'])->buchbarProTag) ? "sumTag" : src_tools_TIME :: time2shortTime($data['stunde']);
  393.       $freePlaces = $arrPlaces[0][$stunde];
  394.       // Der See, Datum und Zeit bleiben gleich
  395.       if (!empty ($this->block_id) AND $data['see_id'] == $this->arrOldData['see_id'] AND $data['datum'] == $this->arrOldData['datum'] AND $data['stunde'] == $this->arrOldData['stunde']) {
  396.          $freePlaces += $this->arrOldData['anzahl']; // freie Plätze werden um alten Betrag erhöht
  397.       }
  398.       // Differenz von angeforderten zu verfügbaren Plätzen
  399.       return $data['anzahl'] - $freePlaces;
  400.    }
  401.    /**
  402.     * speichert Informationen über regelmäßige Reservierungen als HTMl-Datei
  403.     * Die Pfad der Datei lautet /infos/blockaden_SEENAME.html
  404.     * wobei SEENAME der kleingeschriebene Name ohne Umlaute ist.
  405.     *
  406.     * @author kaykoch
  407.     * @access private
  408.     * @since 1 - 01.03.2007
  409.     * @return boolean 
  410.     *
  411.     */
  412.    private function saveRegularyBlockInfo() {
  413.       $returnValue = (boolean) false;
  414.       $arrBlockRow = array ();
  415.       $rowtpl = "<tr><td>%s</td><td>%s</td><td>%s</td><td>%s</td><td>%s</td>";
  416.       $this->arrOldData = $this->oBlock->getRowByID();
  417.       // Alle Blockaden durchlaufen
  418.       foreach ($this->arrOldData as $block) {
  419.          // Zwischenspeicher initialisieren
  420.          if (!isset ($arrBlockRow[$block['see_id']]))
  421.             $arrBlockRow[$block['see_id']] = "";
  422.          $this->oVereine->setParams($block['verein_nr']);
  423.          $block['info'] = (!empty ($block['info'])) ? $this->oVereine->name . ", " . $block['info'] : $this->oVereine->name;
  424.          switch ($block['wiederholung']) {
  425.             case 1 : // wöchentlich
  426.                $arrBlockRow[$block['see_id']] .= sprintf($rowtpl, src_tools_TIME :: dayNr2dayName(src_tools_TIME :: sqlT2realT($block['datum'], "%w")), $block['stunde'], $block['anzahlStunden'], $block['anzahl'], $block['info']);
  427.                break;
  428.             case 2 : // Tage
  429.                $stunde = ($block['ganzerTag']) ? "ganztägig" : $block['stunde'];
  430.                $anzahl = ($block['ganzerTag']) ? "" : $block['anzahl'];
  431.                $anzahlStunden = ($block['ganzerTag']) ? "" : $block['anzahlStunden'];
  432.                $zeitraum = src_tools_TIME :: sqlT2realT($block['datum']) . " bis " . src_tools_TIME :: sqlT2realT(src_tools_TIME :: addDays2SQL($block['datum'], $block['anzahlWiederholung'] - 1));
  433.                $arrBlockRow[$block['see_id']] .= sprintf($rowtpl, $zeitraum, $stunde, $anzahlStunden, $anzahl, $block['info']);
  434.                break;
  435.          }
  436.       }
  437.       foreach ($arrBlockRow as $see_id => $this->blockRow) {
  438.          $this->seename = $this->getSeen($see_id)->name;
  439.          $filename = "infos/blockaden_" . src_tools_MULTI :: cleanUmlaute($this->seename) . ".html";
  440.          src_tools_MULTI :: saveFile(src_tools_TEMPLATE :: getTemplate("regularyblocks_tpl", $this), $filename);
  441.       }
  442.       return (boolean) true;
  443.       ;
  444.    }
  445.  
  446.    /**
  447.     * liefert ein Optionlist mit den Möglichkeiten von Wiederholungsarten
  448.     *
  449.     * @access protected
  450.     * @author Kay Koch, <kay.koch@gmx.de>
  451.     * @param string 
  452.     * @return string 
  453.     */
  454.    private function getRepeatOptionList($index = '') {
  455.       $returnValue = (string) '';
  456.  
  457.       // section -64--88-122--2-339007d5:1043cd4e8c9:-7f92 begin
  458.       foreach ($this->arrKindOfBlocks as $key => $title) {
  459.          $selected = ($key == $index) ? "SELECTED" : "";
  460.          $returnValue .= "<option $selected value='$key'> $title</option>\n";
  461.       }
  462.       // section -64--88-122--2-339007d5:1043cd4e8c9:-7f92 end
  463.  
  464.       return (string) $returnValue;
  465.    }
  466.  
  467.    /**
  468.     *
  469.     * checkHoleDay
  470.     *
  471.     * @author kaykoch
  472.     * @access public
  473.     * @since 1.0 - 27.05.2007
  474.     * @param array $data Übergabeparameter
  475.     * @return void 
  476.     *
  477.     */
  478.    private function checkHoleDay(& $data) {
  479.       if (isset ($data['ganzerTag']) AND ($data['ganzerTag'] == 1)) {
  480.          $oMaxFrei = new src_foundation_tables_MAXFREI();
  481.          $oMaxFrei->setParams($data['see_id'], $data['datum']);
  482.          $arrMaxFrei = $oMaxFrei->getRow();
  483.          $data['anzahl'] = $arrMaxFrei['sumTag'];
  484.       } else {
  485.          $data['ganzerTag'] = "0";
  486.       }
  487.       $this->oVereine->setParams($data['verein_nr']);
  488.       $data['name'] = (!empty ($data['info'])) ? $this->oVereine->name . ", " . $data['info'] : $this->oVereine->name;
  489.    }
  490. } /* end of class src_foundation_admin_ADMINBLOCKADEN */
  491. ?>

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