nagi / laravel-wopi
Wopi implementation in php Laravel
Maintainers
Fund package maintenance!
Requires
- php: ^8.0|^8.1|^8.2|^8.3
- guzzlehttp/guzzle: ^7.9.1
- illuminate/contracts: ^11|^10|^9.0|^12.0
- phpseclib/phpseclib: ^3.0.39
- phpseclib/phpseclib2_compat: ^1.0.6
- spatie/laravel-package-tools: ^1.12.1
Requires (Dev)
- nunomaduro/collision: ^8.0|^7.0
- orchestra/testbench: ^9|^8|^10.0
- pestphp/pest: ^2.0|^3.7
- pestphp/pest-plugin-laravel: ^2.0|^3.1
- spatie/laravel-ray: ^1.37.1
README
Implementation of the WOPI protocol to facilitate intergration with office online and other WOPI-compatible clients using Laravel.
📃 Description
Web Application Open Platform Interface (WOPI) protocol let you integrate Office in your web application.
WOPI protocol enables Office for the web to access and change files that are stored in your service. Basically it allows you to create Google Docs at the confert of your localhost/application.
Supports:
- Collabora Office (Recommended)
- Office 365
- OnlyOffice
📕 Documentation
You'll find the documentation on https://nagi1.github.io/laravel-wopi/docs.
Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the wopi implementation? Feel free to create an issue on GitHub, we'll try to address it as soon as possible.
⚡ Demo/Example
Demo app can be found at https://github.com/nagi1/wopi-host-example
🧪 Tested
This package has been tested using Wopi Validator.
👇👇👇
test Proof-validator vendor/bin/pest.
👇👇👇
To enable the Interactive WOPI Validation, adapt the WOPI configuration:
- client_url: Ensure using Office 365
- enable_interactive_wopi_validation: Set to
true
Warning: This will mock any valid file to be the .wopitest file, and therefore will be destroyed when running tests.
⚠ Important
Editor urls come from the discovery document of the client (/hosting/discovery),
including the placeholder groups such as <wopisrc=WOPI_SOURCE&>. The document is
cached, so clear it whenever the client gets upgraded, otherwise the browser is
handed action urls that no longer exist:
php artisan wopi:clear-discovery
Credits
This project build upon and extends but not limited to Pol Dellaiera's Wopi-lib.
License
The MIT License (MIT). Please see License File for more information.