Wichtig: Diese Erweiterung nicht mit Catalog-Manager v1 installieren!
Der Catalog Manager hat sich bereits bei über 100 Contao-Projekten bewährt.
Überzeuge Dich selbst und installiere eine kostenfreie und uneingeschränkte Testversion. Kaufe erst eine Lizenz, wenn Dein Projekt fertiggestellt ist. Bis dahin stehen wir Dir mit Unterstützung und Beratung zur Seite.
Teste den Catalog Manager und lass Dich von seinen umfangreichen Funktionen überzeugen. Unser Team unterstützt Dich gerne bei der Umsetzung Deiner Projekte.
Deinen Katalog kannst Du ganz einfach unter "Catalog Manager" anlegen. Grundsätzlich ist alles selbsterklärend.
Bei den Navigationseinstellungen kannst Du nur bestehende Navigationspunkte auswählen. Wenn Du einen eigenen Navigationspunkt hinzufügen möchtest, musst Du diesen in Deiner "contao/config/config.php" deklarieren. Hier ist ein Beispiel, wie das geht:
use Contao\ArrayUtil;
ArrayUtil::arrayInsert($GLOBALS['BE_MOD'], 1, [
'my_catalogs' => []
]);
So kannst Du eigene Navigationspunkte erstellen und Deinen Katalog individuell anpassen. Und den prod.cache "leeren" nicht vergessen ;)
Wenn Du eine Eltern-Kind-Beziehung zwischen Deinen Katalogen herstellen möchtest, musst Du Deine Kind-Kataloge einfach als Unterpunkte zum Eltern-Katalog anlegen. Das funktioniert genauso wie beim Anlegen von Unterseiten in der Seitenstruktur.
Wichtig: Sobald Dein Katalog "Datensätze" enthält, kannst Du die Kataloge nicht mehr verschieben!
Es ist auch möglich, Deinen Katalog nach Fieldsets, Subpaletten oder Typen zu unterteilen. Dies kannst Du unter "Paletten bearbeiten" (grünes Icon, 3. von links) machen. Hier sind ein paar Beispielkonfigurationen:
Mit diesen Einstellungen kannst Du Deinen Katalog nach Deinen Bedürfnissen strukturieren und anpassen.
In der neuen Version des Catalog Managers kannst Du keine Backend-CSS-Klassen, SQL-Datentypen oder reguläre Ausdrücke direkt definieren. Stattdessen läuft alles über Rollen, daher ist es wichtig, für jeden Feldtyp die passende Rolle auszuwählen. Hier ist eine Übersicht der wichtigen Rollen:
Ab Version 3.2 wird es möglich sein, eigene Rollen zu definieren.
Auch Listen sind selbsterklärend. Du kannst für alle Deine Kataloge (generell für alle Tabellen) eine Liste ausgeben. Einzig die Ausgabe der Daten im Frontend ist etwas "schwierig". Wie beim Vorgänger gibt es kein Backend-Modul für die Frontend-Ausgabe, das heißt, Du musst auch hier ein Template anlegen.
Im Gegensatz zum Catalog Manager v1 gibt es hier zwei Listen: einmal als Inhaltselement und einmal als Frontend-Modul. Im Inhaltselement gibt es ein Template celistview*, in dem alle Einträge in ein Array übergeben werden. Dieses Array kannst Du in einer foreach-Schleife auslesen. Auf die Felder kannst Du über den Feldnamen zugreifen.
<div class="cm-refrence-list block">
<?php foreach ($this->entities as $arrEntity): ?>
<div class="cm-refrence-entity">
<div class="entity-image">
<a href="https://github.com/alnv/contao-catalog-manager-bundle/blob/master/<?= $arrEntity['masterUrl'] ?>">
<?php if (!empty($arrEntity['image'])): ?>
{{image::<?= $arrEntity['image'][0]['path'] ?>?mode=crop&width=400&height=400}}
<?php endif; ?>
</a>
</div>
<div class="entity-content">
<h3 class="entity-headline"><?= $arrEntity['title'] ?></h3>
<?php if ($arrEntity['teaser']): ?>
<div class="entity-teaser">
<p><?= $arrEntity['teaser'] ?></p>
</div>
<?php endif; ?>
</div>
<div class="entity-link"><a href="https://github.com/alnv/contao-catalog-manager-bundle/blob/master/<?= $arrEntity['masterUrl'] ?>">Weiterlesen</a></div>
</div>
<?php endforeach;?>
</div>
<?= $this->pagination ?>
Mit diesem Template kannst Du Deine Katalogeinträge im Frontend anzeigen lassen. Die Einträge werden in einer foreach-Schleife durchlaufen und entsprechend formatiert ausgegeben.
Das Frontend-Modul besteht aus einem "wrapper"-Template mod_listing_table und die jeweiligen Einträge werden in einem eigenen Template cmlisting* ausgegeben. Hier ein Beispiel:
<?php
use Contao\Date;
$arrEvent = $this->getParent();
$strUrl = array_values($arrEvent['pages'])[0]['master'] ?? '';
?>
<div class="cm-event-entity">
<?php if ($this->origin['startDate']): ?>
<div class="entity-date">
<div class="date-day"><p><?= Date::parse('d', $this->origin['startDate']) ?>.</p></div>
<div class="date-month"><p><?= Date::parse('M', $this->origin['startDate']) ?></p></div>
<div class="date-year"><p><?= Date::parse('Y', $this->origin['startDate']) ?></p></div>
</div>
<?php endif; ?>
<div class="entity-content">
<p class="content-location"><?= $this->location ?></p>
<p class="content-title"><?= $arrEvent['title'] ?></p>
<?php if ($arrEvent['teaser']): ?>
<div class="content-teaser">
<p><?= strip_tags($arrEvent['teaser']) ?></p>
</div>
<?php endif; ?>
<?php if ($strUrl): ?>
<p class="content-url"><a href="https://github.com/alnv/contao-catalog-manager-bundle/blob/master/<?= $strUrl ?>?date=<?= $this->id ?>">mehr Erfahren</a></p>
<?php endif; ?>
</div>
</div>
In diesem Beispiel-Template wird ein einzelner Event-Eintrag im Frontend dargestellt. Die Event-Daten werden mit Hilfe von Contao-Funktionen formatiert und ausgegeben. Das Template kann individuell angepasst werden, um den Anforderungen Deiner Website gerecht zu werden.
Wenn Du in Deinem Backend-Modul "Inhaltselemente" aktivierst, kannst Du für jeden Eintrag individuelle Inhaltselemente anlegen. Diese werden nicht standardmäßig im Template ausgegeben, sondern über eine Funktion:
<?= $this->getContentElements() ?>
Füge diese Funktion in Dein Template ein, um die Inhaltselemente anzuzeigen.
Deine Einträge können in eine Merkliste eingetragen werden. Füge dazu das folgende Formular in Dein Template ein:
<?php
use Alnv\ContaoCatalogManagerBundle\Library\Watchlist;
?>
<?= (new Watchlist())->getForm($this->id, $this->_table, ['useUnits' => true]); ?>
Als erster Parameter muss die ID des Datensatzes eingegeben werden, und als zweiter Parameter die Tabelle.
{{WATCHLIST}}
Liefert die IDs der Datensätze, die in der Merkliste drin sind
{{WATCHLIST-TABLE::?template=ce_watchlist_table&tables=table1,table2}}
Liefert die Tabelle mit allen Datensätzen in der Merkliste
{{WATCHLIST-RESET}}
Leert die Merkliste
{{WATCHLIST-COUNT}}
Liefert die Anzahl der Datensätze in der Merkliste
Über die $this->getRelated('myfieldname') kannst du auf Kind-Elemente zugreifen. Als Rückgabewert erhältst du ein Array, das du mit einer foreach-Schleife durchlaufen und ausgeben kannst. Die einzelnen Datensätze haben wiederum die gleichen Template-Funktionen wie das Eltern-Element.
Hier ist ein Beispiel, wie du darauf zugreifen kannst:
<?php
$arrEntities = $this->getRelated('myfieldname');
?>
<?php foreach($arrEntities as $arrEntity): ?>
<div class="child-entity">
<h3><?= $arrEntity['title'] ?></h3>
<p><?= $arrEntity['description'] ?></p>
<!-- Weitere Felder entsprechend ausgeben -->
</div>
<?php endforeach; ?>
In diesem Beispiel wird das Array $arrEntities mit den Kind-Elementen des Feldes "myfieldname" durchlaufen und jedes Kind-Element mit seinen Feldern wie "title" und "description" ausgegeben. Du kannst dieses Muster anpassen und weitere Felder entsprechend deiner Anforderungen einfügen.
Mit $this->getParent()
kannst du auf das Elternelement zugreifen.
Wenn deine Einträge in der Sitemap erscheinen sollen, musst du dein Katalog unbedingt in einem Frontend-Modul auswählen und dort eine Detailseite definieren.
Für die Detailansicht steht nur ein Frontend-Modul zur Verfügung. Dieses besteht aus zwei Templates: mod_master und cmmaster. Im cmmaster gelten die gleichen Regeln und Funktionen wie in der Listenansicht (cmlisting*).
Du kannst die Liste und Detailansicht auf derselben Seite anzeigen. Nutze die Funktion "Element verstecken", um jeweils die passenden Module für die Listenansicht und Detailansicht zu steuern. Siehe Screenshot.
In der Listenansicht und in einigen anderen Modulen gibt es ein Widget für den Filter. Siehe Screenshot. Vereinfacht gesagt kannst du in diesem Widget die Werte eintragen, nach denen du filtern möchtest, entweder als "Klartext" oder "Inserttag". Achte darauf, dass der Feldwert, der tatsächlich in der Datenbank gespeichert ist, mit dem abgefragten Wert übereinstimmt. Außerdem beachte den Operator, der grundsätzlich gilt:
Wenn du einen Filter erstellen möchtest, benötigst du im Grunde ein Modul, das die gefilterten Parameter als GET-Parameter an den Client übergibt, z.B. https://catalog-manager.org/meine-seite/?category=123. Den GET-Parameter "category" kannst du dann mit {{ACTIVE::category}} auslesen und in den Filtereinstellungen verwenden. Als Modul für den Filter kannst du den Formulargenerator (Formulare) von Contao verwenden oder dein eigenes Formular erstellen.
Um deine Kataloge (Produkte, Jobs, Ansprechpartner etc.) mehrsprachig zu gestalten, kannst du in den Katalog-Einstellungen unter Data Container die Option "Multilingual" auswählen und so deine Tabelle übersetzen. Hierbei verwenden wir die Erweiterung contao-DC_Multilingual von terminal42 (https://github.com/terminal42/contao-DC_Multilingual).
Die Optionen, Auswahllisten und Feldbezeichnungen kannst du mit dem "Übersetzer"-Modul vom Catalog-Manager übersetzen. Die verfügbaren Optionen werden automatisch im Übersetzer-Modul angelegt, sind jedoch zunächst deaktiviert und nur in der Hauptsprache verfügbar. Wenn du den Übersetzer nutzen möchtest, öffne ihn im Backend, wähle den gewünschten Text aus und klicke auf "Bearbeiten". In der Eingabemaske kannst du dann die Sprache und die Übersetzung aktivieren. Siehe dazu den Screenshot.
Darüber hinaus kannst du den Text kopieren und in einer neuen Sprache anlegen. Wichtig ist hierbei, dass der Feldname gleich bleibt und nicht verändert wird.
Du hast auch die Möglichkeit, eigene Texte mit selbstgewählten Feldnamen anzulegen.
Diese Texte kannst du dann in deinem Template verwenden:
<?php
use Alnv\ContaoTranslationManagerBundle\Library\Translation;
?>
<div>
<p><?= Translation::getInstance()->translate('<FELDNAME>') ?></p>
<p><?= $this->myValue ?></p>
</div>
Oder mit InsertTag:
<?php
use Alnv\ContaoTranslationManagerBundle\Library\Translation;
?>
<div>
<p>{{TRANSLATE::FELDNAME::STANDARD WERT}}</p>
<p><?= $this->myValue ?></p>
</div>
Um das Eingabefeld für die Bilderauswahl im Backend zu konfigurieren, kannst du das Eingabefeld "Upload" verwenden. Anschließend musst du die passende Rolle auswählen: "image" für Einzelbilder oder "gallery" für mehrere Bilder. Unabhängig von der gewählten Rolle werden die Bilder immer in einem Array ausgegeben und haben stets dieselben Feldnamen (im Array). Daher benötigst du in deinem Template eine FOREACH-Schleife (oder vergleichbare PHP-Funktion), um auf die Bilder zugreifen zu können:
<?php // Beim Upload-Eingabefeld haben wir den Feldname "images" gewählt, daher $this->images ?>
<?php foreach ($this->images as $arrImage): // $this->images "images" ist eine Variable (Feldname im Eingabefeld) ?>
<figure>
{{image::<?= $arrImage['path'] ?>?mode=proportional&width=800&height=600}}
oder
{{picture::<?= $arrImage['path'] ?>?size=1}}
</figure>
<?php endforeach; ?>
Die Bildgröße kannst du über den InsertTag {{image::}} oder {{picture::}} definieren.
Du kannst die Frontend-Module auch im JSON-Format erhalten, indem du einen POST-Request an folgende URL sendest: /catalog-manager/json-listing/<MODULE-ID>/<PAGE-ID>
Als Parameter sind die ID des Frontend-Moduls (Listenansicht) und die Seiten-ID, von der der Request stammt, erforderlich. An die URL kannst du auch GET-Parameter anhängen, z.B. ?category=123.
Hier ein Beispiel:
function fetchCatalogData(url) {
// Markiere den Ladevorgang als aktiv
this.loading = true;
// Falls keine URL übergeben wurde, wird eine Standard-URL verwendet
if (!url) {
url = '/catalog-manager/json-listing/<MODULE-ID>/<MODULE-ID>';
}
// AJAX-POST-Anfrage mit fetch API
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded'
},
body: new URLSearchParams(this.params),
})
.then(response => response.json())
.then(data => {
// Verarbeite die Antwortdaten
this.catalogs = this.parse(data.results); // Verarbeitung der Ergebnisse
this.total = data.limit ? data.limit : 0; // Gesamtzahl der Ergebnisse
this.pagination = data.pagination; // Pagination-Daten
// Setze die Pagination nach einer kurzen Verzögerung
setTimeout(() => {
this.setPagination(); // Funktion zur Aktualisierung der Pagination
this.loading = false; // Ladevorgang beenden
this.initial = false; // Initialisierung beenden
}, 50);
})
.catch(error => {
console.error('Fehler bei der AJAX-Anfrage:', error);
this.loading = false; // Ladevorgang beenden
});
}
Du kannst auch eine Liste mit paar Zeilen PHP-Code ausgeben.
<?php
use Alnv\ContaoCatalogManagerBundle\Views\Listing;
$arrEntities = (new Listing('<DEINE-CM-TABELLE>', [
'column' => ['pid=?'], // Hier kannst du deine Wunschabfrage hinterlegen.
'value' => [$this->id], // Hier die Datenbankwerte je Abfrage.
'order' => 'startDate DESC', // Reihenfolge
'masterPage' => "<SEITEN-ID" // Optional
]))->parse();
<?php foreach ($arrEntities as $arrEntity): ?>
<h3><?= $arrEntity['MY_FIELD'] ?></h3>
<?php endforeach; ?>
Damit die Umkreissuche korrekt funktioniert, müssen folgende Schritte durchgeführt werden:
1. Adressfelder im Katalog definieren:
Dein Katalog benötigt spezifische Adressfelder wie Postleitzahl oder Ort und Land. Optional können auch Straße und Hausnummer hinzugefügt werden. Weisen Sie den einzelnen Feldern die passenden Rollen zu: street (Straße), streetNumber (Hausnummer), city (Ort), zip (Postleitzahl), postal (Postleitzahl), state (Bundesland), country (Land).
2. GEO-Coding-Lizenzschlüssel erstellen:
Erstelle einen GEO-Coding-Lizenzschlüssel bei Google. Dies kann über den folgenden Link erfolgen: https://console.cloud.google.com/apis/dashboard
3. Formular mit Adressfeldern erstellen:
Erstelle ein Formular, das deine Adressfelder enthält:
Dazu gehören mindestens Postleitzahl oder Ort sowie Land. Optional können Straße und Hausnummer hinzugefügt werden. Verwende die folgenden Feldnamen: rs_pstl für Postleitzahl rs_cty für Ort rs_strt für Straße + Hausnummer rs_cntry für Land rs_dstnc für Distanz Umkreis der Suche definieren:
Im Feld rs_dstnc kann der Suchradius definiert werden. Hierbei werden nur Zahlen akzeptiert.
Mehr Infos folgen …