diff --git a/core/modules/filter/filter.module b/core/modules/filter/filter.module index 6e72068..9f6875e 100644 --- a/core/modules/filter/filter.module +++ b/core/modules/filter/filter.module @@ -34,10 +34,11 @@ function filter_help($route_name, RouteMatchInterface $route_match) { $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('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.') . '

'; - $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)" under "Text processing". See the Field module help and the Field UI help pages for general information on fields and how to create and manage them.', array('!field_help' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui_help' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
'; + $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.') . '
'; + + $output .= '
' . t('Using text fields with text formats') . '
'; + $output .= '
' . t('Text fields that allow text formats are those with "fomatted" in the description. These are Text (formatted, long, with summary), Text (formatted), and Text (formatted, long). You cannot change the type of field once a field has been created.') . '
'; $output .= '
' . t('Choosing a text format') . '
'; $output .= '
' . t('When creating or editing data in a field that has text formats enabled, users can select the format under the field from the Text format select list.') . '
'; $output .= ''; diff --git a/core/modules/text/text.module b/core/modules/text/text.module index 233418a..8389263 100644 --- a/core/modules/text/text.module +++ b/core/modules/text/text.module @@ -24,17 +24,17 @@ function text_help($route_name, RouteMatchInterface $route_match) { $output .= '
' . t('Managing and displaying text fields') . '
'; $output .= '
' . t('The settings and display of the text field can be configured separately. See the Field UI help for more information on how to manage fields and their display.', array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
'; $output .= '
' . t('Creating short text fields') . '
'; - $output .= '
' . t('If you choose Text as the field type on the Manage fields page, then a field with a single row is displayed. You can change the maximum text length in the Field settings when you set up the field.') . '
'; + $output .= '
' . t('If you choose Text (plain), or Text (formatted) as the field type on the Manage fields page, then a field with a single row is displayed. You can change the maximum text length in the Field settings when you set up the field.') . '
'; $output .= '
' . t('Creating long text fields') . '
'; - $output .= '
' . t('If you choose Long text or Long text and summary on the Manage fields page, then users can insert text of unlimited length. On the Manage form display page, you can set the number of rows that are displayed to users.') . '
'; + $output .= '
' . t('If you choose Text (plain, long), Text (formatted, long), or Text (formatted, long, with summary) on the Manage fields page, then users can insert text of unlimited length. On the Manage form display page, you can set the number of rows that are displayed to users.') . '
'; $output .= '
' . t('Trimming the text length') . '
'; $output .= '
' . t('On the Manage display page you can choose to display a trimmed version of the text, and if so, where to cut off the text.') . '
'; $output .= '
' . t('Displaying summaries instead of trimmed text') . '
'; - $output .= '
' . t('As an alternative to using a trimmed version of the text, you can enter a separate summary by choosing the Long text with summary field type on the Manage fields page. Even when Summary input is enabled, and summaries are provided, you can display trimmed text nonetheless by choosing the appropriate format on the Manage display page.') . '
'; + $output .= '
' . t('As an alternative to using a trimmed version of the text, you can enter a separate summary by choosing the Text (formatted, long, with summary) field type on the Manage fields page. Even when Summary input is enabled, and summaries are provided, you can display trimmed text nonetheless by choosing the appropriate format on the Manage display page.') . '
'; $output .= '
' . t('Using text formats and editors') . '
'; - $output .= '
' . t('With the Text processing options you can restrict the input to Plain text only, or allow users to format text. Which options are available to individual users depends on the settings on the Text formats and editors page. If formatted text is submitted, you can still display it without the formatting by choosing Plain text as the Format on the Manage display page.', array('!formats' => \Drupal::url('filter.admin_overview'))) . '
'; + $output .= '
' . t('If you choose Text (plain), or Text (plain, long) you restrict the input to Plain text only. If you choose Text (formatted), Text (formatted, long), or Text (formatted, long with summary) you allow users to write formatted text. Which options are available to individual users depends on the settings on the Text formats and editors page.', array('!formats' => \Drupal::url('filter.admin_overview'))) . '
'; $output .= ''; - return $output; + return $output; } }