 readme  id readmetxt v 16046 20090922 030430 weitzman exp description enable users to create and manage their own groups each group can have members and maintains a group home page where members can post into posts may be placed into multiple groups ie crossposting and individual posts may be shared with nonmembers or not membership to groups may be open closed moderated or invitation only addon modules are available for group image galleries group calendars group vocabulary group stores and so on groups may choose their own theme and language groups have rss feeds and email notifications and so on group admins may customize the layout and contents of their group home page and add additional custom pages requires the upcoming og panels module installation enable the organic groups and organic groups views integration modules if you want to protect some posts so that only certain users may view them enable the organic groups access control module as well please make sure og is working well on its own before enabling other og related modules on the administer organic groups configuration page see the content types table at the top click edit beside each type to set its usage disable comments and attachments for node types which are designated as group nodes you usually want to create a new node type via admin content types page and then designate that content type as a group node see the first item in notes below set other preferences on admin og og as desired it may take some experimenting before you arrive at a configuration well suited to your needs on the administer site building blocks page enable the group details and drag it toward the top of your list optionally enable the other group blocks grant permissions as needed on the admin user permission page begin creating groups visit the node add page joining those groups and posting into those groups the join link appears in the group details block for non inviteonly groups consider enabling the following modules which work well with og pathauto locale notifications after your install is working nicely consider enabling more og addon modules like ogmandatorygroup ogvocab and ogpanels those are known to work well with og some of the others on drupalorg are poorly integrated and will cause problems see http drupalorg project modules category 90 notes this module supports designating any content type to act as a group this content type should be defined by a custom module or via the admin content types page when defining your type you usually want the title label to be group name and the body label to be welcome message since all nodes of this type are treated as groups you will usually not want to designate the standard page story or book node types as groups the feature where custom content types may act as groups enables you to have custom fields for your groups and even different cck fields for different kinds of groups ie content types there are a few handy tabs at the path group you might want to add a link in your navigation to that url each tab also provides a useful rss feed administer nodes permission is required for changing the manager of a group do so by changing the posts author administer nodes permission enables viewing of all nodes regardless of private public status all membership management happens on the membership list page which is linked from the group details block while viewing a group page this includes approving membership requests for selective groups adding removing users and promoting users into group admins if you decide to stop using organic groups just disable it as usual if you ever decide to reenable all your prior group access control information will be restored if you want to start fresh uninstall og ogviews and ogaccess modules developers site builders you may craft your own urls which produce useful behavior for example user register gids 4 will add a checked checkbox for to the user s registration page for subscribing to group nid 4 this feature overrides the usual preference for groups to always appear during registration you may alter the links in the group details block using hookoglinksalter links groupnode see ogblockdetails the current group context is available to javascript code at drupalsettingsog this is useful for enriching ad tags and analytics calls with group information use views bulk operations module to mass update user memberships and also content affiliations themes you may wish to stylize nodes which have properties assigned by this module public vs private posts are denoted by node ogpublic ogaccess provides private posts provided in this package are two template files which are in use by default for both groups and group posts these can be starting points for your customization of look and feel of your group to customize copy one or both to your theme directory and edit as desired your theme directory must also impement nodetplphp for your overrides to be recognized or you might use the ogpanels module to achieve custom group homepages and other group pages that group admins can design themselves integration i recommend enabling the cron features of notifications messaging modules when you do group email notifications are sent during cron runs instead of immediately after a post is submitted this speeds up posting a lot for big groups the delay also helps authors fix typos in their posts before the mail is sent this module exposes an api for retrieving and managing membership via direct php functions ogsavesubscription and via xmlrpc unit testing this module comes with a few unit tests please help update and build more of them see http drupalorg simpletest todo bugs feature requests see http drupalorg project issues og please search before filing issues in order to prevent duplicates upgrading from 50 to 6x the upgrade autoenables the new ogviews module this is needed to get the same functionality that was present in d5 there is no support for migrating custom views please redo those in views2 you might need to use a relationship group members block og 2 block is now served by views views ogmembersblockblock1 group search is now in its own block which must be enabled manually it used to be integrated into the group details block upgrading from 47 to 5x you must update to 5x before updating to 6 credits authored and maintained by moshe weitzman contributors gerhard killesreiter angie byron derek wright thomas ilsche ted serbinski damienvancouver sponsored by bryght http wwwbryghtcom sponsored by broadband mechanics http wwwbroadbandmechanicscom sponsored by finnish broadcasting company http wwwylefi fbc sponsored by post carbon institute http wwwpostcarbonorg  