Skip to content
BranchesTags

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
assets/images
assets/images
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
composer.json
composer.json
 
 
config.inc.php.dist
config.inc.php.dist
 
 
roundcube_backgrounds.php
roundcube_backgrounds.php
 
 

Repository files navigation

Roundcube Backgrounds

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

About

A roundcube webmail plugin to display background images on login/logout page. It can display background images on monthly basis, randomly pick from a folder or display a fixed background image. Inspired by https://github.com/BlueLama/rc-login-background

Resources

Readme
GPL-3.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages