|
|
# Http Upload Plugin
|
|
|
# HTTP Upload Plugin
|
|
|
|
|
|
## Overall description
|
|
|
This Plugin implements [XEP-0363](http://xmpp.org/extensions/xep-0363.html)
|
|
|
This Plugin implements [XEP-0363](http://xmpp.org/extensions/xep-0363.html) for file transfers.
|
|
|
|
|
|
Http Upload was designed to address the following secenarios:
|
|
|
- The recipient is not online (Asynchronous)
|
|
|
- Multiple recipients (Group Chats or Clients)
|
|
|
**This plugin is integrated into Gajim core since Gajim 1.0. It is no longer needed to use HTTP Upload in Gajim 1.0 (plugin gets deactivated automatically and can safely be removed).**
|
|
|
|
|
|
HTTP Upload was designed to address the following secenarios:
|
|
|
- The recipient is not online (asynchronous file transfer)
|
|
|
- Multiple recipients (group chats or multiple clients)
|
|
|
|
|
|
## Encryption
|
|
|
This Plugin can upload encrypted files in conjunction with the [OMEMO Plugin](./OmemoGajimPlugin).
|
... | ... | @@ -18,22 +20,22 @@ You can install the Plugin via the Gajim Plugin Manager. |
|
|
|
|
|
## Example
|
|
|
|
|
|
Server needs to support XEP-0363
|
|
|
*The server you use needs to support [XEP-0363](http://xmpp.org/extensions/xep-0363.html).*
|
|
|
|
|
|
Prosody: [mod_http_upload](http://modules.prosody.im/mod_http_upload.html).
|
|
|
|
|
|
Ejabberd: 'mod_http_upload' is included in ejabberd-core since version 15.10.
|
|
|
|
|
|
Prosody: [mod_http_upload](http://modules.prosody.im/mod_http_upload.html)
|
|
|
After you have connected to a server with XEP-0363 support, you should see a new button for file transfers.
|
|
|
|
|
|
Ejabberd: mod_http_upload is included in ejabberd-core from version 15.10 on
|
|
|
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 XHTML-IM and will always display the thumbnail.
|
|
|
|
|
|
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.
|
|
|
|
|
|
## Changelog
|
|
|
## Changelog (Gajim 0.16)
|
|
|
|
|
|
###### 0.4.6 - 07.06.2017
|
|
|
|
|
|
- Fix https://dev.gajim.org/gajim/gajim-plugins/issues/199
|
|
|
- Fix #199
|
|
|
|
|
|
###### 0.4.5 - 15.03.2017
|
|
|
|
... | ... | @@ -49,4 +51,4 @@ If the recipient doesn't support XHTML-IM they will just see the URL instead. Ga |
|
|
|
|
|
###### 0.4.2 - 10.01.2017
|
|
|
|
|
|
- Better Error handling (dont crash) |
|
|
- Better Error handling (don't crash) |