From f6afe1465d3e39e935eeed4cbd18cd26eb939bd2 Mon Sep 17 00:00:00 2001 From: Sobral Date: Tue, 18 Jan 2022 14:00:22 -0300 Subject: [PATCH 01/69] Add `has_children` conditional variable to categories --- docs/channels/categories.md | 15 +++++++++++++++ docs/channels/category-archive.md | 14 ++++++++++++++ 2 files changed, 29 insertions(+) diff --git a/docs/channels/categories.md b/docs/channels/categories.md index 9789fc2b4..958bfb5fa 100755 --- a/docs/channels/categories.md +++ b/docs/channels/categories.md @@ -272,6 +272,21 @@ These are totally dynamic in that any field you create for your category will au You may use this conditional to test whether the category shown is the active category or not, based on the dynamic URI segment. +### `{has_children}` + + {exp:channel:categories channel="news" style="nested" show_empty="no"} + {category_name} + + {if has_children} + + {/if} + {/exp:channel:categories} + +You may use this conditional to test whether the category shown is or isn't a parent category. + ## Category Dropdown Menu You can also display categories in a dropdown menu using the following code: diff --git a/docs/channels/category-archive.md b/docs/channels/category-archive.md index 8e3f1a1d3..e6bb14b04 100755 --- a/docs/channels/category-archive.md +++ b/docs/channels/category-archive.md @@ -248,6 +248,20 @@ There are several variables available for use inside the `{categories}{/categori {/categories} You may use this conditional to test whether the category shown is the active category or not, based on the dynamic URI segment. +### `{has_children}` + + {categories} + {category_name} + + {if has_children} + + {/if} + {/categories} + +You may use this conditional to test whether the category shown is or isn't a parent category. ### `{category_description}` From e6deb377daa41a7eaa3bc4ae227271c08ae1366f Mon Sep 17 00:00:00 2001 From: Doug Black Jr Date: Fri, 25 Feb 2022 09:48:12 -0500 Subject: [PATCH 02/69] Adding documentation for #1847 --- docs/fieldtypes/url.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/fieldtypes/url.md b/docs/fieldtypes/url.md index 031b4374b..123512303 100755 --- a/docs/fieldtypes/url.md +++ b/docs/fieldtypes/url.md @@ -23,6 +23,7 @@ Which URL Schemes the content author is allowed to use in this URL field. Availa - `http://` - `https://` +- `/` ([single slash protocol-relative URLs](https://en.wikipedia.org/wiki/Wikipedia:Protocol-relative_URL)) - `//` ([protocol-relative URLs](https://en.wikipedia.org/wiki/Wikipedia:Protocol-relative_URL)) - `mailto:` - `ftp://` From b3ae5a44ce4d216437749068458dbadf20cd9e79 Mon Sep 17 00:00:00 2001 From: Gavin * JCOGS Date: Tue, 24 May 2022 13:42:46 +0100 Subject: [PATCH 03/69] Add notes on JOIN alias --- docs/development/legacy/database/active-record.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/development/legacy/database/active-record.md b/docs/development/legacy/database/active-record.md index 936486e76..09dc669a6 100755 --- a/docs/development/legacy/database/active-record.md +++ b/docs/development/legacy/database/active-record.md @@ -163,6 +163,7 @@ NOTE: **Note:** As shown earlier, the `FROM` portion of your query can be specif | \$table | `String` | The table to `JOIN` | | \$cond | `String` | The condition to join `ON` | | \$type | `String` | The type of `JOIN` to perform: `LEFT`, `RIGHT`, `OUTER`, `INNER`, `LEFT OUTER`, `RIGHT OUTER` | +| \$alias | `String` | The alias for the JOIN query | | Returns | `CI_DB_active_record` | The Active Record object | Permits you to write the `JOIN` portion of your query: @@ -182,6 +183,13 @@ If you need a specific type of JOIN you can specify it via the third parameter o ee()->db->join('comments', 'comments.id = blogs.id', 'left'); // Produces: LEFT JOIN comments ON comments.id = blogs.id +If you need to assign an alias to your `JOIN` you can specify it via the fourth parameter of the function. + + ee()->db->join('comments', 'comments.id = exp_blogs.id', 'left', 'observations'); + // Produces: LEFT JOIN comments observations ON observations.id = exp_blogs.id + +NOTE: **Note:** When an alias is specified the normal 'protected' processing of table names in your condition is suspended, so if an alias is being used other tables referenced need to be fully expanded **in the condition**. + ### `where($key[, $value = NULL[, $escape = TRUE]])` | Parameter | Type | Description | From dfc716a70137b479c459d6263c9d960e6d7ea3ee Mon Sep 17 00:00:00 2001 From: Josh Conner Date: Tue, 31 May 2022 10:07:35 -0400 Subject: [PATCH 04/69] Update system-configuration-overrides.md Fix small typo --- docs/general/system-configuration-overrides.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/system-configuration-overrides.md b/docs/general/system-configuration-overrides.md index 7124d6c7e..7c14d0fd0 100755 --- a/docs/general/system-configuration-overrides.md +++ b/docs/general/system-configuration-overrides.md @@ -1054,7 +1054,7 @@ Set the number of emails to be sent in each batch. The batch size you should use NOTE: **Note:** [Batch mode](#email_batchmode) must be enabled. -If you are using one of the more robust mail protocols, like Sendmail or SMTP, you can set a greater batch total, possibly as high as several hundred or even more if you are on a dedicated server. A batch size of 300 in these cases is a good starting point. If you are having goo$1 $2uccess you can increase it until you begin experiencing time-outs. +If you are using one of the more robust mail protocols, like Sendmail or SMTP, you can set a greater batch total, possibly as high as several hundred or even more if you are on a dedicated server. A batch size of 300 in these cases is a good starting point. If you are having good success you can increase it until you begin experiencing time-outs. NOTE: **Note:** Unless your mailing list numbers in the thousands, you won't notice much of a speed gain from setting large batches. If you are using the less efficient "PHP mail" protocol then you will usually need to set a lower batch size; 50-100 is typical. From b2e5e2cde3f38d3b443d03b26e4249738efce804 Mon Sep 17 00:00:00 2001 From: Gilbert <> Date: Fri, 3 Jun 2022 14:28:03 -0700 Subject: [PATCH 05/69] Adding documentation for new cache_clearing_end hook --- .../development/extension-hooks/global/functions.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/development/extension-hooks/global/functions.md b/docs/development/extension-hooks/global/functions.md index e97acda0a..09622678e 100755 --- a/docs/development/extension-hooks/global/functions.md +++ b/docs/development/extension-hooks/global/functions.md @@ -13,6 +13,19 @@ lang: php # Functions Library Extension Hooks +### `cache_clearing_end($which)` + +| Parameter | Type | Description | +| ---------- | -------- | ------------------------------------------------------------------ | +| \$which | `String` | Possible value: `all`, `page`, `db`, `tag`, `sql` | +| Returns | `Void` | | + +Called after the `clear_caching` function has been run. + +How it's called: + + $result = ee()->extensions->call('cache_clearing_end', $which); + ### `create_captcha_start($old_word)` | Parameter | Type | Description | From 090169c9aac987d62315799fd94ba110f6edb90b Mon Sep 17 00:00:00 2001 From: JCOGS Design <13821249+jcogs-design@users.noreply.github.com> Date: Sat, 9 Jul 2022 10:31:35 +0100 Subject: [PATCH 06/69] Add details of removeElement() method I found `removeElement()` while looking for a practical solution to the issue with the EE Model `Search` method - which does bi-directional wildcard searches on the term given rather than literal searches - which in some instances will result in a collection being returned that has too many entries (i.e. you get all those which **contain** the search term in a field rather than **match** the search term). Running a foreach() loop on the output testing the 'seached' field against the original search term allows the incorrect elements to be indentified, **removeElement()** allows them to be removed from the collection. **removeElement()** is one of several public methods in the Collection Class that are not documented. --- docs/development/services/model/collection.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/development/services/model/collection.md b/docs/development/services/model/collection.md index d858e867d..974b5106a 100755 --- a/docs/development/services/model/collection.md +++ b/docs/development/services/model/collection.md @@ -160,6 +160,24 @@ Iterates over all the elements in the Collection and passes them to them to the | \$callback | `Closure` | The callback to pass each element to | | Returns | `Collection` | The original collection | +### `removeElement($model)` + +Removes an element from the Collection and returns the reduced Collection. + +| Parameter | Type | Description | +| ---------- | ------------ | ------------------------------------------------------------- | +| \$model | `Model` | An instance of the Model element held in the collection. | +| Returns | `Collection` | The updated collection without the $model element (if found). | + +**Note:** This is a handy way to correct for an issue with the EE Model search method which performs `%search_term%` searches rather than literal searches, so you get back all the records that contain the search term in the nominated field rather than those that match the search term. For example, if $collection is a Collection object, this code **removes** any elements that fail to meet a conditional test - so if it had 100 elements to begin with and 5 fail the test, after the code `$collection->count()` will return 95: +``` +foreach($collection as $element) { + if($element->field != 'reference_value') { + $collection->removeElement($element); + } +} +``` + ### `count()` Count the elements in the Collection From 94b47d648e2a337644433c3d6bcb0e82bd9a03d3 Mon Sep 17 00:00:00 2001 From: River Kelly <65210753+RK311y@users.noreply.github.com> Date: Fri, 15 Jul 2022 20:41:42 -0600 Subject: [PATCH 07/69] Add code formatting to TRUE --- docs/development/legacy/libraries/input.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development/legacy/libraries/input.md b/docs/development/legacy/libraries/input.md index 6cab1a3a4..cda47640b 100755 --- a/docs/development/legacy/libraries/input.md +++ b/docs/development/legacy/libraries/input.md @@ -30,7 +30,7 @@ This class is initialized automatically. You are not required to use this class to call the incoming data from the superglobal arrays, it will still be available through the superglobals themselves. However, the input class does offer some benefits. -The superglobal methods all allow the specification of an optional second parameter that lets you run the data through the [XSS filter](security). It's enabled by setting the second parameter to boolean TRUE. +The superglobal methods all allow the specification of an optional second parameter that lets you run the data through the [XSS filter](security). It's enabled by setting the second parameter to `TRUE` (boolean). Lastly, the superglobal methods will check to see if the item is set and return `FALSE` (boolean) if not. This lets you conveniently use data without having to test whether an item exists first. In other words, normally you might do something like this: From 8abd59209d84d02b14205bf52288c7b6b7a26789 Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 3 Aug 2022 14:03:57 +0300 Subject: [PATCH 08/69] 6.3.5 changelog --- docs/installation/changelog.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/installation/changelog.md b/docs/installation/changelog.md index dd5a82c95..f8fbe841c 100755 --- a/docs/installation/changelog.md +++ b/docs/installation/changelog.md @@ -8,6 +8,31 @@ --> # ExpressionEngine v6 Change Log +## Version 6.3.5 +(Release: August 3, 2022) + +- **Contributors** 🙌 +
+
+ +
+
+ +- **Enhancements** 🚀 + - Added dismissable post-upgrade information widget + - Improved one-click upgrade process + - Updated Descussion Forum module to version 5.1.0 + +- **Developers** 💻 + - Fixed typos in repo documentation + ## Version 6.3.4 (Release: May 6, 2022) - **Contributors** 🙌 From 2ffc9e0d15d7f65200ae761d96cd61c2721a1440 Mon Sep 17 00:00:00 2001 From: Andy McCormick Date: Wed, 3 Aug 2022 12:27:26 -0400 Subject: [PATCH 09/69] updated v6 menu --- theme/doc-page-template.html | 1 + 1 file changed, 1 insertion(+) diff --git a/theme/doc-page-template.html b/theme/doc-page-template.html index 277107669..52ea184f9 100755 --- a/theme/doc-page-template.html +++ b/theme/doc-page-template.html @@ -65,6 +65,7 @@ v6