Last updated December 11, 2012. Created on September 11, 2005.
Edited by pc-wurm, silverwing, will_in_wi, Amir Simantov. Log in to edit this page.

Drupal 7

Documentation for Drupal 7.x-1.x is here.
Documentation for Drupal 7.x-2.x is here.

Drupal 6 and lower

You can:

  • enable organic group creation and administration permissions at administer >> user management >> permissions.
  • create organic groups at create content >> group.
  • view a list of organic groups at groups.
  • administer organic group at administer >> settings >> og.
  • disable commenting and attachments for nodes of type group at administer >> content management >> content types >> edit "group".
  • enable group details block, group subscriber block, new groups block, and my groups block at administer >> site building >> blocks.
  • if configured, subscribe to groups by selecting the subscribe link in the group block.
  • create content, invite friends, manage subscriptions, view list of subscribers, and see the group administrator in the group block.
  • enable images in the group details block if you have the image module installed.
  • file issues, read about known bugs, and download the latest version on the Organic Groups project page.

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.

Comments

skor’s picture

  1. Make sure you've downloaded and extracted the Views module into your /sites/all/modules directory, and enabled Views and Veiws_RSS under Admin>>Site Building>>Modules.
  2. Download and extract the Organic Groups Module into your sites/all/modules directory
  3. Go to Admin>>Site Building>>Modules and enable the OG module
  4. Go to Admin>>Content Management>>Content Types and create a new content type. I entered the following:
    • Name = Group
    • Type=Groups
    • Description=A collection of people with a common goal
    • Title field label=Group Name
    • Body field label=blank
    • Minimum number of words = 0
    • Explanation or submission guidelines = blank for now
    • Default Options= Published, Not Promoted, Not Sticky, Don't create new revisions
    • Default comment settings = Disabled
    • Save Content Type
  5. Go to Admin>>Organic Groups>>Organic Groups Config and:
    • Access Control: Enable/Disabled your choice (I need to read up on this some more. I've used Taxonomy_Access in the past)
    • Group Details: Pretty self explanitory
    • Node authoring form: Whatever seems right to you. Under Omitted Content Types, you'll probably want to select the "Group" content type you created above, but that might happen automatically after the next step
    • Group home page: Under Group home page node types, pick your Group Content type you created above.
    • Email settings: as desired
    • Member pictures: as desired

Now you can go to Create Content>>Group and create your first group.

Updated 1/27/07: to reflect 5.0 installation of contrib modules into /sites/all/modules instead of /modules

ralphjohnson’s picture

Type = groups (must be lowercase).

Thanks for the step-by-step. Seems to work well.

m1k83l’s picture

To upgrade from 4.7, I had to name the type 'og' instead of 'groups.'

Matthew OMalley’s picture

Right after step 5 and before creating content, you also need to go to Admin>>User Management>>Access Control and set certain roles to create and edit and edit own Groups.

______________________
Grand Junction Design, LLC
Web and Print Design For
Nonprofits and Foundations

______________________
Grand Junction Design, LLC
Web Strategy for Social Change

drupal92037’s picture

Setup under Drupal 6 is similar to instructions for 5.0 (above), but when creating a new content type, you don't have to enter "Groups" in the Type field. Instead, at the bottom, there is a checkbox for designating the content type as a group node.

Also, the content type's Name field doesn't have to be set to "Group". It can be anything you want.

Stomper’s picture

Hi,

Is this process required for Drupal 6? I do not have a "Group" content type as stated here (http://drupal.org/handbook/modules/og).

Odd, because I thought enabling the OG module would do this process automatically.

Thanks

jenlampton’s picture

In Drupal 6 the 'Group' content type is not provided for you.

You'll need to create the content type yourself (you can call it whatever you like) and in the "Organic groups" field set, Organic groups usage to "Group node".

drupalcat’s picture

Maybe This step by step will help you.

Setting up Organic groups configuration

* go to module configuration
* go to Organic groups configuration
* go to "Group home page" and expand
* there will be a list of "Group home page node types:" you will need to add a "group" node type
* click the link that states "create a simple node type" at the bottom of the page
* click the link that states "Add content type"
* fill in fields make "type" called "group"
* return to "Organic groups configuration" page in module configuration expand "Group home page"
* you should now see a "group" field for selection highlight it and save configuration

Setting up URL alias configuration for groups

* go to module configuration
* go to URL aliases
* click "add alias" link
* Existing system path: = node/add/group and og/add
* click "update alias" button

Organic groups access control

* go to administration
* go to "Organic groups configuration"
* pull down "Access control"
* click "Enable" button to enable access control for post to controlled groups

kpm’s picture

* go to module configuration
* go to URL aliases
* click "add alias" link
* Existing system path: = node/add/group and og/add
* click "update alias" button

I am a bit confused with this, right now if I navigate to node/add/group I am taken to the correct location, the correct add group page of the content type group that I created. If I navigate to og/add I am taken to the add view page. These are two different locations, am I misunderstanding something? Won't you loose access to the node/add/group if you alias it to the og/add which would then bring you to the views page when navigating to /node/add/group??

NikLP’s picture

...that this is referring to "these are the existing aliases for OG, alias them to what you want", not alias one onto the other :)

Kineta Systems - Web Development in Nottingham

jcade’s picture

I cannot get the content type that is associated with my group (in this case, Story) to show up on my groups page, even when selecting that group as the audience for the post. What in the world am I missing?!

I want the entire post to show up.

SAFW’s picture

Add me to the list, did something break under 6x-1.1? If anyone can offer pointers it would be much appreciated!

wingie’s picture

Does anybody know how it would be possible to make sure a user can join ONLY one group and not any more?

sandipdev’s picture

I have a problem. Just installed OG. Now SMTP server is not working on my system.Its just a Win XP machine. I have created a few groups. Now when a user tries to join a group by click on Request to Join, it says that the request has been sent for approval by administrator. However, I dont find any request anywhere when I log in as admin. It not under notification or messages or anywhere else. I have changed the request method to web. But nothing seems to be working. Pls help.

I believe...whatever doesn't kill you, makes you.......stranger

zchandler’s picture

I am trying to make OG easier for my users, and the Invite functionality is the piece that needs (imho) to be exposed better. (In this context all groups are Moderated, so Invite is always applicable.)

My plan is to redirect users to the OG Invite page after group node creation ... which is where I am currently stuck. Moshe could no doubt do this one-handed and blind-folder, for me it's a stumper.

I already tried FormAPI $form['#redirect'] (see http://drupal.org/node/134000#comment-1556220) but since that value can only do fixed paths, I can't come up with a way to use it so that it ends in the appropriate /$gid.

Here's the og.module function for making the Invite Page:

function og_invite_page($gid) {
  $node = node_load($gid);
  if ($node->og_selective < OG_INVITE_ONLY || og_is_node_admin($node)) {
    return drupal_get_form('og_invite_form', $gid);
  }
  else {
    drupal_access_denied();
  }
}

So presumably I could get there with some custom module magic, but that is just outside my current expertise level.
Any suggestions out there in the Drupalverse?

joshk’s picture

------
Personal: Outlandish Josh
Professional: Pantheon

SheilaRuth’s picture

According to the page above, "You cannot use this module with other node access modules." However, the link points to a 4 year old post. Does anyone know if this is still true? In Drupal 6.x, can Organic Groups co-exist with Taxonomy Access Control?

NikLP’s picture

I spoke to Moshe about this (in very little detail) recently, and I think the "modern" take on it is that you can indeed integrate OG with node access modules, as long as you're aware of the caveats of the access control system. Obviously, there are potential pitfalls and limitations of this. Be sure to read up about Drupal's access control system, which may help you decide which, if any, access control module is best for your particular use case.

SheilaRuth’s picture

Thanks!

roball’s picture

I have asked the same half a year ago in the issue queue at #384094: Compatibility with the "ACL" module without any response. Nevertheless, I am now running OG 6.x-2.0-rc3 together with ACL 6.x-1.0 and Content Access 6.x-1.1 and did not observe an incompatibility yet.

-- Robert Allerstorfer

Taxoman’s picture

We need more confirmations that OG2.x is playing nicely along with the ACL framework for Drupal6, especially here on this handbook page as to ensure people that it is stable and well working especially in regards to security etc.

pivey’s picture

How about updating the setup instructions for latest D6?
Like many other modules... you need hours to figure out how to setup and use them

bbass’s picture

I'm using the Organic Groups module to create a collaborative workspace for a very specific purpose, so I would like to go ahead and populate each new group with a particular set of content types and display those as a menu regardless of their states of completion. I'm having a lot of trouble with this and wonder if there's something I don't understand - will I need to use PHP in the menu links (that is, $gid or something to that effect)? Or any other general tips?

skizzo’s picture

Just in case you are looking for it... here is a nice tutorial on D6 OG setup (May 2009)

http://groups.idcminnovations.com/articles/setting-drupal-organic-groups

developer-x’s picture

Here are some tips that I came away with having knocked around OG:

1. If you append ?gids[]= to the add node url, it will automatically select the organic to post to. For example:

node/add/post?gids[]=1

This will bring up the "Add Post" page with the Audience preselected to the OG with a nid of 1

2. If you are using Panels with OG and you want to have a PHP based visibility rule to display a block based off of membership, you can use this code :

$object = $contexts ['argument_nid_1'];
$object = $object->data;
return og_is_group_member($object->nid);

3. Node gallery module is a great module for uploading multiple images - but if you want to include the uploaded files into a block within group, you will need to extend the OG views. I won't go into how to extend a view, but here are the view extension definitions I used to include the Node Gallery:

$data['og_ancestry']['node_galleries_gid']= array(
'real field' => 'nid',
'title' => t("Gallery Image from OG"),
'relationship' => array(
'title' => t("Gallery Image from OG"),
'help' => t("Bring in node gallery's images based off an OG"),
'base' => 'node_galleries',
'base field' => 'gid',
'relationship field' => 'nid',
'handler' => 'views_handler_relationship',
'label' => t("Gallery Image from OG"),
),
);
$data['node_galleries']['gid']['field'] = array(
'handler' => 'views_handler_field_numeric',
);

I hope somebody finds these tips useful

- x

siva_qus’s picture

When I create a group and some one post a comment or entry for that groups , the entry will repeat 2 or 3 times. And the group display also repeat 2 or more times , if I am manager of that group. how do i avoid this.

Thanks

Siva

adam42’s picture

Hi there!

I'm setting up an Open Atrium site where organic groups - of course - are in use (in the 6.x-2.1 version)...

I want to hide the groups from the registration form. How-to?

Cheers
Adam

Abraham Heinemann’s picture

I have used OG in D6 with minor problems, however in D7 I have the following:

- We wish to be able to create Group content that is specific to a Group
- Have links to creating this content appear in a menu in each Group
- Convert existing content into Group content (e.g. forums/topics)
- etc

In D6 one is given certain blocks automatically to deal with the first two objectives such as the Group details: http://drupal.org/node/667822 and og_menu block. I have setup Panels, but cannot seem to find a way to replicate these blocks in D7 that come with OG automatically in D6.

Is this because OG is not installed properly (because there is no report or errors saying it isnt)? Or is this because I am unaware of how to do it? (It cannot be simple as I have investigated a fair few possibilities through the Drupal UI)

Thankyou

giorez’s picture

I have the same need

Netrics’s picture

Personally I am very disappointed with OG in D7, compared to D6. There is a reason why the official Drupal Groups is still running on D6. I hate to have to use D6 these days, but if it is a site that would make good use of OG it will always have to be with D6 until they fix a lot of the issues in both 7.1 and 7.2 of OG.

Jason Maggiacomo, Senior Web Developer/Designer @ Humber College (Toronto, Ontario)
Latest Drupal Project: Humber College

chaosmind’s picture

Sorry if this question seems a little thick, but where is the documentation for Organic Groups for Drupal 7?

From the Organic Groups project page, I click on the Documentation link, and am taken to this page, which seems to have two glaring shortcomings. One, it is marked "Deprecated," and two, it says that it applies to Drupal versions 4.7 through 6.

I've found a number of video tutorials for Organic Groups, but they tend to fall into two broad categories: videos for OG under Drupal 6, and videos explaining the differences between the old and the new versions (in other words, tutorials that aren't of much use if you've never used OG before).

Is there some "Getting started with Organic Groups under Drupal 7" documentation I'm just not finding??? TIA for any pointers!

Nil Gravitas’s picture