Changeset 28092

Timestamp:

Apr 6, 2014, 8:33:46 AM (10 years ago)

Author:

rvelices

Message:

bug 3056: quick search - added events for plugins; completed help file

Location:

trunk

Files:

• include/functions_search.inc.php (modified) (4 diffs)
• language/en_UK/help/quick_search.html (modified) (8 diffs)

trunk/include/functions_search.inc.php

@@ -868 +868 @@
         $clauses[] = $file_like;
 
-        if ($inflector!=null && strlen($term)>2
+        $variants = array();
+        if (strlen($term)>2
           && ($expr->stoken_modifiers[$i] & (QST_QUOTED|QST_WILDCARD))==0
-          && strcspn($term, '\'0123456789') == strlen($term)
-          )
-        {
-          $variants = array_unique( array_diff( $inflector->get_variants($term), array($term) ) );
+          && strcspn($term, '\'0123456789') == strlen($term) )
+        {
+          if ($inflector!=null)
+            $variants = array_unique( array_diff( $inflector->get_variants($term), array($term) ) );
+          $variants = trigger_event('qsearch_get_variants', $variants, $token, $expr);
+          $variants = array_unique( array_diff( $variants, array($term) ) );
           $qsr->variants[$term] = $variants;
-        }
-        else
-        {
-          $variants = array();
         }
 
@@ -931 +930 @@
         $clauses[] = $token->scope->get_sql('date_available', $token);
         break;
-
+      default:
+        // allow plugins to have their own scope with columns added in db by themselves
+        $clauses = trigger_event('qsearch_get_images_sql_scopes', $clauses, $token, $expr);
+        break;
     }
     if (!empty($clauses))
@@ -1217 +1219 @@
   $scopes[] = new QNumericRangeScope('score', array('rating'), true);
 
-  $createdDateAliases = array('taken');
+  $createdDateAliases = array('taken', 'shot');
   $postedDateAliases = array('added');
   if ($conf['calendar_datefield'] == 'date_creation')
@@ -1226 +1228 @@
   $scopes[] = new QDateRangeScope('posted', $postedDateAliases);
 
+  // allow plugins to add their own scopes
+  $scopes = trigger_event('qsearch_get_scopes', $scopes);
   $expression = new QExpression($q, $scopes);
+  trigger_action('qsearch_expression_parsed', $expression);
 //var_export($expression);
 
+  if (count($expression->stokens)==0)
+  {
+    return $search_results;
+  }
   $qsr = new QResults;
   qsearch_get_tags($expression, $qsr);
   qsearch_get_images($expression, $qsr);
-//var_export($qsr->all_tags);
+
+  // allow plugins to evaluate their own scopes
+  trigger_action('qsearch_before_eval', $expression, $qsr);
 
   $ids = qsearch_eval($expression, $qsr, $tmp, $search_results['qs']['unmatched_terms']);

trunk/language/en_UK/help/quick_search.html

@@ -35 +35 @@
 <q>OR search</q><br>
 </td>
-<td>Add a OR between words.<br>
+<td>Add an OR between words.<br>
 <q>john OR bill</q></td>
 </tr>
@@ -64 +64 @@
 
 <tr>
-<td><q>tag:</q>
+<td><q>tag:</q><br>
+<q>tags:</q>
 </td>
 <td>Searches only in tag names without looking at photo titles or descriptions.<br>
@@ -71 +72 @@
 
 <tr>
-<td><q>photo:</q>
+<td><q>photo:</q><br>
+<q>photos:</q>
 </td>
-<td></td>
+<td>Searches only for photos with the given words in title or description.<br>
+<q>photo:John</q></td>
 </tr>
 
@@ -79 +82 @@
 <td><q>file:</q>
 </td>
-<td>Searches by file name.</td>
+<td>Searches by file name.<br>
+<q>file:DSC_</q></td>
 </tr>
 
@@ -85 +89 @@
 <td><q>created:</q><br>
 <q>taken:</q>
+<q>shot:</q>
 </td>
-<td>Searches photos by taken date<br>
+<td>Searches photos by taken date.<br>
 <q>taken:2003</q> photos taken in 2003<br>
 <q>taken:20035</q>,<q>taken:2003-5</q>,<q>taken:2003-05</q> photos from may 2003<br>
@@ -97 +102 @@
 <td><q>posted:</q>
 </td>
-<td></td>
+<td>Searches photos by posted date.</td>
 </tr>
 
@@ -104 +109 @@
 <q>height:</q>
 </td>
-<td></td>
+<td>Searches photos with a given width or height.</td>
 </tr>
 <tr>
 <td><q>size:</q>
 </td>
-<td></td>
+<td>Searches photos by size in pixels<br>
+<q>size:5m</q> returns photos of 5 megapixels<br>
+<q>size:>12m</q> returns photos of 12 megapixels or more<br></td>
 </tr>
 <tr>
 <td><q>ratio:</q>
 </td>
-<td></td>
+<td>Searches photos by width/height ratio.<br>
+<q>ratio:3/4 OR ratio:4/3</q> finds photos from compact cameras in portrait or landscape modes
+<q>ratio:>16/9</q> finds panoramas
+</td>
 </tr>
 <tr>
@@ -122 +132 @@
 </tr>
 <tr>
-<td><q>score:</q>
+<td><q>score:</q><br>
+<q>rating:</q>
 </td>
-<td></td>
+<td>Hint: <q>score:*</q> will give you all photos with at least one vote. <q>score:</q> will give you photos without votes.</td>
+</tr>
+<tr>
+<td><q>filesize:</q>
+</td>
+<td>Searches photos by file size<br>
+<q>filesize:1m..10m</q> finds files between 1MB and 10MB.</td>
 </tr>