gs.group.about

The About box for a GroupServer group

Author:	Michael JasonSmith
Contact:	Michael JasonSmith <[email protected]>
Date:	2013-03-12
Organization:	GroupServer.org
Copyright:	This document is licensed under a Creative Commons Attribution-Share Alike 3.0 New Zealand License by OnlineGroups.Net.

Introduction

The About tab on the Group page provides some general information about the group. This product supplies two things: a viewlet for the Group page, and the change Page that allows the contents of the viewlet to be altered.

Viewlet

The About Viewlet is displayed in the main part the Group page [1]. Because the position of the About tab is so valuable multiple products may want to show there. To allow this the About viewlet contains a viewlet manager, gs.group.about.interfaces.IGroupAboutInfo, which other products can supply viewlets for:

<browser:viewlet
  name="a-thing"
  for="gs.group.base.interfaces.IGSGroupMarker"
  manager="gs.group.about.interfaces.IGroupAboutInfo"
  template="browser/templates/athing.pt"
  class=".athing.AThing"
  permission="zope2.View"
  weight="10"
  title="A Thing" />

The "normal" text of the About page is a viewlet that uses the IGroupAboutInfo manager. It gets its content from the aboutText property of the group. A more button [2] is used to stop the content of the About Viewlet overwhelming the page.

Another viewlet is used to link to Change Page if the viewer is a group administrator.

Change Page

The Change About page is a simple form that changes the aboutText property of the group. This module provides the Change page itself — and the link from the Properties list in the Admin tab on the Group page to the Change page. Most group-property pages can only be changed by the site administrator, but an exception is made for the About, which can be changed by the group administrator.

Resources

• Code repository: https://github.com/groupserver/gs.group.about
• Translations: https://www.transifex.com/projects/p/gs-group-about/
• Questions and comments to http://groupserver.org/groups/development
• Report bugs at https://redmine.iopen.net/projects/groupserver

[1]	See gs.group.home <https://github.com/groupserver/gs.group.home>

[2]	See gs.content.js.more <https://github.com/groupserver/gs.content.js.more>