mirror of
https://github.com/processone/ejabberd
synced 2025-10-03 17:59:31 +02:00
Fix mod_pubsub indentation
This commit is contained in:
Badlop
parent
5ee2f48aea
commit
ce6fd654a0
1 changed files with 108 additions and 104 deletions
|
|
@ -4193,43 +4193,91 @@ mod_doc() ->
|
||||||
"is enabled in the default ejabberd configuration file, "
|
"is enabled in the default ejabberd configuration file, "
|
||||||
"and it requires 'mod_caps'.")],
|
"and it requires 'mod_caps'.")],
|
||||||
opts =>
|
opts =>
|
||||||
[{max_nodes_discoitems,
|
[{access_createnode,
|
||||||
#{value => "pos_integer() | infinity",
|
#{value => "AccessName",
|
||||||
desc => ?T("The maximum number of nodes to return in a "
|
desc =>
|
||||||
"discoitem response. The default value is: '100'.")}},
|
?T("This option restricts which users are allowed to "
|
||||||
{access_createnode,
|
"create pubsub nodes using 'acl' and 'access'. "
|
||||||
#{value => "AccessName",
|
"By default any account in the local ejabberd server "
|
||||||
desc => ?T("This option restricts which users are allowed to "
|
"is allowed to create pubsub nodes. "
|
||||||
"create pubsub nodes using 'acl' and 'access'. "
|
"The default value is: 'all'.")}},
|
||||||
"By default any account in the local ejabberd server "
|
{db_type,
|
||||||
"is allowed to create pubsub nodes. "
|
#{value => "mnesia | sql",
|
||||||
"The default value is: 'all'.")}},
|
desc =>
|
||||||
{max_items_node,
|
?T("Same as top-level 'default_db' option, but applied to "
|
||||||
#{value => "MaxItems",
|
"this module only.")}},
|
||||||
desc => ?T("Define the maximum number of items that can be "
|
{default_node_config,
|
||||||
"stored in a node. Default value is: '10'.")}},
|
#{value => "List of Key:Value",
|
||||||
{max_subscriptions_node,
|
desc =>
|
||||||
#{value => "MaxSubs",
|
?T("To override default node configuration, regardless "
|
||||||
desc => ?T("Define the maximum number of subscriptions managed "
|
"of node plugin. Value is a list of key-value "
|
||||||
"by a node. "
|
"definition. Node configuration still uses default "
|
||||||
"Default value is no limitation: 'undefined'.")}},
|
"configuration defined by node plugin, and overrides "
|
||||||
{plugins,
|
"any items by value defined in this configurable list.")}},
|
||||||
#{value => "[Plugin, ...]",
|
{force_node_config,
|
||||||
desc => [?T("To specify which pubsub node plugins to use. "
|
#{value => "List of Node and the list of its Key:Value",
|
||||||
"The first one in the list is used by default. "
|
desc =>
|
||||||
"If this option is not defined, the default plugins "
|
?T("Define the configuration for given nodes. "
|
||||||
"list is: '[flat]'. PubSub clients can define which "
|
"The default value is: '[]'."),
|
||||||
"plugin to use when creating a node: "
|
example =>
|
||||||
"add 'type=\'plugin-name\'' attribute "
|
["force_node_config:",
|
||||||
"to the 'create' stanza element."),
|
" ## Avoid buggy clients to make their bookmarks public",
|
||||||
?T("- 'flat' plugin handles the default behaviour and "
|
" storage:bookmarks:",
|
||||||
"follows standard XEP-0060 implementation."),
|
" access_model: whitelist"]}},
|
||||||
?T("- 'pep' plugin adds extention to handle Personal "
|
{host,
|
||||||
"Eventing Protocol (XEP-0163) to the PubSub engine. "
|
#{desc => ?T("Deprecated. Use 'hosts' instead.")}},
|
||||||
"Adding pep allows to handle PEP automatically.")]}},
|
{hosts,
|
||||||
|
#{value => ?T("[Host, ...]"),
|
||||||
|
desc =>
|
||||||
|
?T("This option defines the Jabber IDs of the service. "
|
||||||
|
"If the 'hosts' option is not specified, the only Jabber "
|
||||||
|
"ID will be the hostname of the virtual host with the "
|
||||||
|
"prefix \"vjud.\". The keyword '@HOST@' is replaced with "
|
||||||
|
"the real virtual host name.")}},
|
||||||
|
{ignore_pep_from_offline,
|
||||||
|
#{value => "false | true",
|
||||||
|
desc =>
|
||||||
|
?T("To specify whether or not we should get last "
|
||||||
|
"published PEP items from users in our roster which "
|
||||||
|
"are offline when we connect. Value is 'true' or "
|
||||||
|
"'false'. If not defined, pubsub assumes true so we "
|
||||||
|
"only get last items of online contacts.")}},
|
||||||
|
{last_item_cache,
|
||||||
|
#{value => "false | true",
|
||||||
|
desc =>
|
||||||
|
?T("To specify whether or not pubsub should cache last "
|
||||||
|
"items. Value is 'true' or 'false'. If not defined, "
|
||||||
|
"pubsub does not cache last items. On systems with not"
|
||||||
|
" so many nodes, caching last items speeds up pubsub "
|
||||||
|
"and allows to raise user connection rate. The cost "
|
||||||
|
"is memory usage, as every item is stored in memory.")}},
|
||||||
|
{max_items_node,
|
||||||
|
#{value => "MaxItems",
|
||||||
|
desc =>
|
||||||
|
?T("Define the maximum number of items that can be "
|
||||||
|
"stored in a node. Default value is: '10'.")}},
|
||||||
|
{max_nodes_discoitems,
|
||||||
|
#{value => "pos_integer() | infinity",
|
||||||
|
desc =>
|
||||||
|
?T("The maximum number of nodes to return in a "
|
||||||
|
"discoitem response. The default value is: '100'.")}},
|
||||||
|
{max_subscriptions_node,
|
||||||
|
#{value => "MaxSubs",
|
||||||
|
desc =>
|
||||||
|
?T("Define the maximum number of subscriptions managed "
|
||||||
|
"by a node. "
|
||||||
|
"Default value is no limitation: 'undefined'.")}},
|
||||||
|
{name,
|
||||||
|
#{value => ?T("Name"),
|
||||||
|
desc =>
|
||||||
|
?T("The value of the service name. This name is only visible "
|
||||||
|
"in some clients that support "
|
||||||
|
"https://xmpp.org/extensions/xep-0030.html"
|
||||||
|
"[XEP-0030: Service Discovery]. "
|
||||||
|
"The default is 'vCard User Search'.")}},
|
||||||
{nodetree,
|
{nodetree,
|
||||||
#{value => "Nodetree",
|
#{value => "Nodetree",
|
||||||
desc =>
|
desc =>
|
||||||
[?T("To specify which nodetree to use. If not defined, the "
|
[?T("To specify which nodetree to use. If not defined, the "
|
||||||
"default pubsub nodetree is used: 'tree'. Only one "
|
"default pubsub nodetree is used: 'tree'. Only one "
|
||||||
"nodetree can be used per host, and is shared by all "
|
"nodetree can be used per host, and is shared by all "
|
||||||
|
|
@ -4251,43 +4299,12 @@ mod_doc() ->
|
||||||
"PubSub Collection Nodes (XEP-0248). In that case you "
|
"PubSub Collection Nodes (XEP-0248). In that case you "
|
||||||
"should also add 'dag' node plugin as default, for "
|
"should also add 'dag' node plugin as default, for "
|
||||||
"example: 'plugins: [flat,pep]'")]}},
|
"example: 'plugins: [flat,pep]'")]}},
|
||||||
{ignore_pep_from_offline,
|
{pep_mapping,
|
||||||
#{value => "false | true",
|
#{value => "List of Key:Value",
|
||||||
desc => ?T("To specify whether or not we should get last "
|
desc =>
|
||||||
"published PEP items from users in our roster which "
|
?T("This allows to define a list of key-value to choose "
|
||||||
"are offline when we connect. Value is 'true' or "
|
"defined node plugins on given PEP namespace."),
|
||||||
"'false'. If not defined, pubsub assumes true so we "
|
example =>
|
||||||
"only get last items of online contacts.")}},
|
|
||||||
{last_item_cache,
|
|
||||||
#{value => "false | true",
|
|
||||||
desc => ?T("To specify whether or not pubsub should cache last "
|
|
||||||
"items. Value is 'true' or 'false'. If not defined, "
|
|
||||||
"pubsub does not cache last items. On systems with not"
|
|
||||||
" so many nodes, caching last items speeds up pubsub "
|
|
||||||
"and allows to raise user connection rate. The cost "
|
|
||||||
"is memory usage, as every item is stored in memory.")}},
|
|
||||||
{force_node_config,
|
|
||||||
#{value => "List of Node and the list of its Key:Value",
|
|
||||||
desc => ?T("Define the configuration for given nodes. "
|
|
||||||
"The default value is: '[]'."),
|
|
||||||
example =>
|
|
||||||
["force_node_config:",
|
|
||||||
" ## Avoid buggy clients to make their bookmarks public",
|
|
||||||
" storage:bookmarks:",
|
|
||||||
" access_model: whitelist"]}},
|
|
||||||
{default_node_config,
|
|
||||||
#{value => "List of Key:Value",
|
|
||||||
desc => ?T("To override default node configuration, regardless "
|
|
||||||
"of node plugin. Value is a list of key-value "
|
|
||||||
"definition. Node configuration still uses default "
|
|
||||||
"configuration defined by node plugin, and overrides "
|
|
||||||
"any items by value defined in this configurable list.
|
|
||||||
")}},
|
|
||||||
{pep_mapping,
|
|
||||||
#{value => "List of Key:Value",
|
|
||||||
desc => ?T("This allows to define a list of key-value to choose "
|
|
||||||
"defined node plugins on given PEP namespace."),
|
|
||||||
example =>
|
|
||||||
[{?T("The following example will use 'node_tune' instead of "
|
[{?T("The following example will use 'node_tune' instead of "
|
||||||
"'node_pep' for every PEP node with the tune namespace:"),
|
"'node_pep' for every PEP node with the tune namespace:"),
|
||||||
["modules:",
|
["modules:",
|
||||||
|
|
@ -4297,29 +4314,20 @@ mod_doc() ->
|
||||||
" http://jabber.org/protocol/tune: tune",
|
" http://jabber.org/protocol/tune: tune",
|
||||||
" ..."]
|
" ..."]
|
||||||
}]}},
|
}]}},
|
||||||
{db_type,
|
{plugins,
|
||||||
#{value => "mnesia | sql",
|
#{value => "[Plugin, ...]",
|
||||||
desc =>
|
desc => [?T("To specify which pubsub node plugins to use. "
|
||||||
?T("Same as top-level 'default_db' option, but applied to "
|
"The first one in the list is used by default. "
|
||||||
"this module only.")}},
|
"If this option is not defined, the default plugins "
|
||||||
{host,
|
"list is: '[flat]'. PubSub clients can define which "
|
||||||
#{desc => ?T("Deprecated. Use 'hosts' instead.")}},
|
"plugin to use when creating a node: "
|
||||||
{hosts,
|
"add 'type=\'plugin-name\'' attribute "
|
||||||
#{value => ?T("[Host, ...]"),
|
"to the 'create' stanza element."),
|
||||||
desc =>
|
?T("- 'flat' plugin handles the default behaviour and "
|
||||||
?T("This option defines the Jabber IDs of the service. "
|
"follows standard XEP-0060 implementation."),
|
||||||
"If the 'hosts' option is not specified, the only Jabber "
|
?T("- 'pep' plugin adds extention to handle Personal "
|
||||||
"ID will be the hostname of the virtual host with the "
|
"Eventing Protocol (XEP-0163) to the PubSub engine. "
|
||||||
"prefix \"vjud.\". The keyword '@HOST@' is replaced with "
|
"Adding pep allows to handle PEP automatically.")]}},
|
||||||
"the real virtual host name.")}},
|
|
||||||
{name,
|
|
||||||
#{value => ?T("Name"),
|
|
||||||
desc =>
|
|
||||||
?T("The value of the service name. This name is only visible "
|
|
||||||
"in some clients that support "
|
|
||||||
"https://xmpp.org/extensions/xep-0030.html"
|
|
||||||
"[XEP-0030: Service Discovery]. "
|
|
||||||
"The default is 'vCard User Search'.")}},
|
|
||||||
{vcard,
|
{vcard,
|
||||||
#{value => ?T("vCard"),
|
#{value => ?T("vCard"),
|
||||||
desc =>
|
desc =>
|
||||||
|
|
@ -4348,8 +4356,7 @@ mod_doc() ->
|
||||||
example =>
|
example =>
|
||||||
[{?T("Example of configuration that uses flat nodes as default, "
|
[{?T("Example of configuration that uses flat nodes as default, "
|
||||||
"and allows use of flat, hometree and pep nodes:"),
|
"and allows use of flat, hometree and pep nodes:"),
|
||||||
[
|
["modules:",
|
||||||
"modules:",
|
|
||||||
" ...",
|
" ...",
|
||||||
" mod_pubsub:",
|
" mod_pubsub:",
|
||||||
" access_createnode: pubsub_createnode",
|
" access_createnode: pubsub_createnode",
|
||||||
|
|
@ -4361,14 +4368,12 @@ mod_doc() ->
|
||||||
" plugins:",
|
" plugins:",
|
||||||
" - flat",
|
" - flat",
|
||||||
" - pep",
|
" - pep",
|
||||||
" ..."
|
" ..."]},
|
||||||
]},
|
|
||||||
{?T("Using relational database requires using mod_pubsub with "
|
{?T("Using relational database requires using mod_pubsub with "
|
||||||
"db_type 'sql'. Only flat, hometree and pep plugins supports "
|
"db_type 'sql'. Only flat, hometree and pep plugins supports "
|
||||||
"SQL. The following example shows previous configuration "
|
"SQL. The following example shows previous configuration "
|
||||||
"with SQL usage:"),
|
"with SQL usage:"),
|
||||||
[
|
["modules:",
|
||||||
"modules:",
|
|
||||||
" ...",
|
" ...",
|
||||||
" mod_pubsub:",
|
" mod_pubsub:",
|
||||||
" db_type: sql",
|
" db_type: sql",
|
||||||
|
|
@ -4378,6 +4383,5 @@ mod_doc() ->
|
||||||
" plugins:",
|
" plugins:",
|
||||||
" - flat",
|
" - flat",
|
||||||
" - pep",
|
" - pep",
|
||||||
" ..."
|
" ..."]}
|
||||||
]}
|
|
||||||
]}.
|
]}.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue