From 04a0bed12b7e8f5a9fe7ae38f0c23c7df3491b71 Mon Sep 17 00:00:00 2001
From: Yuri Salimovskiy <yuri@packettide.com>
Date: Wed, 18 Jan 2023 15:48:35 +0200
Subject: [PATCH 1/2] search module docs

---
 docs/add-ons/search/advanced.md | 59 ++++++++++++++++++++++++++++++++-
 docs/add-ons/search/simple.md   | 16 +++++++++
 2 files changed, 74 insertions(+), 1 deletion(-)

diff --git a/docs/add-ons/search/advanced.md b/docs/add-ons/search/advanced.md
index 48f012909..652ee127d 100755
--- a/docs/add-ons/search/advanced.md
+++ b/docs/add-ons/search/advanced.md
@@ -267,6 +267,63 @@ With this parameter, you can specify the css class you want the form to have, en
 
 With this parameter, you can specify the css id you want the form to have.
 
+### `orderby=`
+
+    orderby="entry_date"
+
+The "orderby" parameter sets the display order of the entries. The available values for this property are `entry_date`, `most_comments`, `recent_comment`, `title`, `status`, `entry_id`, `url_title`, `edit_date`, `comment_total`, `expiration_date`, `view_count_one`, `view_count_two`, `view_count_three`, `view_count_four`.`
+
+If this parameter is not set, it will default to ordering by entry date.
+
+### `sort=`
+
+    sort="asc"
+
+    sort="desc"
+
+The sort order can be "asc" (ascending order or "oldest item first") or "desc" (descending order or "newest item first"). If you do not use a sort order the default is desc.
+
 ## Variables
 
-A full discussion of the available variables is not feasible there is a great deal of interdependence between the various form fields, variables, and javascript functions. The Parameters can be used to modify how the search behaves. If you wish to modify the search form itself, simply use the default form as a base and customize it from there.
+### `channel_names`
+
+Pre-populated string containing list of `<option>` tags containing channels that can be used to select channel to search in.
+
+### `lang:...`
+
+Should you be willing to use the language string from ExpressionEngine language files to build the search, the following are available:
+
+#### `lang:search_engine`
+#### `lang:search`
+#### `lang:search_by_keyword`
+#### `lang:search_in_titles`
+#### `lang:search_in_entries`
+#### `lang:search_everywhere`
+#### `lang:search_by_member_name`
+#### `lang:exact_name_match`
+#### `lang:exact_phrase_match`
+#### `lang:also_search_comments`
+#### `lang:any_date`
+#### `lang:today_and`
+#### `lang:this_week_and`
+#### `lang:one_month_ago_and`
+#### `lang:three_months_ago_and`
+#### `lang:six_months_ago_and`
+#### `lang:one_year_ago_and`
+#### `lang:channels`
+#### `lang:weblogs`
+#### `lang:categories`
+#### `lang:newer`
+#### `lang:older`
+#### `lang:sort_results_by`
+#### `lang:date`
+#### `lang:title`
+#### `lang:most_comments`
+#### `lang:recent_comment`
+#### `lang:descending`
+#### `lang:ascending`
+#### `lang:search_entries_from`
+#### `lang:any_category`
+#### `lang:search_any_words`
+#### `lang:search_all_words`
+#### `lang:search_exact_word`
diff --git a/docs/add-ons/search/simple.md b/docs/add-ons/search/simple.md
index 60689e908..fc79b8712 100755
--- a/docs/add-ons/search/simple.md
+++ b/docs/add-ons/search/simple.md
@@ -182,6 +182,22 @@ With this parameter, you can specify the css class you want the form to have, en
 
 With this parameter, you can specify the css id you want the form to have.
 
+### `orderby=`
+
+    orderby="entry_date"
+
+The "orderby" parameter sets the display order of the entries. The available values for this property are `entry_date`, `most_comments`, `recent_comment`, `title`, `status`, `entry_id`, `url_title`, `edit_date`, `comment_total`, `expiration_date`, `view_count_one`, `view_count_two`, `view_count_three`, `view_count_four`.`
+
+If this parameter is not set, it will default to ordering by entry date.
+
+### `sort=`
+
+    sort="asc"
+
+    sort="desc"
+
+The sort order can be "asc" (ascending order or "oldest item first") or "desc" (descending order or "newest item first"). If you do not use a sort order the default is desc.
+
 ## Variables
 
 There are no specific variables associated with the Simple Search Form. You may use the [{path=''}](templates/globals/path.md) Global Variable to create a link to an Advanced Search Form if you wish.

From 2d6c46fb64d722a3542404a68cea0b533d115f3f Mon Sep 17 00:00:00 2001
From: Yuri Salimovskiy <yuri@packettide.com>
Date: Wed, 10 May 2023 09:40:18 +0300
Subject: [PATCH 2/2] tip about using variable modifiers on search results

---
 docs/add-ons/search/results.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/add-ons/search/results.md b/docs/add-ons/search/results.md
index 66e1b2992..382557f18 100755
--- a/docs/add-ons/search/results.md
+++ b/docs/add-ons/search/results.md
@@ -100,6 +100,8 @@ An excerpt from the entry. The excerpt consists of the first 50 words from the f
 
 The text from the entry. Unlike the {excerpt} variable, this one returns the entire text from the field specified for search excerpting in your [Channel Management](control-panel/channels.md) settings for your channels.
 
+TIP: **Tip:** Use [variable modifiers](templates/variable-modifiers.md) to more precisely control the output of search results variables.
+
 ### `{id_auto_path}`
 
 This parameter is replaced with the URL to the entry with the Entry ID appended to the end. Unlike other "path" variables, this variable does **not** require the Template_Group/Template to be specified. Instead, the path will automatically be determined by the Channel URL setting for the channel in [Channel Management](control-panel/channels.md).