PHPackages                             thelia/carousel-module - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. thelia/carousel-module

ActiveThelia-module

thelia/carousel-module
======================

2.6.0(6mo ago)242.9k↑93.2%5[3 issues](https://github.com/thelia-modules/Carousel/issues)1LGPL-3.0+PHP

Since Oct 25Pushed 6mo ago4 watchersCompare

[ Source](https://github.com/thelia-modules/Carousel)[ Packagist](https://packagist.org/packages/thelia/carousel-module)[ RSS](/packages/thelia-carousel-module/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (79)Used By (1)

Carousel
========

[](#carousel)

This module for Thelia add a customizable carousel on your home page. You can upload you own image and overload the default template in your template for using the carousel.

Installation
------------

[](#installation)

- Copy the module into `/local/modules/` directory and be sure that the name of the module is Carousel.
- Activate it in your thelia administration panel

Usage
-----

[](#usage)

In the configuration panel of this module, you can upload as many images as you want.

Hook
----

[](#hook)

The carousel is installed in the "Home page - main area" (home.body) hook.

Loop
----

[](#loop)

Customize images with the `carousel` loop, which has the same arguments as the `image` loop. You can define a width, a height, and many other parameters

### Input arguments

[](#input-arguments)

ArgumentDescription**width**A width in pixels, for resizing image. If only the width is provided, the image ratio is preserved. Example : width="200"**height**A height in pixels, for resizing image. If only the height is provided, the image ratio is preserved. example : height="200"**rotation**The rotation angle in degrees (positive or negative) applied to the image. The background color of the empty areas is the one specified by 'background\_color'. example : rotation="90"**background\_color**The color applied to empty image parts during processing. Use $rgb or $rrggbb color format. example : background\_color="$cc8000"**quality**The generated image quality, from 0(!) to 100%. The default value is 75% (you can hange this in the Administration panel). example : quality="70"**resize\_mode**If 'crop', the image will have the exact specified width and height, and will be cropped if required. If 'borders', the image will have the exact specified width and height, and some borders may be added. The border color is the one specified by 'background\_color'. If 'none' or missing, the image ratio is preserved, and depending od this ratio, may not have the exact width and height required. resize\_mode="crop"**effects**One or more comma separated effects definitions, that will be applied to the image in the specified order. Please see below a detailed description of available effects. Expected values :- gamma:value : change the image Gamma to the specified value. Example: gamma:0.7.
- grayscale or greyscale : switch image to grayscale.
- colorize:color : apply a color mask to the image. The color format is $rgb or $rrggbb. Example: colorize:$ff2244.
- negative : transform the image in its negative equivalent.
- vflip or vertical\_flip : flip the image vertically.
- hflip or horizontal\_flip : flip the image horizontally.

example : effects="greyscale,gamma:0.7,vflip"**group**The name of an image group. Return only images from the specified group**filter\_disable\_slides**if true (the default), the disabled slides will not be displayed### Ouput arguments

[](#ouput-arguments)

VariableDescription$IDthe image ID$IMAGE\_URLThe absolute URL to the generated image$ORIGINAL\_IMAGE\_URLThe absolute URL to the original image$IMAGE\_PATHThe absolute path to the generated image file$ORIGINAL\_IMAGE\_PATHThe absolute path to the original image file$ALTalt text$TITLEthe slide title$CHAPOthe slide summary$DESCRIPTIONthe slide description$POSTSCRIPTUMthe slide conclusion$LOCALEthe textual elements locale$POSITIONthe slide position in the carousel$URLthe related URL$LIMITEDtrue if slide is disabled, false otherwise$START\_DATElimited slide display start date$END\_DATElimited slide display end date$DISABLEtrue if slide display is limited$GROUPname of the group the slide belong to### Exemple

[](#exemple)

```
{loop type="carousel" name="carousel.front" width="1200" height="390" resize_mode="borders"}

{/loop}

```

How to override ?
-----------------

[](#how-to-override-)

If you want your own carousel in your tempalte, create the directory `modules/Carousel` then create the template `carousel.html` in this directory. Here you can create your own carousel and the replace the default template provided in the module.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance48

Moderate activity, may be stable

Popularity33

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~60 days

Recently: every ~175 days

Total

74

Last Release

185d ago

Major Versions

1.0 → 2.1.62015-02-24

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2196919?v=4)[thelia](/maintainers/thelia)[@thelia](https://github.com/thelia)

---

Top Contributors

[![lopes-vincent](https://avatars.githubusercontent.com/u/6057206?v=4)](https://github.com/lopes-vincent "lopes-vincent (20 commits)")[![gillesbourgeat](https://avatars.githubusercontent.com/u/7335734?v=4)](https://github.com/gillesbourgeat "gillesbourgeat (17 commits)")[![roadster31](https://avatars.githubusercontent.com/u/2197734?v=4)](https://github.com/roadster31 "roadster31 (12 commits)")[![anoziere](https://avatars.githubusercontent.com/u/118798868?v=4)](https://github.com/anoziere "anoziere (4 commits)")[![ThomasArnaud](https://avatars.githubusercontent.com/u/10884519?v=4)](https://github.com/ThomasArnaud "ThomasArnaud (4 commits)")[![lunika](https://avatars.githubusercontent.com/u/767834?v=4)](https://github.com/lunika "lunika (3 commits)")[![bibich](https://avatars.githubusercontent.com/u/1215555?v=4)](https://github.com/bibich "bibich (2 commits)")[![enurit](https://avatars.githubusercontent.com/u/6229611?v=4)](https://github.com/enurit "enurit (1 commits)")[![robinallezard](https://avatars.githubusercontent.com/u/32717550?v=4)](https://github.com/robinallezard "robinallezard (1 commits)")[![zorn-v](https://avatars.githubusercontent.com/u/12619075?v=4)](https://github.com/zorn-v "zorn-v (1 commits)")

### Embed Badge

![Health badge](/badges/thelia-carousel-module/health.svg)

```
[![Health](https://phpackages.com/badges/thelia-carousel-module/health.svg)](https://phpackages.com/packages/thelia-carousel-module)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)