| # Groups |
| |
| You can organize app users into groups. Groups have their own Activity Feed, their own permissions and be a useful alternative to Roles, depending on how you model your data. Groups were originaly designed to emulate Facebook Groups, so they will tend to function about the same way Facebook Groups would. |
| |
| Groups are hierarchical. Every member of the group /groups/california/san-francisco is also a member of the group /groups/california. |
| |
| Groups are also a great way to model things such a topic subscriptions. For example, you could allow people to subscribe (i.e. become a member of the group and be alerted via Activities) to /groups/memes/dogs/doge or subscribe to all /groups/memes/dogs |
| |
| |
| ### General properties |
| |
| Property Type Description |
| ---------- -------- --------------------------------------------------------------------------------- |
| uuid UUID Group’s unique entity ID |
| type string Type of entity, in this case “user” |
| created long [UNIX timestamp](http://en.wikipedia.org/wiki/Unix_time) of entity creation |
| modified long [UNIX timestamp](http://en.wikipedia.org/wiki/Unix_time) of entity modification |
| path string Valid slash-delimited group path (mandatory) |
| title string Display name |
| |
| ### Set properties |
| |
| Set Type Description |
| ------------- -------- --------------------------------------- |
| connections string Set of connection types (e.g., likes) |
| rolenames string Set of roles assigned to a group |
| credentials string Set of group credentials |
| |
| ### Collections |
| |
| Collection Type Description |
| ------------ ---------- ------------------------------------------------------ |
| users user Collection of users in the group |
| activities activity Collection of activities a user has performed |
| feed activity Inbox of activity notifications a group has received |
| roles role Set of roles to which a group belongs |
| |
| |
