feat: Implement bulk generation for category descriptions with AJAX handling

feat: Update version to 1.5.0 and add brand context handling to prompts
feat: Add product attribute inclusion settings and enhance context handling in AI prompts
2026-01-23 18:25:15 +00:00 · 2026-01-23 17:59:32 +00:00 · 2026-01-16 19:19:00 +00:00 · 2026-01-16 19:01:25 +00:00 · 2026-01-16 18:41:03 +00:00 · 2026-01-16 18:21:25 +00:00
10 changed files with 1331 additions and 45 deletions
--- a/assets/css/settings.css
+++ b/assets/css/settings.css
@@ -29,3 +29,63 @@
 	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-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;
+	}
+}
--- a/assets/js/admin.js
+++ b/assets/js/admin.js
@@ -13,6 +13,7 @@
 	const resultField = document.getElementById('groq-ai-output');
 	const jsonCopyButton = modal.querySelector('.groq-ai-copy-json');
 	const contextToggles = modal.querySelectorAll('.groq-ai-context-toggle');
+	const attributeToggles = modal.querySelectorAll('.groq-ai-attribute-toggle');
 	const resultFields = {};
 	modal.querySelectorAll('.groq-ai-result-field').forEach((field) => {
 		const key = field.getAttribute('data-field');
@@ -60,6 +61,7 @@
 			promptField.value = GroqAIGenerator.defaultPrompt;
 		}
 		resetContextToggles();
+		resetAttributeToggles();
 		setTimeout(() => promptField.focus(), 50);
 	}

@@ -115,6 +117,7 @@
 			payload.append('prompt', prompt);
 			payload.append('post_id', GroqAIGenerator.postId || 0);
 			payload.append('context_fields', JSON.stringify(collectContextSelection()));
+			payload.append('attribute_includes', JSON.stringify(collectAttributeSelection()));

 			toggleLoading(true);
 			resultWrapper.hidden = true;
@@ -458,6 +461,20 @@
 		});
 	}

+	function resetAttributeToggles() {
+		const defaults = Array.isArray(GroqAIGenerator.attributeIncludesDefaults)
+			? GroqAIGenerator.attributeIncludesDefaults
+			: [];
+
+		attributeToggles.forEach((toggle) => {
+			const key = toggle.getAttribute('data-attribute');
+			if (!key) {
+				return;
+			}
+			toggle.checked = defaults.includes(key);
+		});
+	}
+
 	function collectContextSelection() {
 		const selected = [];
 		contextToggles.forEach((toggle) => {
@@ -467,4 +484,18 @@
 		});
 		return selected;
 	}
+
+	function collectAttributeSelection() {
+		const selected = [];
+		attributeToggles.forEach((toggle) => {
+			if (!toggle.checked) {
+				return;
+			}
+			const key = toggle.getAttribute('data-attribute');
+			if (key) {
+				selected.push(key);
+			}
+		});
+		return selected;
+	}
 })(jQuery);
--- a/assets/js/category-bulk.js
+++ b/assets/js/category-bulk.js
@@ -0,0 +1,212 @@
+(function () {
+	const data = window.GroqAICategoryBulk || {};
+	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 (!startButton || !data.ajaxUrl) {
+		return;
+	}
+
+	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) {
+		if (!statusField) {
+			return;
+		}
+		statusField.textContent = message || '';
+		statusField.dataset.status = type || '';
+	}
+
+	function appendLog(message, type) {
+		if (!logList || !message) {
+			return;
+		}
+		const item = document.createElement('li');
+		item.textContent = message;
+		item.dataset.status = type || '';
+		logList.appendChild(item);
+	}
+
+	function resetLog() {
+		if (!logList) {
+			return;
+		}
+		logList.innerHTML = '';
+	}
+
+	function toggleButtons(running) {
+		isRunning = running;
+		startButton.disabled = running;
+		if (stopButton) {
+			stopButton.hidden = !running;
+		}
+	}
+
+	function getPendingTerms() {
+		if (!Array.isArray(data.terms)) {
+			return [];
+		}
+		return data.terms.filter((term) => !term.processed);
+	}
+
+	function updateRow(termId, words) {
+		const row = document.querySelector('[data-groq-ai-term-id="' + termId + '"]');
+		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(typeof words === 'number' ? words : wordCell.textContent);
+		}
+	}
+
+	function finish(state) {
+		const summaryTemplate =
+			state === 'done'
+				? data.strings && data.strings.statusDone
+				: state === 'stopped'
+				? data.strings && data.strings.statusStopped
+				: '';
+
+		const summary = summaryTemplate
+			? formatString(summaryTemplate, [successes])
+			: '';
+
+		const statusType = state === 'done' ? 'success' : state === 'stopped' ? 'info' : '';
+		setStatus(summary, statusType);
+		toggleButtons(false);
+		queue = [];
+		totalCount = 0;
+		abortRequested = false;
+	}
+
+	function processNext() {
+		if (abortRequested) {
+			finish('stopped');
+			return;
+		}
+
+		if (!queue.length) {
+			finish('done');
+			return;
+		}
+
+		const term = queue.shift();
+		const position = processed + 1;
+		const progressTemplate = data.strings && data.strings.statusProgress;
+		if (progressTemplate) {
+			setStatus(formatString(progressTemplate, [position, totalCount, term.name || '']), 'loading');
+		}
+
+		const payload = new URLSearchParams();
+		payload.append('action', 'groq_ai_bulk_generate_terms');
+		payload.append('nonce', data.nonce || '');
+		payload.append('taxonomy', data.taxonomy || 'product_cat');
+		payload.append('term_id', term.id);
+
+		fetch(data.ajaxUrl, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+			},
+			body: payload.toString(),
+		})
+			.then((response) => response.json())
+			.then((json) => {
+				if (!json.success) {
+					const errorMessage = (json.data && json.data.message) || 'Onbekende fout';
+					appendLog(formatString((data.strings && data.strings.logError) || '%1$s: %2$s', [term.name || term.id, errorMessage]), 'error');
+					return;
+				}
+
+				term.processed = true;
+				successes += 1;
+				const words = json.data && typeof json.data.words !== 'undefined' ? json.data.words : 0;
+				updateRow(term.id, words);
+				appendLog(formatString((data.strings && data.strings.logSuccess) || '%1$s gevuld.', [term.name || term.id, words]), 'success');
+			})
+			.catch((error) => {
+				appendLog(
+					formatString((data.strings && data.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((data.strings && data.strings.statusEmpty) || '', 'info');
+			return;
+		}
+
+		queue = pending.slice();
+		totalCount = queue.length;
+		processed = 0;
+		successes = 0;
+		abortRequested = false;
+		resetLog();
+		toggleButtons(true);
+		setStatus((data.strings && data.strings.statusIdle) || '', 'info');
+		processNext();
+	}
+
+	startButton.addEventListener('click', startBulk);
+
+	if (stopButton) {
+		stopButton.addEventListener('click', () => {
+			if (!isRunning) {
+				return;
+			}
+			const confirmation = ! (data.strings && data.strings.confirmStop)
+				? window.confirm('Stoppen?')
+				: window.confirm(data.strings.confirmStop);
+			if (confirmation) {
+				abortRequested = true;
+			}
+		});
+	}
+
+	if (!Array.isArray(data.terms) || !data.terms.length) {
+		setStatus((data.strings && data.strings.statusEmpty) || '', 'info');
+	}
+})();
--- a/assets/js/term-admin.js
+++ b/assets/js/term-admin.js
@@ -9,7 +9,11 @@
 	}

 	const promptField = document.getElementById('groq-ai-term-prompt');
-	const outputField = document.getElementById('groq-ai-term-generated');
+	const outputTopField = document.getElementById('groq-ai-term-generated-top');
+	const outputBottomField = document.getElementById('groq-ai-term-generated-bottom');
+	const outputMetaTitleField = document.getElementById('groq-ai-term-generated-meta-title');
+	const outputMetaDescriptionField = document.getElementById('groq-ai-term-generated-meta-description');
+	const outputFocusKeywordsField = document.getElementById('groq-ai-term-generated-focus-keywords');
 	const rawField = document.getElementById('groq-ai-term-raw');
 	const statusField = document.getElementById('groq-ai-term-status');
 	const applyButton = document.getElementById('groq-ai-term-apply');
