Search by

osiktech / roundcube_backgrounds

osiktech

Background images for login/logout page [inspired by https://github.com/BlueLama/rc-login-background]

Package info

github.com/osiktech/roundcube_backgrounds

Type:roundcube-plugin

pkg:composer/osiktech/roundcube_backgrounds

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

dev-main 2026-06-02 12:32 UTC

Requires

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

GPL-3.0-or-later 64e50d7b62941480b386a06a3bb6e0bb8a966b9a

  • Osik <me.woop@osik.de>

loginbackgroundlogoutwallpaper

Published on Packagist.org on 2026-06-02 12:33 UTC

This package is auto-updated.

Last update: 2026-09-02 13:04:49 UTC

README

Roundcube plugin that shows a full-page wallpaper on the login and logout screens.

Features

  • Monthly — uses 01.jpg … 12.jpg (or january.jpg, february.jpg, …); falls back to cycling images in folder order
  • Random — picks a random image on each page load
  • Fixed — always shows one chosen image

All options are configured in config.inc.php only.

Installation

  1. Copy the plugin folder into your Roundcube plugins/ directory as plugins/roundcube_backgrounds/.

  2. Enable the plugin in config/config.inc.php:

    $config['plugins'] = ['roundcube_backgrounds'];

  3. Copy the sample config and adjust:

    cp plugins/roundcube_backgrounds/config.inc.php.dist plugins/roundcube_backgrounds/config.inc.php

  4. Add wallpaper images to plugins/roundcube_backgrounds/assets/ (jpg, png, webp, gif, or svg).

Configuration (config.inc.php)

Option Description
roundcube_backgrounds_mode monthly, random, or fixed
roundcube_backgrounds_fixed Filename for fixed mode
roundcube_backgrounds_path Custom image directory (optional)
roundcube_backgrounds_size CSS background-size (default: cover)
roundcube_backgrounds_position CSS background-position
roundcube_backgrounds_repeat CSS background-repeat
roundcube_backgrounds_attachment CSS background-attachment

Monthly naming examples

assets/images/01.jpg  … images/12.jpg
assets/images/january.jpg  … images/december.jpg

If no month-specific file exists, the plugin uses image index (month - 1) % number_of_images.

Compatibility

  • Roundcube 1.7+ — uses standard plugin hooks (startup, render_page) unchanged in 1.7
  • PHP 8.1+ — required by Roundcube 1.7
  • Elastic skin — login template and #layout-content selectors are unchanged in 1.7
  • Deploy with public_html/ as the web root; plugin images under plugins/roundcube_backgrounds/assets/images are served via static.php

License