ZuidWest Tekst TV GPT

[!WARNING] Deze plugin wordt uitgefaseerd en ontvangt geen nieuwe functionaliteit meer. Gebruik voor nieuwe installaties en verdere ontwikkeling de TekstTV WordPress-plugin.

WordPress-plugin die de GPT-modellen van OpenAI gebruikt om automatisch korte samenvattingen van artikelen te genereren voor tekst-tv-uitzendingen ('kabelkrant') of teletekst.

Kenmerken

• AI-gemaakte samenvattingen met GPT-modellen van OpenAI (gpt-5.5, gpt-5.4-mini en GPT-4.1 familie)
• Automatische detectie en ondersteuning voor de Chat Completions API en Responses API
• Werkt met zowel de Block Editor (Gutenberg) als de Classic Editor
• Auditfunctionaliteit met overzicht van alle samenvattingen en diff-weergave
• Rate limiting (10 requests per minuut per gebruiker)
• Uitgebreide foutafhandeling en validatie met consistente HTTP status codes
• Integratie met WordPress-admin en ACF

Installatie en configuratie

Vereisten

• WordPress 7.0 of hoger
• PHP 8.3 of hoger
• Advanced Custom Fields (ACF) plugin
• OpenAI API key

Installatie

1. Upload de pluginbestanden naar de map /wp-content/plugins/zw-ttvgpt/
2. Activeer de plugin via het scherm Plugins in WordPress
3. Ga naar Instellingen → Tekst TV GPT en configureer de volgende instellingen:
   • OpenAI API key
   • AI-model (standaard: gpt-5.5)
   • Maximaal aantal woorden (standaard: 100)
   • Debugmodus (optioneel)

Modelselectie

De plugin ondersteunt de twee geselecteerde modellen uit de GPT-5 familie en de twee geselecteerde modellen uit de GPT-4.1 familie:

GPT-5.5 (aanbevolen): Nieuwste frontier model voor hoogwaardige tekstsamenvattingen via de Responses API.

GPT-5.4-mini: Snellere en goedkopere GPT-5 variant voor lagere latency of hogere volumes.

GPT-4.1 familie: Bewezen betrouwbare modellen met uitstekende kwaliteit via de Chat Completions API. Keuze uit standaard en mini (budget) varianten.

Legacy ft:-modellen

Bestaande legacy ft: model-ID's blijven bruikbaar via de optie Legacy ft:-model... op de instellingenpagina. De plugin bevat geen tooling meer om trainingsdata te exporteren of nieuwe fine-tuning workflows te beheren.

OpenAI faseert self-serve fine-tuning uit. Nieuwe organisaties zonder eerder fine-tuninggebruik kunnen sinds 7 mei 2026 geen training jobs meer maken. Organisaties zonder recente fine-tuned model-inference verliezen op 2 juli 2026 toegang tot nieuwe training jobs. Voor bestaande actieve klanten stopt het aanmaken van nieuwe fine-tuning jobs op 6 januari 2027. Bestaande fine-tuned modellen blijven beschikbaar voor inference totdat hun basismodel wordt uitgefaseerd. Zie de officiële OpenAI deprecations.

Let op: Alleen bovenstaande basismodellen en bestaande legacy ft: model-ID's worden ondersteund. Oudere losse modellen zoals gpt-5, gpt-4o, en gpt-4-turbo werken niet.

Gebruik

Samenvattingen genereren

1. Open een bericht in de WordPress-editor
2. Scroll naar het ACF-veld voor de tekst-tv-samenvatting
3. Klik op de knop Genereer
4. Wacht terwijl de AI de samenvatting genereert
5. Controleer en bewerk de samenvatting indien nodig
6. Sla het bericht op

Auditoverzicht

• Ga naar Tools → Tekst TV Audit voor een volledig overzicht van alle samenvattingen
• Filter op type: Handmatig, AI (onbewerkt) of AI (bewerkt)
• Filter op wijzigingspercentage: Laag (≤20%), Gemiddeld (21-50%) of Hoog (>50%)
• Bekijk de diff-weergave door op Bekijk diff te klikken

Debuggen

Schakel debugmodus in via Instellingen → Tekst TV GPT om gedetailleerde informatie te loggen:

Browserconsole (JavaScript):

• Post-ID en geselecteerde regio's
• Exacte content die naar de API wordt gestuurd
• Lengte van de content in tekens
• Volledige API-respons
• Error codes bij fouten

Serverlogs (PHP):

• API-requestdetails (model, woordlimiet)
• Gegenereerde samenvattingsmetadata (woordenaantal)
• Foutmeldingen met context

Open de browserconsole en controleer je PHP-foutlog om de debug-output te zien.

Ontwikkelaars

Lokale ontwikkeling

# Clone repository
git clone https://github.com/oszuidwest/zw-ttvgpt.git
cd zw-ttvgpt

# Installeer dependencies
composer install
npm install

# Run linting
vendor/bin/phpcs                    # PHP CodeSniffer
vendor/bin/phpstan analyse --memory-limit=2G  # PHPStan (level 6)
npm run lint                        # Biome (JS/CSS)

# Auto-fix code style issues
vendor/bin/phpcbf                   # PHP auto-fix
npm run lint:fix                    # Biome auto-fix

Codekwaliteit

• PHP: WordPress Coding Standards (WPCS) + PHPStan level 6
• JavaScript/CSS: Biome voor linting en formatting
• CI/CD: GitHub Actions met automatische tests op PHP 8.3 en 8.4

Architectuur

De plugin gebruikt PSR-4 autoloading met namespace ZW_TTVGPT_Core. Belangrijkste componenten:

• API Layer: Automatische detectie Chat Completions (GPT-4.1) vs Responses API (GPT-5.x)
• Admin UI: Instellingenpagina en audit overzicht met diff-weergave
• Security: Rate limiting (10/min/user), nonce verificatie, model whitelist validatie

Licentie

Deze plugin is gelicenseerd onder de GNU General Public License v3.0.

Bijdragen

Bijdragen zijn welkom! Zie onze GitHub repository voor issues en pull requests.

Deze plugin is ontwikkeld door Streekomroep ZuidWest. Het bijbehorende WordPress-thema is gratis beschikbaar.