Content reuse
-------------
Key: DOCU-123
URL: http://jira.magnolia-cms.com/browse/DOCU-123
Project: Documentation
Issue Type: Task
Security Level: Public
Components: content
Reporter: Antti Hietala
Assignee: Antti Hietala
Write a tutorial about content reuse options. Objective is to render the same
page in multiple locations of the content hierarchy or render the same
paragraph on multiple pages, a common request.
Our standard answer to such as request is that Magnolia does not provide
built-in functionality where the same page exists in multiple locations in the
hierarchy but this behavior can be simulated. Options:
* Simulate the JCR Reference property with a custom template.
* Use virtual URIs to map requests for the "copies" back to the source page.
Customize navigation.
* Reconstruct the page by using parts of the source page in the target page.
This would also require customized navigation.
None of these options are really ideal. Aperto has a better approach that
relies on dedicated templates for content reuse. This should become best
practice.
*Business case for reusable pages*
Affiliates inherit content from their parent company. While most affiliate
content is unique, some pages or paragraphs need to be reproduced in verbatim.
Common content should be editable in one location. Changes should propagate to
affiliate sites automatically. Links pointing to other parent company page
should continue to work when content is rendered on the affiliate site. Content
should have affiliate theme and appear in affiliate navigation when rendered on
affiliate site.
*Business case for reusable paragraphs*
Any sidebar content that should be displayed across many pages such as market
data on business pages, upcoming baseball matches on sports pages, or latest
comments on blog posts.
*Reusable pages best practice*
# Create a new Referenced Page template, similar to Redirect template.
# Apply the template to a page in the affiliate hierarchy.
# Use page properties to point to a source page in parent company hierarchy.
# Source page content will be rendered on public instance. \\ \\
{code}
+ Parent company
+ Products
- Life insurance (source page) <-----------
- Car insurance |
- Home insurance |
+ Affiliate |
+ Products |
- Life insurance (inherited, Shadow Template points to source) ---
- ...
{code}
*Reusable paragraphs best practice*
# Create a new Reusable Content page template, a special template that allows
you to add a paragraph or a widget.
# Create a separate hierarchy of pages where you store the reusable paragraphs.
This hierarchy is not displayed on public instance.
# Apply the Reusable Content template to these page.
# Create a new Referenced Paragraph paragraph template.
# Add the Referenced Paragraph on content pages.
# Select one of the reusable paragraphs from the separate hierarchy with the
paragraph dialog. \\ \\
{code}
+ Home
- Sports (contains a Referenced Paragraph that points to reusable content)
- Business
- Blog
- ...
+ Reusable content (hidden hierarchy)
- Support hotline
- Connect with Facebook
- Today's market data
{code}
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.magnolia-cms.com/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
----------------------------------------------------------------
For list details see
http://www.magnolia-cms.com/home/community/mailing-lists.html
To unsubscribe, E-mail to: <[email protected]>
----------------------------------------------------------------
