terminal42/contao-node

Node bundle for Contao Open Source CMS

1.5.26 2024-11-25 10:10 UTC

Requires

• php: ^8.0
• codefog/contao-haste: ^4.21 || ^5.0
• codefog/tags-bundle: ^3.3
• contao/core-bundle: ^4.13 || ^5.0
• doctrine/dbal: ^3.3
• psr/log: ^1.0 || ^2.0 || ^3.0
• symfony/config: ^5.0 || ^6.0 || ^7.0
• symfony/dependency-injection: ^5.0 || ^6.0 || ^7.0
• symfony/http-foundation: ^5.0 || ^6.0 || ^7.0
• symfony/http-kernel: ^5.0 || ^6.0 || ^7.0
• symfony/security-core: ^5.0 || ^6.0 || ^7.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• terminal42/contao-build-tools: dev-main
• terminal42/contao-geoip2-country: ^1.4

Suggests

• terminal42/contao-geoip2-country: Protect nodes in Contao using MaxMind GeoIP2 database

Conflicts

• contao/manager-plugin: <2.0 || >=3.0
• terminal42/contao-geoip2-country: < 1.4 || >= 2.0

MIT

• terminal42 gmbh

• node
• content
• contao

README

This bundle provides a new way for Contao to manage content elements that are common for multiple pages.

Installation

Install the bundle via Composer:

composer require terminal42/contao-node

Configuration

Once installed, you can start creating groups and nodes in the Content > Nodes backend module. Roughly said they work similar to articles – each node can have multiple content elements.

You can then display those nodes in the front end using either the Nodes front end module or content element. Both of them allow you to select either one or multiple nodes and order them.

To better organize nodes you can specify the languages the respective content elements were written in and use arbitrary tags to be able to quickly filter and find them again. Both the languages as well as the tags don't have any influence on the front end but can help you to manage your content in an efficient way.

Thanks to the Contao picker, finding the correct node is as easy as it can get!

Contao non-managed edition

If you don't use the Contao managed edition, additionally you have to configure the tags bundle on your app-level:

# config/config.yml
codefog_tags:
    managers:
        terminal42_node:
            source: 'tl_node.tags'

Insert Tags

The extension also provides two new insert tags: {{insert_node::*}} and {{insert_nodes::*}}. The former expects the ID of a node and will then generate the output of that node. The latter expects a comma separated list of node IDs and will then generate the output of all those nodes. Example: {{insert_nodes::1,2,3}}