https://github.com/heimrichhannot/contao-teaser-bundle

Teaser is a contao content element, that provides the ability to link the element with pages, articles, files, downloads and external urls. Can be used as replacement for ce_page_teaser.
https://github.com/heimrichhannot/contao-teaser-bundle

Last synced: 2 months ago
JSON representation

Teaser is a contao content element, that provides the ability to link the element with pages, articles, files, downloads and external urls. Can be used as replacement for ce_page_teaser.

• Host: GitHub
• URL: https://github.com/heimrichhannot/contao-teaser-bundle
• Owner: heimrichhannot
• Created: 2018-08-14T07:02:32.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-03-05T10:28:40.000Z (4 months ago)
• Last Synced: 2025-05-03T09:46:18.799Z (2 months ago)
• Language: PHP
• Size: 535 KB
• Stars: 0
• Watchers: 4
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

        
# Contao Teaser Bundle

Teaser is a contao content element, that provides the ability to link the element with pages, articles, files, downloads and external urls.

Can be used as replacement for ce_page_teaser. 

## Features

 

* Custom text and css-class for more link

* Link the whole article

* Hide more link, link entire element.

* Overwrite content template

* migration command from ce_page_teaser module and older versions.

![Teaser Frontend](docs/img/contao-teaser-bundle_screenshot_frontend.png)

![Teaser Backend](docs/img/contao-teaser-bundle_screenshot_backend.png)

## Usage

### Install

	

Prerequisites:

* Contao ^4.9 Managed edition

* PHP ^8.1

Install with composer:

```

composer require heimrichhannot/contao-teaser-bundle

```

Update the database afterwards.

## Developers

### Templates

* Element template prefix: `ce_linkteaser_`.

* Image template prefix: `linkteaser_content_image_`.

### Hooks

| Name                      | Arguments                                    | Expected return value | Description                                              |

|---------------------------|----------------------------------------------|-----------------------|----------------------------------------------------------|

| `generateTeaserLink`      | $element: LinkTeaserElement, $showMore: bool | $showMore: bool       | Add custom teaser source and modify the content element. |

| `getContentSourceOptions` | $options: array, $dc: DataContainer          | $options: array       | Add custom source options to the dca.                    |

### Add custom text for more link

Just add your custom text in the default contao translation file within `$GLOBALS['TL_LANG']['MSC']['linkteaser']['teaserlinktext']`. Afterwards (maybe you need to clear your cache) you can choose the new entry in the more link text field.

### Upgrade from older versions

See [Upgrade introductions](UPGRADE.md)