Skip to content

Commit 5cc669f

Browse files
authored
Update file-manager.md
Explained Compatibility Mode better
1 parent c5be66b commit 5cc669f

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

docs/control-panel/file-manager/file-manager.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,10 @@ Tip: How to Turn off File Manager Compatibility Mode
189189
<iframe src="https://www.youtube.com/embed/V1sRqz-b83k?si=0YrmOgxxcfhbWl_L" title="Turn off File Manager Compatibility Mode in ExpressionEngine" width="1920" height="1080" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
190190
</div>
191191

192-
ExpressionEngine 7+ stores files in the database differently then previous versions (using `{file:XX:url}` format instead of `{filedir_X}filename.ext`). This enables ExpressionEngine to provide a more powerful overall experience with files, such as storing files in subfolders, moving files to different locations, and collecting file usage data.
192+
ExpressionEngine 7+ stores files in the database differently then previous versions, and references them using a `{file:XX:url}` format instead of `{filedir_X}filename.ext`). This change enables ExpressionEngine to provide a more powerful overall experience with files: you can store files in subfolders, you can move files to different locations without breaking references in content, and EE can track if and where each file is in use.
193193

194-
ExpressionEngine will still parse the `{filedir_X}` tags in templates or channel entries. However, third-party add-ons that parse file data on their own may not be compatible with the `{file:XX:url}` syntax, causing issues. In order to prevent a bad user experience, users can enable Compatibility Mode for the sites that are upgraded from earlier versions. If you know all installed add-ons are compatible with the new file format, you can run the Update File Usage (found in Tools-> Utilities-> Update File Usage) and then disable Compatibility Mode from the [Content & Design settings](/control-panel/settings/content-design.md#run-file-manager-in-compatibility-mode).
194+
However, third-party add-ons that parse file data on their own may not be compatible with the `{file:XX:url}` syntax, causing issues. In order to prevent a bad user experience, users can enable Compatibility Mode for the sites that are upgraded from earlier versions, though for a modern site, it is recommended to leave compatibility mode off.
195+
196+
If you know all installed add-ons are compatible with the new file format, you can run the Update File Usage (found in Tools-> Utilities-> Update File Usage), which will also convert all old file references to the new format. Then disable Compatibility Mode from the [Content & Design settings](/control-panel/settings/content-design.md#run-file-manager-in-compatibility-mode).
197+
198+
Regardless of mode status, ExpressionEngine will still parse the `{filedir_X}` tags in channel entry fields.

0 commit comments

Comments
 (0)