There is no documentation provided for the og_register module. It can be a bit tricky to figure out how to set this up, as the user needs to change settings in 3 different locations.

PS There are no 'documentation' or 'og_register' components, so I filed this under og.module.

Files: 
CommentFileSizeAuthor
#11 og-add_og_register_docs-1307480-11.patch1.74 KBchrowe
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]
#6 1307480-6-og-add_og_register_docs.patch1.89 KBpfrenssen
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]
#1 1307480-1-og-add_og_register_docs.patch1.43 KBpfrenssen
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]

Comments

Status:Active» Needs review
StatusFileSize
new1.43 KB
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]

Here is an initial proposal for the documentation.

Status:Needs review» Needs work

@ pfrenssen, thank you for the patch.

+++ b/og_register/README.txtundefined
@@ -0,0 +1,21 @@
+3. On the same page add the 'Groups audience' field to the user entity.

It's already there, so this isn't needed.

+++ b/og_register/README.txtundefined
@@ -0,0 +1,21 @@
+5. Go to admin/config/people/accounts/fields/group_audience and check the option

This isn't needed.

Version:7.x-1.x-dev» 7.x-2.x-dev

There is no README.txt in the folder og_register in the two branches of OG.

where is it?

> where is it?

It doesn't exist, because the patch isn't finsihed. I encourage you to help fixing the patch based on #3

StatusFileSize
new1.89 KB
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]

I just worked a bit on this. I now have the benefit of not having done this in the past 8 months, and found my own documentation to be too short and cryptic. I have added clearer step-by-step instructions.

However when I started addressing the remarks in #3 I ran into a few oddities which are probably due to changes that have been made to the 7.x-2.x branch.

Unfortunately I don't have time to look further into this at the moment, but I'll attach my patch in progress since there were some improvements made. The remarks in #3 still need to be addressed in this, and the instructions need to be verified properly against 7.x-2.x. Maybe it would be better to do this the other way round and finish the documentation first for 7.x-1.x and then forward port to 7.x-2.x.

USAGE...
Correct group >Group Register instead of 'group content > Groups audience

+2. Add the 'Group register' field to your group node entity:
+ - Go to Configuration > Organic Groups > OG Field Settings
+ (admin/config/group/fields).
+ - Open the 'Bundles' drop down menu and select your group node entity (e.g.
+ 'node > Group').
+ - Open the 'Fields' drop down menu and select 'group content > Groups
+ audience'.
'group >Group Register'
+ - Click on 'Add field'.

Point 3 unchanged, correct group audience.

@EuroDomenii , can you please re-roll this patch?

Issue tags:+commonslove

I don't think this method works anymore with the latest version of og. at least not with commons.

this is not working for me. following the instructions i was able to get a "group membership" dropdown menu on the registration page, but the only option in the menu is "none".
OG 7.x.2.x
Commons 7.x.3.x

also, i dont think the change in #7 is correct, at least not for 7.x.2.x. What that did when i tried it was to add a checkbox on the registration form itself that asked whether or not to display on registration form.

StatusFileSize
new1.74 KB
PASSED: [[SimpleTest]]: [MySQL] 846 pass(es).
[ View ]

Here is my attempt at a patch. I ran it against 7.x-2.2 but it seems to work with dev as well.

Changes for #6:

  1. Removed anything related to the Groups audience since that does not seem to be required
  2. Moved the step to add the field to the user register form up since that seemed more logical to me and explained it a little more.

DESCRIPTION
-----------
The Organic Groups Register module allows users to choose a group on
registration. This can work both for users that register themselves as for users
that are created by administrators.

USAGE
-----
These instructions assume you already have set up some groups. Refer to the
main documentation for details on how to do this.

1. Enable Organic Groups Register at Modules (admin/modules).
2. Add the 'Group register' field to your group node entity:
- Go to Configuration > Organic Groups > OG Field Settings
(admin/config/group/fields).
- Open the 'Bundles' drop down menu and select your group node entity (e.g.
'node > Group').
- Open the 'Fields' drop down menu and select 'Group > Group
register'.
- Click on 'Add field'.
3. Add field to user registration form
- Go to Configuration > People > Account settings > Manage fields
- Edit the 'Group membership' field.
- Select 'Display on user registration form.' and save.
4. Choose groups to show on the registration page.
- By default the 'Group register field' is set to 'Do not show on registration page' on the Group content type. To change this go to admin/structure/types/manage/group/fields/group_register and change the default value to 'Show on registration page'. Then all new groups will get added to the user registration page automatically.
- Choose per group. Go to admin/content and edit the group node entities you want enabled on the
registration form. For each node locate the 'Group register' field and set it
to 'Show on registration page'.

Status:Needs work» Needs review

Correct status

the steps in #11 seem well formulated and clearly described. BUT when i do them, STILL the only item in the in the dropdown menu on the registration form is "none", though I know I have a number of groups configured to 'Show on registration page'.
Is this working for others??

Status:Needs review» Needs work

+++ b/og_register/README.txt
@@ -0,0 +1,31 @@
+4. Choose groups to show on the registration page. ¶
+   - By default the 'Group register field' is set to 'Do not show on registration page' on the Group content type. To change this go to admin/structure/types/manage/group/fields/group_register and change the default value to 'Show on registration page'. Then all new groups will get added to the user registration page automatically.

Since the rest of the file is wrapped to 70 chars, this bit should be too.

I'm actually still rather confused how to use this.

I want users to be able to register & join the group, from the group page. I don't need functionality during the general user registration process.

