Files

T

Diocrafts f08cffc0e8 feat: add VitePress docs site, music file picker modal, Dockerfile optimization, i18n keys for 14 locales

- Add docs/ with VitePress site (19 pages): guide, config, architecture, FAQ
- Add GitHub Actions workflow for auto-deploy to GitHub Pages
- Replace music 'Add Tracks' upload picker with in-app audio file browser modal
- Add music picker CSS styles with dark theme support
- Add missing i18n keys (search_audio, no_audio_files, etc.) to all 14 locales
- Optimize Dockerfile: shared base stage, COPY --chmod, consolidated RUN, HEALTHCHECK
- Improve README: docs links, updated stats (222+ tests, 14 languages), feature status

2026-04-11 20:58:34 +02:00

2.2 KiB

Raw Blame History

WOPI (Office Document Editing)

OxiCloud integrates with Collabora Online and OnlyOffice via the WOPI protocol, letting users edit documents, spreadsheets, and presentations directly in the browser.

How It Works

User opens a document (.docx, .xlsx, .pptx, .odt, etc.)
OxiCloud generates a WOPI access token and redirects to the editor
The editor fetches the file from OxiCloud via WOPI endpoints
Edits are saved back via PutFile

Configuration

OXICLOUD_WOPI_ENABLED=true
OXICLOUD_WOPI_DISCOVERY_URL="http://collabora:9980/hosting/discovery"

Variable	Default	Description
`OXICLOUD_WOPI_ENABLED`	`false`	Enable WOPI integration
`OXICLOUD_WOPI_DISCOVERY_URL`	—	Editor's WOPI discovery URL
`OXICLOUD_WOPI_SECRET`	(JWT secret)	Token signing key
`OXICLOUD_WOPI_TOKEN_TTL_SECS`	`86400`	Access token lifetime
`OXICLOUD_WOPI_LOCK_TTL_SECS`	`1800`	Lock expiration

Docker Compose with Collabora

services:
  collabora:
    image: collabora/code:latest
    environment:
      - domain=oxicloud\\.example\\.com
      - extra_params=--o:ssl.enable=false
    ports:
      - "9980:9980"
    cap_add:
      - MKNOD

  oxicloud:
    environment:
      OXICLOUD_WOPI_ENABLED: "true"
      OXICLOUD_WOPI_DISCOVERY_URL: "http://collabora:9980/hosting/discovery"

Docker Compose with OnlyOffice

services:
  onlyoffice:
    image: onlyoffice/documentserver:latest
    environment:
      - JWT_ENABLED=false
    ports:
      - "8443:443"

  oxicloud:
    environment:
      OXICLOUD_WOPI_ENABLED: "true"
      OXICLOUD_WOPI_DISCOVERY_URL: "http://onlyoffice/hosting/discovery"

WOPI Endpoints

Method	Endpoint	Description
GET	`/wopi/files/{id}`	CheckFileInfo — file metadata
GET	`/wopi/files/{id}/contents`	GetFile — download file content
POST	`/wopi/files/{id}/contents`	PutFile — save edited content
POST	`/wopi/files/{id}`	Lock / Unlock / RefreshLock

Supported Formats

Any format supported by your Collabora or OnlyOffice installation, typically:

Documents: .docx, .odt, .doc, .rtf
Spreadsheets: .xlsx, .ods, .xls, .csv
Presentations: .pptx, .odp, .ppt

2.2 KiB Raw Blame History