Module: kamailio
Branch: master
Commit: 867294f79f30b1b737d78e623514b4b14475f9cf
URL: https://github.com/kamailio/kamailio/commit/867294f79f30b1b737d78e623514b4b…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2019-11-05T12:31:21+01:00
modules: readme files regenerated - presence_xml ... [skip ci]
---
Modified: src/modules/presence_xml/README
---
Diff: https://github.com/kamailio/kamailio/commit/867294f79f30b1b737d78e623514b4b…
Patch: https://github.com/kamailio/kamailio/commit/867294f79f30b1b737d78e623514b4b…
---
diff --git a/src/modules/presence_xml/README b/src/modules/presence_xml/README
index 2098395373..9f7a80ba05 100644
--- a/src/modules/presence_xml/README
+++ b/src/modules/presence_xml/README
@@ -34,6 +34,9 @@ Anca-Maria Vamanu
3.9. passive_mode(int)
3.10. xcapauth_userdel_reason(str)
3.11. force_dummy_presence(int)
+ 3.12. force_presence_single_body(int)
+ 3.13. presence_single_body_priorities(str)
+ 3.14. presence_single_body_lookup_element(str)
4. Functions
@@ -57,8 +60,11 @@ Anca-Maria Vamanu
1.9. Set passive_mode parameter
1.10. Set xcapauth_userdel_reason parameter
1.11. Set force_dummy_presence parameter
- 1.12. pres_check_basic usage
- 1.13. pres_check_activities usage
+ 1.12. Set force_presence_single_body parameter
+ 1.13. Set presence_single_body_priorities parameter
+ 1.14. Set presence_single_body_lookup_element parameter
+ 1.15. pres_check_basic usage
+ 1.16. pres_check_activities usage
Chapter 1. Admin Guide
@@ -83,6 +89,9 @@ Chapter 1. Admin Guide
3.9. passive_mode(int)
3.10. xcapauth_userdel_reason(str)
3.11. force_dummy_presence(int)
+ 3.12. force_presence_single_body(int)
+ 3.13. presence_single_body_priorities(str)
+ 3.14. presence_single_body_lookup_element(str)
4. Functions
@@ -141,6 +150,9 @@ Chapter 1. Admin Guide
3.9. passive_mode(int)
3.10. xcapauth_userdel_reason(str)
3.11. force_dummy_presence(int)
+ 3.12. force_presence_single_body(int)
+ 3.13. presence_single_body_priorities(str)
+ 3.14. presence_single_body_lookup_element(str)
3.1. db_url(str)
@@ -298,6 +310,50 @@ modparam("presence_xml", "xcapauth_userdel_reason", "rejected")
modparam("presence_xml", "force_dummy_presence", 1)
...
+3.12. force_presence_single_body(int)
+
+ Set this parameter to enable single body notify. One presentity can
+ have multiple dialogs and will by default notify all the dialogs and
+ this can be a problem when dealing with large ring-groups or
+ attendants, use this parameter to only send one body. Look at
+ presence_single_body_priorities and presence_single_body_lookup_element
+ to customize the behaviour.
+
+ Default value: “0”.
+
+ Example 1.12. Set force_presence_single_body parameter
+...
+modparam("presence_xml", "force_presence_single_body", 1)
+...
+
+3.13. presence_single_body_priorities(str)
+
+ Change this parameter to set the priorities when choosing the dialog
+ that will be the final.
+
+ Importance is left to right.
+
+ Default value: “Available|Ringing|On the Phone”.
+
+ Example 1.13. Set presence_single_body_priorities parameter
+...
+modparam("presence_xml", "presence_single_body_priorities", "Offline|Online|Busy
+|Really Busy")
+...
+
+3.14. presence_single_body_lookup_element(str)
+
+ Set the name of the element that should be used to get the priority. If
+ the value obtained is not in the list of
+ presence_single_body_priorities the priority is 0.
+
+ Default value: “note”.
+
+ Example 1.14. Set presence_single_body_lookup_element parameter
+...
+modparam("presence_xml", "presence_single_body_lookup_element", "status")
+...
+
4. Functions
4.1. pres_check_basic(presentity_uri, status)
@@ -314,7 +370,7 @@ modparam("presence_xml", "force_dummy_presence", 1)
* 1 - if a match is found.
* -1 - if a match is not found.
- Example 1.12. pres_check_basic usage
+ Example 1.15. pres_check_basic usage
...
if (pres_check_basic("$ru", "open")) {
...
@@ -338,7 +394,7 @@ modparam("presence_xml", "force_dummy_presence", 1)
* -1 - if a match is not found.
* -2 - if /presence/person or /presence/person/activity do not exist.
- Example 1.13. pres_check_activities usage
+ Example 1.16. pres_check_activities usage
...
if (pres_check_basic("$ru", "open")) {
pres_check_activities("$ru", "unknown");
<!-- Kamailio Pull Request Template -->
<!--
IMPORTANT:
- for detailed contributing guidelines, read:
https://github.com/kamailio/kamailio/blob/master/.github/CONTRIBUTING.md
- pull requests must be done to master branch, unless they are backports
of fixes from master branch to a stable branch
- backports to stable branches must be done with 'git cherry-pick -x ...'
- code is contributed under BSD for core and main components (tm, sl, auth, tls)
- code is contributed GPLv2 or a compatible license for the other components
- GPL code is contributed with OpenSSL licensing exception
-->
#### Pre-Submission Checklist
<!-- Go over all points below, and after creating the PR, tick all the checkboxes that apply -->
<!-- All points should be verified, otherwise, read the CONTRIBUTING guidelines from above-->
<!-- If you're unsure about any of these, don't hesitate to ask on sr-dev mailing list -->
- [X] Commit message has the format required by CONTRIBUTING guide
- [X] Commits are split per component (core, individual modules, libs, utils, ...)
- [X] Each component has a single commit (if not, squash them into one commit)
- [X] No commits to README files for modules (changes must be done to docbook files
in `doc/` subfolder, the README file is autogenerated)
#### Type Of Change
- [ ] Small bug fix (non-breaking change which fixes an issue)
- [X] New feature (non-breaking change which adds new functionality)
- [ ] Breaking change (fix or feature that would change existing functionality)
#### Checklist:
<!-- Go over all points below, and after creating the PR, tick the checkboxes that apply -->
- [ ] PR should be backported to stable branches
- [X] Tested changes locally
- [ ] Related to issue #XXXX (replace XXXX with an open issue number)
#### Description
<!-- Describe your changes in detail -->
this allow notify body aggregation with priorities
You can view, comment on, or merge this pull request online at:
https://github.com/kamailio/kamailio/pull/2118
-- Commit Summary --
* presence_xml: adds option to aggregate xml body with priorities
-- File Changes --
M src/modules/presence_xml/notify_body.c (112)
M src/modules/presence_xml/presence_xml.c (7)
-- Patch Links --
https://github.com/kamailio/kamailio/pull/2118.patchhttps://github.com/kamailio/kamailio/pull/2118.diff
--
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/pull/2118