@@ -47,11 +51,31 @@
 	if (applyButton) {
 		applyButton.addEventListener('click', () => {
 			const descriptionField = document.getElementById('description');
-			if (!descriptionField || !outputField) {
+			const bottomDescriptionField = document.getElementById('groq-ai-term-bottom-description');
+			const rankmathTitleField = document.getElementById('groq-ai-rankmath-title');
+			const rankmathDescriptionField = document.getElementById('groq-ai-rankmath-description');
+			const rankmathKeywordsField = document.getElementById('groq-ai-rankmath-keywords');
+			if (!outputTopField) {
 				return;
 			}
-			descriptionField.value = outputField.value || '';
-			setStatus('Tekst ingevuld in het beschrijving-veld. Vergeet niet op "Opslaan" te klikken.', 'success');
+
+			if (descriptionField) {
+				descriptionField.value = outputTopField.value || '';
+			}
+			if (bottomDescriptionField && outputBottomField) {
+				bottomDescriptionField.value = outputBottomField.value || '';
+			}
+			if (rankmathTitleField && outputMetaTitleField) {
+				rankmathTitleField.value = outputMetaTitleField.value || '';
+			}
+			if (rankmathDescriptionField && outputMetaDescriptionField) {
+				rankmathDescriptionField.value = outputMetaDescriptionField.value || '';
+			}
+			if (rankmathKeywordsField && outputFocusKeywordsField) {
+				rankmathKeywordsField.value = outputFocusKeywordsField.value || '';
+			}
+
+			setStatus('Tekst ingevuld. Vergeet niet op "Opslaan" te klikken.', 'success');
 		});
 	}

@@ -69,6 +93,12 @@
 			rawField.textContent = '';
 		}

