Updated to Drupal 8.5. Core Media not yet in use.
[yaffs-website] / web / modules / contrib / media_entity_image / README.md
index 9afe4f42db99df7d25fae05febc894c0a418ac8e..0265d08bda51304b93cb1d7ebc397e1ec84db20c 100644 (file)
@@ -1,43 +1,35 @@
 ## About Media entity
 
-Media entity provides a 'base' entity for a media element. This is a very basic
-entity which can reference to all kinds of media-objects (local files, YouTube
-videos, tweets, CDN-files, ...). This entity only provides a relation between
-Drupal (because it is an entity) and the resource. You can reference to this
-entity within any other Drupal entity.
+Media entity provides a 'base' entity for a media element. This is a
+very basic entity which can reference to all kinds of media-objects
+(local files, YouTube videos, tweets, CDN-files, ...). This entity only
+provides a relation between Drupal (because it is an entity) and the
+resource. You can reference to this entity within any other Drupal
+entity.
 
 ## About Media entity image
 
-This module provides local image integration for Media entity (i.e. media type
-provider plugin). The user can map fields from image's Exif data to media bundle
-fields.
-
-### Storing field values
-
-If you want to store field values you will have to map them to actual bundle
-fields. At the momemnt there is no GUI for that, so the only method of doing
-that for now is via CMI.
-
-This whould be an example of that (the field_map section):
-
-```
-langcode: en
-status: true
-dependencies:
-  module:
-    - media_entity_image
-id: photo
-label: Photo
-description: 'Photo to be used with content.'
-type: image
-type_configuration:
-  source_field: field_image
-field_map:
-  mime: field_mime
-  make: field_make
-```
-
-Project page: http://drupal.org/project/media_entity_image (if you can't find it, it will be created shortly).
+This module provides local image integration for Media entity (i.e.
+media type provider plugin). The user can map fields from image's Exif
+data to media bundle fields.
+
+### Mapping meta-data to drupal fields
+
+If you want to map some of the image meta-data (for example some of the
+EXIF information), follow these steps:
+1- Create a media bundle of type image
+2- Create some normal fields that will be used to store this information
+3- Go back to the bundle edit form, select "Yes" on the "Whether to
+gather exif data" drop down
+4- Map the desired EXIF fields to the fields you created in step 2.
+These will get automatically populated each time the entity is saved and
+the drupal fields on the entity are empty.
+NOTE that this behavior (only mapping the meta-data when the drupal
+field is empty) may change in the future, once this issue is solved:
+https://www.drupal.org/node/2772045
+
+
+Project page: http://drupal.org/project/media_entity_image.
 
 Maintainers:
  - Janez Urevc (@slashrsm) drupal.org/user/744628