feat: add where function to dt-reports class

dt-reports/reports.php

@@ -310,6 +310,59 @@ public static function get( $value, $type ) : array {
         return $report;
     }
 
+    /**
+     * List reports filtered by where clauses
+     *
+     * @param array $where An assoc array of key, value pairs
+     *
+     * The value parts of the array should be arrays, with 'value' => $value. This allows for adding functionality like operators etc.
+     */
+    public static function list( $where = [] ) {
+        global $wpdb;
+        $report = [];
+
+        $sql = '';
+        $args = [];
+
+        foreach ( $where as $key => $details ) {
+            if ( !is_array( $details ) || !isset( $details['value'] ) ) {
+                return new WP_Error( 'missing-value-type', 'value key is missing for ' . $key );
+            }
+            $value = $details['value'];
+            $new_sql = '';
+            if ( !empty( $sql ) ) {
+                $new_sql .= ' AND';
+            } else {
+                $new_sql .= ' WHERE';
+            }
+
+            $new_sql .= $wpdb->prepare( ' %1$s = ', $key );
+
+            if ( is_numeric( $value ) ) {
+                $new_sql .= '%d';
+            } else if ( is_string( $value ) ) {
+                $new_sql .= '%s';
+            } else {
+                return new WP_Error( 'invalid-value-type', ' $value is of type ' . gettype( $value ) . ' but should be a string or number' );
+            }
+            $sql .= $new_sql;
+            $args[] = $value;
+        }
+
+        //phpcs:ignore
+        $results = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->dt_reports $sql", $args ), ARRAY_A );
+        if ( ! empty( $results ) ) {
+            foreach ( $results as $index => $result ){
+                if ( isset( $result['payload'] ) ){
+                    $results[$index]['payload'] = maybe_unserialize( $result['payload'] );
+                }
+            }
+            $report = $results;
+        }
+
+        return $report;
+    }
+
     /**
      * Delete report
      *