Download block
If the main purpose of your page is for users to download one or more documents e.g. Our annual report, the best way to do this is in a Download documents block, which appears at the bottom of the page, like this:
To use this, click ASSOCIATED DOWNLOADS in the right-hand menu
then click select.
In the Select screen that pops up you can select document from the Provider dropdown so you see only documents [the Drupal media library currently contains a mixture of documents and images – please update this guidance when Barnardo’s gets a proper asset management system]
or if you know the name of the document you need to add to your page, enter it – or keywords – in the Media name field, then click Apply
If you find the document you need in the media library, click it so a tick appears, then click select files.
It won’t show up in the edit view of the page but when you save the page it’ll appear in the download block at the bottom,
Adding a new document to media library
If the document isn’t yet in the media library, click Upload document in the Select window, then Choose files, then browse to wherever you’ve saved the doc, select it and click Select files.
NB it’s important to name the document in a meaningful and identifiable way BEFORE adding it to the media library, so it’s easy to find in future and can’t be confused with other documents in the library.
NB2 it’s superimportant to search the library very thoroughly to make sure your document hasn’t already been added, perhaps with a slightly different name. There are already some duplicates in the media library, which doesn’t make it any easier to find things, and adds a version control risk.
If you need to change the document name (as it appears on the live page) click edit in the associated downloads block on the right-hand menu
and put the name you want to appear in the Description field of the Edit entity window, then click save
The document will still have its original name in the media library (in this case annual_report_version_5.pdf) but will be listed in the download block on the live page as you’ve renamed it in the description field (in this case Barnardo’s Annual Report 2018).
It’s important to rename downloads as in the example above not only to correct anything inaccurate or inelegant that may have been missed when the doc was uploaded to the media library, but also to get rid of the underscores between the words (which would make the title effectively one long word so wouldn’t wrap and would make a mess of the download block in mobile view).
You can also remove a doc from the download block by clicking Remove in this window.
NB if you remove all the docs in this way you’ll be left with an empty download block on the live page. To remove the download block entirely, click Remove in the ASSOCIATED DOWNLOADS area in the right-hand menu.
The download block always appears at the very bottom of the live page. It’s one component that can’t be moved.
Inline downloads
If you want to put an inline download elsewhere on your page, write a line of text to introduce the download e.g. Download our annual report below.
With the cursor in the empty space below that line click E (icon at top of body block) then either select or upload the document (as above).
Then click embed. The link to the document then appears on the page.
NB it doesn’t work like an embedded link. You can’t choose link text or even include it in a line of text - it has to sit on a line of its own, as below