I've added the Group register field to my group nodes, and set its formatter (this step needs to be added to the README, btw), but I'm not seeing any output.

I can't seem to get this working despite following #11. Tried inspecting and it seems the culprit is here. Printing $group_type . '.' . $entity_info['entity keys']['id'], I get node.nid. Checking the query, I get this:

SELECT field_data_group_group0.entity_type AS entity_type, field_data_group_group0.entity_id AS entity_id, field_data_group_group0.revision_id AS revision_id, field_data_group_group0.bundle AS bundle FROM field_data_group_group field_data_group_group0 WHERE (field_data_group_group0.group_group_value = '1') AND (field_data_group_group0.deleted = '0') AND (field_data_group_group0.entity_type = 'node') AND (field_data_group_group0.bundle IN ('course_group', 'group', 'conceptual_lab_group')) AND(( ( EXISTS (SELECT na.nid AS nid FROM node_access na WHERE (( (na.gid = '0') AND (na.realm = 'all') ))AND (na.grant_view >= '1') AND (field_data_group_group0.entity_id = na.nid) )) AND (field_data_group_group0.entity_type = 'node') )OR (field_data_group_group0.entity_type <> 'node') )

There isn't any reference to node.nid and it doesn't get to lines 75-76. I'm using OG 7.x-2.1 btw but there doesn't seem to be any changes on og_register on 7.x-2.x.

Edit: Nevermind, upgrading to 7.x-2.2 resolves it. Had a different culprit.

These steps still do not work for me. Are they working for anyone else??
One question/idea i have is whether there is a missing step in configuring the field and its widget?

+3. Add field to user registration form
+   - Go to Configuration > People > Account settings > Manage fields
+   - Edit the 'Group membership' field.

^^^^is there more that needs to be done at this stage?

I really do not understand what most of the OG settings are, but one thing I noticed is that changing the "Target type" from "taxonomy term" (which was the default in my case) to "node", then i get some different behaviors. That change still does not put the info on the registration form, but it does then give me checkboxes on the edit-profile page (user//edit-profile). But the checkboxes seem to have no effect; checking a group does not result in the user becoming a member of the group.

@joachim, I am able to register users from the group's page by clicking on the "follow" button. I don't remember what configuration, if any, I had to do for that functionality. offhand, i think that worked out of the box for me, but i'm not sure.

I'm seeing the same thing as @WebSinPat - the dropdown shows up on the registration menu, but the only option is 'none' regardless of how many groups are configured to show. Using OG 7.x-2.3.

Updated: in my case, the problem seems to be a conflict with the current version of File Entity (7.x-2.0-alpha1). I do see the correct options if I a) roll back to the previous version of FE, b) give all users permission to bypass file access controls, or c) disable FE altogether--since it's not currently mission critical for me, that's what I'm doing.

With that resolved, the steps above worked just fine.

Version:7.x-2.x-dev» 7.x-2.3

I just upgraded Organic Group to 7.x-2.3 because I didn't succeed to make it work with my previous 7.x-2.1

I now could see my groups in the registration page, but only Public ones !
I need to see also private ones. Any idea ?

@dsdeiz : Could you see Private Groups in the registration page or only public ones ?
Because in my sites which has 7.x-2.3 I could only see public ones.

This is now working for me after upgrading to Commons 3.3.

-I am able to select groups on the registration page when a new member registers for the site
- groups that i select do have that new member added to the group membership (depending on permissions, the user is either added or request for membership is added to moderation queue)

For some reason I can only get this to work if an admin is adding a new user. It doesn't show up on the registration form for anyone else. I've played with the OG permissions but that hasn't made a difference. Is there something else I have to do?

Edit: I found that if I enable "Administer Organic groups permissions" under the Drupal user permissions then non-admin users can add people to a group.

I am pretty confused about this.

I am going to migrate from D6 to D7.
In D6, there was exactly on node (organic group) settings an option to check "show this Organic Group on registration form".
This was easy to understand and easy to set 6 "the most interesting groups" on user registration form.

Is it possible to do this? to choose 6 organic groups which will be on user registration form?

As far I understand current settings, I have to do this:
1. There is no readme for this submodule
2. On admin accounts - fields page I need to edit Entity reference "Group membership"
However, I finish here.
There is no option to choose which organic groups I want to have on registration form.

Does it really work properly or am I missing something? Can somebody give me a hint?
I am pretty surprised why something what worked correctly have to have a lot of different settings on various places and it is pretty hard to undersand whole context, just for selecting organic groups which will be visible on registration form...

I have small success. I found that I have to add another Entity reference field, this time not on into user account fields as before but on content type Group fields.

So I added Entity reference - checkboxes/radios field there (on group content type - fields) , and now while I am editing some group, I can see the option to select group which will be available on registration form.
Hurrah :)

But... I am confused again of that, because I would expectating just one single checkbox show/not show on registration form, but here I have to choose the group (which I currently editing) from all available groups on radio buttons.
This is probably not right usecase, I hope that group I am editing will be selected by default, and other groups will be not there.
Especially when I have hundreds groups, it would be a big mess to have anything like this.

However, after selecting of the editing group as it will be on registration form, it still doesn't work for me.
I have no option (no checkbox and no group name) on user registration form....

Issue summary:View changes

This took me a long time to get working. The steps in post 11 are correct, but I found them a little too concise for me. For anyone else having a similar problem following the steps I have written a longer set of instructions with screenshots.

I have also added these instructions to the Drupal Community Documentation.

@paultrotter50, thanks for the detailed documentation.