+		if (outputTopField) outputTopField.value = '';
+		if (outputBottomField) outputBottomField.value = '';
+		if (outputMetaTitleField) outputMetaTitleField.value = '';
+		if (outputMetaDescriptionField) outputMetaDescriptionField.value = '';
+		if (outputFocusKeywordsField) outputFocusKeywordsField.value = '';
+
 		fetch(GroqAITermGenerator.ajaxUrl, {
 			method: 'POST',
 			headers: {
@@ -83,8 +113,25 @@
 					throw new Error(errorMessage);
 				}

-				if (outputField) {
-					outputField.value = (json.data && json.data.description ? json.data.description : '').trim();
+				if (outputTopField) {
+					const top = json.data && (json.data.top_description || json.data.description) ? (json.data.top_description || json.data.description) : '';
+					outputTopField.value = String(top).trim();
+				}
+				if (outputBottomField) {
+					const bottom = json.data && json.data.bottom_description ? json.data.bottom_description : '';
+					outputBottomField.value = String(bottom).trim();
+				}
+				if (outputMetaTitleField) {
+					const metaTitle = json.data && json.data.meta_title ? json.data.meta_title : '';
+					outputMetaTitleField.value = String(metaTitle).trim();
+				}
+				if (outputMetaDescriptionField) {
+					const metaDescription = json.data && json.data.meta_description ? json.data.meta_description : '';
+					outputMetaDescriptionField.value = String(metaDescription).trim();
+				}
+				if (outputFocusKeywordsField) {
+					const keywords = json.data && json.data.focus_keywords ? json.data.focus_keywords : '';
+					outputFocusKeywordsField.value = String(keywords).trim();
 				}
 				if (rawField) {
 					rawField.textContent = (json.data && json.data.raw ? String(json.data.raw) : '').trim();
--- 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.1
+ * Version: 1.6.0
 * Author: SitiAI
 * Text Domain: siti-ai-product-content-generator
 * Domain Path: /languages
--- a/includes/Admin/class-groq-ai-product-ui.php
+++ b/includes/Admin/class-groq-ai-product-ui.php
@@ -59,6 +59,9 @@ class Groq_AI_Product_Text_Product_UI {
 			$post_id = ( $post && isset( $post->ID ) ) ? (int) $post->ID : 0;

 			$settings = $this->plugin->get_settings();
+			$attribute_defaults = isset( $settings['product_attribute_includes'] ) && is_array( $settings['product_attribute_includes'] )
+				? array_values( array_unique( array_map( 'sanitize_key', $settings['product_attribute_includes'] ) ) )
+				: [];

 			wp_localize_script(
 				'groq-ai-admin',
@@ -69,6 +72,7 @@ class Groq_AI_Product_Text_Product_UI {
 					'defaultPrompt' => $settings['default_prompt'],
 					'postId'        => $post_id,
 					'contextDefaults' => isset( $settings['context_fields'] ) ? $settings['context_fields'] : $this->plugin->get_default_context_fields(),
+					'attributeIncludesDefaults' => $attribute_defaults,
 				]
 			);
 		}
@@ -82,6 +86,7 @@ class Groq_AI_Product_Text_Product_UI {

 		$settings          = $this->plugin->get_settings();
 		$rankmath_enabled  = $this->plugin->is_rankmath_active() && $this->plugin->is_module_enabled( 'rankmath', $settings );
+		$attribute_options = $this->get_product_attribute_include_options();
 		?>
 		<div id="groq-ai-modal" class="groq-ai-modal" aria-hidden="true">
 			<div class="groq-ai-modal__dialog" role="dialog" aria-modal="true" aria-labelledby="groq-ai-modal-title">
@@ -109,6 +114,9 @@ class Groq_AI_Product_Text_Product_UI {
 								$context_definitions = $this->plugin->get_context_field_definitions();
 								$context_defaults    = isset( $settings['context_fields'] ) ? $settings['context_fields'] : $this->plugin->get_default_context_fields();
 								foreach ( $context_definitions as $context_key => $context_info ) :
+									if ( 'attributes' === $context_key ) {
+										continue;
+									}
 									$checked = ! empty( $context_defaults[ $context_key ] );
 									?>
 									<label class="groq-ai-context-option">
@@ -122,6 +130,23 @@ class Groq_AI_Product_Text_Product_UI {
 									</label>
 								<?php endforeach; ?>
 							</div>
+
+							<h3 style="margin-top:16px;"><?php esc_html_e( 'Attributen meesturen', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+							<p class="description"><?php esc_html_e( 'Selecteer welke productattributen je mee wilt geven aan de AI. Dit vervangt de oude alles-of-niets optie.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
+							<?php if ( empty( $attribute_options ) ) : ?>
+								<p class="description"><?php esc_html_e( 'Geen WooCommerce-attributen gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
+							<?php else : ?>
+								<div class="groq-ai-context-options__grid">
+									<?php foreach ( $attribute_options as $attr_key => $attr_label ) : ?>
+										<label class="groq-ai-context-option">
+											<input type="checkbox" class="groq-ai-attribute-toggle" data-attribute="<?php echo esc_attr( $attr_key ); ?>" />
+											<div>
+												<strong><?php echo esc_html( $attr_label ); ?></strong>
+											</div>
+										</label>
+									<?php endforeach; ?>
+								</div>
+							<?php endif; ?>
 						</div>
 					</div>
 					</form>
@@ -225,4 +250,39 @@ class Groq_AI_Product_Text_Product_UI {
 		</div>
 		<?php
 	}
+
+	private function get_product_attribute_include_options() {
+		$options = [
+			'__custom__' => __( 'Custom attributen (niet-taxonomie)', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+		];
+
+		if ( function_exists( 'wc_get_attribute_taxonomies' ) ) {
+			$taxonomies = wc_get_attribute_taxonomies();
+			if ( is_array( $taxonomies ) ) {
+				foreach ( $taxonomies as $attr ) {
+					$name  = isset( $attr->attribute_name ) ? sanitize_key( (string) $attr->attribute_name ) : '';
+					$label = isset( $attr->attribute_label ) ? sanitize_text_field( (string) $attr->attribute_label ) : '';
+					if ( '' === $name ) {
+						continue;
+					}
+					$taxonomy = 'pa_' . $name;
+					if ( '' === $label ) {
+						$label = function_exists( 'wc_attribute_label' ) ? wc_attribute_label( $taxonomy ) : $taxonomy;
+					}
+					$options[ $taxonomy ] = $label;
+				}
+			}
+		}
+
+		if ( count( $options ) > 1 ) {
+			$fixed = [
+				'__custom__' => $options['__custom__'],
+			];
+			unset( $options['__custom__'] );
+			asort( $options, SORT_NATURAL | SORT_FLAG_CASE );
+			$options = $fixed + $options;
+		}
+
+		return $options;
+	}
 }
--- a/includes/Admin/class-groq-ai-settings-page.php
+++ b/includes/Admin/class-groq-ai-settings-page.php
@@ -165,16 +165,52 @@ class Groq_AI_Product_Text_Settings_Page {
 			[
 				'taxonomy' => 'product_cat',
 				'hide_empty' => false,
+				'orderby' => 'name',
+				'order' => 'ASC',
 				'number' => 0,
 			]
 		);
 		if ( is_wp_error( $terms ) ) {
 			$terms = [];
 		}
+
+		$word_map    = [];
+		$empty_terms = [];
+		foreach ( $terms as $term ) {
+			if ( ! $term || ! is_object( $term ) ) {
+				continue;
+			}
+			$word_count                 = $this->count_words( isset( $term->description ) ? $term->description : '' );
+			$word_map[ $term->term_id ] = $word_count;
+			if ( 0 === $word_count ) {
+				$empty_terms[] = $term;
+			}
+		}
 		?>
 		<div class="wrap">
 			<h1><?php esc_html_e( 'Categorie teksten', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h1>
 			<p><?php esc_html_e( 'Klik op een categorie om teksten te genereren en instellingen te beheren. De tabel toont de huidige woordlengte van de categorie-omschrijving.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
+			<div class="groq-ai-bulk-panel">
+				<?php if ( ! empty( $empty_terms ) ) : ?>
+					<p>
+						<?php
+						printf(
+							/* translators: %d: amount of categories without description */
+							esc_html__( 'Er zijn %d categorieën zonder omschrijving. Klik op de knop hieronder om automatisch teksten te genereren.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+							count( $empty_terms )
+						);
+						?>
+					</p>
+					<p>
+						<button type="button" class="button button-primary" id="groq-ai-bulk-generate"><?php esc_html_e( 'Genereer teksten voor lege categorieën', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></button>
+						<button type="button" class="button" id="groq-ai-bulk-cancel" hidden><?php esc_html_e( 'Stop bulk generatie', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></button>
+					</p>
+					<div id="groq-ai-bulk-status" class="description"></div>
+					<ol id="groq-ai-bulk-log" class="groq-ai-bulk-log"></ol>
+				<?php else : ?>
+					<p class="description"><?php esc_html_e( 'Alle categorieën hebben al een omschrijving.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
+				<?php endif; ?>
+			</div>
 			<table class="widefat striped">
 				<thead>
 					<tr>
@@ -191,16 +227,24 @@ class Groq_AI_Product_Text_Settings_Page {
 					<?php foreach ( $terms as $term ) : ?>
 						<?php
 							$link = $this->get_term_page_url( 'product_cat', $term->term_id );
-							$words = $this->count_words( $term->description );
+							$words = isset( $word_map[ $term->term_id ] ) ? $word_map[ $term->term_id ] : 0;
 							$count = isset( $term->count ) ? absint( $term->count ) : 0;
+							$row_classes = [ 'groq-ai-term-row' ];
+							if ( 0 === $words ) {
+								$row_classes[] = 'groq-ai-term-missing';
+							}
 						?>
-						<tr>
+						<tr class="<?php echo esc_attr( implode( ' ', $row_classes ) ); ?>" data-groq-ai-term-id="<?php echo esc_attr( (string) $term->term_id ); ?>">
 							<td>
 								<a href="<?php echo esc_url( $link ); ?>"><strong><?php echo esc_html( $term->name ); ?></strong></a>
 							</td>
 							<td><?php echo esc_html( $term->slug ); ?></td>
 							<td><?php echo esc_html( (string) $count ); ?></td>
-							<td><?php echo esc_html( (string) $words ); ?></td>
+							<td class="groq-ai-word-cell">
+								<span class="groq-ai-word-count" data-term-id="<?php echo esc_attr( (string) $term->term_id ); ?>">
+									<?php echo esc_html( (string) $words ); ?>
+								</span>
+							</td>
 						</tr>
 					<?php endforeach; ?>
 				<?php endif; ?>
@@ -230,6 +274,8 @@ class Groq_AI_Product_Text_Settings_Page {
 			[
 				'taxonomy' => $taxonomy,
 				'hide_empty' => false,
+				'orderby' => 'name',
+				'order' => 'ASC',
 				'number' => 0,
 			]
 		);
@@ -315,10 +361,22 @@ class Groq_AI_Product_Text_Settings_Page {
 		$term_label = ( 'product_cat' === $taxonomy ) ? __( 'Categorie', GROQ_AI_PRODUCT_TEXT_DOMAIN ) : __( 'Term', GROQ_AI_PRODUCT_TEXT_DOMAIN );
 		$word_count = $this->count_words( $term->description );
 		$meta_prompt = get_term_meta( $term_id, 'groq_ai_term_custom_prompt', true );
-		$default_prompt = (string) $meta_prompt;
-		if ( '' === trim( $default_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 );
+		$settings = $this->plugin->get_settings();
+		$bottom_meta_key = $this->resolve_term_bottom_description_meta_key( $term, $settings );
+		$effective_bottom_meta_key = '' !== $bottom_meta_key ? $bottom_meta_key : 'groq_ai_term_bottom_description';
+		$bottom_description = (string) get_term_meta( $term_id, $effective_bottom_meta_key, true );
+		$rankmath_module_enabled = $this->plugin->is_module_enabled( 'rankmath', $settings );
+		$rankmath_active = $this->plugin->is_rankmath_active();
+		$rankmath_title = '';
+		$rankmath_description = '';
+		$rankmath_focus_keywords = '';
+		if ( $rankmath_module_enabled ) {
+			$rankmath_keys = $this->resolve_rankmath_term_meta_keys( $term, $settings );
+			$rankmath_title = (string) get_term_meta( $term_id, $rankmath_keys['title'], true );
+			$rankmath_description = (string) get_term_meta( $term_id, $rankmath_keys['description'], true );
+			$rankmath_focus_keywords = (string) get_term_meta( $term_id, $rankmath_keys['focus_keyword'], true );
 		}
+		$default_prompt = $this->get_term_prompt_text( $term, $meta_prompt );
 		?>
 		<div class="wrap">
 			<h1>
@@ -350,6 +408,24 @@ class Groq_AI_Product_Text_Settings_Page {
 							<p class="description"><?php esc_html_e( 'Dit is de standaard WordPress term-omschrijving (wordt o.a. gebruikt op categorie/merk pagina’s).', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
 						</td>
 					</tr>
+					<tr>
+						<th scope="row"><label for="groq-ai-term-bottom-description"><?php esc_html_e( 'Omschrijving (onderaan)', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></label></th>
+						<td>
+							<textarea name="groq_ai_term_bottom_description" id="groq-ai-term-bottom-description" rows="8" class="large-text"><?php echo esc_textarea( (string) $bottom_description ); ?></textarea>
+							<p class="description">
+								<?php
+									printf(
+										/* translators: %s: meta key */
+										esc_html__( 'Deze tekst wordt opgeslagen in term meta (%s) en is bedoeld voor helemaal onderaan (LiveBetter customfields).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+										esc_html( $effective_bottom_meta_key )
+									);
+									if ( '' === $bottom_meta_key ) {
+										echo ' ' . esc_html__( 'Let op: stel de juiste LiveBetter meta key in via de plugin-instelling of via de filter groq_ai_term_bottom_description_meta_key.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+									}
+								?>
+							</p>
+						</td>
+					</tr>
 					<tr>
 						<th scope="row"><label for="groq-ai-term-custom-prompt"><?php esc_html_e( 'Prompt (optioneel, per term)', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></label></th>
 						<td>
@@ -357,6 +433,34 @@ class Groq_AI_Product_Text_Settings_Page {
 							<p class="description"><?php esc_html_e( 'Laat leeg om de standaard prompt te gebruiken. Deze prompt wordt gebruikt wanneer je op de knop "Genereer" klikt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
 						</td>
 					</tr>
+					<?php if ( $rankmath_module_enabled ) : ?>
+						<?php if ( ! $rankmath_active ) : ?>
+							<tr>
+								<th scope="row"><?php esc_html_e( 'Rank Math', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></th>
+								<td>
+									<p class="description"><?php esc_html_e( 'Rank Math plugin lijkt niet actief. Velden zijn wel invulbaar en worden opgeslagen in term meta, maar Rank Math gebruikt ze pas na activatie.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></p>
+								</td>
+							</tr>
+						<?php endif; ?>
+						<tr>
+							<th scope="row"><label for="groq-ai-rankmath-title"><?php esc_html_e( 'Rank Math meta title', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></label></th>
+							<td>
+								<textarea name="groq_ai_rankmath_meta_title" id="groq-ai-rankmath-title" rows="2" class="large-text"><?php echo esc_textarea( (string) $rankmath_title ); ?></textarea>
+							</td>
+						</tr>
+						<tr>
+							<th scope="row"><label for="groq-ai-rankmath-description"><?php esc_html_e( 'Rank Math meta description', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></label></th>
+							<td>
+								<textarea name="groq_ai_rankmath_meta_description" id="groq-ai-rankmath-description" rows="3" class="large-text"><?php echo esc_textarea( (string) $rankmath_description ); ?></textarea>
+							</td>
+						</tr>
+						<tr>
+							<th scope="row"><label for="groq-ai-rankmath-keywords"><?php esc_html_e( 'Rank Math focus keywords', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></label></th>
+							<td>
+								<textarea name="groq_ai_rankmath_focus_keywords" id="groq-ai-rankmath-keywords" rows="2" class="large-text" placeholder="<?php esc_attr_e( 'bijv. luxe massage apparaat, wellness cadeau', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?>"><?php echo esc_textarea( (string) $rankmath_focus_keywords ); ?></textarea>
+							</td>
+						</tr>
+					<?php endif; ?>
 				</table>
 				<?php submit_button( __( 'Opslaan', GROQ_AI_PRODUCT_TEXT_DOMAIN ) ); ?>
 			</form>
@@ -380,11 +484,21 @@ class Groq_AI_Product_Text_Settings_Page {
 				<textarea id="groq-ai-term-prompt" class="large-text" rows="5"><?php echo esc_textarea( $default_prompt ); ?></textarea>
 				<p>
 					<button type="submit" class="button button-primary"><?php esc_html_e( 'Genereer', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></button>
-					<button type="button" class="button" id="groq-ai-term-apply"><?php esc_html_e( 'Zet in omschrijving', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></button>
+					<button type="button" class="button" id="groq-ai-term-apply"><?php esc_html_e( 'Zet in velden', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></button>
 				</p>
 				<div id="groq-ai-term-status" class="description" aria-live="polite"></div>
-				<h3><?php esc_html_e( 'Gegenereerde tekst', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
-				<textarea id="groq-ai-term-generated" class="large-text" rows="10"></textarea>
+				<h3><?php esc_html_e( 'Gegenereerde tekst (omschrijving, 1 alinea)', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+				<textarea id="groq-ai-term-generated-top" class="large-text" rows="6"></textarea>
+				<h3><?php esc_html_e( 'Gegenereerde tekst (onderaan)', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+				<textarea id="groq-ai-term-generated-bottom" class="large-text" rows="10"></textarea>
+				<?php if ( $rankmath_module_enabled ) : ?>
+					<h3><?php esc_html_e( 'Gegenereerde Rank Math meta title', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+					<textarea id="groq-ai-term-generated-meta-title" class="large-text" rows="2"></textarea>
+					<h3><?php esc_html_e( 'Gegenereerde Rank Math meta description', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+					<textarea id="groq-ai-term-generated-meta-description" class="large-text" rows="3"></textarea>
+					<h3><?php esc_html_e( 'Gegenereerde Rank Math focus keywords', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
+					<textarea id="groq-ai-term-generated-focus-keywords" class="large-text" rows="2"></textarea>
+				<?php endif; ?>
 				<h3><?php esc_html_e( 'Ruwe JSON-output', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?></h3>
 				<pre id="groq-ai-term-raw" style="background:#fff;border:1px solid #ddd;padding:12px;max-height:240px;overflow:auto;"></pre>
 			</form>
@@ -392,6 +506,86 @@ class Groq_AI_Product_Text_Settings_Page {
 		<?php
 	}

+	private function resolve_term_bottom_description_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;
+	}
+
+	private function resolve_rankmath_term_meta_keys( $term, $settings ) {
+		$keys = [
+			'title'        => 'rank_math_title',
+			'description'  => 'rank_math_description',
+			'focus_keyword' => 'rank_math_focus_keyword',
+		];
+		$keys = apply_filters( 'groq_ai_rankmath_term_meta_keys', $keys, $term, $settings );
+		if ( ! is_array( $keys ) ) {
+			$keys = [];
+		}
+
+		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, $custom_prompt = null ) {
+		$prompt = ( null !== $custom_prompt ) ? $custom_prompt : '';
+
+		if ( null === $custom_prompt && $term && isset( $term->term_id ) ) {
+			$prompt = get_term_meta( $term->term_id, 'groq_ai_term_custom_prompt', true );
+		}
+
+		$prompt = trim( (string) $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 get_terms_without_description_payload( $taxonomy ) {
+		$terms = get_terms(
+			[
+				'taxonomy'   => $taxonomy,
+				'hide_empty' => false,
+				'orderby'    => 'name',
+				'order'      => 'ASC',
+				'number'     => 0,
+			]
+		);
+
+		if ( is_wp_error( $terms ) ) {
+			return [];
+		}
+
+		$payloads = [];
+		foreach ( $terms as $term ) {
+			$description = isset( $term->description ) ? trim( wp_strip_all_tags( (string) $term->description ) ) : '';
+			if ( '' !== $description ) {
+				continue;
+			}
+
+			$payloads[] = [
+				'id'     => isset( $term->term_id ) ? absint( $term->term_id ) : 0,
+				'name'   => isset( $term->name ) ? (string) $term->name : '',
+				'slug'   => isset( $term->slug ) ? (string) $term->slug : '',
+				'count'  => isset( $term->count ) ? absint( $term->count ) : 0,
+				'url'    => esc_url( $this->get_term_page_url( $taxonomy, isset( $term->term_id ) ? $term->term_id : 0 ) ),
+			];
+		}
+
+		return array_values( $payloads );
+	}
+
 	public function handle_save_term_content() {
 		if ( ! current_user_can( 'manage_options' ) ) {
 			wp_die( esc_html__( 'Geen toestemming.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
@@ -402,7 +596,11 @@ class Groq_AI_Product_Text_Settings_Page {
 		$taxonomy = isset( $_POST['taxonomy'] ) ? sanitize_key( wp_unslash( $_POST['taxonomy'] ) ) : '';
 		$term_id  = isset( $_POST['term_id'] ) ? absint( $_POST['term_id'] ) : 0;
 		$description = isset( $_POST['description'] ) ? wp_kses_post( wp_unslash( $_POST['description'] ) ) : '';
+		$bottom_description = isset( $_POST['groq_ai_term_bottom_description'] ) ? wp_kses_post( wp_unslash( $_POST['groq_ai_term_bottom_description'] ) ) : '';
 		$custom_prompt = isset( $_POST['groq_ai_term_custom_prompt'] ) ? sanitize_textarea_field( wp_unslash( $_POST['groq_ai_term_custom_prompt'] ) ) : '';
+		$rankmath_meta_title = isset( $_POST['groq_ai_rankmath_meta_title'] ) ? sanitize_text_field( wp_unslash( $_POST['groq_ai_rankmath_meta_title'] ) ) : '';
+		$rankmath_meta_description = isset( $_POST['groq_ai_rankmath_meta_description'] ) ? sanitize_text_field( wp_unslash( $_POST['groq_ai_rankmath_meta_description'] ) ) : '';
+		$rankmath_focus_keywords = isset( $_POST['groq_ai_rankmath_focus_keywords'] ) ? sanitize_text_field( wp_unslash( $_POST['groq_ai_rankmath_focus_keywords'] ) ) : '';

 		if ( '' === $taxonomy || ! taxonomy_exists( $taxonomy ) || ! $term_id ) {
 			wp_safe_redirect( $this->get_settings_page_url() );
@@ -419,6 +617,21 @@ class Groq_AI_Product_Text_Settings_Page {

 		if ( ! is_wp_error( $result ) ) {
 			update_term_meta( $term_id, 'groq_ai_term_custom_prompt', $custom_prompt );
+			$settings = $this->plugin->get_settings();
+			$term = get_term( $term_id, $taxonomy );
+			if ( $term && ! is_wp_error( $term ) ) {
+				$bottom_meta_key = $this->resolve_term_bottom_description_meta_key( $term, $settings );
+				$effective_bottom_meta_key = '' !== $bottom_meta_key ? $bottom_meta_key : 'groq_ai_term_bottom_description';
+				update_term_meta( $term_id, $effective_bottom_meta_key, $bottom_description );
+
+				$rankmath_module_enabled = $this->plugin->is_module_enabled( 'rankmath', $settings );
+				if ( $rankmath_module_enabled ) {
+					$rankmath_keys = $this->resolve_rankmath_term_meta_keys( $term, $settings );
+					update_term_meta( $term_id, $rankmath_keys['title'], $rankmath_meta_title );
+					update_term_meta( $term_id, $rankmath_keys['description'], $rankmath_meta_description );
+					update_term_meta( $term_id, $rankmath_keys['focus_keyword'], $rankmath_focus_keywords );
+				}
+			}
 		}

 		wp_safe_redirect( $this->get_term_page_url( $taxonomy, $term_id ) );
@@ -550,6 +763,14 @@ class Groq_AI_Product_Text_Settings_Page {
 			'groq_ai_product_text_prompts'
 		);

+		add_settings_field(
+			'groq_ai_term_bottom_description_meta_key',
+			__( 'Term-veld (onderaan) meta key', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+			[ $this, 'render_term_bottom_description_meta_key_field' ],
+			'groq-ai-product-text-prompts',
+			'groq_ai_product_text_prompts'
+		);
+
 		add_settings_field(
 			'groq_ai_context_fields',
 			__( 'Standaard productcontext', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
@@ -558,6 +779,14 @@ class Groq_AI_Product_Text_Settings_Page {
 			'groq_ai_product_text_prompts'
 		);

+		add_settings_field(
+			'groq_ai_product_attribute_includes',
+			__( 'Productattributen meesturen', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+			[ $this, 'render_product_attribute_includes_field' ],
+			'groq-ai-product-text-prompts',
+			'groq_ai_product_text_prompts'
+		);
+
 		add_settings_field(
 			'groq_ai_response_format_compat',
 			__( 'Response-format compatibiliteit', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
@@ -1482,6 +1711,22 @@ class Groq_AI_Product_Text_Settings_Page {
 		<?php
 	}

+	public function render_term_bottom_description_meta_key_field() {
+		$settings = $this->plugin->get_settings();
+		$value    = isset( $settings['term_bottom_description_meta_key'] ) ? (string) $settings['term_bottom_description_meta_key'] : '';
+		?>
+		<input type="text"
+			name="<?php echo esc_attr( $this->plugin->get_option_key() ); ?>[term_bottom_description_meta_key]"
+			value="<?php echo esc_attr( $value ); ?>"
+			class="regular-text"
+			placeholder="bijv. bottom_description"
+		/>
+		<p class="description">
+			<?php esc_html_e( 'Dit is de term meta key van het extra customfields-veld dat onderaan de categorie/merk pagina wordt getoond (LiveBetter customfields). Laat leeg om alleen de standaard term-omschrijving te gebruiken.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?>
+		</p>
+		<?php
+	}
+
 	public function render_context_fields_field() {
 		$settings    = $this->plugin->get_settings();
 		$values      = isset( $settings['context_fields'] ) ? $settings['context_fields'] : $this->plugin->get_default_context_fields();
@@ -1489,6 +1734,9 @@ class Groq_AI_Product_Text_Settings_Page {
 		?>
 		<div class="groq-ai-context-defaults">
 			<?php foreach ( $definitions as $key => $definition ) :
+				if ( 'attributes' === $key ) {
+					continue;
+				}
 				$checked = ! empty( $values[ $key ] );
 				?>
 				<label>
@@ -1505,6 +1753,74 @@ class Groq_AI_Product_Text_Settings_Page {
 		<?php
 	}

+	public function render_product_attribute_includes_field() {
+		$settings = $this->plugin->get_settings();
+		$values   = isset( $settings['product_attribute_includes'] ) && is_array( $settings['product_attribute_includes'] )
+			? $settings['product_attribute_includes']
+			: [];
+		$values = array_values( array_unique( array_map( 'sanitize_key', $values ) ) );
+
+		$options = $this->get_product_attribute_include_options();
+		?>
+		<div class="groq-ai-attribute-includes">
+			<p class="description" style="margin-top:0;">
+				<?php esc_html_e( 'Selecteer welke productattributen je als context mee wilt sturen naar de AI. Als je niets selecteert, worden attributen niet meegestuurd (tenzij je dit eerder al had ingeschakeld via de oude instelling).', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?>
+			</p>
+			<?php if ( empty( $options ) ) : ?>
+				<p class="description">
+					<?php esc_html_e( 'Geen WooCommerce-attributen gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ); ?>
+				</p>
+			<?php else : ?>
+				<div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:8px;">
+					<?php foreach ( $options as $key => $label ) :
+						$checked = in_array( $key, $values, true );
+						?>
+						<label style="display:flex;gap:8px;align-items:flex-start;">
+							<input type="checkbox" name="<?php echo esc_attr( $this->plugin->get_option_key() ); ?>[product_attribute_includes][]" value="<?php echo esc_attr( $key ); ?>" <?php checked( $checked ); ?> />
+							<span><?php echo esc_html( $label ); ?></span>
+						</label>
+					<?php endforeach; ?>
+				</div>
+			<?php endif; ?>
+		</div>
+		<?php
+	}
+
+	private function get_product_attribute_include_options() {
+		$options = [
+			'__custom__' => __( 'Custom attributen (niet-taxonomie)', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+		];
+
+		if ( function_exists( 'wc_get_attribute_taxonomies' ) ) {
+			$taxonomies = wc_get_attribute_taxonomies();
+			if ( is_array( $taxonomies ) ) {
+				foreach ( $taxonomies as $attr ) {
+					$name  = isset( $attr->attribute_name ) ? sanitize_key( (string) $attr->attribute_name ) : '';
+					$label = isset( $attr->attribute_label ) ? sanitize_text_field( (string) $attr->attribute_label ) : '';
+					if ( '' === $name ) {
+						continue;
+					}
+					$taxonomy = 'pa_' . $name;
+					if ( '' === $label ) {
+						$label = function_exists( 'wc_attribute_label' ) ? wc_attribute_label( $taxonomy ) : $taxonomy;
+					}
+					$options[ $taxonomy ] = $label;
+				}
+			}
+		}
+
+		if ( count( $options ) > 1 ) {
+			$fixed = [
+				'__custom__' => $options['__custom__'],
+			];
+			unset( $options['__custom__'] );
+			asort( $options, SORT_NATURAL | SORT_FLAG_CASE );
+			$options = $fixed + $options;
+		}
+
+		return $options;
+	}
+
 	public function render_response_format_compat_field() {
 		$settings = $this->plugin->get_settings();
 		$is_enabled = ! empty( $settings['response_format_compat'] );
@@ -1556,7 +1872,7 @@ class Groq_AI_Product_Text_Settings_Page {
 				type="number"
 				id="groq-ai-rankmath-keywords"
 				min="1"
-				max="99"
+				max="100"
 				name="<?php echo esc_attr( $this->plugin->get_option_key() ); ?>[modules][rankmath][focus_keyword_limit]"
 				value="<?php echo esc_attr( $keyword_limit ); ?>"
 				style="width: 80px;"
@@ -1660,6 +1976,37 @@ class Groq_AI_Product_Text_Settings_Page {
 			);
 		}

+		if ( 'settings_page_groq-ai-product-text-categories' === $hook ) {
+			wp_enqueue_script(
+				'groq-ai-category-bulk',
+				plugins_url( 'assets/js/category-bulk.js', GROQ_AI_PRODUCT_TEXT_FILE ),
+				[],
+				GROQ_AI_PRODUCT_TEXT_VERSION,
+				true
+			);
+
+			wp_localize_script(
+				'groq-ai-category-bulk',
+				'GroqAICategoryBulk',
+				[
+					'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+					'nonce'   => wp_create_nonce( 'groq_ai_bulk_generate_terms' ),
+					'taxonomy' => 'product_cat',
+					'terms'   => $this->get_terms_without_description_payload( 'product_cat' ),
+					'strings' => [
+						'statusIdle'     => __( 'Klik op de knop om voor alle lege categorieën automatisch teksten te genereren.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'statusProgress' => __( 'Bezig met categorie %1$s van %2$s: %3$s', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'statusDone'     => __( 'Klaar! %d categorieën bijgewerkt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'statusStopped'  => __( 'Bulk generatie gestopt. %d categorieën bijgewerkt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'statusEmpty'    => __( 'Geen categorieën zonder omschrijving gevonden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'logSuccess'     => __( '%1$s gevuld (%2$d woorden).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'logError'       => __( '%1$s mislukt: %2$s', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+						'confirmStop'    => __( 'Weet je zeker dat je wilt stoppen? De huidige categorie kan onafgemaakt blijven.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					],
+				]
+			);
+		}
+
 		$current_settings = $this->plugin->get_settings();
 		$data = [
 			'optionKey'       => $this->plugin->get_option_key(),
--- 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,101 @@ 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,
+			]
+		);
+
+		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
+		);
+
+		$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 ) );
+		}
+
+		$options = wp_parse_args(
+			$options,
+			[
+				'include_top_products' => true,
+				'top_products_limit'   => 10,
+			]
+		);
+
+		$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 ) );
+
 		$settings         = $this->plugin->get_settings();
 		$provider_manager = $this->plugin->get_provider_manager();
 		$provider_key     = $settings['provider'];
@@ -51,14 +147,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
 			);
@@ -78,6 +173,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,11 +187,11 @@ class Groq_AI_Ajax_Controller {
 		);

 		if ( is_wp_error( $result ) ) {
-			wp_send_json_error( [ 'message' => $result->get_error_message() ], 500 );
+			return $result;
 		}

 		$response_text = $this->extract_content_text( $result );
-		$parsed = null;
+		$parsed        = null;
 		if ( method_exists( $prompt_builder, 'parse_term_structured_response' ) ) {
 			$parsed = $prompt_builder->parse_term_structured_response( $response_text, $settings );
 		}
@@ -105,12 +201,127 @@ class Groq_AI_Ajax_Controller {
 			];
 		}

-		wp_send_json_success(
+		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,
 			[
-				'description' => isset( $parsed['description'] ) ? $parsed['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() {
@@ -138,6 +349,23 @@ class Groq_AI_Ajax_Controller {
 		$system_prompt        = $prompt_builder->build_system_prompt( $settings, $conversation_id );
 		$model                = $this->plugin->get_selected_model( $provider, $settings );
 		$context_fields       = $prompt_builder->parse_context_fields_from_request( isset( $_POST['context_fields'] ) ? $_POST['context_fields'] : '', $settings );
+		if ( array_key_exists( 'attribute_includes', $_POST ) ) {
+			$attribute_includes = [];
+			$attribute_raw      = (string) wp_unslash( $_POST['attribute_includes'] );
+			$decoded            = json_decode( $attribute_raw, true );
+			if ( is_array( $decoded ) ) {
+				foreach ( $decoded as $value ) {
+					$key = sanitize_key( (string) $value );
+					if ( '' === $key ) {
+						continue;
+					}
+					if ( in_array( $key, [ '__custom__', '__all__' ], true ) || 0 === strpos( $key, 'pa_' ) ) {
+						$attribute_includes[] = $key;
+					}
+				}
+			}
+			$settings['product_attribute_includes'] = array_values( array_unique( $attribute_includes ) );
+		}
 		$image_context_mode   = $this->plugin->get_image_context_mode( $settings );
 		$image_context_limit  = $this->plugin->get_image_context_limit( $settings );

@@ -163,7 +391,7 @@ class Groq_AI_Ajax_Controller {
 			}
 		}

-		$product_context_text = $prompt_builder->build_product_context_block( $post_id, $context_fields, $prompt_image_mode, $image_context_limit );
+		$product_context_text = $prompt_builder->build_product_context_block( $post_id, $context_fields, $prompt_image_mode, $image_context_limit, $settings );
 		$image_context_payloads = [];
 		if ( $use_base64_payloads ) {
 			$image_context_payloads = $prompt_builder->get_product_image_payloads( $post_id, $image_context_limit );
--- a/includes/Services/Prompt/class-groq-ai-prompt-builder.php
+++ b/includes/Services/Prompt/class-groq-ai-prompt-builder.php
@@ -55,6 +55,145 @@ class Groq_AI_Prompt_Builder {
 		);
 	}

+	private function detect_brand_taxonomy() {
+		$candidates = [
+			'product_brand',
+			'pwb-brand',
+			'yith_product_brand',
+			'berocket_brand',
+		];
+
+		if ( taxonomy_exists( 'pa_brand' ) ) {
+			array_unshift( $candidates, 'pa_brand' );
+		}
+
+		$candidates = apply_filters( 'groq_ai_brand_taxonomy_candidates', $candidates );
+		$found = '';
+		foreach ( $candidates as $tax ) {
+			$tax = sanitize_key( (string) $tax );
+			if ( $tax && taxonomy_exists( $tax ) ) {
+				$found = $tax;
+				break;
+			}
+		}
+
+		$found = apply_filters( 'groq_ai_brand_taxonomy', $found );
+		return sanitize_key( (string) $found );
+	}
+
+	private function get_internal_link_suggestions( $taxonomy, $current_term_id, $limit = 10 ) {
+		$taxonomy        = sanitize_key( (string) $taxonomy );
+		$current_term_id = absint( $current_term_id );
+		$limit           = max( 0, min( 50, absint( $limit ) ) );
+		if ( '' === $taxonomy || $limit <= 0 || ! taxonomy_exists( $taxonomy ) ) {
+			return [];
+		}
+
+		$cache_key = 'groq_ai_internal_links_' . $taxonomy;
+		$cached    = get_transient( $cache_key );
+		if ( is_array( $cached ) ) {
+			$all = $cached;
+		} else {
+			$terms = get_terms(
+				[
+					'taxonomy'   => $taxonomy,
+					'hide_empty' => false,
+					'orderby'    => 'name',
+					'order'      => 'ASC',
+					'number'     => 0,
+				]
+			);
+			if ( is_wp_error( $terms ) ) {
+				$terms = [];
+			}
+
+			$all = [];
+			foreach ( (array) $terms as $t ) {
+				if ( ! $t || ! is_object( $t ) || empty( $t->term_id ) ) {
+					continue;
+				}
+				$link = get_term_link( $t );
+				if ( is_wp_error( $link ) || ! is_string( $link ) || '' === $link ) {
+					continue;
+				}
+				$name = isset( $t->name ) ? trim( wp_strip_all_tags( (string) $t->name ) ) : '';
+				if ( '' === $name ) {
+					continue;
+				}
+				$all[] = [
+					'term_id' => absint( $t->term_id ),
+					'name'    => $name,
+					'url'     => esc_url_raw( $link ),
+				];
+			}
+
+			set_transient( $cache_key, $all, HOUR_IN_SECONDS );
+		}
+
+		$suggestions = [];
+		foreach ( $all as $row ) {
+			if ( ! is_array( $row ) ) {
+				continue;
+			}
+			$tid = isset( $row['term_id'] ) ? absint( $row['term_id'] ) : 0;
+			if ( $current_term_id && $tid === $current_term_id ) {
+				continue;
+			}
+			$name = isset( $row['name'] ) ? (string) $row['name'] : '';
+			$url  = isset( $row['url'] ) ? (string) $row['url'] : '';
+			if ( '' === $name || '' === $url ) {
+				continue;
+			}
+			$suggestions[] = [
+				'name' => $name,
+				'url'  => $url,
+			];
+			if ( count( $suggestions ) >= $limit ) {
+				break;
+			}
+		}
+
+		return $suggestions;
+	}
+
+	private function build_internal_links_context( $term ) {
+		if ( ! $term || ! is_object( $term ) ) {
+			return '';
+		}
+		$current_tax = isset( $term->taxonomy ) ? sanitize_key( (string) $term->taxonomy ) : '';
+		$current_id  = isset( $term->term_id ) ? absint( $term->term_id ) : 0;
+
+		$links = [];
+
+		// Categories.
+		if ( taxonomy_exists( 'product_cat' ) ) {
+			$links = array_merge( $links, $this->get_internal_link_suggestions( 'product_cat', 'product_cat' === $current_tax ? $current_id : 0, 10 ) );
+		}
+
+		// Brands.
+		$brand_tax = $this->detect_brand_taxonomy();
+		if ( '' !== $brand_tax ) {
+			$links = array_merge( $links, $this->get_internal_link_suggestions( $brand_tax, $brand_tax === $current_tax ? $current_id : 0, 10 ) );
+		}
+
+		if ( empty( $links ) ) {
+			return '';
+		}
+
+		$lines = [];
+		$lines[] = __( 'Interne links (gebruik 2–5 relevante links in de tekst, als HTML: <a href="URL">Anker</a>):', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		foreach ( $links as $link ) {
+			$name = isset( $link['name'] ) ? (string) $link['name'] : '';
+			$url  = isset( $link['url'] ) ? (string) $link['url'] : '';
+			if ( '' === $name || '' === $url ) {
+				continue;
+			}
+			$lines[] = sprintf( '- %s → %s', $name, $url );
+		}
+
+		return implode( "\n", $lines );
+	}
+
 	public function append_response_instructions( $prompt, $settings ) {
 		$instructions = (string) ( $this->get_structured_response_instructions( $settings ) ?? '' );
 		$prompt       = trim( (string) $prompt );
@@ -199,7 +338,7 @@ class Groq_AI_Prompt_Builder {
 		return $normalized;
 	}

-	public function build_product_context_block( $post_id, $fields, $image_mode = 'url', $image_limit = 3 ) {
+	public function build_product_context_block( $post_id, $fields, $image_mode = 'url', $image_limit = 3, $settings = null ) {
 		$post_id = absint( $post_id );

 		if ( ! $post_id ) {
@@ -229,8 +368,14 @@ class Groq_AI_Prompt_Builder {
 			}
 		}

-		if ( ! empty( $fields['attributes'] ) ) {
-			$attributes = $this->get_product_attributes_text( $post_id );
+		$attribute_includes = [];
+		if ( is_array( $settings ) && isset( $settings['product_attribute_includes'] ) && is_array( $settings['product_attribute_includes'] ) ) {
+			$attribute_includes = array_values( array_unique( array_map( 'sanitize_key', $settings['product_attribute_includes'] ) ) );
+		}
+
+		$include_attributes = ! empty( $attribute_includes ) || ! empty( $fields['attributes'] );
+		if ( $include_attributes ) {
+			$attributes = $this->get_product_attributes_text( $post_id, $attribute_includes );
 			if ( $attributes ) {
 				$parts[] = sprintf( __( 'Attributen: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), $attributes );
 			}
@@ -243,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 );

@@ -285,6 +487,16 @@ class Groq_AI_Prompt_Builder {
 			$parts[] = sprintf( __( 'Huidige omschrijving: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), wp_strip_all_tags( (string) $term->description ) );
 		}

+		$bottom_meta_key = $this->resolve_term_bottom_description_meta_key( $term, $settings );
+		$bottom_meta_key = '' !== $bottom_meta_key ? $bottom_meta_key : 'groq_ai_term_bottom_description';
+		if ( '' !== $bottom_meta_key && $term_id ) {
+			$bottom = (string) get_term_meta( $term_id, $bottom_meta_key, true );
+			$bottom = trim( wp_strip_all_tags( $bottom ) );
+			if ( '' !== $bottom ) {
+				$parts[] = sprintf( __( 'Huidige omschrijving (onderaan): %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), $bottom );
+			}
+		}
+
 		if ( $include_top_products ) {
 			$top_products = $this->get_top_products_for_term( $taxonomy, $term_id, $top_products_limit );
 			if ( ! empty( $top_products ) ) {
@@ -296,6 +508,12 @@ class Groq_AI_Prompt_Builder {
 			}
 		}

+		$internal_links = $this->build_internal_links_context( $term );
+		$internal_links = trim( (string) $internal_links );
+		if ( '' !== $internal_links ) {
+			$parts[] = $internal_links;
+		}
+
 		$google_context = apply_filters( 'groq_ai_term_google_context', '', $term, $settings );
 		$google_context = trim( (string) $google_context );
 		if ( '' !== $google_context ) {
@@ -321,9 +539,14 @@ class Groq_AI_Prompt_Builder {
 		$desc_pixels      = $this->settings_manager->get_rankmath_meta_description_pixel_limit( $settings );

 		$properties = [
-			'description' => [
+			'top_description' => [
 				'type'        => 'string',
-				'description' => __( 'HTML-omschrijving voor de categorie/term met paragrafen en eventueel lijstjes.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				'description' => __( 'Korte HTML-omschrijving (1 alinea) voor de standaard WordPress term description. Exact één alinea in <p>-tags.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				'minLength'   => 20,
+			],
+			'bottom_description' => [
+				'type'        => 'string',
+				'description' => __( 'Uitgebreide HTML-omschrijving (helemaal onderaan), 2–4 alinea’s, met paragrafen en eventueel lijstjes.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
 				'minLength'   => 20,
 			],
 		];
@@ -361,7 +584,7 @@ class Groq_AI_Prompt_Builder {
 		$schema = [
 			'type'                 => 'object',
 			'properties'           => $properties,
-			'required'             => [ 'description' ],
+			'required'             => [ 'top_description', 'bottom_description' ],
 			'additionalProperties' => false,
 		];

@@ -404,14 +627,25 @@ class Groq_AI_Prompt_Builder {
 			];
 		}

-		$description = isset( $decoded['description'] ) ? trim( (string) $decoded['description'] ) : '';
-		if ( '' === $description ) {
-			return new WP_Error( 'groq_ai_parse_error', __( 'De AI-respons bevatte geen description veld.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		$top = isset( $decoded['top_description'] ) ? trim( (string) $decoded['top_description'] ) : '';
+		$bottom = isset( $decoded['bottom_description'] ) ? trim( (string) $decoded['bottom_description'] ) : '';
+		// Backward compatibility: older prompts only returned `description`.
+		if ( '' === $top && isset( $decoded['description'] ) ) {
+			$top = trim( (string) $decoded['description'] );
+		}
+		if ( '' === $top && '' === $bottom ) {
+			return new WP_Error( 'groq_ai_parse_error', __( 'De AI-respons bevatte geen top_description/bottom_description velden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
 		}

-		$result = [
-			'description' => $description,
-		];
+		$result = [];
+		if ( '' !== $top ) {
+			$result['top_description'] = $top;
+			// For backwards compatibility with existing UI, keep `description` alias.
+			$result['description'] = $top;
+		}
+		if ( '' !== $bottom ) {
+			$result['bottom_description'] = $bottom;
+		}

 		if ( isset( $decoded['meta_title'] ) ) {
 			$result['meta_title'] = $this->truncate_meta_field( (string) $decoded['meta_title'], 60 );
@@ -438,7 +672,8 @@ class Groq_AI_Prompt_Builder {

 	private function get_term_structured_response_instructions( $settings = null ) {
 		$schema_parts = [
-			'"description":"..."',
+			'"top_description":"..."',
+			'"bottom_description":"..."',
 		];

 		$rankmath_enabled = $this->settings_manager->is_module_enabled( 'rankmath', $settings );
@@ -455,10 +690,21 @@ class Groq_AI_Prompt_Builder {
 			$json_structure
 		);

-		$instruction .= ' ' . __( 'Zorg dat description geldige HTML bevat (gebruik minimaal <p>-tags en waar relevant lijstjes of benadrukking). Voeg geen extra tekst buiten het JSON-object toe.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		$instruction .= ' ' . __( 'Zorg dat top_description en bottom_description geldige HTML bevatten. top_description moet exact één alinea zijn in <p>-tags. bottom_description moet 2–4 alinea’s bevatten.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		$instruction .= ' ' . __( 'Voeg geen extra tekst buiten het JSON-object toe.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		$instruction .= ' ' . __( 'Als in de context een sectie "Interne links" staat, verwerk dan 2–5 van deze links natuurlijk in bottom_description als HTML-links (<a href="URL">Anker</a>).', GROQ_AI_PRODUCT_TEXT_DOMAIN );
 		return $instruction;
 	}

+	private function resolve_term_bottom_description_meta_key( $term = null, $settings = null ) {
+		$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 );
+		return sanitize_key( (string) $key );
+	}
+
 	private function get_top_products_for_term( $taxonomy, $term_id, $limit = 10 ) {
 		$taxonomy = sanitize_key( (string) $taxonomy );
 		$term_id  = absint( $term_id );
@@ -650,7 +896,7 @@ class Groq_AI_Prompt_Builder {
 		return substr( $text, 0, $limit );
 	}

-	private function get_product_attributes_text( $post_id ) {
+	private function get_product_attributes_text( $post_id, $attribute_includes = [] ) {
 		if ( ! function_exists( 'wc_get_product' ) ) {
 			return '';
 		}
@@ -667,14 +913,27 @@ class Groq_AI_Prompt_Builder {
 			return '';
 		}

+		$attribute_includes = is_array( $attribute_includes ) ? array_values( array_unique( array_map( 'sanitize_key', $attribute_includes ) ) ) : [];
+		$include_all        = empty( $attribute_includes ) || in_array( '__all__', $attribute_includes, true );
+		$include_custom     = $include_all || in_array( '__custom__', $attribute_includes, true );
+
 		$lines = [];

 		foreach ( $attributes as $attribute ) {
 			if ( $attribute->is_taxonomy() ) {
-				$terms = wc_get_product_terms( $post_id, $attribute->get_name(), [ 'fields' => 'names' ] );
+				$taxonomy_name = sanitize_key( (string) $attribute->get_name() );
+				if ( ! $include_all && ! in_array( $taxonomy_name, $attribute_includes, true ) ) {
+					continue;
+				}
+
+				$terms = wc_get_product_terms( $post_id, $taxonomy_name, [ 'fields' => 'names' ] );
 				$value = implode( ', ', array_map( 'sanitize_text_field', (array) $terms ) );
-				$label = wc_attribute_label( $attribute->get_name() );
+				$label = wc_attribute_label( $taxonomy_name );
 			} else {
+				if ( ! $include_custom ) {
+					continue;
+				}
+
 				$options = $attribute->get_options();
 				$value   = implode( ', ', array_map( 'sanitize_text_field', (array) $options ) );
 				$label   = sanitize_text_field( $attribute->get_name() );
--- a/includes/Services/Settings/class-groq-ai-settings-manager.php
+++ b/includes/Services/Settings/class-groq-ai-settings-manager.php
@@ -33,6 +33,8 @@ class Groq_AI_Settings_Manager {
 			'store_context'  => '',
 			'default_prompt' => '',
 			'max_output_tokens' => 2048,
+			'product_attribute_includes' => [],
+			'term_bottom_description_meta_key' => '',
 			'groq_api_key'   => '',
 			'openai_api_key' => '',
 			'google_api_key' => '',
@@ -73,6 +75,10 @@ class Groq_AI_Settings_Manager {
 		$limit = isset( $settings['image_context_limit'] ) ? $this->sanitize_image_context_limit_value( $settings['image_context_limit'] ) : 3;
 		$settings['image_context_limit'] = $limit;

+		$settings['product_attribute_includes'] = $this->sanitize_product_attribute_includes(
+			isset( $settings['product_attribute_includes'] ) ? $settings['product_attribute_includes'] : []
+		);
+
 		return $settings;
 	}

@@ -89,6 +95,8 @@ class Groq_AI_Settings_Manager {
 			'store_context'  => '',
 			'default_prompt' => '',
 			'max_output_tokens' => 2048,
+			'product_attribute_includes' => [],
+			'term_bottom_description_meta_key' => '',
 			'groq_api_key'   => '',
 			'openai_api_key' => '',
 			'google_api_key' => '',
@@ -149,6 +157,8 @@ class Groq_AI_Settings_Manager {
 			'store_context'  => sanitize_textarea_field( $input['store_context'] ),
 			'default_prompt' => sanitize_textarea_field( $input['default_prompt'] ),
 			'max_output_tokens' => $max_output_tokens,
+			'product_attribute_includes' => $this->sanitize_product_attribute_includes( isset( $raw_input['product_attribute_includes'] ) ? $raw_input['product_attribute_includes'] : [] ),
+			'term_bottom_description_meta_key' => sanitize_key( (string) $input['term_bottom_description_meta_key'] ),
 			'groq_api_key'   => sanitize_text_field( $input['groq_api_key'] ),
 			'openai_api_key' => sanitize_text_field( $input['openai_api_key'] ),
 			'google_api_key' => sanitize_text_field( $input['google_api_key'] ),
@@ -174,6 +184,33 @@ class Groq_AI_Settings_Manager {
 		];
 	}

+	private function sanitize_product_attribute_includes( $value ) {
+		if ( ! is_array( $value ) ) {
+			return [];
+		}
+
+		$clean = [];
+		foreach ( $value as $item ) {
+			$item = sanitize_key( (string) $item );
+			if ( '' === $item ) {
+				continue;
+			}
+
+			// Allow special tokens and attribute taxonomies.
+			if ( in_array( $item, [ '__all__', '__custom__' ], true ) || 0 === strpos( $item, 'pa_' ) ) {
+				$clean[] = $item;
+			}
+		}
+
+		$clean = array_values( array_unique( $clean ) );
+		// Hard cap to avoid overly large option payloads.
+		if ( count( $clean ) > 200 ) {
+			$clean = array_slice( $clean, 0, 200 );
+		}
+
+		return $clean;
+	}
+
 	public function get_context_field_definitions() {
 		if ( null === $this->context_field_definitions ) {
 			$this->context_field_definitions = [
@@ -197,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 ),
@@ -224,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 ) ) {
@@ -282,7 +324,7 @@ class Groq_AI_Settings_Manager {
 		$config = $this->get_module_config( 'rankmath', $settings );
 		$limit  = isset( $config['focus_keyword_limit'] ) ? absint( $config['focus_keyword_limit'] ) : 3;

-		return max( 1, min( 10, $limit ) );
+		return max( 1, min( 100, $limit ) );
 	}

 	public function get_rankmath_meta_title_pixel_limit( $settings = null ) {
@@ -375,7 +417,7 @@ class Groq_AI_Settings_Manager {
 				if ( $limit <= 0 ) {
 					$limit = $module_default_config['focus_keyword_limit'];
 				}
-				$result[ $module_key ]['focus_keyword_limit'] = max( 1, min( 10, $limit ) );
+				$result[ $module_key ]['focus_keyword_limit'] = max( 1, min( 100, $limit ) );

 				$title_pixel_limit = isset( $raw['meta_title_pixel_limit'] ) ? absint( $raw['meta_title_pixel_limit'] ) : ( isset( $current_config['meta_title_pixel_limit'] ) ? absint( $current_config['meta_title_pixel_limit'] ) : $module_default_config['meta_title_pixel_limit'] );
 				if ( $title_pixel_limit <= 0 ) {
Author	SHA1	Message	Date
Roberto Guagliardo	5b256f1374	feat: Implement bulk generation for category descriptions with AJAX handling	2026-01-23 18:25:15 +00:00
Roberto Guagliardo	d878bb7805	feat: Update version to 1.5.0 and add brand context handling to prompts	2026-01-23 17:59:32 +00:00
Roberto Guagliardo	43ddbddd11	feat: Add product attribute inclusion settings and enhance context handling in AI prompts	2026-01-16 19:19:00 +00:00
Roberto Guagliardo	7b9f26e966	feat: Enhance term management by adding Rank Math meta fields and updating bottom description handling	2026-01-16 19:01:25 +00:00
Roberto Guagliardo	6f488c5c6d	feat: Add bottom description field for terms and update related functionality	2026-01-16 18:41:03 +00:00
Roberto Guagliardo	1c4ef5e16a	fix: Update version to 1.4.2 and enhance internal link suggestions with brand taxonomy detection	2026-01-16 18:21:25 +00:00