PHPackages                             pr3set-llc/silverstripe-elemental-promos - 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. [Templating & Views](/categories/templating)
4. /
5. pr3set-llc/silverstripe-elemental-promos

ActiveSilverstripe-vendormodule[Templating & Views](/categories/templating)

pr3set-llc/silverstripe-elemental-promos
========================================

A block to display a group of promo objects - a small card with an image, headline, short description, and link.

5.0.0(7mo ago)010BSD-3-ClausePHPPHP ^8.1

Since Oct 9Pushed 7mo agoCompare

[ Source](https://github.com/PR3SET-LLC/silverstripe-elemental-promos)[ Packagist](https://packagist.org/packages/pr3set-llc/silverstripe-elemental-promos)[ RSS](/packages/pr3set-llc-silverstripe-elemental-promos/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (4)Used By (0)

Silverstripe Elemental Promos
=============================

[](#silverstripe-elemental-promos)

A block to display a group of promos - a small card with an image, headline, short desciption, and link.

[![CI](https://github.com/dynamic/silverstripe-elemental-promos/actions/workflows/ci.yml/badge.svg)](https://github.com/dynamic/silverstripe-elemental-promos/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/8b12497eceb43c83b6e9d8a314f26aaf9eb0a3017ca9db17b007df4756db7999/68747470733a2f2f636f6465636f762e696f2f67682f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/dynamic/silverstripe-elemental-promos)

[![Latest Stable Version](https://camo.githubusercontent.com/8fe44c46686eb91bec8116feaee12aaa75aab60a49faf948238867e8bf2ea2a2/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f762f737461626c65)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![Total Downloads](https://camo.githubusercontent.com/a8313643a66f2bc416306c525a8f1c7d3506adbca02521bd55331c905be37e93/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f646f776e6c6f616473)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![Latest Unstable Version](https://camo.githubusercontent.com/9cabaa9b0c99fd260428d914c4d2234be3093fd3439305e15f8bc16bf878e3fa/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f762f756e737461626c65)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![License](https://camo.githubusercontent.com/17ebb73896c9e5b3fb35dd51c0daf0ee962a62aec5b32c10db2c0afb5317557a/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f6c6963656e7365)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)

Requirements
------------

[](#requirements)

- dnadesign/silverstripe-elemental: ^5
- dynamic/silverstripe-elemental-baseobject: ^5
- jonom/focuspoint: ^5

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

[](#installation)

`composer require dynamic/silverstripe-elemental-promos`

License
-------

[](#license)

See [License](LICENSE.md)

Usage
-----

[](#usage)

A content block to display a group of promos - a small card with an image, headline, short desciption, and link. Typically this will display 3 to 4 promos per row depending on layout restrictions.

### Template Notes

[](#template-notes)

The default templates are based off [Bootstrap 5](https://getbootstrap.com/) classes/styling

Screen Shots
------------

[](#screen-shots)

#### Default Template of a Promos Element

[](#default-template-of-a-promos-element)

[![Default Template of a Promos Element](./docs/en/_images/promos-block-sample.png)](./docs/en/_images/promos-block-sample.png)

#### CMS - Promos Main Tab

[](#cms---promos-main-tab)

[![CMS - Promos Block Main Tab](./docs/en/_images/promos-block-cms.png)](./docs/en/_images/promos-block-cms.png)

#### CMS - Promos Block - Promo Edit

[](#cms---promos-block---promo-edit)

[![CMS - Promos Block - Promos Edit](./docs/en/_images/promos-block-cms-promo-edit.png)](./docs/en/_images/promos-block-cms-promo-edit.png)

Upgrading from version 4
------------------------

[](#upgrading-from-version-4)

This module drops `gorriecoe/silverstripe-linkfield` usage in favor of `silverstripe/linkfield`.

Getting more elements
---------------------

[](#getting-more-elements)

See [Elemental modules by Dynamic](https://github.com/orgs/dynamic/repositories?q=elemental&type=all&language=&sort=)

Configuration
-------------

[](#configuration)

See [SilverStripe Elemental Configuration](https://github.com/silverstripe/silverstripe-elemental#configuration)

Translations
------------

[](#translations)

The translations for this project are managed via [Transifex](https://www.transifex.com/dynamicagency/silverstripe-elemental-promos/)and are updated automatically during the release process. To contribute, please head to the link above and get translating!

Maintainers
-----------

[](#maintainers)

- [Dynamic](https://www.dynamicagency.com) ()

Bugtracker
----------

[](#bugtracker)

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

- Create a new issue
- Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
- Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution
----------------------------

[](#development-and-contribution)

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance65

Regular maintenance activity

Popularity5

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.1% of commits — single point of failure

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 ~1 days

Total

3

Last Release

214d ago

Major Versions

5.x-dev → 6.x-dev2025-10-10

PHP version history (2 changes)5.0.0PHP ^8.1

6.x-devPHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/c208fab8524cbd6c981c5b550a073e4d09b30ecf085657753328008ac398042a?d=identicon)[pr3set](/maintainers/pr3set)

---

Top Contributors

[![jsirish](https://avatars.githubusercontent.com/u/1163643?v=4)](https://github.com/jsirish "jsirish (49 commits)")[![muskie9](https://avatars.githubusercontent.com/u/870751?v=4)](https://github.com/muskie9 "muskie9 (13 commits)")[![mak001](https://avatars.githubusercontent.com/u/1750550?v=4)](https://github.com/mak001 "mak001 (3 commits)")[![juangadiel-pr3set](https://avatars.githubusercontent.com/u/231773882?v=4)](https://github.com/juangadiel-pr3set "juangadiel-pr3set (2 commits)")[![juangadiel](https://avatars.githubusercontent.com/u/706997?v=4)](https://github.com/juangadiel "juangadiel (2 commits)")[![AntonyThorpe](https://avatars.githubusercontent.com/u/1023740?v=4)](https://github.com/AntonyThorpe "AntonyThorpe (2 commits)")[![korthjp17](https://avatars.githubusercontent.com/u/3858661?v=4)](https://github.com/korthjp17 "korthjp17 (1 commits)")

---

Tags

silverstripecontentcardblockselementalpromospiff

### Embed Badge

![Health badge](/badges/pr3set-llc-silverstripe-elemental-promos/health.svg)

```
[![Health](https://phpackages.com/badges/pr3set-llc-silverstripe-elemental-promos/health.svg)](https://phpackages.com/packages/pr3set-llc-silverstripe-elemental-promos)
```

###  Alternatives

[nobrainerweb/silverstripe-content-blocks

Split your page content into manageable blocks/sections of content, each with their own template

301.5k](/packages/nobrainerweb-silverstripe-content-blocks)

PHPackages © 2026

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