E-Democracy Pages Wiki

Search Wiki

 

Tools

 

GroupServer Object and Interface Index

From E-Democracy.org

Revision as of 13:32, 2 July 2013 by Wbushey (Talk | contribs) (GSGroupInfo)

GroupServer has many objects, interfaces, and components. This page serves as an incomplete list and quick reference of the data structures of GroupServer. In many cases, a brief description of the structure's purpose and listing of its properties/methods is provided. In general, the EGG-INFO/PKG-INFO of the structure's egg will provide much more detail, and will probably be more current. And of course, there's the code itself.

Groups, Group, and GroupMembers

GSGroupsInfo

Package: gs.groups.groupsInfo.GSGroupsInfo

ZCA Name: groupserver.GroupsInfo - adapter

Provides info/access for all groups on the site, and creates lists of groups based on user membership.

  • .get_all_groups()
  • .get_visible_groups() - Returns all groups visible to the logged in user
  • .get_visible_group_ids() - Returns ids of .get_visible_groups()
  • .filter_visible_groups_id(gIds)
  • .clear_groups_cache()
  • .get_non_member_groups_for_user(user)
  • .get_joinable_groups_for_user(user)
  • .get_joinable_group_ids_for_user(user)
  • .get_member_groups_for_user(user, authUser=None) - Returns a list of groups the user is a member of. If "user" is the same as the "authenticatedUser", then the list will be of all groups that "user" is a member of. Otherwise only the groups that the user is a member of, and has posted to, will be listed.

IGSGroupInfo

Package: Products.GSGroup.interfaces.IGSGroupInfo

Declares basic properties of a group:

  • group_exists()
  • get_id()
  • get_name()
  • get_url()
  • get_property(prop, default)

GSGroupInfo

Package: Products.GSGroup.groupInfo.GSGroupInfo

ZCA Name: groupserver.GroupInfo

Implements IGSGroupInfo and provides the following constructor:

  • __init__(self, context, groupId=None): If no groupId, the group will be figured out by acquisition.

Additional properties/methods provided:

  • groupObj
  • description
  • relativeURL
  • group_type
  • ptn_coach
  • group_admins
  • group_stats
  • site_admins
  • joinability

IGSGroupMembersInfo

Package: Products.GSGroupMember.interfaces.IGSGroupMembersInfo

Declares properties related to the set (and subsets) of members of a group.

  • groupInfo
  • siteInfo
  • members
  • fullMembers
  • fullMembersCount
  • invitedMembers
  • invitedMembersCount
  • etc...

GSGroupMembersInfo

Package: Products.GSGroupMember.groupMembersInfo.GSGroupMembersInfo

IGSMailingListInfo

Package: Products.GSGroup.interfaces.IGSMailingListInfo

  • is_moderated
  • is_moderated_new
  • get_moderators
  • get_moderatees
  • get_blocked_members

GSMailingListInfo

Package: Products.GSGroup.mailinglistinfo.GSMailingListInfo

ZCA Name: groupserver.MailingListInfo

Implements IGSMailingListInfo. Also includes an instance of the Mailing List Manager for the group as .mlist.

Site Objects

IGroupserverSite

Package: Products.GroupServer.interfaces.IGroupserverSite

Simple interface for a GroupServer site folder.

Provides:

  • get_site()

GroupserverSite

Package: Products.GroupServer.GroupserverSite

Implements IGroupserverSite and subclasses OFS.OrderedFolder.OrderedFolder.

IGSSiteInfo

Package: Products.GSContent.interfaces.IGSSiteInfo

A marker interface.

GSSiteInfo

Package: Products.GSContent.view.GSSiteInfo

ZCA Name: groupserver.SiteInfo

Implements IGSSiteInfo.

Provides the following properties:

  • id
  • name
  • title
  • url
  • site_admins
  • showImage - Don’t know what this does
  • skin

Also provides:

  • siteObj
  • config
  • get_path
  • get_support_email
  • get_property(prop, default=None) - Convenience method for .siteObj.getProperty(prop, default)

User Objects

IGSUserInfo

Package: Products.CustomUserFolder.interfaces.IGSUserInfo

ZCA Name

  • groupserver.UserFromId - Factory based on a provided user ID
  • groupserver.LoggedInUser - Factory returned the logged in user

Declares methods to get available information about individual users.

  • get_id
  • get_profile_url
  • get_names
  • get_display_name
  • get_image_url
  • get_groups
  • get_email_address_visibility
  • get_all_email_addresses
  • get_preferred_email_addresses
  • get_timezone

GSUserInfo

Package: Products.CustomUserFolder.userInfo.GSUserInfo

Implements IGSUserInfo and adapts ICustomUser. However, the methods declared by IGSUserInfo are not defined.

ICustomUser

Package: Products.CustomUserFolder.interfaces.ICustomUser

Appears to be a marker interface

CustomUser

Package: Products.CustomUserFolder.CustomUser.CustomUser

Inherits from User and Folder, and implements ICustomUser

  • get_image(url_only=True) - Returns the image of a user, or just the url by default.

IGSEmailUser

Package: gs.profile.email.base.interfaces.IGSEmailUser

Represents a user who can add and remove email addresses to and from their profile. Also allows user to manage other settings related to email delivery.

Methods

  • add_address
  • remove_address
  • is_address_verified
  • get_addresses - Returns a list of all email addresses associated with the user
  • get_verified_addresses
  • get_unverified_addresses
  • get_delivery_addresses - Returns default delivery email addresses
  • set_delivery
  • drop_delivery

EmailUser

Package: gs.profile.email.base.useremail.EmailUser

ZCA Name

  • groupserver.EmailUserFromEmailAddress - Returns an EmailUser based on a provided email address string

' Factory

  • gs.profile.email.base.useremail.EmailUserFromUser(ICustomUser)'

Implements IGSEmailUser and Adapts IGSUserInfo

ACL User

Retrieving ACL User by Email

user = context.acl_users.get_userByEmail(email)

Properties of ACL User

  • user.getId() - User ID
  • user.getProperty(<string>, <string>) - General Properties
 

Home - Mobile - Forums - Wiki - Blog - About - Help - Contact - People - Donate - Rules - Archives