Returns a tree of all groups and events.
If the moderation status filter is set then only groups with the given moderation status will be returned. If a group does not have the given moderation status and does have children then its children will not be returned.
If the parent group filter is set then only children of the specified parent will be returned.
array groups.getGroupTree ( int vhostID = 0, string moderationStatus = 'accepted', int parentGroup = 0, int groupType = NULL, mixed vhost = 0, mixed uid = 0, mixed removeEmptyChildNodes = 0 )
Type | Description | |||
---|---|---|---|---|
0 | The vhost ID that the group belong to. | |||
'accepted' | Only return groups with the specified moderation status'. If a group with children does not have the given moderation status the parent group and its children will not be returned. | |||
0 | The parent group ID if you only want the children of specific groups returned. | |||
NULL | This is used to specify a specific group type. If a group is not of the specified group type it will not be returned. If a group is a child of a group that is not of the specified group type, it will not be returned. This argument may be one or more of the following values: 1(groups), 2(events) 3(assignments) or null(return all groups, assignments and events). NB: You may specify multiple groupTypes. For example, passing '1,3' will return data for Groups and Assignments. | |||
0 | ||||
0 | ||||
0 |
The response will be an array of items of all groups and / or events from the vhost. Each parent will also include an array of all if its children too.
<?xml version="1.0" encoding="UTF-8"?> <result> <item> <id>9584</id> <name>Documentation</name> <description/> <note/> <logo>0</logo> <logo_height>0</logo_height> <logo_width>0</logo_width> <publicUrl/> <thumbUrl/> <url/> <created>2012-01-20 16:16:19</created> <createdBy>41799</createdBy> <memberCount>0</memberCount> <mediaCount>0</mediaCount> <approvedMediaCount>0</approvedMediaCount> <notDeniedMediaCount>0</notDeniedMediaCount> <geo_longitude>0</geo_longitude> <geo_latitude>0</geo_latitude> <moderationStatus>accepted</moderationStatus> <parentGroup>0</parentGroup> <address/> <city/> <country/> <state/> <postalcode/> <newMediaEmailTemplateID>0</newMediaEmailTemplateID> <host/> <groupType>1</groupType> <vhost>231</vhost> <other/> <custom1/> <treeleft>1</treeleft> <treeright>46</treeright> <email/> <children> <item> <id>9575</id> <name>Overview</name> <description/> <note/> <logo>0</logo> <publicUrl/> <thumbUrl/> <url/> <created>2012-01-20 12:13:12</created> <createdBy>41799</createdBy> <memberCount>0</memberCount> <mediaCount>0</mediaCount> <approvedMediaCount>0</approvedMediaCount> <notDeniedMediaCount>0</notDeniedMediaCount> <geo_longitude>0</geo_longitude> <geo_latitude>0</geo_latitude> <moderationStatus>unmoderated</moderationStatus> <parentGroup>9584</parentGroup> <address/> <city/> <country/> <state/> <postalcode/> <newMediaEmailTemplateID>0</newMediaEmailTemplateID> <host/> <groupType>1</groupType> <vhost>231</vhost> <other/> <custom1/> <treeleft>2</treeleft> <treeright>11</treeright> <email/> <children> <item> <id>9581</id> <name>Introduction</name> <description/> <note/> <logo>0</logo> <publicUrl/> <thumbUrl/> <url/> <created>2012-01-20 15:25:49</created> <createdBy>41799</createdBy> <memberCount>0</memberCount> <mediaCount>4</mediaCount> <approvedMediaCount>1</approvedMediaCount> <notDeniedMediaCount>3</notDeniedMediaCount> <geo_longitude>0</geo_longitude> <geo_latitude>0</geo_latitude> <moderationStatus>accepted</moderationStatus> <parentGroup>9575</parentGroup> <address/> <city/> <country/> <state/> <postalcode/> <newMediaEmailTemplateID>0</newMediaEmailTemplateID> <host/> <groupType>1</groupType> <vhost>231</vhost> <other/> <custom1/> <treeleft>3</treeleft> <treeright>6</treeright> <email/> <children/> </item> </children> </item> <item> <id>9574</id> <name>API Reference</name> <description>This is a description field to briefly describe what exactly the API Reference is for and how it should be used.</description> <note/> <logo>0</logo> <publicUrl/> <thumbUrl/> <url/> <created>2012-01-20 12:12:46</created> <createdBy>41799</createdBy> <memberCount>0</memberCount> <mediaCount>0</mediaCount> <approvedMediaCount>0</approvedMediaCount> <notDeniedMediaCount>0</notDeniedMediaCount> <geo_longitude>0</geo_longitude> <geo_latitude>0</geo_latitude> <moderationStatus>unmoderated</moderationStatus> <parentGroup>9584</parentGroup> <address/> <city/> <country/> <state/> <postalcode/> <newMediaEmailTemplateID>0</newMediaEmailTemplateID> <host/> <groupType>1</groupType> <vhost>231</vhost> <other/> <custom1>api</custom1> <treeleft>12</treeleft> <treeright>39</treeright> <email/> <children> <item> <id>9594</id> <name>Getting Started</name> <description/> <note/> <logo>0</logo> <publicUrl/> <thumbUrl/> <url/> <created>2012-01-24 10:21:49</created> <createdBy>41799</createdBy> <memberCount>0</memberCount> <mediaCount>0</mediaCount> <approvedMediaCount>0</approvedMediaCount> <notDeniedMediaCount>0</notDeniedMediaCount> <geo_longitude>0</geo_longitude> <geo_latitude>0</geo_latitude> <moderationStatus>unmoderated</moderationStatus> <parentGroup>9574</parentGroup> <address/> <city/> <country/> <state/> <postalcode/> <newMediaEmailTemplateID>0</newMediaEmailTemplateID> <host/> <groupType>1</groupType> <vhost>231</vhost> <other/> <custom1/> <treeleft>13</treeleft> <treeright>14</treeright> <email/> <children/> </item> </children> </item> </children> </item> </result>
{ "status": true, "result": [ { "id": "GROUP_ID", "name": "GROUP_NAME", "description": "", "note": "", "logo": "0", "logo_height": "0", "logo_width": "0", "publicUrl": "", "thumbUrl": "", "url": "", "created": "2012-01-20 16:16:19", "createdBy": "USER_ID", "memberCount": "0", "mediaCount": "0", "approvedMediaCount": "0", "notDeniedMediaCount": "0", "geo_longitude": "0", "geo_latitude": "0", "moderationStatus": "accepted", "parentGroup": "0", "address": "", "city": "", "country": "", "state": "", "postalcode": "", "newMediaEmailTemplateID": "0", "host": "", "groupType": "1", "vhost": "VHOST_ID", "other": [], "custom1": "", "treeleft": "1", "treeright": "46", "email": "", "children": [ { "id": "GROUP_ID", "name": "GROUP_NAME", "description": "", "note": "", "logo": "0", "publicUrl": "", "thumbUrl": "", "url": "", "created": "2012-01-20 12:13:12", "createdBy": "USER_ID", "memberCount": "0", "mediaCount": "0", "approvedMediaCount": "0", "notDeniedMediaCount": "0", "geo_longitude": "0", "geo_latitude": "0", "moderationStatus": "unmoderated", "parentGroup": "PARENT_GROUP_ID", "address": "", "city": "", "country": "", "state": "", "postalcode": "", "newMediaEmailTemplateID": "0", "host": "", "groupType": "1", "vhost": "VHOST_ID", "other": [], "custom1": "", "treeleft": "2", "treeright": "11", "email": "", "children": [ { "id": "GROUP_ID", "name": "GROUP_NAME", "description": "", "note": "", "logo": "0", "publicUrl": "", "thumbUrl": "", "url": "", "created": "2012-01-20 15:25:49", "createdBy": "USER_ID", "memberCount": "0", "mediaCount": "4", "approvedMediaCount": "1", "notDeniedMediaCount": "3", "geo_longitude": "0", "geo_latitude": "0", "moderationStatus": "accepted", "parentGroup": "PARENT_GROUP_ID", "address": "", "city": "", "country": "", "state": "", "postalcode": "", "newMediaEmailTemplateID": "0", "host": "", "groupType": "1", "vhost": "VHOST_ID", "other": [], "custom1": "", "treeleft": "3", "treeright": "6", "email": "", "children": [] } ] }, { "id": "GROUP_ID", "name": "GROUP_NAME", "description": "This is a description field to briefly describe what exactly the API Reference is for and how it should be used.", "note": "", "logo": "0", "publicUrl": "", "thumbUrl": "", "url": "", "created": "2012-01-20 12:12:46", "createdBy": "USER_NAME", "memberCount": "0", "mediaCount": "0", "approvedMediaCount": "0", "notDeniedMediaCount": "0", "geo_longitude": "0", "geo_latitude": "0", "moderationStatus": "unmoderated", "parentGroup": "PARENT_GROUP_ID", "address": "", "city": "", "country": "", "state": "", "postalcode": "", "newMediaEmailTemplateID": "0", "host": "", "groupType": "1", "vhost": "VHOST_ID", "other": [], "custom1": "api", "treeleft": "12", "treeright": "39", "email": "", "children": [] } ] }, { "id": "GROUP_ID", "name": "GROUP_NAME", "description": "TEST DESCRIPTION", "note": "", "logo": "0", "publicUrl": "", "thumbUrl": "", "url": "", "created": "2012-01-27 15:46:38", "createdBy": "USER_ID", "memberCount": "0", "mediaCount": "1", "approvedMediaCount": "0", "notDeniedMediaCount": "0", "geo_longitude": "0", "geo_latitude": "0", "moderationStatus": "denied", "parentGroup": "0", "address": "", "city": "", "country": "", "state": "", "postalcode": "", "newMediaEmailTemplateID": "0", "host": "", "groupType": "1", "vhost": "VHOST_ID", "other": [], "custom1": "", "treeleft": "47", "treeright": "48", "email": "", "children": [] } ] }