This how-to explains how to add a small "News" feature to your Nuxeo Platform for enabling News content publishing at workspace level, using only Nuxeo Studio.
Newsis a simple document with a title and a Rich content body, where it is possible to set HTML and pictures.
Newsare stored in a dedicated folder inside the workspace.
- People having the "Edit" permission inside a workspace can create draft
Newsdirectly from the workspace, by clicking one single button.
Newswill be displayed on a front tab at workspace level.
- The publishing process will be based on the default Nuxeo lifecycle: if a
Newsis in "approved" state (vs initial "draft" state), then it is automatically displayed in the front tab (the title and the HTML body). To do this publishing action, users having "NewsManagement" role will click on a contextual button, on the News' upper right corner, to approve the
Newswill be ordered by descending date of publishing, and we want to see only the first three news.
News document type
It is composed of a title that can be edited using a HTML Widget. The HTML widget in Nuxeo applications has the ability to upload pictures for the rich content, providing the target type has the "files" schema: this one will be added to our
When they are published,
News must be sorted by their publishing date. Considering what "publishing" means here, the publishing date is the time when it was approved. We will store that information on the default Dublin Core field
dc:valid , which accepts a date.
To display the published news, we will use a "content view" on a front tab at workspace level. It means that the list of "published news" will be the result of a query. This query looks like "select all news which are inside this workspace and which are published, ordered by their publishing date", which can be translated by:
ecm:isCheckedInVersion = 0 AND ecm:currentLifeCycleState = 'approved' AND ecm:primaryType ='News' AND ecm:path STARTSWITH ?
? will be replaced by the dynamical expression
To implement the "NewsManagement" role, we will create a new permission called NewsManagement. It will be bound to the Workspace type, so that it is assignable only on workspaces. This NewsManagement permission will be used to "filter" the two buttons that will have to be created: the button to create the news, and the button to publish the content.
The Create News button will be displayed on the Folder toolbar category of Workspace type, next to the New button. But we want the news to be created in a specific subfolder of the workspace, the "news" folder. To achieve this, we will be using the following operation combo set:
- Fetch > Document
./news: note the use of relative path, as we are on the workspace.
- Navigate to document: that changes the current document to "news" folder.
- Show Create Document page, with type
News, that displays the content form.
And to make sure that there is always a News folder inside the workspace, we will configure a "content-template", that says that each time a workspace is created, a folder called "News Folder" is created inside it. Also, as the news are created through this button, we don't want the News type to appear in the list of document types that are displayed when clicking on the New button in Nuxeo Platform.
The Publish News button is quite simple, just operating a
follow transition on the document and updating the
dc:valid date with the current date.