Kentico CMS 6.0 Developer's Guide

Enabling users to create groups

Enabling users to create groups

Previous topic Next topic Mail us feedback on this topic!  

Enabling users to create groups

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

You can enable site users to create new groups by placing the Community -> Groups -> Group registration web part on your site. You have to set the following properties of the web part:

 

Template source alias path - alias path of the document that will be used, together with the documents stored under it, as a template for groups created by the web part. If left empty, the value of the Site Manager -> Settings -> Community -> Group template path field will be used.

Template target alias path - alias path where the documents copied from the Template source alias path will be loaded when a group is created.

Automatically create forum - if checked, a forum group and a General discussion forum are automatically added under the created group.

Automatically create media library - if checked, a media library is automatically added under the created group.

Automatically create smart search indexes - if checked, a smart search index is automatically created for the documents of the created group, as well as for the new forum if the Automatically create forum property is enabled.

Group profile URL path - alias path of the page containing the group profile. The {groupname} wildcard can be used to substitute for the name of the current group.

Combine with default culture - if checked, the default culture will be used when creating group pages under a culture where the source or target nodes were not found.

Group name label text - text that will be displayed in the form before the field where the group name is entered.

Text after successful registration - text displayed when a group is successfully created.

Text after successful registration with approving - text displayed when a group is successfully created, but requires an administrator's approval to be published on the web.

 

Require approval - if checked, the group will have to be approved by a site administrator before it is published on the site.

Redirect to URL - URL where the user will be redirected after creating the group.

Hide form after registration - if checked, the form will be hidden after creating the group.

 

Group pages templates

 

Each group has its own section on the website where its content is stored - so called group pages. When adding the Group registration web part to your site, you have to specify the Template source alias path and Template target alias path properties. These two properties are essential when creating the group pages section of each group.

 

The page specified by the Template source alias path and all its sub-pages are copied to the location specified by the Template target alias path.

 

To get a better idea of how this works, you can take a look at our sample Community Starter site. On the site, the Group registration web part is configured the following way:

 

Template source alias path: /Groups/Template

Template target alias path: /Group-pages

 

As you can see in the screenshot below, there is the /Groups/Template page with one sub-page: Pages. When a new group is created, its title page is created under /Group-pages and the Pages page is created under it. As you have probably noticed, the web parts placed on the title page are identical to those placed on the Template page. Web parts on the Pages page are also identical to the source Pages page. Under Pages, all group documents will be stored.

 

devguide_clip0792
 
All Kentico CMS documents can be set to be owned by a group. This can be done by signing into CMS Desk, selecting a document from the content tree, switching to Edit mode and going to Properties -> General -> Owned by group and choosing a group from the drop-down list displayed after clicking the Change button. This property is used to identify which group a document belongs to and is used by various group context sensitive web parts to display the correct content. It also influences the editing permissions of Group administrator widget zones.

 

In Site Manager -> Settings -> Community, you can enable or disable the Use parent community group for new documents option. It you have it enabled, all newly created documents will inherit the group assignment from their parent document.
 
devguide_clip1076

 
Please refer to Community Site Guide -> Part 2 -> Creating the Groups section for a step-by-step tutorial on how to create a sample group pages section of a website.