jfcherng-roundcube / cloudview
A Roundcube plugin which lets you view documents with cloud viewer.
Fund package maintenance!
www.paypal.me/jfcherng/5usd
Installs: 838
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 3
Forks: 5
Open Issues: 5
Type:roundcube-plugin
Requires
- php: >=7.1.3
- roundcube/plugin-installer: ~0.1
Requires (Dev)
- dev-master
- 0.6.19
- 0.6.18
- 0.6.17
- 0.6.16
- 0.6.15
- 0.6.14
- 0.6.13
- 0.6.12
- 0.6.11
- 0.6.10
- 0.6.9
- 0.6.8
- 0.6.7
- 0.6.6
- 0.6.5
- 0.6.4
- 0.6.3
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.4
- 0.5.3
- 0.5.2
- 0.5.1
- 0.5.0
- 0.4.5
- 0.4.4
- 0.4.3
- 0.4.2
- 0.4.1
- 0.4.0
- 0.3.2
- 0.3.1
- 0.3.0
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.1
- 0.1.0
- dev-dependabot/npm_and_yarn/elliptic-6.6.0
- dev-dependabot/npm_and_yarn/braces-3.0.3
This package is auto-updated.
Last update: 2024-10-31 02:24:53 UTC
README
A Roundcube plugin which lets you directly view mail attachments in the browser with cloud viewers like Google Docs or Microsoft Office Web.
Viewers & Supported Formats
3rd-party Viewers
Self-hosting Viewers
Requirements
This plugin is tested in the following environment.
- Roundcube:
1.4.0
,1.6.0
- PHP:
7.1.3
(min requirement),8.1
- Skin:
Classic
,Larry
,Elastic
Different environments may work as well without guarantee.
How to install this plugin in Roundcube
Install via Composer (Recommended)
This plugin has been published on Packagist by the name of jfcherng-roundcube/cloudview.
- Go to your
ROUNDCUBE_HOME
(i.e., the root directory of your Roundcube). - Run
composer require jfcherng-roundcube/cloudview
. - Copy
config.inc.php.dist
toconfig.inc.php
and editconfig.inc.php
if you want.
Install manually
- Create folder
cloudview
inROUNDCUBE_HOME/plugins
if it does not exist. - Copy all plugin files there.
- Copy
config.inc.php.dist
toconfig.inc.php
and editconfig.inc.php
if you want. - Edit
ROUNDCUBE_HOME/conf/config.inc.php
locate$config['plugins']
and add'cloudview',
there:
<?php // some other codes... $config['plugins'] = array( // some other plugins... 'cloudview', // <-- add this );
Prerequisites
This plugin will extract attachments from messages into plugins/cloudview/temp/
so that remote cloud viewers can publicly access them.
- The
temp/
directory underplugins/cloudview/temp/
should be public accessible. - Make sure the user running the RoundCube server has "write" permission to the
temp/
directory. - Your RoundCube installation should be publicly accessible. I.e., not under an internal server.
Temporary Files
Those temporary files under plugins/cloudview/temp/
will not be deleted automatically.
You will need to setup a cron job to periodically delete them.
For example, execute crontab -e
and add the following job
# delete temporary files on 03:00 AM every day
0 3 * * * rm -rf PATH_TO_ROUNDCUBE/plugins/cloudview/temp/*/
For Developers
Compile Frontend Assets
- You will need to have Node.js installed.
- Install dependencies via
npm install
(oryarn
if you prefer) - Compile assets with
./compile.sh
Acknowledgement
- The basic idea comes from https://github.com/brestows/cloudview-roundcube
- This plugin is initially sponsored by @Galandrix.