diff --git a/core/modules/file/file.module b/core/modules/file/file.module index bb0dd76..8890b2c 100644 --- a/core/modules/file/file.module +++ b/core/modules/file/file.module @@ -23,15 +23,19 @@ function file_help($path, $arg) { case 'admin/help#file': $output = ''; $output .= '

' . t('About') . '

'; - $output .= '

' . t('The File module defines a File field type for the Field module, which lets you manage and validate uploaded files attached to content on your site (see the Field module help page for more information about fields). For more information, see the online handbook entry for File module.', array('@field-help' => url('admin/help/field'), '@file' => 'http://drupal.org/documentation/modules/file')) . '

'; + $output .= '

' . t('The File module allows you to create fields that contain files. See the Field module help and the Field UI help pages for general information on fields and how to create and manage them. For more information, see the online documentation for the File module.', array('!field' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')), '!file_documentation' => 'https://drupal.org/documentation/modules/file')) . '

'; $output .= '

' . t('Uses') . '

'; $output .= '
'; - $output .= '
' . t('Attaching files to content') . '
'; - $output .= '
' . t('The File module allows users to attach files to content (e.g., PDF files, spreadsheets, etc.), when a File field is added to a given content type using the Field UI module. You can add validation options to your File field, such as specifying a maximum file size and allowed file extensions.', array('@fieldui-help' => url('admin/help/field_ui'))) . '
'; - $output .= '
' . t('Managing attachment display') . '
'; - $output .= '
' . t('When you attach a file to content, you can specify whether it is listed or not. Listed files are displayed automatically in a section at the bottom of your content; non-listed files are available for embedding in your content, but are not included in the list at the bottom.') . '
'; - $output .= '
' . t('Managing file locations') . '
'; - $output .= '
' . t("When you create a File field, you can specify a directory where the files will be stored, which can be within either the public or private files directory. Files in the public directory can be accessed directly through the web server; when public files are listed, direct links to the files are used, and anyone who knows a file's URL can download the file. Files in the private directory are not accessible directly through the web server; when private files are listed, the links are Drupal path requests. This adds to server load and download time, since Drupal must start up and resolve the path for each file download request, but allows for access restrictions.") . '
'; + $output .= '
' . t('Managing and displaying file fields') . '
'; + $output .= '
' . t('The settings and the display of the file 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('Allowing file extensions') . '
'; + $output .= '
' . t('In the field settings, you can define which are the allowed file extensions (e.g. pdf docx psd) for the files that will be uploaded with the file field.') . '
'; + $output .= '
' . t('Storing files ') . '
'; + $output .= '
' . t('Uploaded files can either be stored as public or private, depending on the File system settings. For more information, see the System help page.', array('!file-system' => \Drupal::url('system.file_system_settings'), '!system-help' => \Drupal::url('help.page', array('name' => 'system')))) . '
'; + $output .= '
' . t('Restricting the maximum file size') . '
'; + $output .= '
' . t('The maximum file size that users can upload is limited by PHP settings of the server, but you can restrict it by entering the appropriate value into the Maximum upload size field. The maximum file size is automatically displayed to users in the help text of the file field.') . '
'; + $output .= '
' . t('Displaying files and descriptions') . '
'; + $output .= '
' . t('In the field settings, you can allow users to toggle whether individual files are displayed. In the display settings, you can then choose one of the following formats: A file can still be linked to directly by its URI even if it is not displayed.') . '
'; $output .= '
'; return $output; }