contao-community-alliance/merger2

Module merger V2 for Contao OpenSource CMS

4.3.1 2024-09-16 07:00 UTC

Requires

• php: ^8.0
• ext-json: *
• ext-mbstring: *
• contao/core-bundle: ^4.13 || ^5.0
• doctrine/dbal: ^2.11 || ^3.1
• menatwork/contao-multicolumnwizard-bundle: ^3.5
• mobiledetect/mobiledetectlib: ^2.8 || ^3.74
• symfony/config: ^4.4 || ^5.1 || ^6.0
• symfony/dependency-injection: ^4.4 || ^5.1 || ^6.0
• symfony/http-foundation: ^4.4 || ^5.1 || ^6.0
• symfony/http-kernel: ^4.4.13 || ^5.1.5 || ^6.0
• symfony/translation-contracts: ^1.1 || ^2.0 || ^3.0
• symfony/twig-bundle: ^4.4 || ^5.1 || ^6.0
• symfony/yaml: ^4.4 || ^5.1 || ^6.0
• twig/twig: ^2.0 || ^3.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• phpcompatibility/php-compatibility: dev-develop
• phpcq/coding-standard: ^2.1.2
• phpcq/runner-bootstrap: 1.x-dev
• phpcsstandards/phpcsutils: ^1.0@dev
• sebastian/diff: ^4.0

Conflicts

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

Replaces

• bi3/contao-merger2: 4.3.1
• contao-legacy/merger2: 4.3.1

LGPL-3.0-or-later

• David Molineus

• theme
• module
• layout
• contao

README

Merger²

The Contao Community Alliance merger² extension provides a powerful frontend module to merge various content:

• Article inheritance
• Conditional content
• Powerful condition language

Requirements

Merger² v4 requires at least Contao 4.13 with PHP 7.4 or Contao 5 with PHP 8.0 higher and is prepared for the Contao Managed Edition.

Changelog

See CHANGELOG

Documentation

The documentation is managed as a wiki on Github. Feel free to contribute.

Condition Reference

Each condition is an expression which may contain different functions. Function may be combined with && or || constraints and you can turn back conditions with ! as NOT.

articleExists(column: string [, includeUnpublished: bool])

Test if an article exists in the specific column or section.

• column Column or section name.
• includeUnpublished If true also unpublished articles are recognized.

children(count: integer [, includeUnpublished: bool])

Test if the page have the specific count of children.

• count Count of children.
• includeUnpublished Include unpublished pages.

depth(value: string)

Test the page depth.

• value Depth with comparing operator, e.g. ">2".

isMobile([cookieOnly: bool])

Detect if page is rendered as mobile page.

• cookieOnly If true only the TL_VIEW cookie is recognized. Otherwise the user agent might active mobile view if an mobile layout exist.

language(language: string)

Test the page language.

• language Page language

page(pageId: string|integer)

Test the page id or alias.

• pageId Page id or alias

pageInPath(pageId: string|integer)

Test if page id or alias is in path.

• pageId Page id or alias

platform (platform: string)

Test the user platform.

• platform Platform type. Valid values are desktop, tablet, smartphone or mobile.

root (pageId: string|integer)

Test the root page id or alias.

• pageId Page id or alias

Custom functions

Merger² is prepared for custom functions. Simply implement the ContaoCommunityAlliance\Merger2\Functions\FunctionInterface and provide it as a cca.merger2.function tagged service.