WEB-INF/lib/ttConfigHelper.class.php

   1 <?php
   2 // +----------------------------------------------------------------------+
   3 // | Anuko Time Tracker
   4 // +----------------------------------------------------------------------+
   5 // | Copyright (c) Anuko International Ltd. (https://www.anuko.com)
   6 // +----------------------------------------------------------------------+
   7 // | LIBERAL FREEWARE LICENSE: This source code document may be used
   8 // | by anyone for any purpose, and freely redistributed alone or in
   9 // | combination with other software, provided that the license is obeyed.
  10 // |
  11 // | There are only two ways to violate the license:
  12 // |
  13 // | 1. To redistribute this code in source form, with the copyright
  14 // |    notice or license removed or altered. (Distributing in compiled
  15 // |    forms without embedded copyright notices is permitted).
  16 // |
  17 // | 2. To redistribute modified versions of this code in *any* form
  18 // |    that bears insufficient indications that the modifications are
  19 // |    not the work of the original author(s).
  20 // |
  21 // | This license applies to this document only, not any other software
  22 // | that it may be combined with.
  23 // |
  24 // +----------------------------------------------------------------------+
  25 // | Contributors:
  26 // | https://www.anuko.com/time_tracker/credits.htm
  27 // +----------------------------------------------------------------------+
  28
  29 // Class ttConfigHelper is a helper class to handle comma-separated lists of config data.
  30 // For example, in tt_groups table we have a field called "config", that may store something like:
  31 //
  32 // allow_overlap,uncompleted_indicators,minutes_in_unit:15,future_entries
  33 //   Above, some values are simply defined by their presence such as allow_overlap.
  34 //   Other values have associated values after colon such as minutes_in_work_unit (15).
  35 class ttConfigHelper {
  36   var $config = null; // Source config string.
  37   var $config_array = null;  // Array of config values.
  38
  39   // Constructor.
  40   function __construct($config) {
  41     $this->config = $config;
  42     $this->config_array = explode(',', $this->config);
  43   }
  44
  45   // getDefinedValue determines if a value identified by name is defined.
  46   function getDefinedValue($name) {
  47     return in_array($name, $this->config_array);
  48   }
  49
  50   // setDefinedValue either sets or deletes a defined value identified by name.
  51   function setDefinedValue($name, $set = true) {
  52     if ($set) {
  53       // Setting part.
  54       if (!$this->getDefinedValue($name)) {
  55         $this->config_array[] = $name;
  56         $this->config = implode(',', $this->config_array);
  57         return;
  58       }
  59
  60     } else {
  61       // Deleting part.
  62       foreach ($this->config_array as $key => $value) {
  63         if ($value === $name) {
  64           unset($this->config_array[$key]);
  65           $this->config = implode(',', $this->config_array);
  66           return;
  67         }
  68       }
  69     }
  70   }
  71
  72   // The getIntValue parses an integer value from the source config string.
  73   function getIntValue($name) {
  74     $name_with_colon = $name.':';
  75     $len = strlen($name_with_colon);
  76
  77     foreach ($this->config_array as $unparsed_value) {
  78       if (substr($unparsed_value, 0, $len) === $name_with_colon) {
  79         // Found value.
  80         $unparsed_len = strlen($unparsed_value);
  81         $int_value = (int) substr($unparsed_value, -($unparsed_len - $len));
  82         return $int_value;
  83       }
  84
  85     }
  86     return false;
  87   }
  88
  89   // The setIntValue sets an integer value into config array.
  90   function setIntValue($name, $value) {
  91     // Try to find and replace an already existing value.
  92     $name_with_colon = $name.':';
  93     $len = strlen($name_with_colon);
  94
  95     foreach ($this->config_array as $key => $unparsed_value) {
  96       if (substr($unparsed_value, 0, $len) === $name_with_colon) {
  97         // Found an already existing value.
  98         if ($value !== null) {
  99           // Replace value.
 100           $this->config_array[$key] = $name.':'.$value;
 101         } else {
 102           // Remove value if our new value is NULL.
 103           unset($this->config_array[$key]);
 104         }
 105         $this->config = implode(',', $this->config_array);
 106         return;
 107       }
 108     }
 109     // If we get here, the value was not found, so add it.
 110     $this->config_array[] = $name.':'.$value;
 111     $this->config = implode(',', $this->config_array);
 112     return;
 113   }
 114
 115   // The getConfig returns the config string.
 116   function getConfig() {
 117     return $this->config;
 118   }
 119 }