From 689470778a0dfc399f74904bb16d0c56d26d89ea Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Sun, 5 Jan 2025 09:35:20 +0200 Subject: [PATCH 1/7] Added `orderby` parameter to `exp:channel:categories` tag --- docs/channels/categories.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/channels/categories.md b/docs/channels/categories.md index 79871b70..73e59dea 100755 --- a/docs/channels/categories.md +++ b/docs/channels/categories.md @@ -128,6 +128,20 @@ You may alternatively specify which categories to not show If you specify that a parent category is not shown, then any children of that parent category are then unable to be shown by the tag. The parent category is required for any and all children categories. +### `orderby=` + +This parameter allows you to specify the order in which the categories are displayed. Only applicable when using the "[linear](#style)" style. The default is to display the categories in the order they are displayed in the CP, where also they can be reordered. You can order by any of the following: + + orderby="category_name" + + orderby="category_url_title" + + orderby="category_description" + +You can also the name of the custom field as the parameter value. If you have a custom field called "my_custom_field" you would use + + orderby="my_custom_field" + ### `show_empty=` show_empty="no" From a18e8979391895b85b04356fe8bacd51ee9b5533 Mon Sep 17 00:00:00 2001 From: Eric Swierczek <2423727+swierczek@users.noreply.github.com> Date: Thu, 20 Feb 2025 13:55:22 -0600 Subject: [PATCH 2/7] Add must-interact documentation --- docs/development/services/modal.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/development/services/modal.md b/docs/development/services/modal.md index 352682f2..3434761f 100755 --- a/docs/development/services/modal.md +++ b/docs/development/services/modal.md @@ -130,6 +130,25 @@ Finally, we need to create our Bulk Action Controls with some special data attri Now when a user selects some content in the table, the bulk action controls should appear, and when "Remove" is selected and submitted, a modal will appear showing a list of content about to be deleted, where they can then confirm the deletion and your `POST` handler will be fired. +## Advanced functionality + +### Required interaction + +By default, clicking the close button, the escape key, or anywhere outside of the modal will close it, acting similar to cancelling the action the modal was prompting for. But if you want to prevent this default behavior and instead want to require the modal to be interacted with, you can add the `must-interact` class as part of the `name` parameter. + + $modal_vars = array( + 'name' => 'hello must-interact', + // ... other settings + ); + $modal_html = ee('View')->make('ee:_shared/modal_confirm_delete')->render($modal_vars); + +NOTE: Note: you will also need to add custom JS to remove `.must-interact`, and then trigger `$(modal).trigger('modal:close')` in order to close it. + + $('.modal-wrap .dialog__buttons button').on('click', function() { + $(this).closest('.must-interact').removeClass('must-interact'); + $(this).closest('.modal').trigger('modal:close'); + }); + ## CP/Modal Service Methods **class `ExpressionEngine\Service\Modal\ModalCollection`** From 1b8ac60a052e4aa30a7f3433b9d3cbb98b6423cd Mon Sep 17 00:00:00 2001 From: Eric Swierczek <2423727+swierczek@users.noreply.github.com> Date: Thu, 20 Feb 2025 13:57:43 -0600 Subject: [PATCH 3/7] Text update --- docs/development/services/modal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development/services/modal.md b/docs/development/services/modal.md index 3434761f..ff63a5d4 100755 --- a/docs/development/services/modal.md +++ b/docs/development/services/modal.md @@ -142,7 +142,7 @@ By default, clicking the close button, the escape key, or anywhere outside of th ); $modal_html = ee('View')->make('ee:_shared/modal_confirm_delete')->render($modal_vars); -NOTE: Note: you will also need to add custom JS to remove `.must-interact`, and then trigger `$(modal).trigger('modal:close')` in order to close it. +NOTE: Note: you will also need to add custom JS to remove `.must-interact`, and then trigger the `modal:close` event in order to close it. $('.modal-wrap .dialog__buttons button').on('click', function() { $(this).closest('.must-interact').removeClass('must-interact'); From 6f22805f6bde6b7a65b9a40d8fce4c06dbe5bd19 Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 21 May 2025 19:08:52 +0300 Subject: [PATCH 4/7] Fix examples for channel form `field_errors` tag --- docs/channels/channel-form/examples.md | 2 +- docs/channels/channel-form/overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/channels/channel-form/examples.md b/docs/channels/channel-form/examples.md index 8205bb71..ee0ab48a 100755 --- a/docs/channels/channel-form/examples.md +++ b/docs/channels/channel-form/examples.md @@ -121,7 +121,7 @@
  • {error}
    • {/global_errors} {field_errors} -
  • {error}
    • +
  • {field}: {error}
    • {/field_errors} {/if} diff --git a/docs/channels/channel-form/overview.md b/docs/channels/channel-form/overview.md index 587f57e9..d35e83bd 100755 --- a/docs/channels/channel-form/overview.md +++ b/docs/channels/channel-form/overview.md @@ -428,7 +428,7 @@ If you have chosen [inline error handling](#error_handling), you can display the ### `{field_errors}` - {field_errors}{error}{/field_errors} + {field_errors}{field}: {error}{/field_errors} If you have chosen [inline error handling](#error_handling), you can display field-related entry submission errors. From d00237eed96a7312c5d46de98b9bd1e5f06077a0 Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 4 Jun 2025 16:39:23 +0300 Subject: [PATCH 5/7] Adds `reserved_field_names` config file --- docs/config/config-files.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/config/config-files.md b/docs/config/config-files.md index 9228836b..c142c79e 100644 --- a/docs/config/config-files.md +++ b/docs/config/config-files.md @@ -75,3 +75,9 @@ We generally recommend using [Template Routes](templates/routes.md) and not modi `stopwords.php` This file contains an array of words that the search functions in EE will ignore in order to a) reduce load, and b) generate better results. + +### Reserved field names + +`reserved_field_names.php` + +This file contains an array of variable names that are reserved by ExpressionEngine and cannot be used as custom field names. From 1cbb4c23fe780914487f8dba5db297f6d5518a1d Mon Sep 17 00:00:00 2001 From: robinsowell Date: Fri, 29 Aug 2025 12:06:05 -0400 Subject: [PATCH 6/7] Changing docs to match CP language --- docs/control-panel/template-manager.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/control-panel/template-manager.md b/docs/control-panel/template-manager.md index 3cadca50..ee9b72cf 100755 --- a/docs/control-panel/template-manager.md +++ b/docs/control-panel/template-manager.md @@ -74,7 +74,7 @@ The Template Notes tab enables you to save notes and information about your temp ### Access - **Allowed member roles** -- Choose which member roles are allowed to access the template. -- **No access redirect** -- Page to redirect users without permissions to. If a template is selected the user does not have access to, the 404 page will be displayed instead. +- **No access template** -- Page to display to users without permissions to access the current template. If a template is selected the user does not have access to, the 404 page will be displayed instead. - **Enable HTTP Authentication?** -- When set to enable, users with permissions will have to login to view this template. NOTE: **Note:** If you are running PHP-FPM / FastCGI, you will probably need to add this to your `.htaccess` so the server makes the necessary environment variables available to PHP & ExpressionEngine. From c6299265b3bc08b651f508225b548ba88fd7bcdd Mon Sep 17 00:00:00 2001 From: robinsowell Date: Mon, 23 Feb 2026 17:28:59 -0500 Subject: [PATCH 7/7] Document sort parameter for category entries Only if sortby param is used --- docs/channels/categories.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/channels/categories.md b/docs/channels/categories.md index 73e59dea..39c8eb27 100755 --- a/docs/channels/categories.md +++ b/docs/channels/categories.md @@ -166,6 +166,14 @@ Determines whether entries dated in the "future" to are included when calculatin By default, future dated entries will **not** count when determining whether a category is empty. +### `sort=` + + sort="asc" + +The sort order can be ascending (asc) or descending (desc). The order will default to “descending” if nothing is specified. + +This parameter is only applicable when using the "[orderby](#orderby)" parameter to specify the sort order. + ### `status=` status="open"