You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/fieldtypes/textarea.md
+31-1Lines changed: 31 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,17 @@ Height of the editor in rows of text.
21
21
22
22
### Text Formatting
23
23
24
-
Specifies how the entered-text will be formatted when rendered on the front-end. Choices include replacing each linebreak with a `BR` tag, automatically surrounding paragraphs with `P` tags, or Markdown processing. [Additional plugins](development/plugins.md) may be installed to provide more text formatting options.
24
+
Specifies how the entered text will be formatted when rendered on the front-end. Choices include:
25
+
26
+
***None** - content will be output exactly as entered
27
+
*[**Auto line break**](/general/text-formatting.html#auto-br) - simply replaces each linebreak with a `<br>` tag
28
+
*[**Markdown**](/general/text-formatting.html#markdown) - processes content as Markdown and outputs HTML
29
+
***XML Encode** - content is formatted and escaped for safe use in an XML document like an RSS feed
30
+
*[**XHTML**](/general/text-formatting.html#auto-xhtml) - Encloses paragraphs with `<p>` tags, adds curly quotes, and does other more advanced processing to make plain text into proper HTML while leaving any HTML intact.
31
+
32
+
XHTML is an original EE formatting option and it is a good default for plain text that needs to be output as nice HTML, especially for text that contains some HTML as well. [Additional plugins](development/plugins.md) may be installed to provide more text formatting options.
33
+
34
+
NOTE: **Note:** To see the Markdown or XML Encode options, those add-ons on must be installed.
25
35
26
36
### Allow Override?
27
37
@@ -34,3 +44,23 @@ Either left-to-right, or right-to-left.
34
44
### Field Tools
35
45
36
46
Show formatting buttons to make writing markup easier, show a smiley chooser, or show a file chooser button to easily insert images or links to files.
47
+
48
+
## {file:XX:url} Tag / Inserting a File
49
+
50
+
In a textarea field, when you add a file using the field tools, EE will insert code like this:
When the field is output, EE will replace `{file:XX:url}` with the file's URL.
61
+
62
+
With that tag in the content of the field, EE will also track the file as being used in this entry. This information is updated whenever an entry is saved with a field containing `{file:XX:url}`. If you reference an uploaded file directly by URL, EE will not track that the file is in use in that entry. This tracking is true for other field types as well, but those other field types often do not display the tag directly as `{file:XX:url}`.
63
+
64
+
If your site is set to [Compatibility Mode](/control-panel/file-manager/file-manager.md#compatibility-mode) for backwards compatibility with older add-ons, file references will instead look like `{filedir_X}filename.ext` and usage will not be tracked.
0 commit comments