Add bulk term generation functionality and enhance logging

- Introduced a new JavaScript file for handling bulk term generation in the admin interface. - Implemented AJAX requests for generating terms and handling responses with appropriate logging. - Enhanced the Groq_AI_Ajax_Controller to support new options for term generation, including origin and force parameters. - Improved error handling and logging for term generation events. - Updated the user interface to reflect the status of term generation and provide feedback to the user.
feat: Implement bulk generation for category descriptions with AJAX handling
2026-01-23 18:55:52 +00:00 · 2026-01-23 18:25:15 +00:00 · 2026-01-23 17:59:32 +00:00
7 changed files with 963 additions and 1223 deletions
--- a/assets/css/settings.css
+++ b/assets/css/settings.css
@@ -29,3 +29,80 @@
 	align-items: center;
 	margin-top: 8px;
 }
+
+.groq-ai-bulk-panel {
+	margin: 16px 0;
+	padding: 16px;
+	background: #fff;
+	border: 1px solid #dcdcde;
+}
+
+.groq-ai-bulk-panel .description {
+	margin-top: 8px;
+}
+
+.groq-ai-bulk-actions {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 8px;
+	align-items: center;
+	margin-top: 8px;
+}
+
+#groq-ai-bulk-status {
+	margin-top: 8px;
+}
+
+#groq-ai-bulk-status[data-status='error'] {
+	color: #b32d2e;
+}
+
+#groq-ai-bulk-status[data-status='success'] {
+	color: #008a20;
+}
+
+.groq-ai-bulk-log {
+	margin: 12px 0 0;
+	padding-left: 18px;
+	max-height: 220px;
+	overflow-y: auto;
+	font-size: 13px;
+}
+
+.groq-ai-bulk-log li {
+	margin-bottom: 4px;
+}
+
+.groq-ai-bulk-log li[data-status='error'] {
+	color: #b32d2e;
+}
+
+.groq-ai-bulk-log li[data-status='success'] {
+	color: #008a20;
+}
+
+.groq-ai-term-row.groq-ai-term-missing td {
+	background: #fff8e5;
+}
+
+.groq-ai-term-row.groq-ai-term-updated td {
+	animation: groqAiTermPulse 1.8s ease-out 1;
+}
+
+@keyframes groqAiTermPulse {
+	from {
+		background-color: #e3f8eb;
+	}
+	to {
+		background-color: transparent;
+	}
+}
+
+.groq-ai-term-actions {
+	width: 180px;
+}
+
+.groq-ai-regenerate-term.is-busy {
+	opacity: 0.6;
+	pointer-events: none;
+}
--- a/assets/js/term-bulk.js
+++ b/assets/js/term-bulk.js
@@ -0,0 +1,288 @@
+(function () {
+	const data = window.GroqAITermBulk || {};
+	const startButton = document.getElementById('groq-ai-bulk-generate');
+	const stopButton = document.getElementById('groq-ai-bulk-cancel');
+	const statusField = document.getElementById('groq-ai-bulk-status');
+	const logList = document.getElementById('groq-ai-bulk-log');
+
+	if (!data.ajaxUrl || !startButton || !statusField || !logList) {
+		return;
+	}
+
+	const strings = data.strings || {};
+	const allowRegenerate = !!data.allowRegenerate;
+	const terms = (Array.isArray(data.terms) ? data.terms : [])
+		.map((term) => {
+			const id = parseInt(term.id, 10);
+			if (!Number.isFinite(id)) {
+				return null;
+			}
+			const words = typeof term.words === 'number' ? term.words : parseInt(term.words, 10) || 0;
+			const hasDescription = !!term.hasDescription;
+			return {
+				id,
+				name: term.name || '',
+				slug: term.slug || '',
+				count: typeof term.count === 'number' ? term.count : parseInt(term.count, 10) || 0,
+				words,
+				hasDescription,
+				needsGeneration: !hasDescription,
+			};
+		})
+		.filter(Boolean);
+
+	const termMap = new Map();
+	terms.forEach((term) => termMap.set(term.id, term));
+
+	let queue = [];
+	let totalCount = 0;
+	let processed = 0;
+	let successes = 0;
+	let isRunning = false;
+	let abortRequested = false;
+
+	function formatString(template, values) {
+		if (!template) {
+			return '';
+		}
+		let autoIndex = 0;
+		return template.replace(/%(\d+\$)?[sd]/g, (match, position) => {
+			let valueIndex;
+			if (position) {
+				valueIndex = parseInt(position, 10) - 1;
+			} else {
+				valueIndex = autoIndex;
+				autoIndex += 1;
+			}
+			const replacement = values[valueIndex];
+			return typeof replacement === 'undefined' ? '' : String(replacement);
+		});
+	}
+
+	function setStatus(message, type) {
+		statusField.textContent = message || '';
+		statusField.dataset.status = type || '';
+	}
+
+	function appendLog(message, type) {
+		if (!message) {
+			return;
+		}
+		const item = document.createElement('li');
+		item.textContent = message;
+		item.dataset.status = type || '';
+		logList.appendChild(item);
+	}
+
+	function resetLog() {
+		logList.innerHTML = '';
+	}
+
+	function toggleButtons(running) {
+		isRunning = running;
+		startButton.disabled = running;
+		if (stopButton) {
+			stopButton.hidden = !running;
+		}
+	}
+
+	function getPendingTerms() {
+		return terms.filter((term) => term.needsGeneration);
+	}
+
+	function updateRow(term) {
+		const row = document.querySelector('[data-groq-ai-term-id="' + term.id + '"]');
+		if (!row) {
+			return;
+		}
+		row.classList.remove('groq-ai-term-missing');
+		row.classList.add('groq-ai-term-updated');
+		const wordCell = row.querySelector('.groq-ai-word-count');
+		if (wordCell) {
+			wordCell.textContent = String(term.words);
+		}
+	}
+
+	function markTermCompleted(term, words) {
+		term.hasDescription = true;
+		term.needsGeneration = false;
+		if (Number.isFinite(words)) {
+			term.words = words;
+		}
+		updateRow(term);
+	}
+
+	function finish(state) {
+		const summaryTemplate = state === 'done' ? strings.statusDone : state === 'stopped' ? strings.statusStopped : '';
+		const summary = summaryTemplate ? formatString(summaryTemplate, [successes]) : '';
+		const statusType = state === 'done' ? 'success' : state === 'stopped' ? 'info' : '';
+		setStatus(summary, statusType);
+		toggleButtons(false);
+		queue = [];
+		totalCount = 0;
+		processed = 0;
+		successes = 0;
+		abortRequested = false;
+	}
+
+	function sendRequest(term, options = {}) {
+		const payload = new URLSearchParams();
+		payload.append('action', 'groq_ai_bulk_generate_terms');
+		payload.append('nonce', data.nonce || '');
+		payload.append('taxonomy', data.taxonomy || '');
+		payload.append('term_id', term.id);
+		if (options.force) {
+			payload.append('force', '1');
+		}
+
+		return fetch(data.ajaxUrl, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+			},
+			body: payload.toString(),
+		}).then((response) => response.json());
+	}
+
+	function handleResponse(term, json, context) {
+		if (!json || !json.success) {
+			const errorMessage = (json && json.data && json.data.message) || 'Onbekende fout';
+			appendLog(formatString(strings.logError || '%1$s: %2$s', [term.name || term.id, errorMessage]), 'error');
+			if (context === 'single') {
+				setStatus(formatString(strings.regenerateError || '%1$s mislukt: %2$s', [term.name || term.id, errorMessage]), 'error');
+			}
+			return false;
+		}
+
+		const words = json.data && typeof json.data.words !== 'undefined' ? parseInt(json.data.words, 10) : term.words;
+		markTermCompleted(term, Number.isFinite(words) ? words : term.words);
+		appendLog(formatString(strings.logSuccess || '%1$s gevuld.', [term.name || term.id, term.words]), 'success');
+		if (context === 'single') {
+			setStatus(formatString(strings.regenerateDone || '%s is bijgewerkt.', [term.name || term.id]), 'success');
+		}
+		return true;
+	}
+
+	function processNext() {
+		if (abortRequested) {
+			finish('stopped');
+			return;
+		}
+
+		if (!queue.length) {
+			finish('done');
+			return;
+		}
+
+		const term = queue.shift();
+		const progressTemplate = strings.statusProgress;
+		if (progressTemplate) {
+			setStatus(formatString(progressTemplate, [processed + 1, totalCount, term.name || '']), 'loading');
+		}
+
+		sendRequest(term)
+			.then((json) => {
+				if (handleResponse(term, json, 'bulk')) {
+					successes += 1;
+				}
+			})
+			.catch((error) => {
+				appendLog(
+					formatString(strings.logError || '%1$s: %2$s', [term.name || term.id, error && error.message ? error.message : 'Onbekende fout']),
+					'error'
+				);
+			})
+			.finally(() => {
+				processed += 1;
+				if (abortRequested) {
+					finish('stopped');
+				} else {
+					processNext();
+				}
+			});
+	}
+
+	function startBulk() {
+		if (isRunning) {
+			return;
+		}
+
+		const pending = getPendingTerms();
+		if (!pending.length) {
+			setStatus(strings.statusEmpty || '', 'info');
+			return;
+		}
+
+		queue = pending.slice();
+		totalCount = queue.length;
+		processed = 0;
+		successes = 0;
+		abortRequested = false;
+		resetLog();
+		toggleButtons(true);
+		if (strings.statusIdle) {
+			setStatus(strings.statusIdle, 'info');
+		}
+		processNext();
+	}
+
+	startButton.addEventListener('click', startBulk);
+
+	if (stopButton) {
+		stopButton.addEventListener('click', () => {
+			if (!isRunning) {
+				return;
+			}
+			const confirmation = strings.confirmStop ? window.confirm(strings.confirmStop) : window.confirm('Stoppen?');
+			if (confirmation) {
+				abortRequested = true;
+			}
+		});
+	}
+
+	if (allowRegenerate) {
+		const buttons = document.querySelectorAll('.groq-ai-regenerate-term');
+		buttons.forEach((button) => {
+			button.addEventListener('click', () => {
+				if (isRunning) {
+					setStatus(strings.regenerateBlocked || '', 'error');
+					return;
+				}
+				const termId = parseInt(button.getAttribute('data-term-id'), 10);
+				const term = termMap.get(termId);
+				if (!term) {
+					setStatus('Onbekende term.', 'error');
+					return;
+				}
+				if (strings.confirmRegenerate) {
+					const confirmed = window.confirm(formatString(strings.confirmRegenerate, [term.name || term.id]));
+					if (!confirmed) {
+						return;
+					}
+				}
+				button.classList.add('is-busy');
+				button.disabled = true;
+				if (strings.regenerateProgress) {
+					setStatus(formatString(strings.regenerateProgress, [term.name || term.id]), 'loading');
+				}
+				sendRequest(term, { force: true })
+					.then((json) => {
+						handleResponse(term, json, 'single');
+					})
+					.catch((error) => {
+						const message = error && error.message ? error.message : 'Onbekende fout';
+						appendLog(formatString(strings.logError || '%1$s: %2$s', [term.name || term.id, message]), 'error');
+						setStatus(formatString(strings.regenerateError || '%1$s mislukt: %2$s', [term.name || term.id, message]), 'error');
+					})
+					.finally(() => {
+						button.disabled = false;
+						button.classList.remove('is-busy');
+					});
+			});
+		});
+	}
+
+	if (getPendingTerms().length === 0) {
+		setStatus(strings.statusEmpty || '', 'info');
+	}
+})();
--- a/groq-ai-product-text.php
+++ b/groq-ai-product-text.php
@@ -2,7 +2,7 @@
 /**
 * Plugin Name: SitiAI Product Teksten
 * Description: Genereer productteksten met diverse AI-aanbieders rechtstreeks vanuit WooCommerce.
- * Version: 1.4.5
+ * Version: 1.6.1
 * Author: SitiAI
 * Text Domain: siti-ai-product-content-generator
 * Domain Path: /languages
--- a/includes/Admin/class-groq-ai-settings-page.php
+++ b/includes/Admin/class-groq-ai-settings-page.php
--- a/includes/Core/class-groq-ai-ajax-controller.php
+++ b/includes/Core/class-groq-ai-ajax-controller.php
@@ -10,6 +10,7 @@ class Groq_AI_Ajax_Controller {
 		add_action( 'wp_ajax_groq_ai_generate_text', [ $this, 'handle_generate_text' ] );
 		add_action( 'wp_ajax_groq_ai_refresh_models', [ $this, 'handle_refresh_models' ] );
 		add_action( 'wp_ajax_groq_ai_generate_term_text', [ $this, 'handle_generate_term_text' ] );
+		add_action( 'wp_ajax_groq_ai_bulk_generate_terms', [ $this, 'handle_bulk_generate_terms_request' ] );
 	}

 	public function handle_generate_term_text() {
@@ -35,6 +36,113 @@ class Groq_AI_Ajax_Controller {
 			wp_send_json_error( [ 'message' => __( 'Term niet gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) ], 404 );
 		}

+		$result = $this->run_term_generation(
+			$term,
+			$prompt,
+			[
+				'include_top_products' => $include_top_products,
+				'top_products_limit'   => $top_products_limit,
+				'origin'               => 'term_manual',
+			]
+		);
+
+		if ( is_wp_error( $result ) ) {
+			wp_send_json_error( [ 'message' => $result->get_error_message() ], 500 );
+		}
+
+		wp_send_json_success( $result );
+	}
+
+	public function handle_bulk_generate_terms_request() {
+		if ( ! current_user_can( 'manage_options' ) ) {
+			wp_send_json_error( [ 'message' => __( 'Je hebt geen toestemming voor deze actie.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) ], 403 );
+		}
+
+		check_ajax_referer( 'groq_ai_bulk_generate_terms', 'nonce' );
+
+		$taxonomy = isset( $_POST['taxonomy'] ) ? sanitize_key( wp_unslash( $_POST['taxonomy'] ) ) : '';
+		$term_id  = isset( $_POST['term_id'] ) ? absint( $_POST['term_id'] ) : 0;
+		$force    = ! empty( $_POST['force'] );
+
+		if ( '' === $taxonomy || ! taxonomy_exists( $taxonomy ) || ! $term_id ) {
+			wp_send_json_error( [ 'message' => __( 'Taxonomie en term_id zijn verplicht.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) ], 400 );
+		}
+
+		$term = get_term( $term_id, $taxonomy );
+		if ( ! $term || is_wp_error( $term ) ) {
+			wp_send_json_error( [ 'message' => __( 'Term niet gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) ], 404 );
+		}
+
+		$current_description = isset( $term->description ) ? trim( wp_strip_all_tags( (string) $term->description ) ) : '';
+		if ( '' !== $current_description && ! $force ) {
+			wp_send_json_error(
+				[
+					'message' => __( 'Categorie heeft al een omschrijving.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					'code'    => 'groq_ai_term_has_description',
+				],
+				400
+			);
+		}
+
+		$options = apply_filters(
+			'groq_ai_bulk_term_generation_options',
+			[
+				'include_top_products' => true,
+				'top_products_limit'   => 10,
+			],
+			$term
+		);
+
+		$options['origin'] = $force ? 'term_force_regenerate' : 'term_bulk_auto';
+		$options['force']  = $force;
+
+		$result = $this->run_term_generation( $term, $this->get_term_prompt_text( $term ), $options );
+		if ( is_wp_error( $result ) ) {
+			wp_send_json_error( [ 'message' => $result->get_error_message() ], 500 );
+		}
+
+		$settings = $this->plugin->get_settings();
+		$saved    = $this->save_term_generation_result( $term, $result, $settings );
+
+		if ( is_wp_error( $saved ) ) {
+			wp_send_json_error( [ 'message' => $saved->get_error_message() ], 500 );
+		}
+
+		wp_send_json_success(
+			[
+				'term_id' => $term_id,
+				'name'    => isset( $term->name ) ? (string) $term->name : '',
+				'words'   => isset( $saved['words'] ) ? absint( $saved['words'] ) : 0,
+				'count'   => isset( $term->count ) ? absint( $term->count ) : 0,
+			]
+		);
+	}
+
+	private function run_term_generation( $term, $prompt, $options = [] ) {
+		if ( ! $term || ! is_object( $term ) ) {
+			return new WP_Error( 'groq_ai_invalid_term', __( 'Term niet gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$taxonomy = isset( $term->taxonomy ) ? sanitize_key( (string) $term->taxonomy ) : '';
+		$term_id  = isset( $term->term_id ) ? absint( $term->term_id ) : 0;
+
+		$options = wp_parse_args(
+			$options,
+			[
+				'include_top_products' => true,
+				'top_products_limit'   => 10,
+				'origin'              => 'term_manual',
+				'force'               => false,
+			]
+		);
+
+		$origin            = isset( $options['origin'] ) ? sanitize_key( (string) $options['origin'] ) : 'term_manual';
+		$force_run         = ! empty( $options['force'] );
+		$include_top_products = ! empty( $options['include_top_products'] );
+		$top_products_limit   = isset( $options['top_products_limit'] ) ? absint( $options['top_products_limit'] ) : 10;
+		$top_products_limit   = max( 1, min( 25, $top_products_limit ) );
+
+		$logger          = $this->plugin->get_generation_logger();
 		$settings         = $this->plugin->get_settings();
 		$provider_manager = $this->plugin->get_provider_manager();
 		$provider_key     = $settings['provider'];
@@ -51,14 +159,13 @@ class Groq_AI_Ajax_Controller {
 			? $prompt_builder->build_term_system_prompt( $settings, $conversation_id, $term )
 			: $prompt_builder->build_system_prompt( $settings, $conversation_id );

-		$model = $this->plugin->get_selected_model( $provider, $settings );
 		$context_block = '';
 		if ( method_exists( $prompt_builder, 'build_term_context_block' ) ) {
 			$context_block = $prompt_builder->build_term_context_block(
 				$term,
 				[
 					'include_top_products' => $include_top_products,
-					'top_products_limit' => $top_products_limit,
+					'top_products_limit'   => $top_products_limit,
 				],
 				$settings
 			);
@@ -67,6 +174,19 @@ class Groq_AI_Ajax_Controller {
 			? $prompt_builder->prepend_term_context_to_prompt( $prompt, $context_block )
 			: $prompt_builder->prepend_context_to_prompt( $prompt, $context_block );

+		$usage_meta = [
+			'term_context' => [
+				'taxonomy' => $taxonomy,
+				'term_id'  => $term_id,
+				'origin'   => $origin,
+			],
+			'term_options' => [
+				'include_top_products' => $include_top_products,
+				'top_products_limit'   => $top_products_limit,
+				'force'                => $force_run,
+			],
+		];
+
 		$response_format  = null;
 		$use_response_format = $this->plugin->should_use_response_format( $provider, $settings );
 		if ( $use_response_format && method_exists( $prompt_builder, 'get_term_response_format_definition' ) ) {
@@ -78,6 +198,7 @@ class Groq_AI_Ajax_Controller {
 			$final_prompt = $prompt_builder->append_response_instructions( $prompt_with_context, $settings );
 		}

+		$model  = $this->plugin->get_selected_model( $provider, $settings );
 		$result = $provider->generate_content(
 			[
 				'prompt'          => $final_prompt,
@@ -91,31 +212,192 @@ class Groq_AI_Ajax_Controller {
 		);

 		if ( is_wp_error( $result ) ) {
-			wp_send_json_error( [ 'message' => $result->get_error_message() ], 500 );
+			if ( $logger ) {
+				$logger->log_generation_event(
+					[
+						'provider'      => $provider_key,
+						'model'         => $model,
+						'prompt'        => $final_prompt,
+						'response'      => '',
+						'usage'         => $usage_meta,
+						'status'        => 'error',
+						'error_message' => $result->get_error_message(),
+						'post_id'       => 0,
+					]
+				);
+			}
+			return $result;
 		}

 		$response_text = $this->extract_content_text( $result );
-		$parsed = null;
+		$response_usage = is_array( $result ) && isset( $result['usage'] ) ? $result['usage'] : [];
+		if ( ! is_array( $response_usage ) ) {
+			$response_usage = [];
+		}
+		$response_usage['term_context'] = $usage_meta['term_context'];
+		$response_usage['term_options'] = $usage_meta['term_options'];
+		$parsed        = null;
 		if ( method_exists( $prompt_builder, 'parse_term_structured_response' ) ) {
 			$parsed = $prompt_builder->parse_term_structured_response( $response_text, $settings );
 		}
+		if ( is_wp_error( $parsed ) ) {
+			if ( $logger ) {
+				$logger->log_generation_event(
+					[
+						'provider'      => $provider_key,
+						'model'         => $model,
+						'prompt'        => $final_prompt,
+						'response'      => $response_text,
+						'usage'         => $response_usage,
+						'status'        => 'error',
+						'error_message' => $parsed->get_error_message(),
+						'post_id'       => 0,
+					]
+				);
+			}
+			return $parsed;
+		}
 		if ( ! is_array( $parsed ) ) {
 			$parsed = [
 				'description' => trim( (string) $response_text ),
 			];
 		}

-		wp_send_json_success(
+		if ( $logger ) {
+			$logger->log_generation_event(
+				[
+					'provider' => $provider_key,
+					'model'    => $model,
+					'prompt'   => $final_prompt,
+					'response' => $response_text,
+					'usage'    => $response_usage,
+					'status'   => 'success',
+					'post_id'  => 0,
+				]
+			);
+		}
+
+		return [
+			'top_description'    => isset( $parsed['top_description'] ) ? $parsed['top_description'] : ( isset( $parsed['description'] ) ? $parsed['description'] : '' ),
+			'bottom_description' => isset( $parsed['bottom_description'] ) ? $parsed['bottom_description'] : '',
+			'meta_title'         => isset( $parsed['meta_title'] ) ? $parsed['meta_title'] : '',
+			'meta_description'   => isset( $parsed['meta_description'] ) ? $parsed['meta_description'] : '',
+			'focus_keywords'     => isset( $parsed['focus_keywords'] ) ? $parsed['focus_keywords'] : '',
+			'description'        => isset( $parsed['description'] ) ? $parsed['description'] : ( isset( $parsed['top_description'] ) ? $parsed['top_description'] : '' ),
+			'raw'                => $response_text,
+		];
+	}
+
+	private function save_term_generation_result( $term, $result, $settings ) {
+		$term_id  = isset( $term->term_id ) ? absint( $term->term_id ) : 0;
+		$taxonomy = isset( $term->taxonomy ) ? sanitize_key( (string) $term->taxonomy ) : '';
+
+		if ( ! $term_id || '' === $taxonomy ) {
+			return new WP_Error( 'groq_ai_invalid_term', __( 'Term niet gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$top_description = '';
+		if ( isset( $result['top_description'] ) && '' !== trim( (string) $result['top_description'] ) ) {
+			$top_description = (string) $result['top_description'];
+		} elseif ( isset( $result['description'] ) ) {
+			$top_description = (string) $result['description'];
+		}
+
+		if ( '' === trim( wp_strip_all_tags( $top_description ) ) ) {
+			return new WP_Error( 'groq_ai_missing_description', __( 'De AI gaf geen omschrijving terug.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$update = wp_update_term(
+			$term_id,
+			$taxonomy,
 			[
-				'top_description' => isset( $parsed['top_description'] ) ? $parsed['top_description'] : ( isset( $parsed['description'] ) ? $parsed['description'] : '' ),
-				'bottom_description' => isset( $parsed['bottom_description'] ) ? $parsed['bottom_description'] : '',
-				'meta_title' => isset( $parsed['meta_title'] ) ? $parsed['meta_title'] : '',
-				'meta_description' => isset( $parsed['meta_description'] ) ? $parsed['meta_description'] : '',
-				'focus_keywords' => isset( $parsed['focus_keywords'] ) ? $parsed['focus_keywords'] : '',
-				'description' => isset( $parsed['description'] ) ? $parsed['description'] : ( isset( $parsed['top_description'] ) ? $parsed['top_description'] : '' ),
-				'raw' => $response_text,
+				'description' => wp_kses_post( $top_description ),
 			]
 		);
+
+		if ( is_wp_error( $update ) ) {
+			return $update;
+		}
+
+		$bottom_key = $this->get_bottom_meta_key( $term, $settings );
+		if ( '' !== $bottom_key ) {
+			$bottom_description = isset( $result['bottom_description'] ) ? (string) $result['bottom_description'] : '';
+			update_term_meta( $term_id, $bottom_key, wp_kses_post( $bottom_description ) );
+		}
+
+		if ( $this->plugin->is_module_enabled( 'rankmath', $settings ) ) {
+			$rankmath_keys = $this->get_rankmath_term_meta_keys( $term, $settings );
+			update_term_meta( $term_id, $rankmath_keys['title'], sanitize_text_field( isset( $result['meta_title'] ) ? $result['meta_title'] : '' ) );
+			update_term_meta( $term_id, $rankmath_keys['description'], sanitize_text_field( isset( $result['meta_description'] ) ? $result['meta_description'] : '' ) );
+			update_term_meta( $term_id, $rankmath_keys['focus_keyword'], sanitize_text_field( isset( $result['focus_keywords'] ) ? $result['focus_keywords'] : '' ) );
+		}
+
+		return [
+			'words' => $this->count_words( $top_description ),
+		];
+	}
+
+	private function get_bottom_meta_key( $term, $settings ) {
+		$default_key = '';
+		if ( is_array( $settings ) && isset( $settings['term_bottom_description_meta_key'] ) ) {
+			$default_key = sanitize_key( (string) $settings['term_bottom_description_meta_key'] );
+		}
+
+		$key = apply_filters( 'groq_ai_term_bottom_description_meta_key', $default_key, $term, $settings );
+		$key = sanitize_key( (string) $key );
+
+		return '' !== $key ? $key : 'groq_ai_term_bottom_description';
+	}
+
+	private function get_rankmath_term_meta_keys( $term, $settings ) {
+		$defaults = [
+			'title'        => 'rank_math_title',
+			'description'  => 'rank_math_description',
+			'focus_keyword' => 'rank_math_focus_keyword',
+		];
+
+		$keys = apply_filters( 'groq_ai_rankmath_term_meta_keys', $defaults, $term, $settings );
+		if ( ! is_array( $keys ) ) {
+			$keys = $defaults;
+		}
+
+		return [
+			'title'        => isset( $keys['title'] ) ? sanitize_key( (string) $keys['title'] ) : 'rank_math_title',
+			'description'  => isset( $keys['description'] ) ? sanitize_key( (string) $keys['description'] ) : 'rank_math_description',
+			'focus_keyword' => isset( $keys['focus_keyword'] ) ? sanitize_key( (string) $keys['focus_keyword'] ) : 'rank_math_focus_keyword',
+		];
+	}
+
+	private function get_term_prompt_text( $term ) {
+		$prompt = '';
+
+		if ( $term && isset( $term->term_id ) ) {
+			$prompt = (string) get_term_meta( $term->term_id, 'groq_ai_term_custom_prompt', true );
+		}
+
+		$prompt = trim( $prompt );
+		if ( '' !== $prompt ) {
+			return $prompt;
+		}
+
+		$default_prompt = __( 'Schrijf een SEO-vriendelijke categorieomschrijving in het Nederlands. Gebruik duidelijke tussenkoppen en <p>-tags. Voeg geen prijsinformatie toe.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+
+		return apply_filters( 'groq_ai_default_term_prompt', $default_prompt, $term );
+	}
+
+	private function count_words( $text ) {
+		$text = wp_strip_all_tags( (string) $text );
+		$text = trim( preg_replace( '/\s+/u', ' ', $text ) );
+
+		if ( '' === $text ) {
+			return 0;
+		}
+
+		if ( preg_match_all( '/\pL[\pL\pN\']*/u', $text, $matches ) ) {
+			return count( $matches[0] );
+		}
+
+		return str_word_count( $text );
 	}

 	public function handle_generate_text() {
--- a/includes/Services/Prompt/class-groq-ai-prompt-builder.php
+++ b/includes/Services/Prompt/class-groq-ai-prompt-builder.php
@@ -388,9 +388,66 @@ class Groq_AI_Prompt_Builder {
 			}
 		}

