<Media>
This option is used to add any number of images to your media gallery. Any image added to your gallery can be internally linked by its image id using URL References and its data can be accessed using Data References. The image id can also be used as a page's <MediaId> or added to the <FeaturedImages>. Most fields are optional, only the image id and one of the URLs must be defined. Any missing image formats, when referenced, will be automatically replaced with the next largest size, or smaller if a larger size does not exist.
Example:
<Media> <Image> <Id> M1 </Id> <Title> Typewriter </Title> <Large> https://.../image_l.jpg </Large> <Medium> https://.../image_m.jpg </Medium> <Small> https://.../image_s.jpg </Small> <Thumb> https://.../image_t.jpg </Thumb> <Credit> Copyright Bob Bobson </Credit> <Caption> An old typewriter </Caption> <Place> London </Place> <Date> January 5, 1942 </Date> <Note> Dad's </Note> <Data> <Name> Camera Type </Name> <Value> Canon EOS Rebel </Value> </Data> <Data> <Name> Lens </Name> <Value> 50mm f/1.4 </Value> </Data> </Image> </Media>
Properties:
Additional Properties:
BlüeBox allows you to define any number of additional properties for images. These properties can be accessed from pages and in page templates using Data References.
Technical Details
BlüeBox defines an internal image placeholder to access the <Id> of the 'current' image, where 'current' means the image being displayed. Since pages cannot define a 'current' image, this placeholder can only be used by page templates to display images.
Properties of the 'current' image can also be accessed by page templates by using Data References (data references are always bound at build time) All of the above listed properties can be accessed directly using the current image placeholder and the property name. BlüeBox defines a shortcut to make this easier, i.e. <image.property>Title</image.property>
. User-defined properties can also be accessed by using the value of the <Name> property. In addition, several read-only properties are also available. The following is a complete list of accessible properties.