feat(search): ✨ add actual searching

www/src/db_handler/db_interface.php

@@ -83,13 +83,25 @@ interface PostdataInterface {
 
 
     // Returns an array of PostData information
-    // based on the tag search list
+    // based on various search parameters.
     //
-    // Tag searchlist is comprised of space-separated
-    // tags. Each tag can have a weighting prefix,
-    // and some special tags exist (such as limit:N,
-    // order:S).
-    public function search_posts($taglist);
+    // search_options can either be:
+    // - An Array
+    // - Or a String
+    //
+    // In case of it being an Array, it may include
+    // the keys:
+    // - "query" (which will be processed similar
+    //    to how $search_options will be processed),
+    // - "text", which is searched for in text fields 
+    //    (title, brief, fulltext),
+    // - "tags", which is matched IN BINARY MODE against
+    //    the post tags
+    // - "path", which is used as filter
+    // - "order_by": determines which column to order by. NULL
+    //   will order by FULLTEXT match scores
+    // - "limit" and "offset", self-explanatory
+    public function search_posts($search_options);
 }
 
 ?>