=== Ad Integration for mobile.de API ===
Contributors: werbeagenturcommotion
Tags: mobile.de, api, ad-integration
Requires at least: 6.7
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plugin to integrate the Ad-Integration for mobile.de via the API and show your vehicles on your website.

== Description ==
This plugin connects your website directly to **mobile.de (Ad Integration API)** and imports all your vehicles along with their vehicle data.

This allows you to present your vehicle offerings on your website without duplicate maintenance. Changes on mobile.de (e.g., price, availability, features) are automatically applied.

= Features =
* Importing vehicles via the mobile.de API
* Saving the vehicles as **Custom Post Type** in WordPress
* Support for all vehicle categories (e.g. SUV, sedan, convertible, motorbikes and motorhomes)
* Automatic transfer of images, descriptions and technical data
* Customizable permalinks (e.g. `/vehicles/limousine/audi-a6/`)
* Dedicated archive and detail pages for vehicles
* Additional shortcodes, Gutenberg blocks and widgets for Elementor
* Compatible with all popular themes and page builders such as **Gutenberg, WPBakery, Elementor and DIVI**

= Who is the plugin suitable for? =
The plugin is ideal for **car dealerships, vehicle dealers, and fleets** who want to manage their offers on mobile.de and also display them on their own website – without duplicating the effort.

= Disclaimer =
This product is not affiliated with mobile.de GmbH. It has not been developed, supported, or distributed by mobile.de, nor is it endorsed or connected with mobile.de in any way. Any references to mobile.de are made solely for technical compatibility or functional description purposes.

We strive to display all data accurately; however, we do not guarantee the correctness of the information provided. In case of technical issues or discrepancies, please contact us for assistance.

== External Services ==

= mobile.de Search API =
This plugin connects to the mobile.de Search API to retrieve, import and update vehicle advertisements from mobile.de.

What the service is used for:

* Importing, updating and displaying your vehicle listings inside WordPress.

What data is sent:

* API credentials for mobile.de (username and password)
* Search parameters such as filters, pagination and timestamps
* The mobile.de Ad ID when retrieving detailed ad information
* Date of last sync

When data is sent:

* On setup
* During scheduled cron synchronisation (hourly)
* When manually triggering a sync in the backend

Service provider:

* mobile.de GmbH
* [Terms of Service](https://www.mobile.de/en/service/agbIndex)
* [Privacy Policy](https://www.mobile.de/en/service/privacyPolicy)

= License Verification =
This plugin sends a license validation request to: https://api.commotion.online/license.php

What the service is used for:

* Verifying the authenticity and validity of the plugin license

What data is sent:

* The plugin license key (ID) in JSON format

When data is sent:

* Only if a license is set at all
* When entering or validating the license key
* Periodically, to confirm ongoing license validity (once per day)

Service provider:

* [ComMotion](https://commotion.online/en/)
* [Privacy Policy](https://commotion.online/en/privacy/)

== Frequently Asked Questions ==

= Do I need a dealer account for mobile.de? =
Yes. The plugin only works with valid access data for the **mobile.de Ad Integration API**.

= Can I customize the vehicle pages? =
Yes. Vehicles are created as a custom post type and can be freely designed using your theme or page builder.

= Are changes synchronized automatically? =
Yes. The built-in cron job updates the data regularly and reliably.

= Where can I find the documentation and help? =
Often you are not alone with a problem or a question. We regularly publish help and expand the documentation with new functions. [Go to help](https://commotion.online/en/mobile-de-api-documentation/)

= Where can I get support? =
We support you with your project on request. We offer you both to set up the plugin and to carry out individual change requests. Just contact us without obligation. [Go to contact](https://commotion.online/en/contact/?topic=Ad+Integration+for+mobile.de+API+in+WordPress)

== Installation ==

= Minimum Requirements =
* PHP 8.0
* MySQL 5.6 or MariaDB 10.3

= Recommended Requirements =
* PHP 8.5 or greater is recommended
* MySQL 8.1 or greater is recommended
* MariaDB 10.6 or greater is recommended

= Automatic installation =
Automatic installation is the easiest option -- WordPress will handles the file transfer, and you won't need to leave your web browser. To do an automatic install, log in to your WordPress dashboard, navigate to the Plugins menu, and click "Add New."

In the search field type "Ad Integration for mobile.de API" then click "Search Plugins." Once you've found us, you can view details about it such as the point release, rating, and description. Most importantly of course, you can install it by! Click "Install" and WordPress will take it from there.

= Manual installation =
Manual installation method requires downloading the plugin and uploading it to your web server via your favorite FTP application. The WordPress codex contains [instructions on how to do this here](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation).

= Updating =
Automatic updates should work smoothly, but we still recommend you back up your site.

If you encounter issues with the course pages after an update, flush the permalinks by going to WordPress > Settings > Permalinks and hitting "Save". That should return things to normal.

== Contributors & Developers ==
"Ad Integration for mobile.de API" is currently available in English and German.

== Screenshots ==

1. Frontend: Archive vehicles page / page with shortcode
2. Frontend: Filter vehicles by category
3. Frontend: Single vehicle page with all details
4. Backend: Gutenberg block and shortcodes for implementation
5. Backend: Custom Post Type for all imported vehicles
6. Backend: Settings

== Credits ==

Plugin bundles the following third-party resources:

* slick, Copyright 2017, Ken Wheeler, Licensed under the MIT license.

== Changelog ==

= 1.3.2 =
* Minor bugfixes and improvements.
* Compatibility for latest WordPress version.

= 1.3.1 =
* Minor bugfixes and improvements.

= 1.3 =
* AJAX errors are displayed in console log instead of alert.
* New filter options.
* Minor bugfixes and improvements.
* Compatibility for latest WordPress version.

= 1.2 =
* Compatibility for custom template overrides.
* Better detection of line breaks in the vehicle description.
* Fixes a bug if a data value does not exist.

= 1.1 =
* Post image updates on change.
* Minor bugfixes and improvements.
* Compatibility for latest WordPress version.

= 1.0 =
* Initial release.