Space Template Layout Edition

[srenault-meeds]

Rationale

Admins can add and edit space templates. Each template is preconfigured with a layout (home) and with a menu (apps).
In order to help our admins customizing their environment, editing each template layout would be more than interesting.

Indeed, that would provide a whole feature of adding / editing templates.
Moreover, saving a space layout and navigation as a template would be a plus so admins can easily catch nice customization and so they can earn in productivity.

1. Functional Requirements

Top User Stories

Adding a template

When adding a template
Then you access the current form to add characteristics, and to preconfigure permissions, access control, creation steps.
Once done, you will be invited to update the default layout and navigation.

From there, you can customize the layout of each page, one by one

• updating apps,
• adding contents and pref of apps
• updating sections,
• customizing their style (page or section or app)
  AND you can add, remove, update nodes / navigation

Each change is saved and stored for the space template.
Indeed, when using this template to create a space, then any preference (layout / nav) is reused so the user can easily create a space as expected.

Editing a template layout

When accessing options of a template
It is possible to edit the layout
Once requested, the navigation drawer is proposed so you can manage nodes and layout.

When saving it, then the template is updated and only new space created using it will get this new layout/navigation.

Precision: Product Templates cannot be edited

Impacts

Gamification

--

Notifications

--

Analytics

--

Unified Search

--

2. Technical Requirements

Expected Volume & Performance

Security

The Space Templates Management has to be allowed to administrators only. The Pages Content of type SNV/Image/Links has to be re-imported when instantiating a space template for a given space so that all permissions are re-computed switch new space Group identifier.

Extensibility

Study whether it's possible or not to allow to extend the Space Template navigations without having to override the whole space site template.

Configurability

N/A

Upgradability

The already existing Space Templates (prepared with #150) has to use the new strategy of space Layout definition.

Existing Features

N/A

Feature Flags

N/A

Other Non Functional Requirements

N/A

3. Software Architecture

Security

Knowing that SNV/Image/Links portlets are using the contextual information about the current page to check ACL, when instantiating the pages or the portal layouts, the SNV/Image/Links content has to be exported in order to re-import it with the new preferences and contextual information about the current space pages. This strategy already exists and is used in page template duplication process.
For containers attached Backgrounds, its permissions will be set to Everyone in order to allow all spaces to reuse the attached background.

Access

• The UI will reuse the same Navigation Drawer to display the list of available pages for the space site template
• The same App and pages will be re-used to manage pages layout

Services & processing

• A new PortalConfig type will be added in addition to existing ones, of type:
  • PORTAL
  • GROUP
  • USER
  • GROUP_TEMPLATE (new)
  • PORTAL_TEMPLATE (will not be handled here but in a future [DRAFT] Site Template #149)
• The current existing behavior of Site template declaration will be improved to import the group site template rather than reading it from configuration when being instantiated. This will allow to manage the site layout, navigation and pages layout using UI. The import mode strategy on startup has to be preserved as well as any type of sites.

Data and persistence

N/A

[margondicco]

Hello @srenault-meeds

My first feedbacks

1-
In your screenshots, i can see some content (for the stream app, description, administrators, etc.) : just for the example ? Or can we define some default datas in the template

2-
For the function sav as template : i am not confortable with the button in the top bar. IMO it's a secondary functionality. Couldn't we propose an action in the space settings section?

Thank you

[srenault-meeds]

Sorry, I have to review it a little in fact. This is why I removed my last comment.

Regarding the content, only data like links, snv, image and preferences will be kept yes. Not the description IMO. Indeed, this can be too much personalized.

Regarding the option to save it as a template. I am not ok with you solution neither. Indeed, only platform admins can access this option. And some spaces can not provide de settings app (circle template for example).
The other solution I thought about was an option in the spaces management. Still, I found it too much hidden. This is why I proposed this option in the top bar. I will think about it more.

Thanks

[srenault-meeds]

@margondicco ok to check. Thanks

[margondicco]

Hello Go Fonc

[boubaker]

Ready for Tech review by DAO members (eXo : @rdenarie )