|
|
# Http Upload Plugin
|
|
|
|
|
|
## Overall description
|
|
|
Current file transfer mechanisms don't work for the following scenarios:
|
|
|
- The recipient is not online (asynchronous)
|
|
|
- The recipient is using multiple clients (how does the sender know which client the recipient wants the files sent to)
|
|
|
- Multiple recipients (group chats)
|
|
|
This Plugin implements [XEP-0363](http://xmpp.org/extensions/xep-0363.html)
|
|
|
|
|
|
So the file transfer method described in [XEP-0363](http://xmpp.org/extensions/xep-0363.html) was developed and implemented in Gajim as this plugin.
|
|
|
Other clients that also supports XEP-0363 is the Android client [https://conversations.im/] Conversations.
|
|
|
Http Upload was designed to address the following secenarios:
|
|
|
- The recipient is not online (Asynchronous)
|
|
|
- Multiple recipients (Group Chats or Clients)
|
|
|
|
|
|
To upload files encrypted in combination with the [wiki:OmemoGajimPlugin] you need to install the `python-cryptography` package on Linux.
|
|
|
## Encryption
|
|
|
This Plugin can upload encrypted files in conjunction with the [OMEMO Plugin](./OmemoGajimPlugin).
|
|
|
|
|
|
On Linux you need to install `python-cryptography`.
|
|
|
|
|
|
## Installation
|
|
|
|
... | ... | @@ -17,15 +18,19 @@ You can install the Plugin via the Gajim Plugin Manager. |
|
|
|
|
|
## Example
|
|
|
|
|
|
Server needs to support XEP-0363, there is a [generic component](https://github.com/siacs/HttpUploadComponent) which can be used for most servers. For Prosody there is also [mod_http_upload](http://modules.prosody.im/mod_http_upload.html) and for ejabberd there is [mod_http_upload](https://github.com/processone/ejabberd-contrib/tree/master/mod_http_upload).
|
|
|
Server needs to support XEP-0363
|
|
|
|
|
|
After you have connected to a server with support you should see the buttons as can be seen in the screenshot below. When using the button for sending images you will see an image preview in the dialog for selecting image, also when upload is completed a thumbnail will be sent to the recipients with [XHTML-IM](http://xmpp.org/extensions/xep-0071.html), if the recipient doesn't support XHTML-IM they will just see the URL instead. Gajim supports HTML-IM and will always display the thumbnail. Other clients like Conversations will automatically download and display the image if the sender is in the recipients roster, if the sender is not in the roster or the image is shared in a anonymous MUC the recipient can long press the URL to download and display.
|
|
|
Prosody: [mod_http_upload](http://modules.prosody.im/mod_http_upload.html)
|
|
|
|
|
|
Ejabberd: mod_http_upload is included in ejabberd-core from version 15.10 on
|
|
|
|
|
|
![](Screenshot from 2015-09-02 124035.png, 600)
|
|
|
After you have connected to a server with support you should see two new buttons.
|
|
|
When using the button for sending images you will see an image preview in the dialog for selecting the image.
|
|
|
Also when the upload is completed a thumbnail will be sent to the recipients with [XHTML-IM](http://xmpp.org/extensions/xep-0071.html).
|
|
|
If the recipient doesn't support XHTML-IM they will just see the URL instead. Gajim supports HTML-IM and will always display the thumbnail.
|
|
|
|
|
|
## Bugs / Feature Requests
|
|
|
## Changelog
|
|
|
|
|
|
Existing bugs and feature requests are [query:?status=accepted&status=assigned&status=new&status=reopened&component=HttpUploadPlugin here].
|
|
|
###### 0.4.2 - 10.01.2017
|
|
|
|
|
|
If you have any issues, create a [/newticket?component=HttpUploadPlugin&owner=tmolitor new ticket]. |
|
|
\ No newline at end of file |
|
|
- Better Error handling (dont crash) |