|
|
# 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)
|
|
|
|
|
|
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.
|
|
|
|
|
|
To upload files encrypted in combination with the [wiki:OmemoGajimPlugin] you need to install the `python-cryptography` package on Linux.
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
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).
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
![](Screenshot from 2015-09-02 124035.png, 600)
|
|
|
|
|
|
## Bugs / Feature Requests
|
|
|
|
|
|
Existing bugs and feature requests are [query:?status=accepted&status=assigned&status=new&status=reopened&component=HttpUploadPlugin here].
|
|
|
|
|
|
If you have any issues, create a [/newticket?component=HttpUploadPlugin&owner=tmolitor new ticket]. |
|
|
\ No newline at end of file |