sdc/contao-full-background-images

Use full background images in Contao Open Source CMS. This extension also provides a full background image slider/fader.

3.0.1 2022-05-15 12:44 UTC

Requires

• php: ^7.2 || ^8.0
• contao/core-bundle: ^4.9
• symfony/config: ^4.4 || ^5.1
• symfony/dependency-injection: ^4.4 || ^5.1
• symfony/http-kernel: ^4.4 || ^5.1

Requires (Dev)

• contao/easy-coding-standard: ^2.0
• contao/manager-plugin: ^2.0
• phpunit/phpunit: ^8.4
• symfony/phpunit-bridge: ^4.4 || ^5.1

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

Replaces

• oneup/contao-full-background-images: 3.0.1

MIT

• Sebastian Dernbach

• background
• images
• slider
• contao
• full

README

This extension provides multiple variants of having full background images for a Contao Open Source CMS based website:

• Single full background image with fade in
• Randomized full background image with fade in
• Multiple full background images with fade in and fade to change images
• Subpages can inherit settings from a parent page
• Mobile ready (phone & tablet)

Documentation

Installation

• Install it via the Contao Manager (Composer) (search for sdc/contao-full-background-images)

Requirements

• jQuery has to be enabled in the page layout

Usage

All settings are placed in the page tree. Subpages will inherit the settings from parent page by default.

You can optionally define different settings for each subpage. It's also possible to disable the background image(s) on certain pages.

Regular page / 403 / 404

Operation mode

• Inherit from parent - Inherits settings from a parent page
• Selection of background images - Choose the background images for this page
• Disabled - No background images are shown

Sort

• All known Contao sort modes

Image mode

• Single image - Show only one image (the first from the selection)
• Random single image - Show only one image (random from the selection)
• Fade multiple images - Show all images from the selection with fading

Timeout time

• Time between image changes in ms

Animation speed

• Animation speed in ms

Enable navigation

If checked, a navigation element is displayed (default lower left corner)

Enable navigation click

If checked, you can click on the navigation items to change the background

Enable prev/next navigation

If checked, a prev and a next button (default style: arrow) is added to the navigation items

Center image horizontally

If checked, the background image will be horizontally centered, else left aligned.

Center image vertically

If checked, the background image will be vertically centered, else top aligned.

Custom template

You can choose a specific template for the current page.

Upgrade Notes

• First release for Contao 4.4 3.0.0

Compatibility

This extension requires the Contao Open Source CMS at version 4.4.0 or higher and works in all modern browsers (Internet Explorer 8+).

License

This extension is licensed under the MIT license. See the complete license in the following directory:

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.

When reporting a bug, it may be a good idea to reproduce it in the demo project built using the Contao Open Source CMS to allow developers of the extension to reproduce the issue by simply cloning it and following some steps.