Image Metadata

Writes the alt text, caption and title of images in the media library using the AI provider already configured in WordPress. Existing values are never overwritten.

• Author: George Vasiliades - https://github.com/Poseidonas
• License: GPL-2.0-or-later
• Requires WordPress 7.0+ and PHP 8.0+

What it does

Alt text is both an accessibility requirement and something search engines read, and almost no media library has it. Filling it in by hand for a few thousand images is not work anybody does.

WordPress 7.0 added an AI client to core. Providers and their keys are configured once by the site owner under Settings, Connectors, and any plugin can then use them. This plugin never asks for a key of its own and never sells a subscription. It calls the provider the site already has, so every request is on your own account and under your own terms.

Three fields are written, each only when it is empty:

• Alt text, when the image has none at all.
• Caption, when the caption is empty.
• Title, only while the title is still the one WordPress made from the file name.

The title rule matters, because WordPress never leaves a title empty: it fills it with the file name. A title is treated as machine made when it equals the file name, when it equals the file name with the extension still attached, or when sanitize_title() of either matches. Anything a person typed is kept.

All three fields come from one request. The plugin asks the provider for a JSON object with only the fields that are actually missing, which costs a third of what three separate requests would, and keeps the three texts consistent with each other.

The image sent to the provider is the medium derivative read from disk, not the full size original, and not a URL the provider has to fetch.

Three ways to run it

The bulk run keeps no list of pending images. Each image gets a _icxcnika_image_status meta value of done, skipped or failed, and the next batch is simply the newest images that have no status yet. Nothing to corrupt, nothing to resume, and an interrupted run continues where it left off.

Settings

Settings > Image Metadata.

What is written

When it runs

Limits

What is skipped, and why

• Anything that is not image/jpeg, image/png, image/webp, image/gif or image/avif. SVG is never sent.
• Images smaller than the minimum size in either dimension. Images with no stored dimensions are not skipped.
• Images that already have every switched on field.

Skipped images are marked skipped so the bulk run does not look at them again, and they never count against the daily limit.

Honest limits

• Every image is one request billed to your own provider account. The settings page says so, and the daily limit exists for that reason.
• A model can describe an image incorrectly, or miss what matters about it. Generated text should be reviewed, especially on pages where the image carries meaning.
• Purely decorative images should have empty alt text, not a description. The plugin cannot tell decorative from meaningful, so leave those out of the run or clear them afterwards.
• Scheduled work depends on WP-Cron, which needs traffic or a real cron job to fire.

Filters

• icxcnika_image_settings - all settings before they are applied.
• icxcnika_image_pre_generate - receives null, the attachment ID and the list of missing fields. Return an array with alt, caption or title keys to supply the values yourself, and no request is made. This is also how the plugin can be driven by a different service.
• icxcnika_image_language - the locale used to tell the model which language to write in.
• icxcnika_image_registry_payload - data sent to the installation registry.

Data stored

• Option icxcnika_image_settings (the settings).
• Option icxcnika_image_usage (the date and the number written that day, not autoloaded).
• Option icxcnika_image_state (whether a bulk run is in progress, not autoloaded).
• Option icxcnika_image_registry_key (random installation key of 48 characters, created only if installation reporting is active).
• Post meta _icxcnika_image_status on each image looked at, holding done, skipped or failed.
• Post meta _icxcnika_image_error on images that failed, holding the first 300 characters of the message.
• Transient icxcnika_image_release (cached GitHub release lookup, 12 hours).
• Cron events icxcnika_image_batch (the bulk run, single events chained a minute apart), icxcnika_image_single (one image after upload) and icxcnika_image_registry_ping (weekly, only if installation reporting is active).

Installation reporting

On activation, on deactivation and once a week the plugin sends a small JSON message to the author's installation registry: plugin slug, plugin version, home URL, site URL, WordPress version, WooCommerce version if present, PHP version, locale and whether the site is a multisite. Each report carries a random installation key generated locally on first use. The reporting address is empty by default, which means nothing is sent at all. No content, no user data, no personal data and no images are ever sent to the author. Add define( 'ICXCNIKA_REGISTRY_DISABLE', true ); to wp-config.php to turn the reporting off, or define( 'ICXCNIKA_REGISTRY_URL', '...' ); to point it elsewhere.

