view doc/jp/event.rst @ 3410:55f9a38864af

jp (file/receive): display or answer to C.META_TYPE_NOT_IN_ROSTER_LEAK dialog: when a file is proposed by an entity not in roster, the dialog asking for confirmation is displayed. If the bare jid of the sender is explicitely waited (i.e. it's in arguments), then the dialog is automatically confirmed.
author Goffi <goffi@goffi.org>
date Thu, 12 Nov 2020 14:53:16 +0100
parents 81c8910db91f
children
line wrap: on
line source

========================
event: events management
========================

Event commands allows you to create/modify or get data about an event, and to manage your
invitees.

list
====

List events available on a service

example
-------

Retrieve events of profile::

  $ jp event list

.. _jp-event_get:

get
===

Get metadata about a specific event.

example
-------

Retrieve an event metadata::

  $ jp event get  -n org.salut-a-toi.event:0__BsyCsXpcrRh44CQhSVTUMi -i 'org.salut-a-toi.event:0'

.. _jp-event_create:

create
======

Create a new event. You can specify the date of the event with ``-d DATE, --date DATE``,
and an id with ``-i ID, --id ID`` (default id is used if omitted).

Configuration options are specified using ``-f KEY VALUE, --field KEY VALUE`` where key
can be a custom data or one of:

name
  name of the event
description
  details of the event
image
  URL of the main picture of the event
background-image
  URL of image to use as background
register
  a boolean value, set to ``true`` if you want to register the event in your local list

example
-------

Create an event about to celebrate New Year::

  $ jp event create -d 2019-12-31 -f name "New Year's Eve" -f description "Party to celebrate new year" -f register true -f image https://example.net/some_image.jpg


modify
======

This command in the same way as jp-event_create_ but modify an existing event. You need to
specify the node of the event to modify using ``-n NODE, --node NODE``.

example
-------

Add a background image to the New Year event created above::

  $ jp event modify -n org.salut-a-toi.event:0__d8QQLJvbcpDXxK66UBXKfT -f background-image https://example.net/some_background_image.jpg


invitee
=======

Subcommands to handle guests. Please check :ref:`jp-event_invitee`.