Text formats define how user-entered content is processed, filtered, and displayed in Formatted text fields. Text formats combine with text editors to control the editing experience for Formatted text fields and ensure that the content meets security and presentation standards.
Text formats¶
A text format is a set of processing rules that:
- Define what HTML elements are allowed.
- Specify which text filters are applied.
- Control how links, media, and other elements behave.
- Enforce security by removing potentially dangerous markup.
- Format text according to defined standards.
Text formats are paired with editors such as CKEditor to provide the content creation interface for formatted text fields. For more information about text formats, visit Text formats.
Default text formats¶
Acquia Source includes a pre-configured text format with rich text editing and without rich text editing, which can be customized based on requirements. For information about how to manage text formats, visit Managing text formats.
Filters¶
Text formats use filters to process input. Filters control what you can add to the content of your website, and how that content is displayed. By carefully configuring filters, you can create a secure, consistent, and well-moderated website.
Filters help promote:
- Security
- Accessibility
- Display consistency
The following table lists the types of filters in Acquia Source:
| Filters | Description |
|---|
| HTML filters | - Limit allowed HTML tags: Specify which HTML elements and attributes are permitted
- HTML corrector: Fix broken HTML markup
- Display any HTML as plain text: Escape all HTML tags
|
| Link filters | - Convert URLs into links: Automatically link recognized URLs
- Convert line breaks into HTML: Convert newlines to <br> or <p> tags
- Pathologic: Fix links in content when moved between environments
|
| Media and Embed filters | - Display embedded entities: Show referenced entities inline
- Align images: Control image alignment with classes or styles
- Embed media: Allow media embeds from external sources
|
| Special content filters | - Caption filter: Support image captions
- Token filter: Replace tokens with dynamic values
|
CKEditor configuration¶
When using CKEditor with a text format, you can configure:
Format switching enables users to switch between formats when editing. User with permissions to use multiple formats can view and use the format selector in the editor.
For a user to switch between text formats :
The user has permissions to use multiple formats.
This requires assigning text formats to specific roles. For more information, visit Managing text formats.
The field must be configured to allow multiple text formats.
For more information, visit Using text formats with fields.