WordPress.org
Get WordPress
WordPress.org

Plugin Directory

Webschmiede Vehicle Inventory

Webschmiede Vehicle Inventory

By Webschmiede
Download

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/Vehicle with Offer; 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 take id="<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.

Screenshots

Vehicle overview with filter and search. Highlighted vehicles carry a label and come first.
Vehicle overview with filter and search. Highlighted vehicles carry a label and come first.
Vehicle page with gallery, price, contact buttons and technical data.
Vehicle page with gallery, price, contact buttons and technical data.
The “Vehicle list” block in the editor – as grid, list or slider, with its settings in the sidebar.
The “Vehicle list” block in the editor – as grid, list or slider, with its settings in the sidebar.
Vehicles in the backend with image, price, status and mobile.de listing number.
Vehicles in the backend with image, price, status and mobile.de listing number.
mobile.de connection: status, last valid sync, queue and the settings for sync and images.
mobile.de connection: status, last valid sync, queue and the settings for sync and images.
Display settings: contact details, card fields and how long sold vehicles stay visible.
Display settings: contact details, card fields and how long sold vehicles stay visible.
Built-in help with instructions for every block and shortcode.
Built-in help with instructions for every block and shortcode.

Blocks

This plugin provides 2 blocks.

  • Vehicle list
  • Vehicle filter

Installation

  1. Install and activate the plugin.
  2. Go to Vehicles mobile.de and enter your API credentials (or define WS_FZ_MOBILE_USER and WS_FZ_MOBILE_PASS in wp-config.php).
  3. Click “Test connection”, then “Start sync”.
  4. Recommended: run wp ws-fz sync from a real server cron job every hour.

FAQ

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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Webschmiede Vehicle Inventory” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Webschmiede Vehicle Inventory” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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_stand and ws_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_hinweis hides 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, prefix ws_fz_). No own update mechanism.

0.3.0

  • Blocks, filter, templates, structured data.

0.2.0

  • Sync engine, local images, lifecycle, WP-CLI.

Meta

Ratings

No reviews have been submitted yet.

Your review

See all reviews

Contributors

Support

Got something to say? Need help?

View support forum