Car Listings – Installation & Nutzung
Diese Anleitung richtet sich an Endbenutzer des WordPress-Plugins Car Listings von CATAMA Software. Das Plugin zeigt Fahrzeuge aus Ihrer CATAMA-Anwendung mit Filter- und Detailansicht auf Ihrer Website an.
Voraussetzungen
- WordPress ab Version 5.0
- PHP ab Version 7.4
- Ein CATAMA-Zugang mit API-Token für die Fahrzeugliste (Token finden Sie in den CATAMA-Einstellungen)
Installation
Plugin installieren
- Laden Sie die ZIP-Datei des Plugins von Ihrer Bezugsquelle herunter. z.B. https://www.catama-software.de/plugins/carlistings/downloads/car-listings-latest.zip
- Melden Sie sich im WordPress-Backend an.
- Gehen Sie zu Plugins → Installieren → Plugin hochladen.
- Wählen Sie die ZIP-Datei aus und klicken Sie auf Jetzt installieren.
- Nach der Installation: Plugin aktivieren klicken.
Das Menü Car Listings erscheint anschließend unter Einstellungen.
Erste Einrichtung
Öffnen Sie Einstellungen → Car Listings und tragen Sie die folgenden Pflichtangaben ein:
Basis-URL Ihrer CATAMA-Anwendung, z. B.
https://app.catama-software.deDen Token für den Zugriff auf die Fahrzeugliste finden Sie in den CATAMA-Einstellungen. Er wird nur serverseitig verwendet und nicht im Frontend angezeigt.
Speichern Sie die Einstellungen mit Einstellungen speichern. Anschließend können Sie die weiteren Optionen (Kontakt, Design, Felder, Cache) anpassen.
Einstellungen im Überblick
| Bereich | Beschreibung |
|---|---|
| Allgemeine Einstellungen | CATAMA URL und API-Token (siehe Erste Einrichtung). |
| Kontakt-Einstellungen | Kontakt-Formular-URL (mit Platzhalter {fahrzeugname}), Telefonnummer, URL zur Fahrzeug-Übersichtsseite. |
| Design-Einstellungen | Farben für Buttons, Text, Hintergrund, Rahmen usw. – an Ihr Corporate Design anpassbar. |
| Preis-Einstellungen | Netto-Preis anzeigen ja/nein, Bezeichnung für Bruttopreis. |
| Übersichtsseite / Detailseite – Felder | Auswahl, welche Felder (z. B. Erstzulassung, Kilometerstand, Preis) angezeigt werden. |
| Anpassbare Labels | Bezeichnungen der Fahrzeugeigenschaften (z. B. „Hersteller“, „Modell“, „Kilometerstand“) anpassen. |
| Cache-Verwaltung | Cache-Dauer in Minuten (Standard 5). Button „Cache jetzt leeren“, wenn Änderungen in CATAMA sofort sichtbar sein sollen. |
| Auto-Update System | Anzeige der Plugin-Version, Option für automatische Updates, Button „Jetzt aktualisieren“, falls eine neue Version bereitsteht. |
| URL-Struktur (Rewrite Rules) | Wenn Fahrzeug-Detailseiten einen 404-Fehler liefern: Rewrite Rules neu laden klicken. |
Nutzung auf der Website
Shortcodes
Das Plugin stellt zwei Shortcodes bereit:
| Shortcode | Verwendung |
|---|---|
[car_listings] |
Zeigt die Fahrzeugübersicht mit Filtern an. Einmal auf einer Seite oder einem Beitrag einfügen (z. B. auf der Seite „Fahrzeuge“). |
[car_detail id="123"] |
Zeigt die Detailansicht eines Fahrzeugs mit der ID 123. Wird meist nicht manuell genutzt – die Detailseiten haben eine eigene URL (siehe unten). |
Fahrzeug-Detailseiten (eigene URLs)
Jedes Fahrzeug hat eine eigene, suchmaschinenfreundliche URL:
https://ihre-domain.de/fahrzeug/ID/slug
Beispiele:
https://ihre-domain.de/fahrzeug/202/vw-polohttps://ihre-domain.de/fahrzeug/205/audi-a6
Die Links von der Übersicht („Mehr erfahren“ o. Ä.) führen automatisch auf diese URLs. Wenn nach der Aktivierung des Plugins die Detailseiten mit 404 antworten, gehen Sie unter Einstellungen → Car Listings zum Abschnitt URL-Struktur und klicken Sie auf Rewrite Rules neu laden.
Ablauf für Besucher
- Besucher öffnet die Seite mit
[car_listings](z. B. „Fahrzeuge“). - Übersicht mit Filteroptionen und Karten wird angezeigt.
- Klick auf ein Fahrzeug führt zur Detailseite
/fahrzeug/ID/slug. - Auf der Detailseite: Kontakt-Button (Formular/Telefon) und „Zurück zur Übersicht“, sofern in den Einstellungen konfiguriert.
Updates
Unter Einstellungen → Car Listings im Bereich Auto-Update System sehen Sie die aktuelle Version und ob ein Update verfügbar ist. Sie können:
- Jetzt nach Updates suchen – prüft erneut auf dem Update-Server.
- Jetzt auf Version x.x.x aktualisieren – führt Sie zur WordPress-Update-Seite, wo Sie das Plugin-Update ausführen.
Optional können Sie Automatische Updates aktivieren, damit WordPress das Plugin bei neuen Versionen selbst aktualisiert.
Hilfe & Tipps
Keine Fahrzeuge sichtbar
- CATAMA URL und API-Token prüfen (in CATAMA: Token in den Einstellungen prüfen).
- In CATAMA nur Fahrzeuge mit mobile_status = 1 (bzw. für Anzeige freigegeben) erscheinen in der Liste.
Detailseiten zeigen 404
Einstellungen → Car Listings → Abschnitt URL-Struktur (Rewrite Rules) → Rewrite Rules neu laden klicken.
Änderungen aus CATAMA erscheinen nicht
Die Daten werden gecacht. Unter Einstellungen → Car Listings → Cache-Verwaltung auf Cache jetzt leeren klicken oder die Cache-Dauer verringern.
Download fehlgeschlagen beim Plugin-Update
Wenn beim Update „Service Unavailable“ oder „Download fehlgeschlagen“ erscheint, liegt das an der Erreichbarkeit der Download-URL auf dem Update-Server. Unter Einstellungen → Car Listings finden Sie den ausklappbaren Abschnitt Hilfe bei Download-Fehlern mit Hinweisen und optionaler Filter-Lösung.