+		if ( ! empty( $fields['brands'] ) ) {
+			$brands_context = $this->get_product_brand_context_text( $post_id );
+			if ( '' !== $brands_context ) {
+				$parts[] = sprintf( __( 'Merken: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), $brands_context );
+			}
+		}
+
 		return implode( "\n\n", array_filter( $parts ) );
 	}

+	private function get_product_brand_context_text( $post_id ) {
+		$post_id  = absint( $post_id );
+		$taxonomy = $this->detect_brand_taxonomy();
+
+		if ( ! $post_id || '' === $taxonomy || ! taxonomy_exists( $taxonomy ) ) {
+			return '';
+		}
+
+		$terms = get_the_terms( $post_id, $taxonomy );
+		if ( empty( $terms ) || is_wp_error( $terms ) ) {
+			return '';
+		}
+
+		$entries = [];
+		foreach ( $terms as $term ) {
+			if ( ! $term || ! is_object( $term ) ) {
+				continue;
+			}
+
+			$name = isset( $term->name ) ? trim( wp_strip_all_tags( (string) $term->name ) ) : '';
+			if ( '' === $name ) {
+				continue;
+			}
+
+			$description = isset( $term->description ) ? trim( wp_strip_all_tags( (string) $term->description ) ) : '';
+			if ( '' !== $description ) {
+				$entries[] = sprintf( '%s - %s', $name, $description );
+			} else {
+				$entries[] = $name;
+			}
+		}
+
+		$entries = array_values( array_unique( array_filter( $entries ) ) );
+		if ( empty( $entries ) ) {
+			return '';
+		}
+
+		$context = implode( '; ', $entries );
+
+		/**
+		 * Filters the product brand context string added to prompts.
+		 *
+		 * @param string $context
+		 * @param int    $post_id
+		 * @param array  $terms
+		 * @param string $taxonomy
+		 */
+		return (string) apply_filters( 'groq_ai_product_brand_context', $context, $post_id, $terms, $taxonomy );
+	}
+
 	public function prepend_context_to_prompt( $prompt, $context ) {
 		$context = trim( (string) $context );

--- a/includes/Services/Settings/class-groq-ai-settings-manager.php
+++ b/includes/Services/Settings/class-groq-ai-settings-manager.php
@@ -234,6 +234,11 @@ class Groq_AI_Settings_Manager {
 					'description' => __( 'Voeg gestructureerde productattributen toe (zoals kleur, maat, materiaal).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
 					'default'     => false,
 				],
+				'brands'           => [
+					'label'       => __( 'Merken', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					'description' => __( 'Voegt gekoppelde productmerken toe (detecteert WooCommerce merk-taxonomieën).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					'default'     => true,
+				],
 				'images'            => [
 					'label'       => __( 'Afbeeldingen', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
 					'description' => __( 'Voeg een korte lijst toe met productafbeeldingen (beschrijving + URL).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
@@ -261,7 +266,7 @@ class Groq_AI_Settings_Manager {
 		$normalized  = [];

 		foreach ( $definitions as $key => $data ) {
-			$normalized[ $key ] = false;
+			$normalized[ $key ] = ! empty( $data['default'] );
 		}

 		if ( ! is_array( $fields ) ) {