Page Authoring with Content Fragments
Adobe Experience Manager (AEM) content fragments are created and managed as page-independent assets .
They allow you to create channel-neutral content, together with (possibly channel-specific) variations. You can then use these fragments, and their variations, when authoring your content pages.
Together with the updated JSON exporter, structured content fragments can also be used to deliver AEM content via Content Services to channels other than AEM pages.
Content Fragments and Experience Fragments are different features within AEM:
- Content Fragments are editorial content, primarily text and related images. They are pure content, without design and layout.
- Experience Fragments are fully laid out content; a fragment of a web page.
Experience Fragments can contain content in the form of Content Fragments, but not the other way around.
This page must be read in conjunction with Working with Content Fragments (and related pages) as it introduces basic terminology and concepts, together with creating and managing fragments.
The content fragments enable:
- Marketing and Campaign Strategy
- Review content via centrally managed content fragments.
- Creative Pro
- Tracking of creative assets via collections associated with content fragments.
- Copy Writers
- Write in the AEM content fragment editor.
- Can create content variations.
- Can associate relevant content with the content fragment.
- Can use versioning/workflow.
- Can share content fragment.
- Can manage translations centrally.
- Producers and Journey Managers
- Select from predefined fragments and variations with authoring in AEM.
- Can rely on fragment and associated content always being up-to-date as copy writers and creatives make their updates in centrally managed fragments and assets.
- Can rely on associated media content being curated for relevancy.
- Can create ad-hoc content variations on the fly while still ensuring those variations remain centrally managed in the fragment.
Adding a Content Fragment to Your Page
- Open your page for editing.
- Add the Content Fragment component; from either the Components browser or Insert New Component .
- You can either:
An alternative method is to drag a specific content fragment directly onto the page. This will automatically create the associated component (Content Fragment).
- Open the Assets browser and filter for Content Fragments (the default is Images). Then drag the required fragment onto the component instance.
- Select the content fragment component, then Configure from the toolbar. In the dialog you can open the selection dialog to browse and select the required Content Fragment .
- Initially the content from the Main Element and Master (variation) will be shown. You can select other elements and/or variations as required.
Selecting the Element or Variation
Open the fragment's Configuration dialog to configure the fragment for use on the current page. The dialog can depend on the component used.
In the appropriate configuration dialog you can select the available parameters, including:
- Content FragmentSpecify the fragment to be used.
- Display Mode :
- Single Text Element
- Multiple Element
The elements available depend on the template used.
- The default Main will always be available.
- A selection will be available if the fragment was created with an appropriate template.
- The default Master will always be available.
- A selection will be available if variations were created for the fragment.
- Paragraphs : specify the range of paragraph(s) to include:
- Range : for example, 1 , 3-5 , 9-*
- Handle headings as their own paragraphs
- Handle headings as their own paragraphs
Quick Connection to Fragment Editor
You can open the fragment source for editing (the asset) using the Edit icon on the component toolbar. This will allow you to edit and manage the content fragment .
As always, editing the fragment source will impact all pages that reference that content fragment.
Adding In-Between Content
When a specific content fragment is added to the page, there is a Drag components here placeholder between each HTML paragraph (and at the top/bottom) of the fragment.
This allows you to add extra content in-between (i.e. in-between content) the fragment content (at any of the available points), without having to change the root fragment.
For in-between content you can:
- Add components from the Components browser .
- Add assets from the Assets browser .
- Use Associated Content as a source for in-between content.
The in-between content is page content. It is not stored in the content fragment.
You can also insert visual assets (images) to the fragment itself .
Visual assets inserted into the fragment itself are attached to the preceding paragraph in the fragment. This means that you cannot position in-between content between a visual asset and the preceding paragraph.
After you have added in-between content to a content fragment on your page, then changing the structure of the underlying content fragment (i.e. in the content fragment editor) could lead to erroneous/unexpected results.
When this occurs the in-between content is kept as is:
- In-between components have an absolute position within the sequence of components in the fragment flow. This position does not change, even when the content of paragraphs in the fragment changes. This can make it appear as if the relative positioning has changed, as in-between paragraphs have no contextual relationship to the (fragment) paragraphs they are positioned next to.
- Unless the two paragraph structures conflict; in such a case, the in-between content is not displayed (although it is still present internally).
Using Associated Content
If you have associated content with the content fragment these assets will be available from the side panel (after you place your fragment on the content page). Associated content is effectively a special source of content for of in-between content .
There are various methods of adding visual assets (e.g. images) to the fragment and/or page.
If you have multiple content fragments on the one page, the Associated Content tab will show assets appropriate to all fragments.
Once you have added a fragment with associated content to your page a new tab ( Associated Content ) is opened in the side panel.
From here you can drag the assets to the required location (either to an existing component or to the required position where the appropriate component will be created):
Assets Inserted into the Fragment
If assets (e.g. images) have been inserted into the fragment itself, then the options for editing these assets in the page editor is limited.
For example, for an image you can
- Crop, rotate or flip the image.
- Add a title or alternative text.
- Specify a size.
- You can also configure the layout.
Other changes, such as move, copy, delete must be made in the fragment editor.
Fragments need to be published so they can used used on your published web pages:
- A fragment can be published after creating the fragment in the Assets console .
- If an unpublished fragment is used on a page that is being published, the fragment can also be published at this time.