Update documentation of mod_shared_roster (#3214)

This commit is contained in:
Badlop 2020-04-16 13:12:32 +02:00
parent c11922e2a2
commit 0705695e02
1 changed files with 16 additions and 15 deletions

View File

@ -1228,9 +1228,10 @@ mod_doc() ->
"not replace the standard roster. Instead, the shared roster " "not replace the standard roster. Instead, the shared roster "
"contacts are merged to the relevant users at retrieval time. " "contacts are merged to the relevant users at retrieval time. "
"The standard user rosters thus stay unmodified."), "", "The standard user rosters thus stay unmodified."), "",
?T("Shared roster groups can be edited only via the Web Admin. " ?T("Shared roster groups can be edited via the Web Admin, "
"Each group has unique identification and those parameters:"), "", "and some API commands called 'srg_*'. "
?T("- Name: The group's name will be displayed in the roster."), "", "Each group has a unique name and those parameters:"), "",
?T("- Label: Used in the rosters where this group is displayed."),"",
?T("- Description: of the group, which has no effect."), "", ?T("- Description: of the group, which has no effect."), "",
?T("- Members: A list of JIDs of group members, entered one per " ?T("- Members: A list of JIDs of group members, entered one per "
"line in the Web Admin. The special member directive '@all@' " "line in the Web Admin. The special member directive '@all@' "
@ -1240,7 +1241,7 @@ mod_doc() ->
"represents the online users in the virtual host. With those " "represents the online users in the virtual host. With those "
"two directives, the actual list of members in those shared " "two directives, the actual list of members in those shared "
"rosters is generated dynamically at retrieval time."), "", "rosters is generated dynamically at retrieval time."), "",
?T("- Displayed groups: A list of groups that will be in the " ?T("- Displayed: A list of groups that will be in the "
"rosters of this group's members. A group of other vhost can " "rosters of this group's members. A group of other vhost can "
"be identified with 'groupid@vhost'."), "", "be identified with 'groupid@vhost'."), "",
?T("This module depends on 'mod_roster'. " ?T("This module depends on 'mod_roster'. "
@ -1274,8 +1275,8 @@ mod_doc() ->
[{?T("Take the case of a computer club that wants all its members " [{?T("Take the case of a computer club that wants all its members "
"seeing each other in their rosters. To achieve this, they " "seeing each other in their rosters. To achieve this, they "
"need to create a shared roster group similar to this one:"), "need to create a shared roster group similar to this one:"),
["Identification: club_members", ["Name: club_members",
"Name: Club Members", "Label: Club Members",
"Description: Members from the computer club", "Description: Members from the computer club",
"Members: member1@example.org, member2@example.org, member3@example.org", "Members: member1@example.org, member2@example.org, member3@example.org",
"Displayed Groups: club_members"]}, "Displayed Groups: club_members"]},
@ -1287,24 +1288,24 @@ mod_doc() ->
"should see all managers. This scenario can be achieved by " "should see all managers. This scenario can be achieved by "
"creating shared roster groups as shown in the following lists:"), "creating shared roster groups as shown in the following lists:"),
["First list:", ["First list:",
"Identification: management", "Name: management",
"Name: Management", "Label: Management",
"Description: Management", "Description: Management",
"Members: manager1@example.org, manager2@example.org", "Members: manager1@example.org, manager2@example.org",
"Displayed Groups: management, marketing, sales", "Displayed: management, marketing, sales",
"", "",
"Second list:", "Second list:",
"Identification: marketing", "Name: marketing",
"Name: Marketing", "Label: Marketing",
"Description: Marketing", "Description: Marketing",
"Members: marketeer1@example.org, marketeer2@example.org, marketeer3@example.org", "Members: marketeer1@example.org, marketeer2@example.org, marketeer3@example.org",
"Displayed Groups: management, marketing", "Displayed: management, marketing",
"", "",
"Third list:", "Third list:",
"Identification: sales", "Name: sales",
"Name: Sales", "Label: Sales",
"Description: Sales", "Description: Sales",
"Members: salesman1@example.org, salesman2@example.org, salesman3@example.org", "Members: salesman1@example.org, salesman2@example.org, salesman3@example.org",
"Displayed Groups: management, sales" "Displayed: management, sales"
]} ]}
]}. ]}.