✨ add increment() and decrement() methods

Signed-off-by: otengkwame <[email protected]>

Author: otengkwame

Core/core/Models/EasyModel.php

@@ -1070,21 +1070,24 @@ public function outerJoin($table, $condition, $escape = null)
         return $this;
     }
 
+        //------------------ CodeIgniter Database  Wrappers ------------------
 
-    //------------------ CodeIgniter Database  Wrappers --------------------------------------------------
-
-    /**
-     *   To allow for more expressive syntax, we provide wrapper functions
-     *   for most of the query builder methods here.
-     *
-     *   This allows for calls such as:
-     *   $result = $this->model->select('...')
-     *                         ->where('...')
-     *                         ->having('...')
-     *                         ->find();
-     *
+    /*
+     |   To allow for more expressive syntax, we provide 
+     |   wrapper functions for most of the query 
+     |   builder methods here and also some 
+     |   custom methods.
+     |
+     |   This allows for calls such as:
+     |   $result = $this->model->select('...')
+     |                         ->where('...')
+     |                         ->having('...')
+     |                         ->find();
+     |
      */
 
+    //--------------------------------------------------------------------
+
     /**
      * Pick function
      * A sugared way of using select()
@@ -1099,6 +1102,105 @@ public function pick($select = '*', $escape = null)
         return $this;
     }
 
+    //--------------------------------------------------------------------
+
+    /**
+     * Increments the value of fields or multiple fields 
+     * and their values by primary key of a specific table.
+     * 
+     * @param mixed $id
+     * @param string|array $fields
+     * @param integer $value
+     * @param array $columns
+     * @return bool|CI_DB_query_builder
+     */
+    public function increment(
+        mixed $id,
+        string|array $fields,
+        int|array $value = 1,
+        array $columns = []
+    ) {
+        
+        if (is_numeric($value)) {
+            $value = (int) abs($value);
+        }
+       
+        $columns = is_array($value) ? $value : $columns;
+
+        $fieldsArray = is_array($fields);
+
+        $this->db->where($this->primaryKey, $id);
+
+        if ($fieldsArray) {
+            foreach ($fields as $field => $number) {
+                $this->db->set($field, "{$field}+{$number}", false);
+            }
+        }
+
+        if (!$fieldsArray && is_string($fields)) {
+            $this->db->set($fields, "{$fields}+{$value}", false);
+        }
+
+        if (!empty($columns) ) {
+            $this->db->set($columns, false);
+        }
+
+        $result = $this->db->update($this->table);
+
+        return ($fieldsArray) ? $result : $this;
+       
+    }
+
+    //--------------------------------------------------------------------
+
+    /**
+     * Decrements the value of fields or multiple fields 
+     * and their values by primary key of a specific table.
+     * 
+     * @param mixed $id
+     * @param string|array $fields
+     * @param integer $value
+     * @param array $columns
+     * @return bool|CI_DB_query_builder
+     */
+    public function decrement(
+        mixed $id,
+        string|array $fields,
+        int|array $value = 1,
+        array $columns = []
+    ) {
+        if (is_numeric($value)) {
+            $value = (int) abs($value);
+        }
+       
+        $columns = is_array($value) ? $value : $columns;
+
+        $fieldsArray = is_array($fields);
+
+        $this->db->where($this->primaryKey, $id);
+
+        if ($fieldsArray) {
+            foreach ($fields as $field => $number) {
+                $this->db->set($field, "{$field}-{$number}", false);
+            }
+        }
+
+        if (!$fieldsArray && is_string($fields)) {
+            $this->db->set($fields, "{$fields}-{$value}", false);
+        }
+
+        if (!empty($columns) ) {
+            $this->db->set($columns, false);
+        }
+
+        $result = $this->db->update($this->table);
+
+        return ($fieldsArray) ? $result : $this;
+       
+    }
+
+    //--------------------------------------------------------------------
+
     /**
      * Select function
      *
@@ -1454,5 +1556,6 @@ public function set($key, $value = '', $escape = true)
         $this->db->set($key, $value, $escape);
         return $this;
     }
+    
 }
 /* end of file Core/core/Models/EasyModel.php */