Merge pull request #971 from ExpressionEngine/7.dev

ExpressionEngine 7.5.9

Author: bryannielsen

README.md

@@ -32,7 +32,12 @@ To build the theme assets, run `npm run buildAssets`. You can also dynamically r
 
 ### Viewing local changes
 
-Manually load `/build/index.html` in your browser to view your local build. For example, `file:///Users/<username>/Documents/ExpressionEngine-User-Guide/build/index.html`. You can use the side navigation to navigate to different local files, but the search functionality always takes you to the live version at docs.expressionengine.com.
+There are 2 options for viewing your local changes.
+
+1. Run `npx http-server -o` which should make the site available at [http://127.0.0.1:8080/build/](http://127.0.0.1:8080/build/).
+2. Manually view any HTML file in `/build/` in your browser. For example, `file:///Users/<username>/Documents/ExpressionEngine-User-Guide/build/index.html` to view the home page.
+
+You can use the side navigation to navigate to different local files, but the search functionality takes you to the live version at [https://docs.expressionengine.com](https://docs.expressionengine.com) unless you follow the steps at [Using DocSearch Locally](#using-docsearch-locally).
 
 ## Using DocSearch Locally
 

docs/advanced-usage/env-support.md

@@ -8,7 +8,7 @@
 -->
 # ENV File Support
 
-Config files can also be configured using [PHP Environment variables ($_ENV)](https://www.php.net/manual/en/reserved.variables.environment.php). To utilize this, create a file named `.env.php` in the root of your ExpressionEngine install. 
+Config files can also be configured using [PHP Environment variables ($_ENV)](https://www.php.net/manual/en/reserved.variables.environment.php). To utilize this, create a file named `.env.php` in the root of your ExpressionEngine install.
 
 NOTE: The `.env.php` file must be placed in same directory as the `system` directory. If you move the `system` directory above the webroot you must also move `.env.php`.
 
@@ -31,19 +31,20 @@ This variable can now be used in your `/system/user/config.php` as illustrated b
 Here is an example of what it might look like to manage all your database connection settings, and Base URL in `.env.php`
 
 ```
-// .env.php
-
-// URLs
+#.env.php
+#URLs
 BASE_URL=http://mysite.test/
 
-// DATABASE SETTINGS
+#DATABASE SETTINGS
 DB_HOSTNAME=db
 DB_DATABASE=db
 DB_USERNAME=db
 DB_PASSWORD=db
 DB_PORT=3306
 ```
 
+NOTE: You must use `#` for comments within `.env.php`. Using `//` will result in your `.env.php` being unable to be read.
+
 ```
 // system/user/config.php
 <?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');
@@ -53,7 +54,7 @@ $config['save_tmpl_files'] = 'y';
 $config['base_url'] = $_ENV['BASE_URL'];
 $config['site_url'] = $config['base_url'];
 
-$config['app_version'] = '7.2.0';
+$config['app_version'] = '7.5.8';
 $config['encryption_key'] = 'bb748b72de235352315122d00';
 $config['session_crypt_key'] = '985796e4444444563463e2c80242';
 
@@ -83,15 +84,15 @@ The site short name can be accessed in the code using `$GLOBALS['assign_to_confi
 The below example demonstrates this approach, assuming you have 2 MSM sites with short names of `default_site` and `second_site`
 
 ```
-// .env.php
-// SITE-SPECIFIC SETTINGS
+#.env.php
+#SITE-SPECIFIC SETTINGS
 default_site.BASE_PATH=/home/sites/mysite.test/
 default_site.BASE_URL=http://mysite.test/
 
 second_site.BASE_PATH=/home/sites/anothersite.test/
 second_site.BASE_URL=http://anothersite.test/
 
-// DATABASE SETTINGS
+#DATABASE SETTINGS
 DB_HOSTNAME=db
 DB_DATABASE=db
 DB_USERNAME=db
@@ -110,7 +111,7 @@ $config['base_url'] = $_ENV[$GLOBALS['assign_to_config']['site_name'] . '.' . 'B
 
 $config['site_url'] = $config['base_url'];
 
-$config['app_version'] = '7.2.0';
+$config['app_version'] = '7.5.8';
 $config['encryption_key'] = 'bb748b72de235352315122d00';
 $config['session_crypt_key'] = '985796e4444444563463e2c80242';
 

docs/channels/entries.md

@@ -789,6 +789,10 @@ If five entries are being displayed per page, then for the fourth entry on the s
 
 **BONUS:** Since the Search module utilizes channel variables, {absolute_count} is also available to the Search Results tag.
 
+### `{absolute_index}`
+
+Similar to `absolute_count` but starts at 0 instead of 1. So the first entry will have value of "0" and the second entry will have a value of "1" etc.
+
 ### `{absolute_results}`
 
 This variable will always display the absolute total number of results that are returned by the tag, regardless of pagination.
@@ -963,6 +967,10 @@ The date the entry was submitted in GMT. This variable is **not** localized for
 
 The date on which the entry was last edited in GMT. This variable is **not** localized for each user's date settings. See [Date Variable Formatting](templates/date-variable-formatting.md) for more information.
 
+### `{index}`
+
+Similar to `count` but starts at 0 instead of 1. So the first entry will have value of "0" and the second entry will have a value of "1" etc.
+
 ### `{ip_address}`
 
 The IP address of the author when they posted the entry.

docs/fieldtypes/file.md

@@ -25,7 +25,8 @@ A File field allows you to browse through existing files and upload new files.
 
 ![file field with file selected](_images/field_file_file.png)
 
-Once a file has been selected in the field, that file can be replaced by clicking the <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" src="../../_images/icon_edit.png" alt="edit icon"> icon. The field selection can be cleared by clicking <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" src="../../_images/icon_remove.png" alt="remove icon"> icon (this will not remove the file from the system). You can also change the file metadata (such as the title or description) by clicking the <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" src="../../_images/icon_edit_meta.png" alt="settings icon"> icon - please note that file's metadata will be changed globally throughout the system.
+Once a file has been selected in the field, that file can be replaced by clicking the <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" 
+src="../_images/icon_edit.png" alt="edit icon"> icon. The field selection can be cleared by clicking <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" src="../_images/icon_remove.png" alt="remove icon"> icon (this will not remove the file from the system). You can also change the file metadata (such as the title or description) by clicking the <img style="margin-bottom: 0px; vertical-align: middle; display:inline-block;" src="../_images/icon_edit_meta.png" alt="settings icon"> icon - please note that file's metadata will be changed globally throughout the system.
 
 ## Field Settings
 
@@ -170,6 +171,12 @@ The automatically-detected MIME type of the file.
 
 The date the file was last modified. See [Date Variable Formatting](templates/date-variable-formatting.md) for more information.
 
+One powerful use of the modified_date is 'cache busting', forcing browers to use a new image rather than a cached one when an image is modified but not renamed:
+
+    {image}
+        <img src="{url}?v={modified_date}" />
+    {/image}
+
 ### `{path}`
 
 The URL to the folder containing the file, including a trailing slash.

docs/installation/changelog.md

@@ -8,6 +8,30 @@
 -->
 # ExpressionEngine v7 Change Log
 
+## Version 7.5.9
+(Release: March 26th, 2025)
+
+<div class="max-w-7xl mx-autotext-center">
+<div class="space-y-8 sm:space-y-12">
+    <ul role="list" class="mx-auto grid grid-cols-2 gap-x-4 gap-y-1 sm:grid-cols-4 md:gap-x-6 lg:max-w-5xl lg:gap-x-8 lg:gap-y-1 xl:grid-cols-5">
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/752126?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Yuri Salimovskiy</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=intoeetive" target="_BLANK">@intoeetive</a></p></div></div></div></li>
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/563996?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Bryan Nielsen</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=bryannielsen" target="_BLANK">@bryannielsen</a></p></div></div></div></li>
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/11818941?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Matt Johnson</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=matthewjohns0n" target="_BLANK">@matthewjohns0n</a></p></div></div></div></li>
+    </ul>
+</div>
+</div>
+
+**Bug Fixes** 💃🐛
+
+- Resolved [#4692](https://github.com/ExpressionEngine/ExpressionEngine/issues/4692) where Search add-on did not include enough custom fields when searching multiple channels
+- Resolved [#4745](https://github.com/ExpressionEngine/ExpressionEngine/issues/4745) where using `edit_date` variable in Structure navigation was giving PHP error
+- Resolved [#4725](https://github.com/ExpressionEngine/ExpressionEngine/issues/4725) where Search was showing an error if `results` parameter was too big
+- Resolved [#4720](https://github.com/ExpressionEngine/ExpressionEngine/issues/4720) where file usage was not calculated correctly for textareas containing multiple images
+- Resolved [#4689](https://github.com/ExpressionEngine/ExpressionEngine/issues/4689) where adding category from entry page could show wrong UI
+- Resolved [#4682](https://github.com/ExpressionEngine/ExpressionEngine/issues/4682) where cloning entry with hidden RTE field was giving PHP error
+- Resolved an issue where curl requests on Windows could not use the native root certificate store
+- Resolved an issue where updates from the CLI would not increment the version number
+
 ## Version 7.5.8
 (Release: March 4th, 2025)
 

theme/_assets/default.min.css

@@ -126,22 +126,23 @@
 }
 // All nested lists
 .sidebar-toc li ul {
-	margin: 8px 0 0 1em;
+	margin: 18px 0 0 1em;
     padding-left: 1em;
     border-left: 1px solid rgb(226, 229, 238);
 }
 
 // All items
 .sidebar-toc li {
-	margin-bottom: 5px;
+	margin-bottom: 13px;
 	color: @dark-grey;
   padding-right: @p-sm;
 }
 
 // First level items
 .sidebar-toc > ul > li {
-	margin: 0 0 10px 0;
+	margin: 0 0 18px 0;
 	font-size: 0.95em;
+	line-height: 1.14em;
 }
 .sidebar-toc > ul > li > a {
     color: rgb(117, 118, 152);