diff --git a/core/modules/file/file.module b/core/modules/file/file.module index 769d480..745ef5e 100644 --- a/core/modules/file/file.module +++ b/core/modules/file/file.module @@ -22,15 +22,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('system.file_system_settings'))) . '
'; + $output .= '
' . t('Allowing file extensions') . '
'; + $output .= '
' . t('You need to specify file extensions by typing them in the File extension field before users can upload files with these extension. The list of allowed file extension is automatically displayed in the help text of the file field.') . '
'; + $output .= '
' . t('Storing files ') . '
'; + $output .= '
' . t('Files that are uploaded through a file field are stored in a directory that is publicly accessible over the web. When public files are listed, direct links to the files are used, and anyone who knows the URL of that file can download it. The public folder is defined in the settings.php file. Consult the File system settings for information about that directory. Files can be stored in a protected folder by setting a Private file system path in the File system settings. Files in the private directory are not accessible directly through the web server. This increases the server load and download time, since the site must resolve the path for each file download request', array('!file-system' => \Drupal::url('system.file_system_settings'))) . '
'; + $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('If the Display field in the Field settings is enabled, users can toggle whether individual files are displayed. Files can be referred to by their URI even if they are not displayed. You can choose a display format from the drop-down menu: ') . '
'; $output .= '
'; return $output; }