Klassifieds for WooCommerce

Klassifieds for WooCommerce imports the classified ads of a kleinanzeigen.de account into your shop. Your ad becomes a WooCommerce product carrying its title, description, price, images and location, and can be brought back in step with its ad whenever you ask: prices follow, changed texts follow, and an ad that has disappeared upstream is taken out of the catalogue instead of being sold on. The only credential the plugin needs is the public account ID — the one that appears in the account's own kleinanzeigen.de URL. There is no login, no OAuth and no password to store. Products appear as soon as their text data has been read; their images follow within a few minutes, fetched by a background job. What it does

• Imports ads as WooCommerce products of their own product type — a simple and a variable classified product, so ads with variants stay variable.
• Brings products back in step with their ads when you start a sync from the plugin's dashboard: new ads are created, changed ads are updated, and ads that have vanished upstream are deactivated and fall back to plain products rather than being deleted.
• Restores a product automatically when its ad comes back.
• Keeps the shop tidy: a product whose ad has been gone for more than 30 days is deleted, together with its images. This housekeeping is the "Cleanup regularly" setting on the Tools tab, on by default.
• Maps ad content to your shop: category, label and keyword mapping is configured in the plugin's settings.

Images are stored in your media library Each ad image is downloaded once, as WebP, and stored in your media library like an image you upload yourself, so your shop serves it from its own address. A typical photo takes about 30 KB, plus the sizes WordPress makes of it. A site can keep the images off its disk instead: tick "Show images from kleinanzeigen.de instead of copying them" on the plugin's General settings tab. Its product pages then load every image from kleinanzeigen.de, so each visitor's browser sends kleinanzeigen.de the visitor's IP address, their browser's user agent and your shop's address. If you switch it on, say so in your privacy policy. The klassifieds_hotlink_images filter overrides the setting. Ticking it applies to images fetched from then on: the ones already stored stay in your media library until their product is removed, which the "Cleanup regularly" setting on the Tools tab (on by default) does once its ad has been inactive for more than 30 days. Unticking it again stores the linked images in the background, one product at a time; until a product's turn comes, its images still load from kleinanzeigen.de. How the work is scheduled Imports and syncs run in the background through WordPress's own scheduler (WP-Cron), which advances when your site receives traffic. On a shop that is still quiet, that can be slow and irregular. There are two ways to make it steady, neither of them required:

• Set up a system cron for wp-cron.php — the usual approach for any WordPress site that cares about timing.
• Or switch on the optional trigger service described below.

External services This plugin contacts two third-party services. Both are called from your server, never from a visitor's browser, unless you switch on hotlinking (see "Images are stored in your media library" above). One is required for the plugin to do anything at all; the other is optional and switched off by default. kleinanzeigen.de — the source of the ads and the reason the plugin exists. The plugin requests the public account page and the public ad pages of the account ID you enter, reads the ad data from them and downloads the ad images. What is sent is the account ID and the ad IDs, as part of the URL of an ordinary HTTP request; no data about your shop, your customers or your visitors is transmitted. Requests happen while an import or sync you started is running, and from the background job that downloads the images of any product still missing them. Once the items an import brought in are in the store — their text data and their images alike — no further requests are made until you manually trigger a sync from the plugin's dashboard page. Terms of use: https://themen.kleinanzeigen.de/nutzungsbedingungen/ Privacy policy: https://themen.kleinanzeigen.de/datenschutzerklaerung/ pinger.webpremiere.de — an optional trigger service run by the plugin author, for shops whose own traffic is too thin to drive WordPress's scheduler reliably. It is switched off by default and nothing is sent unless you turn it on under Klassifieds → Settings. When you switch it on, and then once a day while it is on, your server sends the service one request. It carries your site address, the plugin version, whether the free or the Pro edition is running, and a fixed token that marks the request as coming from this plugin (the same in every copy, so it identifies nothing). Like every web request, it also passes your server's IP address, the time, and the user agent WordPress sends, which names the WordPress version and your site address. Beyond that, nothing is sent: no content of your shop or your ads, and no data about your customers or your visitors. The service then requests wp-cron.php on your site about once a minute, which lets WordPress run its scheduled work on time. Those requests carry no data. The service keeps one entry per site: the site address, the plugin version, the edition and the time of the last registration. It does not keep the IP address. The entry is deleted as soon as you switch the service off or deactivate the plugin, and automatically once a site has not registered for four days. The server's access log, which records every request with its IP address, is deleted after seven days. The plugin author sees the list of registered sites in order to run the service; it is used for nothing else and passed on to no one. The service runs on the author's own server in Germany. To have your entry removed, or to ask what is stored about your site, write to info@webpremiere.de. The plugin works without it — imports and syncs simply advance whenever WordPress's own scheduler runs. Terms: https://klassifieds.webpremiere.de/en/agb/ Privacy policy: https://klassifieds.webpremiere.de/en/datenschutz/ Source code and building Two parts of the plugin are compiled, and their sources ship with it:

• build/, the onboarding screen, is built from src/ with @wordpress/scripts.
• admin/css/style-admin-klassifieds.css is built with Tailwind CSS from admin/css/style-admin-klassifieds-input.css, which imports admin/css/style-admin-common-input.css.

To rebuild them, run these in the plugin's folder, with Node.js and npm installed:

