diff -u b/core/modules/filter/filter.module b/core/modules/filter/filter.module
--- b/core/modules/filter/filter.module
+++ b/core/modules/filter/filter.module
@@ -48,18 +48,18 @@
case 'admin/help#filter':
$output = '';
$output .= '' . t('About') . '
';
- $output .= '' . t('The Filter module allows administrators to configure text formats. A text format defines the HTML tags, codes, and other input allowed in text entered in the site. They defend your web site against potentially damaging input from malicious users. A visual text editor can be associated with the text formats by using the Text Editor module. For more information, see the online documentation for the Filter module.', array('!filter_do' => 'https://drupal.org/documentation/modules/filter/','!editor_help' => \Drupal::url('help.page', array('name' => 'editor')))) . '
';
+ $output .= '' . t('The Filter module allows administrators to configure text formats. Text formats define the HTML tags, codes, and other input allowed in text entered in the site and they defend your web site against potentially damaging input from malicious users. A visual text editor can be associated with the text formats by using the Text Editor module. For more information, see the online documentation for the Filter module.', array('!filter_do' => 'https://drupal.org/documentation/modules/filter/','!editor_help' => \Drupal::url('help.page', array('name' => 'editor')))) . '
';
$output .= '' . t('Uses') . '
';
$output .= '';
- $output .= '- ' . t('Managing text formats') . '
';
+ $output .= '- ' . t('Managing text formats') . '
';
$output .= '- ' . t('You can create and edit text formats on the Text formats page (if the Text Editor module is enabled, this page is named Text formats and editors). One text format is included by default: Plain text (which removes all HTML tags). Additional text formats may be created during installation. You can create a text format by clicking "Add text format".', array('!formats' => \Drupal::url('filter.admin_overview'),'!add_format' => \Drupal::url('filter.format_add'))) . '
';
$output .= '- ' . t('Assigning roles to text formats') . '
';
$output .= '- ' . t('You can define which users will be able to use each text format by selecting roles. To ensure security, anonymous and untrusted users should only have access to text formats that restrict them to either plain text or a safe set of HTML tags. This is because HTML tags can allow embedding malicious links or scripts in text. More trusted registered users may be granted permission to use less restrictive text formats in order to create rich text. Improper text format configuration is a security risk.') . '
';
$output .= '- ' . t('Selecting filters') . '
';
- $output .= '' . t('A text format is composed of a list of filters. Each filter is designed for a specific purpose, and generally either adds, removes, or transforms elements within user-entered text before it is displayed. A filter does not change the actual text, but instead, modifies it temporarily before it is displayed. One filter may remove unapproved HTML tags, while another automatically adds HTML to make URLs display as clickable links. Make sure that the filter "Limit allowed HTML tags" is always enabled on text formats that untrusted users can use. Set the Filter processing order to ensure that all filters are applied in the right order.') . '
';
+ $output .= '
' . t('Each text format uses filters that add, remove, or transform elements within user-entered text. For example, one filter removes unapproved HTML tags, while another transforms URLs into clickable links. Filters are applied in a specific order and do not change the actual content, but instead, modify it temporarily before it is displayed.') . '
';
$output .= '
' . t('Each filter can have additional configuration options. For example, for the "Limit allowed HTML tags" filter you need to define the list of HTML tags that the filter leaves in the text.') . '
- ' . t('Making text formats available for field editing') . '
';
- $output .= '- ' . t('Text formats can be used for processing the content of Long text fields that are attached to an entity type such as content, a comment or a user account. If you want a field to use a text format, you must choose "Filtered text (user selects text format)" in "Text processing option". This will ensure that the text formats and the visual text editor will be available when entering text in that particular field. See the Field module help and the Field UI help pages for general information on fields and how to create and manage them.', array('!entity_help' => \Drupal::url('help.page', array('name' => 'entity')), '!field_help' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui_help' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
';
+ $output .= '- ' . t('Enabling text formats for field editing') . '
';
+ $output .= '- ' . t('In the field settings for a field that supports text formats (such as Long text), you can enable the use of text formats by choosing "Filtered text (user selects text format)" in "Text processing option". See the Field module help and the Field UI help pages for general information on fields and how to create and manage them.', array('!entity_help' => \Drupal::url('help.page', array('name' => 'entity')), '!field_help' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui_help' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
';
$output .= '- ' . t('Choosing a text format') . '
';
$output .= '- ' . t('When creating or editing data in a field that has text formats enabled, users can use the text format widget to choose between available formats.') . '
';
$output .= '
';