Syscara Import for Contao

The Syscara Import bundle is an extension for the vehicle manager and imports vehicle data via the API of the well-known CRM software SYSCARA©.

Your benefits

fast and automatic loading of all specified vehicles via the Syscara API
automatic mapping of the vehicle data from the API to the vehicle manager
automatic import of all photos and the floor plan (for motorhomes) of each vehicle

Note

The import requires access data for the Syscara CRM. Without access data, no vehicle data can be read from the Syscara API.

Note

SYSCARA and the SYSCARA logo are registered trademarks of a third party and are not affiliated with pdir GmbH or the Syscara Import* 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:

Requirements

Note

Syscara Import 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 Syscara Import bundle requires Contao 4.9 or higher and PHP 7.4. The vehicle manager must be installed in version 3.1 or higher.

Tip

We recommend Contao 4.9 with PHP 7.4 or higher.

License

Syscara Import for Contao is available as a domain license and can be ordered online on pdir.de.

For the full version, install vehicle-syscara-import.

Note

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

Order a license Product website

Installation

Contao 4 with the Contao Manager

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 SYSCARA, you need a license.

Order a license Product website

Configuration

You find more information about the configuration in the vehicle manager section Configuration.

Synchronization

You find more information about the synchronization in the vehicle manager section Synchronization.

Linking the vehicle number

To make vehicles reachable via their vehicle number (domain.com/VEHICLENUMBER), first install the extension terminal42/contao-url-rewrite.

In the folder app/src/EventListener, create a PHP file named HookListener.php.

<?php

namespace App\EventListener;

use Contao\CoreBundle\ServiceAnnotation\Hook;
use Contao\Database;
use Contao\StringUtil;

class HookListener {
    /**
     * @Hook("vehicleFetchItems")
     */
    public function vehicleFetchItems($vehicles): void
    {
        $vehicles = json_decode(json_encode($vehicles), true);

        $database = Database::getInstance();
        $database->execute("TRUNCATE tl_url_rewrite");

        foreach($vehicles as $item) {
            $alias = '/details/'.StringUtil::generateAlias($item['hersteller'].' '.$item['modell'].' '.$item['baureihe'].' '.$item['eigene_id']).'.html';
            $alias = str_replace(['ä','ü','ö'], ['a','u','o'], $alias);

            $set = [
                'name' => $item['eigene_id'],
                'tstamp' => time(),
                'type' => 'basic',
                'requestPath' => '/'.$item['eigene_id'],
                'responseUri' => $alias,
                'responseCode' => 301
            ];
            $database->prepare("INSERT INTO tl_url_rewrite %s")->set($set)->execute();
        }
    }
}

The line $database->execute("TRUNCATE tl_url_rewrite"); empties the table. If you have other rewrite rules, you need to adjust this part.

You may also need to adjust the alias in $alias = '/details/' if the vehicle detail page has a different URL.

Then create config.php in the folder app/contao/config and clear the cache in the Contao Manager.

<?php

use App\EventListener\HookListener;

$GLOBALS['TL_HOOKS']['vehicleFetchItems'][] = [HookListener::class, 'vehicleFetchItems'];

With the next import, the table should be filled. You find it in the back end under System > URL rewrites.

Syscara Import for Contao

Subsections of Syscara Import

Requirements

Contao 4

License

License

Installation

Contao 4 with the Contao Manager

Configuration

Configuration

Synchronization

Linking the vehicle number