rapid-data / company-data-bundle
Bundle for storing and outputting general company data as well as their branch locations
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ^4.9
- heimrichhannot/contao-multi-column-editor-bundle: ^2.12
- heimrichhannot/contao-twig-support-bundle: ^1.0
- illuminate/collections: ^v8.30
- illuminate/support: ^v8.30
- rapid-data/contao-rapid-utilities-bundle: ^1.1.3 || ^2.0
- symfony/config: ^4.4 || ^5.1
- symfony/dependency-injection: ^4.4 || ^5.1
- symfony/http-kernel: ^4.4 || ^5.1
Requires (Dev)
- contao/easy-coding-standard: ^2.0
- contao/manager-plugin: ^2.0
- phpunit/phpunit: ^8.4
- symfony/phpunit-bridge: ^4.4 || ^5.1
Conflicts
- contao/manager-plugin: <2.0 || >=3.0
README
Dieses Contao-Bundle erweitert Contao 4 um die Möglichkeit, im Backend grundlegende Firmendaten, sowie Standorte der Firmen zu verwalten. Angelegte Firmendaten können entweder als Inhaltselement oder durch Insert-Tags ausgegeben bzw. weiter verwendet werden.
Installation
Das Bundle kann direkt über composer installiert werden:
composer require rapid-data/company-data-bundle
Verwendung
Nach der Installation steht im Contao-Backend der Menüpunkt „Firmendaten” zur Verfügung. Dort können Firmen und ihre Standorte angelegt werden.
Inhaltselemente
Zur Ausgabe der Firmendaten stehen 3 Module zur Auswahl:
- Firma: Gibt die Firmendaten ggf. zusammen mit dem Hauptstandort aus.
- Liste von Filialen: Gibt die Filialen einer Firma als strukturierte Daten (schema.org) aus.
- Filiale: Gibt die Daten einer einzelnen Filiale als strukturierte Daten (schema.org) aus.
Insert-Tags
Alle Firmen- und Filial-/Standortdaten können auch über Insert-Tags ausgegeben werden.
| Insert-Tag | Beschreibung |
|---|---|
{{company_[eigenschaft]::[company-alias]}} | Gibt die Eigenschaft [eigenschaft] der Firma mit dem Alias [company-alias] aus. Beispiel: {{company_name::firma1}} |
{{company_socialMedia::[company-alias]:[socialNetwork]_[eigenschaft]}} | Gibt die Social-Media-Eigenschaft [eigenschaft] der Firma mit dem Alias [company-alias] für die Platform [socialNetwork] aus. Beispiel: {{company_socialMedia::firma1:facebook_url}} |
{{company_location_[eigenschaft]::[company-alias]:[location-alias]}} | Gibt die Standort-Eigenschaft [eigenschaft] für den Standort [location-alias] der Firma mit dem Alias [company-alias] aus. Beispiel: {{company_location_name::firma1:standort1}} |
Standard-Firma in einem Seitenbaum
Es kann für einen Seitenbaum, eine ‚besitzende‘ Firma festgelegt werden. Um auf die Besitzer-Firma innerhalb des Seitenbaumes zuzugreifen, kann der Alias bei den Insert-Tags weggelassen werden:
{{company_email}} oder für den Hauptstandort (sofern er im Backend als Hauptstandort zugewiesen wurden) {{company_location_name}}.