Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: DOCU-2700

...

clearboth
width343px
alignright
classmenu

This page describes how to use the Stories app, an example of a custom content editor that authors can use to quickly create and publish flexible content in Magnolia. 

...

Use the Stories app to create and edit stories on a Magnolia author instance. Complete the structured outline to give the story a set of key, static properties. Then build up the unstructured body of your story using content blocks you want: images, texts, videos and links. You can save and publish in one click to get your content on your website fast.

Compared to pages, stories are ideal for quickly producing free-form content without any page-hierarchy constraints. Stories, with a clear distinction between formatting and content, can then be published to different destinations: from a web page to a mobile app or as an article for an online newspaper. 

...

Demo stories

If you have the Magnolia demo modules installed, the Stories app contains some sample blogposts blog posts to show what you can do with the Stories app. Without the demo modules, the Stories app does not contain any content by default.

In the demo, the Stories app has been decorated to extend the default functionality described in this page. The customization of the Stories app introduces new blocks, changed outline properties, sample content and templates for rendering the content.  

...

  • Use the  external link icon to link to external URLs or emails.
  • Use the  internal link icon to link to content in another Magnolia app. By default, you can link to content in the Pages and Assets apps from the Stories app.

...

Add image or video blocks to select an existing asset or upload a new one. Magnolia uses basic mtk components to embed images and videos in your stories.

...

When you have finished writing your story, you can directly click Save and Publish at the bottom of the story. Alternatively, you can select a story in the workbench and click Publish. The publication process and statuses are explained here.

Note

You must publish any assets you use in your stories separately.

The Stories app does not provide any default page or component templates to render the stories. The templates to render the stories must be configured by your development team. The templates provided by the  article-editor module may be used and adapted for this purpose. You can see an example of published stories in the Magnolia demo

Shortcuts

Anchor
stories-shortcuts
stories-shortcuts
The Stories app supports several shortcuts to make editing more user-friendly. The shortcuts vary depending on if you are editing a block (edit mode) or not (select mode).

Include Page
DOCS56:_stories app shortcutsDOCS56:
_stories app shortcuts

Multilingual content

...