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