General availability
• The cover image is only displayed to portfolio authors on the 'Pages and collections' overview page. In future, we can think about other screens to change to display search results etc. with these 'cards'.
• Images can be added in all levels of Mahara: personal, group, institution, and site level. People who have access to the 'Pages and collections' screens in these levels can view the cover image.
• When a portfolio is copied, the cover image is copied as well like artefacts on a page and tags.
• The cover image can be re-used on multiple pages. Therefore, if it is removed from a page, it is not deleted from the 'Files' area.
• If a cover image is uploaded from a device, it is placed into the folder 'cover images' in the 'Files' area.
Pages and collections overview page
• The middle area of a page or collection 'card' that is currently reserved for the description can receive an image.
• When a page or collection has a description and a portfolio author hovers over that portfolio 'card', an overlay appears that displays the description temporarily. This is similar to the overlay that we have on the default buttons on the dashboard page.
• On mobile, the description area can be clicked to reveal the description.
• Screen reader accessible text will be added as well and people navigating with their keyboard can access the description by navigating into the space.
• The image does not extend to the title area or the bottom options bar.
• The image description (if one is added to the image in Mahara) is used for the <alt> / <title> tag to make it accessible.
'Settings' screen of a page and 'Edit' screen of a collection
• The 'Settings' screen of a page and the 'Edit' screen of a collection get another option to add a cover image.
• On the page settings this will be placed in to the 'Advanced' panel.
• A file selector and uploader allows the portfolio author to select an image from their already uploaded files or upload a new one from their device. Allowed image formats are jpg and png.
• Since images can be very large, .jpg and .png are automatically reduced in size when used as cover image to reduce the amount of data that needs to be loaded.
• Deal with square and rectangular images. Typically, the cards have a square area for the description. However, when in mobile view, they turn into rectangles.
• Recommended dimensions are listed in a description field below the upload to guide portfolio authors.
• The image can be replaced at any point in time.
• The image can be removed from the page at any point in time. When this is done, it is not deleted from the file storage.
Export and import
• HTML (and PDF in future): Cover images are ignored for the export as there is no card display. The image files themselves do come along if an entire account is exported and not only a particular portfolio.
• Leap2A: The cover image is exported and displayed when imported.
This work is sponsored by the Center for Applied Linguistics.
Patch for "master" branch: https:/