This app enables users to edit office documents from [Mattermost](https://mattermost.com/) using ONLYOFFICE Docs packaged as Document Server - [Community or Enterprise Edition](https://github.com/ONLYOFFICE/onlyoffice-mattermost#onlyoffice-docs-editions).
## Features
You will need an instance of ONLYOFFICE Docs (Document Server) that is resolvable and connectable both from Mattermost and any end clients. ONLYOFFICE Document Server must also be able to POST to Mattermost directly.
Document Server and Mattermost can be installed either on different computers or on the same machine. In case you choose the latter option, you need to set up a custom port for Document Server.
You can install free Community version of ONLYOFFICE Docs or scalable Enterprise Edition with pro features.
To install free Community version, use [Docker](https://github.com/onlyoffice/Docker-DocumentServer) (recommended) or follow [these instructions](https://helpcenter.onlyoffice.com/installation/docs-community-install-ubuntu.aspx) for Debian, Ubuntu, or derivatives.
To install Enterprise Edition, follow the instructions [here](https://helpcenter.onlyoffice.com/installation/docs-enterprise-index.aspx).
Community Edition vs Enterprise Edition comparison can be found [here](https://github.com/ONLYOFFICE/onlyoffice-mattermost#onlyoffice-docs-editions).
## Installing ONLYOFFICE app for Mattermost
[](https://github.com/ONLYOFFICE/onlyoffice-mattermost/blob/main/assets/screen_settings.png)
- **Document Editing Service address**: The URL and port of the installed ONLYOFFICE Document Server.
- **Secret key**: Starting from version 7.2, JWT is enabled by default and the secret key is generated automatically to restrict the access to ONLYOFFICE Docs and for security reasons and data integrity. Specify your own secret key in the Mattermost plugin configuration. In the ONLYOFFICE Docs [config file](https://api.onlyoffice.com/editors/signature/), specify the same secret key and enable the validation.
- **JWT Header**: If JWT protection is enabled, it is necessary to specify a custom header name since the Mattermost security policy blocks external 'Authorization' Headers. This header should be specified in the ONLYOFFICE Docs signature settings as well (further information can be found [here](https://api.onlyoffice.com/editors/signature/)).
- **JWT Prefix**: Used to specify the ONLYOFFICE Docs prefix.
## Using ONLYOFFICE app for Mattermost
Users are able to open files sent in personal and group Mattermost chats for viewing and co-editing.
When files are sent in the chat message, the following actions are available in the file context menu by clicking the ⋮ symbol:
- **Open file in ONLYOFFICE** and **Change access rights** — for the author of the message.
- **Open file in ONLYOFFICE** — for the recipient of the message.
[](https://github.com/ONLYOFFICE/onlyoffice-mattermost/blob/main/assets/screen_actions.png)
When clicking on the *Open file in ONLYOFFICE* button, the corresponding ONLYOFFICE editor opens in the same window.
[](https://github.com/ONLYOFFICE/onlyoffice-mattermost/blob/main/assets/screen_editor.png)
The author of the message with attached documents is able to change access rights to the file via the context menu using the **Change access rights** option. This action is available both in personal and group chats.
[](https://github.com/ONLYOFFICE/onlyoffice-mattermost/blob/main/assets/screen_share.png)
ONLYOFFICE bot sends notifications about changes in the document specifying the name of the user who made those changes.
[](https://github.com/ONLYOFFICE/onlyoffice-mattermost/blob/main/assets/screen_bot.png)
## ONLYOFFICE Docs editions
ONLYOFFICE offers different versions of its online document editors that can be deployed on your own servers.
**ONLYOFFICE Docs** packaged as Document Server:
- Community Edition (`onlyoffice-documentserver` package)
- Enterprise Edition (`onlyoffice-documentserver-ee` package)
The table below will help you make the right choice.
Pricing and licensing
Community Edition
Enterprise Edition
[Get it now](https://www.onlyoffice.com/download-docs.aspx?utm_source=github&utm_medium=cpc&utm_campaign=GitHubMattermost#docs-community)
\* If supported by DMS.
In case of technical problems, the best way to get help is to submit your issues [here](https://github.com/ONLYOFFICE/onlyoffice-mattermost/issues). Alternatively, you can contact ONLYOFFICE team on [forum.onlyoffice.com](https://forum.onlyoffice.com/).
# Instalação Plugin Mattermost Jitsi
**Link**: [https://github.com/mattermost-community](https://github.com/mattermost-community) Repositório de plugins.
Plugin Jitsi/Mattermost: [https://github.com/mattermost-community/mattermost-plugin-jitsi](https://github.com/mattermost-community/mattermost-plugin-jitsi)
# Disclaimer
**This repository is community supported and not maintained by Mattermost. Mattermost disclaims liability for integrations, including Third Party Integrations and Mattermost Integrations. Integrations may be modified or discontinued at any time.**
# Mattermost Jitsi Plugin (Beta)
[](https://circleci.com/gh/mattermost/mattermost-plugin-jitsi) [](https://codecov.io/gh/mattermost/mattermost-plugin-jitsi) [](https://github.com/mattermost/mattermost-plugin-jitsi/releases/latest) [](https://github.com/mattermost/mattermost-plugin-jitsi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22Up+For+Grabs%22+label%3A%22Help+Wanted%22)
**Maintainer:** [@mickmister](https://github.com/mickmister) **Originally developed by:** [Sean Sackowitz](https://github.com/seansackowitz).
Start and join voice calls, video calls and use screen sharing with your team members with a Jitsi plugin for Mattermost.
Clicking a video icon in a Mattermost channel posts a message that invites team members to join a Jitsi meetings call.
[](https://user-images.githubusercontent.com/13119842/86600303-e145a600-bf6d-11ea-8562-775869064af0.png)
## Features
- Use a `/jitsi` command to start a new meeting. Optionally append a desired meeting topic after the command.
- Embed Jitsi meetings as a floating window inside Mattermost for a seamless experience.
- Click a video icon in channel header to start a new Jitsi meeting in the channel. Not yet supported on mobile.
- Use a `/jitsi settings` command to configure user preferences, including
- whether Jitsi meetings appear as a floating window inside Mattermost or in a separate window
- how meeting names are generated
The plugin has been tested on Chrome, Firefox and the Mattermost Desktop Apps.
## Installation
1. In GitHub, go to the [Releases](https://github.com/mattermost/mattermost-plugin-jitsi/releases) directory to download the plugin file.
2. In Mattermost, go to **System Console > Plugins > Plugin Management**.
3. Select **Choose File** to upload the plugin file.
## Configuration
Go to **System Console > Plugins > Jitsi** and set the following values:
1. **Enable Plugin**: **true**.
2. **Jitsi Server URL**: The URL for your Jitsi server. If you set the Jitsi Server URL to `https://meet.jit.si`, it uses the public server provided by Jitsi.
3. **Embed Jitsi video inside Mattermost**: When **true**, Jitsi video is embedded as a floating window inside Mattermost. This feature is experimental.
4. (Optional) If your Jitsi server uses JSON Web Tokens (JWT) for authentication, set:
- **Use JWT Authentication for Jitsi**: **true**.
- **App ID** and **App Secret** used for JWT authentication.
- **Meeting Link Expiry Time** in minutes. Defaults to 30 minutes.
5. **Jitsi Meeting Names**: Select how Jitsi meeting names are generated by default. The user can optionally override this setting for themselves via `/jitsi settings`.
- Defaults to using random English words in title case, but you can also use a UUID as the meeting link, or the team and channel name where the Jitsi meeting is created. You can also allow the user to choose the meeting name each time by default.
You're all set! To test it, go to any Mattermost channel and click the video icon in the channel header to start a new Jitsi meeting.
## Localization
Mattermost Jitsi Plugin supports localization in multiple languages:
- English
- French
- German
- Spanish
- Hungarian
The plugin automatically displays languages based on the following:
- For system messages, the locale set in **System Console > General > Localization > Default Server Language** is used.
- For user messages, such as help text and error messages, the locale set set in **Account Settings > Display > Language** is used.
## Manual builds
You can use Docker to compile the binaries yourself. Run `./docker-make` shell script which builds a Docker image with necessary build dependencies and runs `make all` afterwards.
You can also use make targets like `dist` (`./docker-make dist`) from the [Makefile](https://github.com/mattermost-community/mattermost-plugin-jitsi/blob/master/Makefile).
## Development
This plugin contains both a server and web app portion. Read our documentation about the [Developer Workflow](https://developers.mattermost.com/integrate/plugins/developer-workflow/) and [Developer Setup](https://developers.mattermost.com/integrate/plugins/developer-setup/) for more information about developing and extending plugins.
### Releasing new versions
The version of a plugin is determined at compile time, automatically populating a `version` field in the [plugin manifest](https://github.com/mattermost-community/mattermost-plugin-jitsi/blob/master/plugin.json):
- If the current commit matches a tag, the version will match after stripping any leading `v`, e.g. `1.3.1`.
- Otherwise, the version will combine the nearest tag with `git rev-parse --short HEAD`, e.g. `1.3.1+d06e53e1`.
- If there is no version tag, an empty version will be combined with the short hash, e.g. `0.0.0+76081421`.
To disable this behaviour, manually populate and maintain the `version` field.
### Server
Inside the `/server` directory, you will find the Go files that make up the server-side of the plugin. Within there, build the plugin like you would any other Go application.
### Web App
Inside the `/webapp` directory, you will find the JS and React files that make up the client-side of the plugin. Within there, modify files and components as necessary. Test your syntax by running `npm run build`.
## Contributing
We welcome contributions for bug reports, issues, feature requests, feature implementations, and pull requests. Feel free to [file a new issue](https://github.com/mattermost/mattermost-plugin-jitsi/issues/new/choose) or join the [Plugin: Jitsi channel](https://community.mattermost.com/core/channels/plugin-jitsi) on the Mattermost community server.
For a complete guide on contributing to the plugin, see the [Contribution Guidelines](https://github.com/mattermost-community/mattermost-plugin-jitsi/blob/master/CONTRIBUTING.md).