• npm install
• npm run build rebuilds build/ from src/
• npm run tw:build rebuilds admin/css/style-admin-klassifieds.css

The PHP libraries in vendor/ are installed with Composer, from composer.json and composer.lock: composer install --no-dev --optimize-autoloader. Klassifieds Pro A paid add-on runs the synchronization unattended, so products follow their ads without anyone starting a run, and adds a distributed sync worker, screenshots, e-mail reports and discount pricing. It is not required and it unlocks nothing here — everything described above works on its own. See https://klassifieds.webpremiere.de

1. Install and activate WooCommerce. Klassifieds for WooCommerce does not run without it.
2. Upload the plugin to /wp-content/plugins/, or install it through the Plugins screen in WordPress.
3. Activate the plugin through the Plugins screen.
4. Open Klassifieds → Settings, read and confirm the terms of use.
5. Enter your kleinanzeigen.de account ID. The import starts by itself a few seconds later and runs in the background.

Requirements: WordPress 6.7 or newer, PHP 8.1 or newer, WooCommerce.

0.9.199

• Fixed: the admin scripts of 0.9.198 were the readable development build, four to six times larger than needed. They are minified again, as in 0.9.197. Nothing else changed.

0.9.198

• New: when scheduled jobs ran late because nobody visited the site, the dashboard offers the background service in a snackbar with a switch. Closing it keeps it closed for the rest of the browser session. The message and the switch's name are translated into German.
• Fixed: the cache of a fetched ad page no longer fills the options table. A page is cached only after a real fetch, for ten minutes instead of an hour, and is removed once the images are stored; expired pages are deleted every five minutes.
• The account's display name is read once and kept.

0.9.197

• Fixed: the "delete images" button on the product edit screen did nothing without Klassifieds Pro, because the library it needs to read the form was only loaded by Pro. The plugin loads it itself again.
• For developers: the ajax script is the class KlassifiedsAjax, registered as window.KlassifiedsAjaxClass, so Klassifieds Pro can extend it. The inline edit, poll and ping functions moved to Pro, which is the only plugin that answers them. The script no longer refers to Pro's websocket or list classes.

0.9.196

• The admin scripts are built from source: each one is a module in src/admin/, compiled by npm run build into build/admin/. The page loads the same scripts under the same names and they do what they did.
• Fixed: after importing images on a product without Klassifieds Pro, the message that says how many images came in never appeared; the script asked for a class only Pro has.
• Fixed: clearing the dashboard's scheduler stopped only every other timer.
• The script that adds notice() and revert() to jQuery now loads after the script that hands it its settings. On the product and term screens it ran before.
• For developers: npm run test:js runs the tests of the admin scripts (Vitest). The AJAX request functions read the nonce when they are called, not when the script starts.

0.9.195

• Cookies go through one class, KlassifiedsCookie. It reads the last cookie on the page, which the old reader missed, and a missing orientation cookie no longer stops the dashboard's scripts.
• The server-side bulk edit marker is gone: KlassifiedsAjax.bulkedit() and the _ajax_klassifieds_bulkedit action. Klassifieds Pro guards the list in the browser.
• For developers: Klassifieds\Utils\Utils::parse_remote_url() moved to klassifieds()->fn()->parse_remote_url(). Klassifieds Pro 0.9.171 calls it there.

0.9.194

• The dashboard's rainbow border turns again while it loads in the background, instead of turning the whole header with it. Its animation was named spin, the name WooCommerce's admin styles give a rotation, and whichever stylesheet loaded last won; it is klassifieds-rainbow-spin now.
• Products and label terms without an image show WooCommerce's placeholder (Klassifieds Pro's own, with Pro) through the new klassifieds_placeholder_image filter. The ad icon and the installer mark follow the new artwork.
• For developers: Klassifieds_Product::placeholder_image() is gone; use klassifieds()->fn()->get_placeholder_image_src(). The location icons' classes are klassifieds and custom, set by Klassifieds Pro 0.9.170.

0.9.193

• The installer shows its percentage again. 0.9.192 renamed the element it is written into, and the installer's script kept looking for the old name, so the number stayed empty while an account was being installed.
• For developers: the two percentages are written by id, #svg-installer-value and #svg-bulk-value (Klassifieds Pro 0.9.169 writes the bulk edit's there). tests/svg-styles.php pins both ids.

0.9.192

• An ad's page is read once. Its text, its location and its images come from one reader for the mobile and the desktop page of an ad, which keeps each page it fetched for an hour, where every one of them used to fetch the page again.
• A product keeps its description when its ad's page cannot be read, instead of taking "Not found" or nothing in its place.
• Bulk actions in Klassifieds Pro's product list show how far they have come, as a percentage over the list.
• For developers: every AJAX handler answers through Klassifieds_Ajax::json_success() or json_error(), so every reply carries success, and a failure a message instead of data.error. Klassifieds_Dom_Document (mobile(), desktop()) replaces read_dom_document(), get_ad_locality() and get_ad_images(); get_ad_content() stays, deprecated, for Klassifieds Pro 0.9.167. create_product_images() takes the page as array( 'device' => …, 'html' => … ). Update Klassifieds Pro to 0.9.168 afterwards.

Older releases are listed in changelog.txt, which ships with the plugin.