diff --git a/core/modules/image/image.module b/core/modules/image/image.module index 28e3f18..0057eec 100644 --- a/core/modules/image/image.module +++ b/core/modules/image/image.module @@ -54,10 +54,10 @@ function image_help($route_name, RouteMatchInterface $route_match) { $output = ''; $output .= '

' . t('About') . '

'; - $output .= '

' . t('The Image module allows you to create entity fields that contain image files, and to configure Image styles that can be used to manipulate the display of images. See the Field module help and the Field UI help pages for terminology and general information on entities, fields, and how to create and manage fields. For more information, see the online documentation for the Image module.', array('!image_styles' => \Drupal::url('image.style_list'), '!field' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui' => $field_ui_url, '!image_documentation' => 'https://drupal.org/documentation/modules/image')) . '

'; + $output .= '

' . t('The Image module allows you to create fields that contain image files, and to configure Image styles that can be used to manipulate the display of images. See the Field module help and the Field UI help pages for terminology and general information on entities, fields, and how to create and manage fields. For more information, see the online documentation for the Image module.', array('!image_styles' => \Drupal::url('image.style_list'), '!field' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui' => $field_ui_url, '!image_documentation' => 'https://drupal.org/documentation/modules/image')) . '

'; $output .= '

' . t('Uses') . '

'; $output .= '
' . t('Defining image styles') . '
'; - $output .= '
' . t('The concept of image styles is that you can upload one image and display it in several ways; each display variation, or image style, is the result of applying one or more effects to the original image. As an example, you might upload a high-resolution image with a 4:3 aspect ratio, and display it scaled down, square cropped, or black-and-white (or any combination of these effects). The Image module provides a way to do this efficiently: you configure an image style with the desired effects on the Image styles page, and the first time a particular image is requested in that style, the effects are applied. The resulting image is saved, and the next time that same style is requested, the saved image is retrieved without the need to recalculate the effects. Drupal core provides several effects that you can use to define styles; others may be provided by contributed modules.', array('!image' => \Drupal::url('image.style_list'))); + $output .= '
' . t('The concept of image styles is that you can upload a single image, but display it in several ways; each display variation, or image style, is the result of applying one or more effects to the original image. As an example, you might upload a high-resolution image with a 4:3 aspect ratio, and display it scaled down, square cropped, or black-and-white (or any combination of these effects). The Image module provides a way to do this efficiently: you configure an image style with the desired effects on the Image styles page, and the first time a particular image is requested in that style, the effects are applied. The resulting image is saved, and the next time that same style is requested, the saved image is retrieved without the need to recalculate the effects. Drupal core provides several effects that you can use to define styles; others may be provided by contributed modules.', array('!image' => \Drupal::url('image.style_list'))); $output .= '
' . t('Naming image styles') . '
'; $output .= '
' . t('When you define an image style, you will need to choose a displayed name and a machine name. The displayed name is shown in administrative pages, and the machine name is used to generate the URL for accessing an image processed in that style. There are two common approaches to naming image styles: either based on the effects being applied (for example, Square 85x85), or based on where you plan to use it (for example, Profile picture).') . '
'; $output .= '
' . t('Configuring image fields') . '
'; @@ -65,11 +65,11 @@ function image_help($route_name, RouteMatchInterface $route_match) { $output .= '
' . t('Configuring image fields for accessibility') . '
'; $output .= '
' . t('For accessibility and search engine optimization, all images that convey meaning on web sites should have alternate text. Drupal also allows entry of title text for images, but it can lead to confusion for screen reader users and its use is not recommended. Image fields can be configured so that alternate and title text fields are enabled or disabled; if enabled, the fields can be set to be required. The recommended setting is to enable and require alternate text and disable title text.') . '
'; $output .= '
' . t('Configuring image field file storage') . '
'; - $output .= '

' . t('When you create an image field, you will need to choose whether the uploaded images will be stored in the public or private file directory defined in your settings.php file and shown on the File system settings page. This choice cannot be changed later. You can also configure your field to store files in a subdirectory of the public or private directory; this setting can be changed later and can be different for each entity sub-type using the field. For more information on file storage, see the System module help page.', array('!file-system' => \Drupal::url('system.file_system_settings'), '!system-help' => \Drupal::url('help.page', array('name' => 'system')))) . '

'; + $output .= '

' . t('When you create an image field, you will need to choose whether the uploaded images will be stored in the public or private file directory defined in your settings.php file and shown on the File system page. This choice cannot be changed later. You can also configure your field to store files in a subdirectory of the public or private directory; this setting can be changed later and can be different for each entity sub-type using the field. For more information on file storage, see the System module help page.', array('!file-system' => \Drupal::url('system.file_system_settings'), '!system-help' => \Drupal::url('help.page', array('name' => 'system')))) . '

'; $output .= '

' . t('The maximum file size that can be uploaded is limited by PHP settings of the server, but you can restrict it further by configuring a Maximum upload size in the field settings (this setting can be changed later). The maximum file size, either from PHP server settings or field configuration, is automatically displayed to users in the help text of the image field.') . '

'; $output .= '

' . t('You can also configure a minimum and/or maximum resolution for uploaded images. Images that are too small will be rejected. Images that are to large will be resized. During the resizing the EXIF data in the image will be lost.', array('!exif' => 'http://en.wikipedia.org/wiki/Exchangeable_image_file_format')) . '

'; $output .= '
' . t('Configuring default images for image fields') . '
'; - $output .= '
' . t('You can provide a default image when you create an image field; this setting cannot be changed later. However, each entity sub-type can override the default image setting, and this configuration can be changed later. If a user editing an entity with an image field does not upload an image, the sub-type setting for default image will be displayed instead, or the image field setting if there is no default image in the sub-type settings.') . '
'; + $output .= '
' . t('You can configure a default image that will be used if no image is uploaded in an image field. This default can be defined for all instances of the field in the field storage settings when you create a field, and the setting can be overridden for each entity sub-type that uses the field.') . '
'; $output .= '
' . t('Configuring image field behavior') . '
'; $output .= '
' . t('On the Manage display page, you can choose the image style used to display the image in each display mode, and whether or not to display the image as a link. On the Manage form display page, you can choose the preview image style shown on the entity edit form.') . '
'; $output .= '';