Description
Webschmiede Vehicle Inventory imports the vehicle listings of a mobile.de dealer account into WordPress and keeps them in sync.
- Complete, safe sync. Every run compares the full list of listings. If mobile.de answers with an error or an incomplete list, nothing is changed. A mass-removal guard stops the sync when many vehicles disappear at once.
- Lifecycle. A vehicle that is no longer listed is marked as sold after two valid runs, stays visible with a “sold” notice for a configurable time and then redirects (301) to the overview.
- Local images. Images are stored in the media library (WebP), unchanged images are never downloaded twice.
- Blocks. Vehicle list (grid, list or slider), filter and search, gallery with lightbox, data, price, equipment, description, consumption, contact buttons, “sold” notice and similar vehicles. Templates for the single vehicle, the overview and the archives are provided and can be changed in the site editor.
- Block bindings. Bind core paragraph, heading, image and button blocks to vehicle fields.
- Structured data.
Car/VehiclewithOffer; integrates into Rank Math’s graph when Rank Math is active. - Shortcodes for every page builder (Elementor, WPBakery, Divi, classic editor):
[ws_fz_liste],[ws_fz_filter],[ws_fz_galerie],[ws_fz_daten],[ws_fz_preis],[ws_fz_ausstattung],[ws_fz_beschreibung],[ws_fz_umwelt],[ws_fz_kontakt],[ws_fz_verkauft],[ws_fz_aehnliche]and[ws_fz_feld feld="preis"]. They accept the same settings as the blocks, e.g.[ws_fz_liste layout="slider" anzahl="8" spalten_desktop="4"]; vehicle shortcodes takeid="<mobile.de ID or post ID>"or use the current vehicle. - No theme or page builder required. Works with any block theme and the standard block editor.
- Translatable. All texts are in English and translatable; translations are managed on translate.wordpress.org.
- WP-CLI.
wp ws-fz sync,wp ws-fz status --format=json,wp ws-fz pruefen.
You need API access to the mobile.de Search API (a dealer account with API credentials).
External services
This plugin connects to the mobile.de Search API (https://services.mobile.de/search-api/), operated by mobile.de GmbH, to read the vehicle listings of the dealer account you configure.
- What is sent: your API user name and password (HTTP Basic authentication) and, if set, your mobile.de customer number. No visitor data is ever sent.
- When: only on the server, during the scheduled sync (hourly by default, or when an administrator starts it, or via WP-CLI). Visitors’ browsers never contact mobile.de.
- Images of the listings are downloaded from mobile.de’s image servers (
img.classistatic.de) during the sync and stored in your media library. - Documentation: https://services.mobile.de/docs/search-api.html
- Service provider: mobile.de GmbH – Terms of Service: https://www.mobile.de/en/service/agbIndex · Privacy Policy: https://www.mobile.de/en/service/privacyPolicy
- Using the API requires your own access agreement with mobile.de. You are responsible for complying with its terms.
Disclaimer
Webschmiede Vehicle Inventory is an independent product of Webschmiede. It is not affiliated with, endorsed by or connected to mobile.de GmbH in any way, and it was neither developed, distributed nor supported by mobile.de. The name mobile.de is used only to describe which interface the plugin works with; it is a trademark of its owner.
The plugin shows the data exactly as the mobile.de Search API delivers it. We take care to display it correctly, but we cannot guarantee that the information is complete or accurate. If something looks wrong, please contact us.
Installation
- Install and activate the plugin.
- Go to Vehicles → mobile.de and enter your API credentials (or define
WS_FZ_MOBILE_USERandWS_FZ_MOBILE_PASSinwp-config.php). - Click “Test connection”, then “Start sync now”.
- Recommended: run
wp ws-fz syncfrom a real server cron job every hour.
FAQ
Where do I get the mobile.de API credentials?
The plugin needs an API user and an API password for the mobile.de Search API. According to mobile.de, a dealer account gets these credentials in the mobile.de dealer area; otherwise mobile.de customer support activates the Search API. Menu names and any costs are up to mobile.de. Details: Vehicles → Help in the plugin and the mobile.de API documentation at https://services.mobile.de/.
What happens if mobile.de is not reachable?
Nothing changes. A run only counts when every page of the list was received completely and without errors.
Will vehicles be deleted?
No vehicle is deleted by the sync. Sold vehicles are kept as an expired post so that their old address can redirect. Uninstalling the plugin keeps all vehicles unless you explicitly choose otherwise in the settings.
Can editors change the data?
Data from mobile.de is shown read-only in the editor. Editors can add their own text, highlight or hide a vehicle and change the display settings under Vehicles → Display. Vehicle types, makes and classes come from mobile.de as well; only their description (shown on their archive page) can be edited.
Where do I find instructions for the blocks and shortcodes?
In the backend under Vehicles → Help.
Screenshots







Changelog
0.8.0
- New: central design defaults under Vehicles → Display – primary colour (price, highlight, “sold” notice), secondary colour (background of cards and filter), border colour and width (vehicle cards) and corner radius (cards, filter, gallery). They apply to the vehicle list, filter, gallery, price, similar vehicles and “sold” notice blocks and their shortcodes; where a block has its own setting, that value wins. Theme palette colours can be picked from a list with colour swatches.
- New: button colour and button text colour for the contact, phone, filter and “Load more” buttons. Empty = the theme decides, as before.
- New: live preview next to the design settings – a sample vehicle card, filter and buttons change immediately while you edit.
- Note: border width and corner radius of existing list, filter and gallery blocks that use the previous defaults (1 px, 8 px) now follow the central default. Without a central default they look the same as before.
- New: help section “Access to the mobile.de API” (name of the interface, dealer area, API support contact as published by mobile.de) and a link to it on the mobile.de screen while no credentials are set.
- Slider: no scrollbar when arrows or dots are shown (scrolling with touch, trackpad or mouse wheel still works). Without JavaScript or with controls set to “None” the scrollbar stays.
- Fix: archive pages of a make (e.g. /fahrzeuge/marke/man/) redirected to themselves and could not be opened. The permalink rules are rewritten once after the update.
- Fix: with a border wider than 2 px, the bottom border of vehicle cards was cut off in the slider.
- Fix: drop-downs in the plugin settings have the same height as the input fields next to them.
- Fix: the provided templates (single vehicle, overview, archives) no longer show “unexpected content” warnings in the site editor.
- Fix: the slider marks the first dot as active right after loading.
- Fix: the default texts “Top offer” and the “sold” notice are no longer stored when saving the display settings. They now follow the language of the website; existing custom texts stay as they are.
- Plugin header: Plugin URI points to the plugin page on webschmiede.at.
- Readme: button name “Start sync now” corrected; tag “fahrzeuge” instead of “gutenberg”.
0.7.1
- Migration from “Ad Integration for mobile.de API”: the migration record is now stored in the database (non-autoloaded option) instead of a folder under wp-content. The plugin keeps no files of its own; vehicle images are imported into the uploads directory via media_handle_sideload().
- Uninstall also removes the options
ws_fz_standandws_fz_listen_seiten.
0.7.0
- Renamed to Webschmiede Vehicle Inventory (slug
webschmiede-vehicle-inventory). - The sync warning in the admin area now only appears on the plugin’s own screens and on the Plugins screen.
- Translation files are no longer bundled in the wordpress.org package; translations come from translate.wordpress.org.
0.6.4
- Plugin header: removed the Plugin URI, which was the same as the Author URI.
0.6.3
- Plugin name shortened to “WS Fahrzeuge”, so the plugin’s address on wordpress.org matches its text domain
ws-fahrzeuge.
0.6.2
- New WS mark in the admin header, taken from the Webschmiede logo.
- A short note about setup and support by Webschmiede on the plugin’s Help page and below its settings pages. Each user can hide it; the filter
ws_fz_webschmiede_hinweishides it for everyone. Nothing is loaded from or sent to external servers.
0.6.1
- Requires PHP 8.1 (was 8.3).
- Translations: a language pack from wordpress.org takes precedence over the bundled German files.
- Every PHP file is protected against direct access.
- Vehicle cards and structured data: the first-registration abbreviation is translated (was always “EZ”); the address hint on the mobile.de page is translated.
- Database queries use identifier placeholders (%i) for table and column names; passes Plugin Check without errors or warnings.
0.6.0
- All texts are now in English and translatable; German translations (de_DE, de_DE_formal) are included. Other German locales (de_AT, de_CH …) fall back to them.
- Vehicle types and classes are assigned via their mobile.de key, so changing the site language never creates duplicate terms. Existing terms are recognised automatically.
0.5.3
- Admin notices (also from other plugins) appear above the plugin header instead of inside it.
- New page Vehicles → Help with short instructions for blocks and shortcodes.
- Vehicle types, makes and classes are created and assigned only by the sync. Their description stays editable; name, slug, assignment and deletion are locked.
0.5.2
- The vehicle title always comes from mobile.de; it can no longer be edited in the backend.
0.5.1
- Vehicles can never be added by hand, even if another plugin replaces the post type capabilities.
0.5.0
- Shortcodes for page builders without the block editor.
- Redesigned admin pages (status tiles, cards, switches) and list columns for image, price and status.
- Filter labels stay readable in themes that colour form labels.
0.4.0
- Renamed to WS Fahrzeuge (slug
ws-fahrzeuge, prefixws_fz_). No own update mechanism.
0.3.0
- Blocks, filter, templates, structured data.
0.2.0
- Sync engine, local images, lifecycle, WP-CLI.
