DIGITAL FACTORY 7.0 User Guide: Content editing Rooted in Open Source CMS, Jahia s Digital Industrialization paradigm is about streamlining Enterprise digital projects across channels to truly control time-to-market and TCO, project after project. Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Geneva, Switzerland http://www.jahia.com
Summary Introduction... 4 1 Pages... 5 1.1 Pages and sitemap management... 5 1.1.1 Page selection... 5 1.1.2 Page status... 6 1.1.3 Actions... 7 1.2 Create a page... 8 1.3 Edit page properties... 10 1.4 Pages metadata... 10 1.5 Delete a page... 10 1.6 Move pages... 15 1.7 Site tree management... 16 1.7.1 Reordering pages... 16 1.7.2 Move a page in the tree... 19 1.8 Adding Links in menus... 21 1.9 Menu labels... 24 2 Create new content... 25 2.1 Create new content in-context... 25 2.2 Create content out-of-context... 27 3 Update content... 31 Page 2 / 47
4 Delete content... 33 5 Preview content... 36 5.1 Simple preview... 36 5.2 Customized preview... 38 6 Move content... 39 6.1 In the same page... 39 6.2 Move a content into another page... 42 7 Publish content... 43 7.1 Publication status... 44 7.1.1 Of a page... 44 7.1.2 Of content-items inside a page... 45 7.2 Request a publication... 46 7.2.1 On a page... 46 7.2.2 On a content-item... 46 7.2.3 Unpublish... 46 Page 3 / 47
Introduction Jahia Digital Factory is a platform for managing a variety of digital initiatives in a productive and secure fashion. Initiatives such as building websites, mobile sites, intranets and portals, all of which can interact with visitors in order to deliver the best user experience possible. This document provides a practical explanation on basic content editing operations in Edit mode: - Create, edit, move, delete pages - Create, edit, move, delete content - Preview and publish pages and content It is complemented by the other User Guide documents available on the Jahia web site (http://www.jahia.com/documentation-and-downloads/editors-documentation) that explain in details the different tools and user interfaces. Page 4 / 47
1 Pages Each web project has a least a first page created by default which is called home. Authors build the site structure under this first page in a tree organization. By default, this tree of pages is reflected in the navigation menu of the site as seen by the visitors. In other words, authors don t have to manage pages and page classification on one side and the site navigation on another side, they are the same. Note: An important thing to recall when working with Digital factory is that what is called a page is a content item in itself, different form the content displayed in the page. A page is in fact a receptacle of other content-items that are located directly under it or somewhere else on the platform through references. 1.1 Pages and sitemap management Pages management is done in the first tab of the Selector. All pages manually created by authors appear here. As explained in the first section of this document, content items that are not pages (news, articles, events ) and are called directly by users in live mode are rendered as html pages using content templates and therefore are not listed in the tree. 1.1.1 Page selection Each page displayed in the tree can be selected (left-click on the page name); the page itself is then displayed in the Main panel. When a page is selected, the line is colored in light blue. Page 5 / 47
1.1.2 Page status - When a page is published, its title is written in black - When a page is not published (exist only in staging version) the title is written in grey. - To have more information about the page status (page has been modified, unpublished, etc) authors can use the Publication Manager (Publication menu) or the Site Manager (Managers menu). Page 6 / 47
1.1.3 Actions All actions on pages can be done through a contextual-menu. Right-click on a page in the tree to display the available actions. Those actions depend on the page status, and the author role. Page 7 / 47
1.2 Create a page To create a page, do a right-click on an existing page in the site tree, then choose Create page in the contextual menu. Page 8 / 47
An edit-form appears allowing to fill the following properties - the system name: it is the name of the page in the system, and it determines tye default url of the page. - the page title: the name that will appear in the tree, in the navigation menu and as page title by default - the page template: the model that will drive the page structure Depending on your platform or specific project, other options can appear in this form to offer a deeper control on the page behavior. For instance it happens often that authors need two different titles, one (shorter) that will be displayed in the navigation menu and a variant (longer) that will be displayed in the page itself. Another example is the possibility to hide a page in the navigation menu. Those kind of options can be added by developers to match functional needs; If you feel that an option is missing and would be interesting on your pages, you should ask for it to your Page 9 / 47
administrators or project responsible. 1.3 Edit page properties To change page properties you can - Right click on the page in the site tree and choose Edit in the contextual menu - Click on the page in the site tree (the page appears in the main panel) and choose Edit in the top-right menu of the main panel (by default this menu reacts to the object selected in the main panel, when you select a page in the tree, until you choose to select a specific content in the page itself, it is the whole page that is selected by default). 1.4 Pages metadata The metadata tab of the Edit-Engine shows the meta information automatically captured by Digital Factory, as for any other content-item, like the creation date, the author, the last publication date or the last editor of the page. By default, two fields are available for manual editing: description and keywords. Those fields can be used to fill hidden information in the final page used by the search engines to analyze and rank your pages. Ask your webmaster or project manager if those fields are used or not in your templates and if you need to fill them when creating or updating a page. Note that custom fields can be added if necessary, or automated systems can be implemented to fill the metadata fields. 1.5 Delete a page To delete a page you can Page 10 / 47
- Right click on the page in the site tree and choose Delete in the contextual menu - Click on the page in the site tree (the page appears in the main panel) and choose Delete in the top-right menu of the main panel (by default this menu reacts to the object selected in the main panel, when you select a page in the tree, until you choose to select a specific content in the page itself, it is the whole page that is selected by default). - Click on the page in the site tree and use the delete action in the right-click contextual menu. When requesting this delete action, to avoid manipulation mistakes, Digital Factory does not immediately delete the page but a) Ask for a confirmation in a popup window b) If the author confirms, Digital Factory a. Lock the page to impeach editing on it by other users (and all sub-pages) Page 11 / 47
b. Place a mark on it. The page is, in fact, marked for deletion. Note that, as the whole site organization is a tree, when a page is marked for deletion, automatically all sub-pages are also marked for deletion. If the page has never been published, you can return in the same contextual menu and choose delete permanently. Page 12 / 47
The page and all the sub-pages and content-items will be deleted instantly. If you don t want to delete the page, you can choose undelete and the page will return to its normal state and will be unlocked. If the page has already been published the deletion can occur only through a publication process. The delete permanently option is not available in the right-click menu (only the undelete option). It is a constraint necessary to ensure the consistency of the repository. Page 13 / 47
You can then select publish <name of the page> in the contextual menu, or wait for a later publication process of the complete page or several pages including this one. If the publication is approved, then the deletion will be executed at the same time for the staging object and its published version. Note : as we ve seen previously, when requesting the deletion, Digital Factory ask for a confirmation and let you write a message to motive your request. Filling this form is not mandatory, but can help reviewer to validate your request during the publication workflow. Page 14 / 47
1.6 Move pages Pages can be reordered simply by moving them in the site tree with the mouse, or by cut and paste. To move a page in the tree you can - click on the page, hold the mouse button pressed and drag the page on the page that will be its new parent then release the mouse button - right click on the page you want to move, choose Cut in the contextual menu, then rightclick on the page that will be its new parent then choose Paste in the contextual menu Page 15 / 47
1.7 Site tree management Because organizing the site navigation is highly strategic and typically an editorial choice, there is no automatic sorting on the page tree. When a new page is created it is added under its parent, in the latest position if siblings already exist. Authors can change the ordering at any time by drag and drop. 1.7.1 Reordering pages To change the place of a page between others Select the page a drag at the desired place between other pages, an insertion line (a dashed line) appears to show the exact place the page will have. In the following example, the page Santo Spirito is being dragged between the pages Michelangelo and Savonarole. Page 16 / 47
and then drop the page (release the mouse button). The page appears at its new location Page 17 / 47
Be careful to release your page between other pages, if you release it on an existing page, it will be moved as a child of that page (see above paragraph). If you move a page by mistake at a wrong place, just reselect the page whatever its location is and move it to the desired place. Page 18 / 47
1.7.2 Move a page in the tree Using drag and drop it is also possible to move a page (and all its child pages and content) to any other location in the tree. To move a page, select and drag it on another page. Page 19 / 47
When your page hovers another page, the mouse cursor changes and shows a the page, the tree is refreshed automatically and the page appears in its new location. icon. Release Page 20 / 47
1.8 Adding Links in menus Digital Factory offers the possibility to add entries in the site tree that are not new pages but simple links (internal or external). This is convenient if you need to have in your menu an entry that points to a page located in fact at a deeper level of your site or that links to an external site. To add an internal link - Right-click on the page under which the link must appear and choose New internal link : an edit-engine appears that allows to set a title, to choose a page on the platform through a content-picker and a target window (a new window, the same window ). The content picker allows to navigate on the platform (left panel) and select the target (page or content-item) on the right. Page 21 / 47
To add an external link - Right-click on the page under which the link must appear and choose New external link : an edit-engine appears that allows to set the title (displayed in the menu), the url (do not forget the http://) and to choose the target window (a new window, the same window ). Page 22 / 47
Links (external and internal) appear in the site tree with different icons to differentiate them from standard pages. Page 23 / 47
1.9 Menu labels Digital Factory allows also to add entries in the site tree that will appear in menus but will not be clickable. This can be convenient to organize menus, especially long menus. The way labels will be visually rendered in menus seen by visitors depends on the graphic styling of your pages. In the screenshot bellow, labels are automatically replaced by simple separators; it could have been directly the labels in another font or another color. This choice does not belong to the authors but are driven by the templates (unless the developers insert an option to let authors control that styling) Page 24 / 47
2 Create new content 2.1 Create new content in-context In context editing is the fact to work and create content directly in pages. It is the natural way to work with Digital Factory in Edit mode and the most convenient for authors most of the time. When content is created in-context, the new content is stored underneath the containing object and appears immediately in the page where it has been created. In other words, when a content-item is created directly in page, this content will be stored as a child of the page and will appear immediately in the page in the area chosen by the author. To create in-context content you must, in the Selector, select the page where the content must appear then Open the second tab of the Selector, then drag and drop a component corresponding to your need. Component can be inserted in page areas/lists, at the top, at the bottom or between two existing content. When the component can be dropped a blue dashed line appears to indicate precisely where the content will be inserted. Components are grouped in meaningful categories, but can be customized and rearranged for your platform. Please read the document Edit Mode: GUI and Tools overview available on Jahia.com (http://www.jahia.com/documentation-and-downloads/editors-documentation) to learn more about the Selector and use of components in depth. Page 25 / 47
Use the buttons visible in the page itself at the bottom of editable areas. If the area allows only certain types of content (this is defined by the developers in the templates) a buttons will be displayed for each content type. When hitting (one of) the button(s) of a given content type the Edit-Form is displayed immediately. If the area is not limited to certain content types, a generic button any content is displayed. When hitting the button, a popup window allows you to choose the content type that you want to create, once selected, the Edit-Form appears. Page 26 / 47
To know more about the Edit-Engine, please read the document Edit Mode: GUI and Tools overview accessible on the Jahia web site (http://www.jahia.com/documentation-anddownloads/editors-documentation) 2.2 Create content out-of-context Out of context editing is the fact to work and create content into folders, without placing them directly in pages. It is a less convenient approach than in-context editing except for some specific use cases. Working out-of-context can also be a preference for some users accustomed to work this way with other systems. To create a content out-of-context you can - Activate the 3rd tab of the Selector, use the upper part of the Selector to select a destination folder and choose create new content in the right-click contextual menu. Then you ll have to Page 27 / 47
choose the type of content you want to create in a popup window, and then the Edit-Form appears. - Use the Content Manager (see Managers section) Choose the type of content you want to create Page 28 / 47
Fill the edit-engine and save, as for any other content creation. The new item appears in the bottom part of the Selector with a red icon (the item has never been published) Page 29 / 47
Page 30 / 47
3 Update content To update content you can - Double-click on the content item in the page - Left-click on a content item in the page to select it (it should be bordered in red) then do a rightclick and choose edit in the contextual menu. In both cases the result is to open the Edit-Form allowing to change the actual data in each property (field). Page 31 / 47
To know more about the Edit-Engine, please read the document Edit Mode: GUI and Tools overview accessible on the Jahia web site (http://www.jahia.com/documentation-anddownloads/editors-documentation) The Edit-Engine as it will be displayed depends first on your role as an author. The role defines what tools / tabs are available. The standard editor role, as provided with Digital Factory, provides access to 9 tabs. When editing content the most important tab is the first one (the one displayed by default) that allows authors to type or edit the actual data of each field. The fields available are different Page 32 / 47
4 Delete content To delete content, you can - Select the item inside the page (left click) then right-click and choose delete in the contextual menu. Digital Factory ask for a confirmation then, if you confirm, the page is refreshed immediately and the content item is hovered with a special layout. The content item is not yet deleted but just marked for deletion. Page 33 / 47
To completely delete the content item it depends of the content item status - if the content has never been published you can redo a right-click and choose delete permanently as for pages (see section 2.5 Delete a page) Page 34 / 47
- if the content has already been published the deletion can occur only through a publication process. It is a constraint necessary to ensure the consistency of the repository. You can then select publish name of the item in the contextual menu, or wait for a later publication process of the complete page or several pages. If the publication is approved, then the deletion will be executed at the same time for the staging object and its published version. Page 35 / 47
5 Preview content By default, Contribute mode and Edit mode display pages in a fashion close to the final result but sometimes it is necessary to control what the page will look like exactly before publishing it. 5.1 Simple preview To preview a page you can - Use the Mode Menu and choose preview or preview in a new window. The page is displayed as it will be visible by unauthenticated users (simple visitors) if it is published now. - Use the View Menu and choose customized preview if you want to see the page as it will be for a given user profile and / or at a given date. In case some content items have been configured to become visible only at a specific date or during a certain amount of time or the page may contain content items that have specific access rights thus not visible by every visitor. A page in Edit mode Page 36 / 47
The same page in Preview mode: button, toolbar and areas has disappeared Page 37 / 47
5.2 Customized preview If the page you want to preview has access rights set on different content-items, r if some content must appear or disappear at specified dates, the simple preview will not allow to verify that everything works as expected, as it display the page - Only for guest users - On a standard desktop web browser - As if published right now To preview a page for a given user, or channel, or date, you can use the Customized preview entry in the View menu. A pop-up window allows to specify the desired criteria. Page 38 / 47
6 Move content 6.1 In the same page To move content in the same page, you can: - Simply drag and drop the content-item from one place to another, in the same area, or into another area if the destination area allows that type of content. When you start moving an item, for ergonomic reasons the rendering is changed to, whatever the original size of the content in the page Digital factory help users to know if a content-item can be dropped by using icons. If the item is not droppable the icon is, as soon as the content can be dropped somewhere the icon changes to and a dotted line appears in the page to show exactly where the content will be inserted Page 39 / 47
- Another possibility is to select the item you want to move (left click, the item is then bordered in red) and choose cut in the right-click contextual menu. As soon as an item is cut (placed in the clipboard) paste buttons appear in the different areas of the page where the content can be moved. Page 40 / 47
Click on paste, the item disappears from its original location and appears in the new location; the paste buttons disappear from the page. Page 41 / 47
Obviously, the rendering of the item may not be perfect instantly, as each area has a different size and specific rendering styles. Being able to move items from one location to another requires that you know your templates and what is possible or not. If the rendering of some content types in a specific area is not correct in your opinion, you should ask your webmaster or designer to create a specific view (rendering) that will match this location nicely. 6.2 Move a content into another page To move a content from one page to another page, the procedure is nearly the same: select the item you want to move (left click, the item is then bordered in red) and choose cut in the rightclick contextual menu, then go to the destination page and click on one of the paste button that appears on the destination page. Note: using the same procedure but using the copy action, instead of cut, the content will be duplicated where it is pasted. Sometimes it can be safer to copy-paste then delete the original manually than cut and paste. Also, it is sometimes simpler and faster to start with a filled content and retyping what you want in it, rather than starting with an empty content. Page 42 / 47
7 Publish content Publishing is a necessary step to make content accessible to visitors. Basically a publication consists to copy the staging content (stored in a private warehouse) in a second location (a public warehouse). Sure things are not always as simple : 1. Publication is subject to certain rules that ensure integrity of content: - Content in a given language cannot be issued if the fields defined as mandatory are not met. - Content in a given language cannot be issued if the fields defined as mandatory are not filled in other languages themselves defined as mandatory. - Content cannot be issued if the parent is not itself published. 2. Publication can be launched - On a single content-item - On a page (and all content-items that appear in this page) - On a page and all sub-pages (and all content that appear in those pages) - On the whole site 3. Publication is done per language. 4. When a publication workflow is started - The content-items that must be published are temporally locked (they cannot be edit until the end of the publication process, whether is approved or rejected) - A publication task is created and automatically notified to all users that can handle it. Moreover, although this is not an obligation, it is very common that the publication is subject to a workflow/validation process consisting in one or more stages. Digital Factory offers even the possibility of using different publishing process for each page or each content-item within a page. Thus we can imagine a site that most pages are subject to a single stage of validation, but specifically the contents of the "press releases" were subjected to two stages of validation and the financial section with three validation steps: a proof reader, a first validator and, finally, the Chief Financial Officer. Page 43 / 47
As a publisher, details of the process that runs when you request the publication is ultimately of little importance and you do not even need to know the details, whatever its complexity, such as the number of steps and actors involved. For an editor, the publication should remain as transparent as possible. And what matters is - To find out about the current publication status of a page or content. - Know how to request a publication. 7.1 Publication status 7.1.1 Of a page Choose Publication manager in the Publication menu. Page 44 / 47
7.1.2 Of content-items inside a page Choose Status in the Publication menu. Overlays appear on the different items with clear labels. Note that those statuses disappear as soon as you click somewhere or if you navigate to another page. It s just on the fly information. Page 45 / 47
7.2 Request a publication 7.2.1 On a page To simply publish the page and the content inside it, right-click on the page name in the Selector and choose Publish <page name> <language> in the contextual menu or chose the same option in the Publication menu. To publish a page and all sub-pages and content-items, select the page in the Selector and choose Publish all under <page name> <language> in the Publication menu. 7.2.2 On a content-item In the Main panel, right-click on the desired item and choose Publish <content name> <language> or Publish all under <content name> <language>. Publishing individual content-items provides several advantages - If several items have been modified in a page but are not all ready for publication you can still update your page in live mode with the ready to be published items. Most CMS does not provide this capacity, they are page-based and you have no choice but publish the complete page or nothing. - Publication of a single item is more secure (no risk to publish items changed by other users by mistake) and faster than publishing multiple content-items or pages at the same time (in fact, publishing a content-item is done instantly) 7.2.3 Unpublish Ti remove a content-item or a page from the live mode and thus make it unavailable to visitors, the procedure is exactly the same as for publication, but you must choose the unpublish action. Page 46 / 47
Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Geneva, Switzerland http://www.jahia.com