Skip to content
Tutorials Center
My learning

Topics

Lesson 14 of 37 ยท Articles and Categories

The Editor, Media Manager and Text Filters

Write content with the Joomla editor, upload and insert images with the Media Manager, and understand text filters that keep HTML safe, with runnable examples.

Most of an editor's day in Joomla is spent in three places: the text editor where the article is written, the Media Manager where images and documents live, and, invisibly, the text filters that decide which HTML is allowed to survive. This lesson explains all three and ends with working examples of filtering and image handling logic.

The backend itself is described in words. The runnable pieces are stand-ins that illustrate the filtering and file-naming ideas.

The editors

Joomla's default editor is TinyMCE, a visual (WYSIWYG) editor with a toolbar for headings, lists, links, tables, images and a Source code view. Two alternatives ship with Joomla: CodeMirror, a code editor for people who write HTML by hand, and None, a plain textarea. The site-wide default is set in Global Configuration, and each user can choose their own in Users > Manage > (user) > Basic Settings.

Useful TinyMCE habits:

  • Use heading styles (Paragraph dropdown: Heading 2, Heading 3), not bold text, for structure; search engines and screen readers use headings.
  • Paste as plain text (Ctrl+Shift+V) from Word to avoid messy markup.
  • Use the Source code view to inspect problems; stray <span style="..."> tags usually come from pasting.
  • Insert a Read More and optionally a Page Break (which splits an article into pages with a table of contents).
  • Content blocks, buttons and extra toolbar items can be added through the TinyMCE plugin settings (System > Plugins > Editor - TinyMCE), where you can create toolbar sets per user group.

Below the editor, a row of editor buttons (Article, Image, Menu, Module, Contact, Fields, Page Break, Read More) lets you insert Joomla-specific items: link to another article, embed a module position, and more.

The Media Manager

Open Content > Media. It shows the images folder of the site, with a tree on the left and files on the right, in a grid or list view. You can:

  • Upload files (the toolbar's Upload button or drag and drop).
  • Create Folder for structure (for example images/news/2026).
  • Edit an image (crop, resize, rotate, filters) in the built-in image editor (Joomla 4 and later).
  • Delete and preview files.

In the article editor, the Image button opens the same manager in a dialog. You pick a file, add the alternative text (describing the image for people who cannot see it) and optional caption, and insert it. The article form's Images and Links tab uses the same chooser for intro and full article images.

What may be uploaded

Joomla restricts file types and sizes. In Media > Options you set:

  • Legal extensions (allowed file types), for example bmp, gif, jpg, jpeg, png, webp, avif, pdf, doc, docx, mp3, mp4, etc.
  • Maximum size in megabytes (also limited by the PHP upload_max_filesize and post_max_size values).
  • Optional check for image headers and a list of illegal mime types to block disguised files.
  • The path of the images folder.

Do not allow executable file types such as php, phtml or phar in uploads. A user who can upload a PHP file and open it in the browser can run code on your server. The defaults block these; do not weaken them.

flowchart LR
    A["Choose file"] --> B{"Extension allowed?"}
    B -- no --> X["Rejected"]
    B -- yes --> C{"Size under limit?"}
    C -- no --> X
    C -- yes --> D{"Looks like a real image/doc?"}
    D -- no --> X
    D -- yes --> E["Saved in images/..."]

The kinds of checks an upload goes through.

JS Stand-in: upload checks and safe file names

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Notice that the double-extension case is caught before the type check could be fooled. Joomla's real checks are stricter and include content inspection, but the principle is the same: never trust a file because of its name alone.

Text filters: keeping HTML safe

Anyone who can write HTML into an article can write <script> into it. If a low-privilege user could do that, they could steal a Super User's session. That is why Text Filters exist.

In System > Global Configuration > Text Filters, each user group has a filter type:

  • No Filtering: everything is kept (default for Super Users; use with care).
  • Default Blacklist: removes a list of dangerous tags and attributes (such as script, iframe, object, onclick).
  • Custom Blacklist or Whitelist: you list tags and attributes.
  • No HTML: strips all HTML.

Filtering runs on save, so unsafe markup is removed before it reaches the database. If an author complains that an iframe embed disappears, it is the text filter at work; the right fix is to allow a trusted tag for a trusted group, not to give everybody No Filtering.

JS Stand-in: a simple blacklist filter

Press Run (or Ctrl + Enter) to see the console output here.

No output.

This stand-in demonstrates the idea only. Real HTML cannot be reliably cleaned with a handful of regular expressions: Joomla uses a proper HTML filter class with parsed tags and attributes, and you should never write your own for security purposes.

Putting it together: a content workflow

  1. Write in TinyMCE with heading styles.
  2. Upload images into a dated folder through the Media Manager, with clear file names and alt text.
  3. Insert Read More, link internal articles using the Article button.
  4. Save and check the frontend.
  5. Let the text filter protect the site from anyone with lower privileges.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. What is the default Joomla editor?

    TinyMCE is the default WYSIWYG editor. CodeMirror and None are alternatives.
  2. 2. Why must executable file types such as php not be allowed in uploads?

    An uploaded PHP file opened in the browser would run with the server's rights.
  3. 3. When do text filters run?

    Filtering on save removes unsafe markup from content written by lower groups.
  4. 4. Why add alternative text to inserted images?

    Alt text is read by screen readers and used by search engines.

Summary

  • TinyMCE is the default editor; use heading styles, plain-text paste and the Source view when needed.
  • The Media Manager handles uploads, folders and image editing; limits are set in Media options and PHP.
  • Allow only safe file types; never allow executable ones.
  • Text filters per user group strip dangerous HTML on save.
  • Always add alt text to meaningful images.

Next: Menus and Menu Items