Shared assets are a means of sharing content between sections. Say for example you wish to re-use the same page design each month for a regular feature, or you wish to repeat a particular layout for every page of an article, or a border & background for an entire magazine.
Shared layers can be thought of as template pages or common layouts, they let you easily reuse content without tediously cut-and-pasting or copying pages, this reduces both production effort as well as content size; content produced using shared assets can be radically smaller than traditional content.
Shared layers are created using the same workflow and file naming convention as regular Oomph sections. Just like sections they contain layer numbered files for portrait and or landscape e.g.
P1-1.pdf, and may also refer to animations if desired e.g
Shared layer folders live within a sub-directory of the top-level folder, and is named
Shared/Layers/Recipe. It's folder name (
Recipe) is the name that you would reference when applying it to a section (see below).
The shared layers folder listing may look like this for example:
/Shared/Layers/News/P1-1.pdf /Shared/Layers/Recipe/P1-1.png /Shared/Layers/Recipe/P1-2.pdf /Shared/Layers/Sport/P1-2.pdf
When a shared layer is applied to a section, the layers are all combined to make the final page. If an identically named file appears in both the section and in the shared folder, precedence will be given to the file from the section, and the file from the shared folder will be ommited. This allows you to override the global content with specific content if desired.
It is also permissable to have no files at all, i.e. let the section be completely empty. In this case the final display will only show the pages from the shared folder itself. To apply shared layers to a section, simply reference the shared folder name in the section, separating it with a vertical bar (
|) character, e.g.:
20-Mudcake | Recipe 30-Netball | Sport
^) character instead of a vertical bar. This is to support the Windows file system which does not allow the use of the vertical bar in file names. If you are using Windows, you should replace all instances of the vertical bar (
|) with the caret(
^) in the examples below.
Say for example we had these files in our mudcake recipe section:
/20-Mudcake | Recipe/P1-5.pdf
The final displayed page would combine the files from both the shared folder and the section. The equivalent when not using layouts would be like this:
/20-Mudcake/P1-1.png /20-Mudcake/P1-2.pdf /20-Mudcake/P1-5.pdf
Multiple shared layers can be combined by simply listing more than one on the section folder. All the files will be combined with the section, with precedence given in the order they appear. e.g.:
20-Netball | Sport | News
There is a specially treated shared layer folder that when present is applied to every single page within a publication. Like other shared layers, it goes in the
Shared/Layers folder along with any custom folders you have. It use the reserved folder name
Defaultin your own content, if present, it will be applied to all pages.
When combined with shared layers, shared objects provide a tidy way to organise the content that will be loaded into shared layers.
Each object lives within a sub-directory of the top-level folder named
Shared/Objects, or directly within a section. The shared objects folder structure may look like this for example:
/Shared/Objects/Header/S1-1.png /20-Mudcake/Body/S1-1.pdf /20-Mudcake/Photo/S1-1.jpg
Here is an example file system listing showing use of some basic shared layers and objects:
Naming a hotspot for a shared object
If you wish to use a shared object on a page of your content, label the hotspot exactly as you would if it was within the same section folder. e.g. If you had a shared object named IPS1, Oomph will look in the section folder to for a folder of the same name. If it does not find once, it will look through the shared assets folder.
Subsequently, any objects defined within a section take precedence over any shared objects. i.e. If you were to later add IPS1 into the section folder, Oomph would use that instead of the IPS1 in your shared folder.
iPad Preview Files
To view these files on your iPad click here to download Oomph Viewer onto your iPad. Once Oomph Viewer is installed download the Handy Book of Oomph in the Library section and preview all the Oomph features in one issue.
Got a question?