snappymail/README.md

6.3 KiB


RainLoop Webmail


Simple, modern & fast web-based email client.

Modest system requirements, decent performance, simple installation and upgrade, no database required - all these make RainLoop Webmail a perfect choice for your email solution.


For more information about the product, check rainloop.net.

Information about installing the product, check the wiki page.

And don't forget to read the official documentation.

License

RainLoop Webmail (Community edition) is released under GNU AFFERO GENERAL PUBLIC LICENSE Version 3 (AGPL). http://www.gnu.org/licenses/agpl-3.0.html

Copyright (c) 2019 Rainloop Team

Modifications

This fork has the following changes:

  • Privacy/GDPR friendly (no: Social, Gravatar, Facebook, Google, Twitter, DropBox, OwnCloud, X-Mailer)
  • Admin uses password_hash/password_verify
  • Auth failed attempts written to syslog
  • Added Fail2ban instructions
  • ES2015
  • PHP 7.3+ required
  • PHP mbstring extension required
  • PHP replaced pclZip with ZipArchive
  • PHP yaml extension else use the old Spyc
  • Removed BackwardCapability (class \RainLoop\Account)
  • Removed ChangePassword (plugins won't work)
  • Removed OAuth support
  • Removed POP3 support
  • Removed background video support
  • Removed Sentry (Application Monitoring and Error Tracking Software)
  • Replaced gulp-uglify with gulp-terser
  • CRLF => LF line endings
  • Embed boot.js and boot.css into index.html
  • Ongoing removal of old JavaScript code (things are native these days)
  • Added modified Squire HTML editor as replacement for CKEditor
  • Split Admin specific JavaScript code from User code

Removal of old JavaScript

This fork uses downsized/simplified versions of scripts and has no support for Internet Explorer.

The result is faster and smaller download code (good for mobile networks).

Things might work in Edge 18, Firefox 50-62 and Chrome 54-68 due to one polyfill for array.flat().

  • Added dev/prototype-*.js for some additional features
  • boot.js without webpack overhead
  • Replaced jQuery with jQuery.slim
  • Replaced ProgressJS with simple native dropin
  • Replaced Autolinker with simple https/email detection
  • Replaced ifvisible.js with simple drop-in replacement
  • Replaced momentToNode with proper HTML5
  • Replaced resize listeners with ResizeObserver
  • Replaced bootstrap.js with native drop-in replacement
  • Replaced dev/Common/ClientStorageDriver/* with Web Storage Objects polyfill
  • Removed pikaday
  • Removed underscore
  • Removed polyfills
  • Removed Modernizr
  • Removed nanoscroll
  • Removed jquery-scrollstop
  • Removed jquery-mousewheel
  • Removed matchmedia-polyfill
  • Removed momentjs (localization still used)
  • Removed opentip (use CSS)
  • Removed non-community (aka Prem/Premium/License) code
  • Modified Jua.js to be without jQuery
  • Replaced *Ajax with *Fetch classes because we use the Fetch API, not jQuery.ajax
  • Replaced knockoutjs 3.4 with a modified 3.5.1
js/* 1.14.0 native
admin.js 2.130.942 855.381
app.js 4.184.455 2.498.825
boot.js 671.522 5.777
libs.js 647.614 326.075
polyfills.js 325.834 0
TOTAL 7.960.367 3.686.058
js/min/* 1.14.0 native gzip 1.14 gzip brotli
admin.min.js 252.147 117.342 73.657 33.520 28.941
app.min.js 511.202 340.862 140.462 89.653 72.639
boot.min.js 66.007 3.117 22.567 1.563 1.333
libs.min.js 572.545 302.989 176.720 94.417 83.208
polyfills.min.js 32.452 0 11.312 0 0
TOTAL 1.434.353 764.310 424.718 219.153 186.121

670.043 bytes (205.565 gzip) is almost 50% smaller and it feels faster.

CSS changes

  • Solve jQuery removed "features" with native css code.
  • Removed html.no-css
  • Removed dev/Styles/Cmd.less
  • Removed dev/Styles/Scroll.less
  • Removed Internet Explorer from normalize.css
  • Removed node_modules/opentip/css/opentip.css
  • Removed node_modules/pikaday/css/pikaday.css
  • Removed vendors/bootstrap/less/breadcrumbs.less
  • Removed vendors/bootstrap/less/navbar.less
  • Removed vendors/bootstrap/less/popovers.less
  • Removed vendors/bootstrap/less/progress-bars.less
  • Removed vendors/bootstrap/less/scaffolding.less
  • Removed vendors/bootstrap/less/sprites.less
  • Removed vendors/bootstrap/less/tooltip.less
  • Removed vendors/jquery-nanoscroller/nanoscroller.css
  • Removed vendors/jquery-letterfx/jquery-letterfx.min.css
  • Removed vendors/Progress.js/minified/progressjs.min.css
css/* 1.14.0 native gzip 1.14 gzip brotli
app.css 340.334 254.033 46,959 36.648 30.815
app.min.css 274.791 207.558 39.618 32.050 27.234
boot.css 2.538 837 668
boot.min.css 2.055 732 560

Squire vs CKEditor

The Squire implementation is not 100% compatible yet, but is shows the massive overhead of CKEditor.

Still TODO:

  • support for tables (really needed?!?)
  • support BIDI (really needed?!?)
normal min gzip min gzip
squire 128.826 47.074 33.671 15.596
ckeditor ? 520.035 ? 155.916

CKEditor including the 7 asset requests (css,language,plugins,icons) is 633.46 KB / 180.47 KB (gzip).

Enable it in /data/_data_/_default_/configs/application.ini in the [labs] section add/edit: use_squire_html_editor = On

PHP73 branch

There's a branch with only the PHP 7.3 changes at https://github.com/the-djmaze/rainloop-webmail/tree/php73