Vehicle Manager for Contao

An extension with filters and features to show your vehicle stock on your own website. All vehicles can be managed directly in the back end. Extensive filter and sorting functions complete the list view. The detail view contains all vehicle information and a lean product slider. Additional features can be integrated on request. Just ask us.

Your benefits

List view with extensive filter and sorting functions
Detail view with Contao image slider
Featured vehicle
Templates and design can be customized the usual “Contao way”
Guaranteed support for the latest or current Contao LTS version

Optionally available

Automatic synchronization of vehicles from the mobile.de platform via API
Automatic synchronization of vehicles from the SysCara platform via XML import

More information is available on the project website.

More information about the vehicle manager on pdir.de

Note

mobile.de and the mobile.de logo are registered trademarks of a third party and are not affiliated with pdir GmbH or the mobile.de* extension for Contao. The extension uses the mobile.de* API to import the vehicle data.

Quick start

Order a license Product website

This documentation covers the following topics:

@MDevster 251 commits

@seibtph 139 commits

@cmette 1 commits

Requirements

Note

The vehicle manager is compatible with Contao 4.9 or higher.

Contao 4

Contao 4 requires a web server such as Apache or NGINX with PHP and MySQL support. The vehicle manager requires Contao 4.9 or higher and PHP 7.2.

Tip

We recommend Contao 4.13 with PHP 8.1 or higher.

Contao Manager

The vehicle manager is easy to install with the Contao Manager. Just search for Fahrzeugmanager.

The extension in the extension directory on contao.org.

License

The vehicle manager for Contao is available as a domain license and can be ordered online on pdir.de.

For the full version, install the mobilede-sync-bundle.

Note

You receive the required access data and the installation guide by email after your order.

Order a license Product website

Installation

The extension is easy to install with the Contao Manager.

Open the Contao Manager and log in
Select Discover in the navigation
Enter “Fahrzeugmanager” in the search field
Click Add on Fahrzeugmanager (formerly Mobile.de Inserate)
Select Packages in the navigation
Click the green Apply changes button at the bottom
Run the database changes when the installation has finished

As soon as you want to import data from mobile.de, you need a license.

Order a license Product website

Configuration

This section covers the following topics:

1 / Create modules

First create one page each for the list view and the detail view.

List view

For the list view, place an element in the intended article and select the element type Fahrzeugmanager Listenansicht (vehicle manager list view).
In the field Detail view, select the page with the detail view.

Example placement of the element

Filter

Since version 2.3.0 of the vehicle manager you can show the filter form and the results on separate pages.

To show the filter form on a separate page, place an element of type Fahrzeugmanager Listenansicht (vehicle manager list view), select the page for the list view and enable the options Filter only and Show filter expanded.

This is what it should look like in the front end.

Detail view

For the detail view, place an element in the intended article and select the element type Fahrzeugmanager Detailansicht (vehicle manager detail view).

Contact form in the detail view

The ce_mobilede_reader template contains the following insert tag at around line 192: {{insert_form::1}} Enter the ID of the form you want to include here.

You can pass the vehicle model to the form when the page loads, for example with the following script:

<script>
$(document).ready( function() {
  if(jQuery('.md-detail-header h1').length) {
    jQuery('.additional-form input[name="Fahrzeug"]').html(jQuery('.md-detail-header h1').html());
  }
});
</script>

Example placement of the element

Accounts

Account overview

The menu item Accounts (PDIR APPS) opens the account overview, where you can also create a new account with the New button at the top right.

Create a new account

mobile.de import

Select MobileDe API Sync as the API type to import data from mobile.de.

Note

For the mobile.de API sync you need the full version of the vehicle manager, the access data for the mobile.de API and your customer ID. You find the customer ID in the source code of your mobile.de dealer page. (Example: https://home.mobile.de/MY-COMPANY, press F12 and search for “customerId” in the source code.)

Note

The API access data is not the same as your dealer login! This article (in German) describes where to find the access data and how to create it.

SYSCARA import

If you use the Syscara extension and want to import data from SYSCARA, select the API type Syscara-API Sync.

Synchronization

Manual synchronization

You can run a manual synchronization for all active accounts in the back end at any time. Go to PDIR APPS * Vehicle manager * Start import.

Automatic synchronization / poor man’s cron

Contao runs some tasks at regular intervals with its own cron functionality. All active vehicle manager accounts are updated every hour.

Automatic synchronization / real cron job on the server

Recommendation: set up a real cron job with the Contao console.

php vendor/bin/contao-console vehicle:mobileDe:import

The Contao manual explains how to set up the cron job correctly.

Import demo data

You can import our demo data for the initial setup. Go to PDIR APPS * Vehicle manager * Import demo data.

Update

You can update the extension with the Contao Manager. Then open the install tool and update the database if necessary.

Tip

A database backup beforehand never hurts!

Themes

Contao themes

These themes already include layout templates (CSS and templates) for the vehicle manager.

MATE theme

MATE is a Contao theme that supports Contao 4.x and uses the front end framework Materialize based on Material Design.

The theme is optimized for all devices and common browsers and already includes styles for all modules and elements of the Contao core. Header, footer and content as well as colors and layout can easily be adapted to your needs.

The MATE theme is available free of charge (with copyright notice) or as a paid version (without copyright notice).

There are 4 different color schemes with matching shades: green, blue, dark and yellow.

Demo: https://mate.pdir.de/immobilien.html Documentation: Vehicle manager Install for free or order a license: https://contao-themes.net/theme-detail/mate.html

List view (vertical layout)

List view (horizontal layout)

Exposé (detail view)

Issues

If you ran into problems during installation or setup, or if you found a bug in the extension, please open a new ticket:

All tickets Create a new ticket

Note

Please check first whether your bug is already known.

Vehicle Manager for Contao

Subsections of Vehicle Manager

Requirements

Contao 4

Contao Manager

License

License

Installation

Configuration

1 / Create modules

Subsections of Configuration

List view

Example placement of the element

Filter

Filter form on a separate page

Detail view

Contact form in the detail view

Example placement of the element

Accounts

Account overview

Create a new account

mobile.de import

SYSCARA import

Synchronization

Manual synchronization

Automatic synchronization / poor man’s cron

Automatic synchronization / real cron job on the server

Import demo data

Update

Themes

Contao themes

MATE theme

List view (vertical layout)

List view (horizontal layout)

Exposé (detail view)

Issues