Updates

Updates are delivered from GitHub Releases of this repository. WordPress shows them on the Plugins screen like any other update, together with the details view and the automatic updates link.

Uninstall

Deleting the plugin removes the four options, both post meta keys from every image, the transient and all three cron events. Metadata that was written stays on the images, because it belongs to the media library and not to the plugin.

Image Metadata (Ελληνικά)

Γράφει το alt text, τη λεζάντα και τον τίτλο των εικόνων της βιβλιοθήκης πολυμέσων μέσω του παρόχου AI που έχει ήδη ρυθμιστεί στο WordPress. Οι υπάρχουσες τιμές δεν αντικαθίστανται ποτέ.

• Δημιουργός: George Vasiliades - https://github.com/Poseidonas
• Άδεια: GPL-2.0-or-later
• Απαιτεί WordPress 7.0+ και PHP 8.0+

Τι κάνει

Το alt text είναι ταυτόχρονα απαίτηση προσβασιμότητας και κείμενο που διαβάζουν οι μηχανές αναζήτησης, και σχεδόν καμία βιβλιοθήκη πολυμέσων δεν το έχει. Η συμπλήρωσή του στο χέρι για μερικές χιλιάδες εικόνες δεν είναι δουλειά που κάνει κανείς.

Το WordPress 7.0 πρόσθεσε AI client στον πυρήνα. Οι πάροχοι και τα κλειδιά τους ρυθμίζονται μία φορά από τον ιδιοκτήτη του site στις Ρυθμίσεις, Connectors, και από εκεί και πέρα κάθε πρόσθετο μπορεί να τα χρησιμοποιήσει. Αυτό το πρόσθετο δεν ζητά ποτέ δικό του κλειδί και δεν πουλά συνδρομή. Καλεί τον πάροχο που έχει ήδη το site, οπότε κάθε αίτημα χρεώνεται στον δικό σας λογαριασμό και με τους δικούς σας όρους.

Γράφονται τρία πεδία, το καθένα μόνο όταν είναι κενό:

• Alt text, όταν η εικόνα δεν έχει καθόλου.
• Λεζάντα, όταν η λεζάντα είναι κενή.
• Τίτλος, μόνο όσο ο τίτλος είναι ακόμα αυτός που έφτιαξε το WordPress από το όνομα αρχείου.

Ο κανόνας του τίτλου έχει σημασία, επειδή το WordPress δεν αφήνει ποτέ κενό τίτλο: τον συμπληρώνει με το όνομα αρχείου. Ένας τίτλος θεωρείται αυτόματος όταν ισούται με το όνομα αρχείου, όταν ισούται με το όνομα αρχείου μαζί με την κατάληξη, ή όταν ταιριάζει το sanitize_title() οποιουδήποτε από τα δύο. Ό,τι έγραψε άνθρωπος διατηρείται.

Και τα τρία πεδία προκύπτουν από ένα αίτημα. Το πρόσθετο ζητά από τον πάροχο ένα αντικείμενο JSON με μόνο τα πεδία που πράγματι λείπουν, πράγμα που κοστίζει το ένα τρίτο σε σχέση με τρία ξεχωριστά αιτήματα και κρατά τα τρία κείμενα συνεπή μεταξύ τους.

Η εικόνα που στέλνεται είναι το παράγωγο medium διαβασμένο από τον δίσκο, όχι το πρωτότυπο πλήρους μεγέθους και όχι URL που πρέπει να κατεβάσει ο πάροχος.

Τρεις τρόποι εκτέλεσης

Η μαζική εκτέλεση δεν κρατά λίστα εκκρεμών εικόνων. Κάθε εικόνα παίρνει meta _icxcnika_image_status με τιμή done, skipped ή failed, και η επόμενη παρτίδα είναι απλώς οι νεότερες εικόνες που δεν έχουν ακόμα κατάσταση. Τίποτα δεν μπορεί να αλλοιωθεί, τίποτα δεν χρειάζεται συνέχιση, και μια διακοπτόμενη εκτέλεση συνεχίζει από εκεί που έμεινε.

Ρυθμίσεις

Ρυθμίσεις > Image Metadata.

Τι γράφεται

Πότε εκτελείται

Όρια