event/invitee: event invitees management

invitee groups commands to invite somebody to an event, get or set data about an invitee, and list all invitees. You can send an invitation by e-mail to people without XMPP account.

get

Retrieve the RSVP status of one or several guest(s).

You may specify the guest(s) to retrieve by using their bare JIDs with -j JIDS, --jid JIDS as many times as necessary. By default, all guests RSVPs are retrieved.

If no response is known yet, no data is returned.

example

Get RSVP of Louise:

$ li event invitee get -u "xmpp:pubsub.example.net?;node=urn%3Axmpp%3Aevents%3A0%2Fparty;item=picnic_abd1" -j louise@example.org

set

Set your own RSVP data.

Use -f KEY VALUE, --field KEY VALUE to specify the data to set. KEY can any field name used in the RSVP form, where usually attending is used (with the possible values of yes, no, and maybe).

example

Indicate that you’ll come to a picnic:

$ li event invitee set -s pubsub.example.net -n urn:xmpp:events:0/party -i picnic_abd1 -f attending yes

list

Get and format the RSVP of your invitees. Note that as for libervia-cli_event_invitee_get and libervia-cli_event_invitee_set you must use invitees node and not the event node.

By default, only people who have answered are shown. You may use -m, --missing to show other people which were invited, but have not answered yet. When using this option, you can also use -R, --no-rsvp to only show people which have not answered yet.

You’ll also have a small summary indicating how many people who can expect at your event.

example

Get the full list of invitees (including those who didn’t answered yet) with the RSVP formatted:

$ li event invitee list -u "xmpp:pierre@example.net?;node=generic%2F876a2b99-1c90-41fa-b823-c4a467140770" -m

invite

Invite somebody to an event. The invitation is done by e-mail, a guest account will be created. Contrary to other invitee commands, in this one you’ll use the event node directly.

This command is really similar to create

E-mail address is specified using -e EMAIL, --email EMAIL and you’ll need to give an URL template (using -U URL_TEMPLATE, --url-template URL_TEMPLATE)leading to your website page handling the invitation (for Libervia default invitation page is <your_server>/g/<uuid>). You can use {uuid} as a placeholder which will be replaced by event’s id.

You’ll probably want to specify the name of the invitee, using -N NAME, --name NAME and your own name (as the host inviting), using -H HOST_NAME, --host-name HOST_NAME. The language spoken by your guest can be specified using -l LANG, --lang LANG, it is mainly useful if you have many invitee speaking different languages.

example

Pierre is inviting Louise (whose e-mail address is louise_email@example.net) to an event he’s organising:

$ li event invitee invite -e louise_email@example.et -N "Louise" -H "Pierre" -l fr -U "https://www.example.org/g/{uuid}" -u "xmpp:pierre@example.org?;node=generic%2F61400ea7-a2a2-4ce0-9b68-3735b602f671"