chore: Bump version to 1.6.4 and update OAuth redirect URI descriptions

chore: Bump version to 1.6.3
Refactor code structure for improved readability and maintainability
2026-01-26 19:50:38 +00:00 · 2026-01-26 19:26:20 +00:00 · 2026-01-26 19:25:42 +00:00 · 2026-01-23 19:02:11 +00:00 · 2026-01-23 18:55:52 +00:00 · 2026-01-23 18:25:15 +00:00
18 changed files with 3843 additions and 461 deletions
--- a/SitiWebUpdater.php
+++ b/SitiWebUpdater.php
@@ -33,7 +33,7 @@ class SitiWebUpdater {
 			require_once ABSPATH . 'wp-admin/includes/plugin.php';
 		}

-		$this->plugin	= get_plugin_data( $this->file );
+		$this->plugin	= get_plugin_data( $this->file, false, false );
 		$this->basename = plugin_basename( $this->file );
 		$this->active	= is_plugin_active( $this->basename );
 	}
--- 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/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/term-admin.js
+++ b/assets/js/term-admin.js
@@ -0,0 +1,149 @@
+(function () {
+	if (!window.GroqAITermGenerator) {
+		return;
+	}
+
+	const form = document.getElementById('groq-ai-term-form');
+	if (!form) {
+		return;
+	}
+
+	const promptField = document.getElementById('groq-ai-term-prompt');
+	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');
+	const includeTopProducts = document.getElementById('groq-ai-term-include-top-products');
+	const topProductsLimit = document.getElementById('groq-ai-term-top-products-limit');
+
+	function setStatus(message, type) {
+		if (!statusField) {
+			return;
+		}
+		statusField.textContent = message || '';
+		statusField.setAttribute('data-status', type || '');
+	}
+
+	function setLoading(isLoading) {
+		form.classList.toggle('is-loading', !!isLoading);
+		const buttons = form.querySelectorAll('button, input[type="submit"]');
+		buttons.forEach((btn) => {
+			btn.disabled = !!isLoading;
+		});
+	}
+
+	function buildPayload(prompt) {
+		const payload = new URLSearchParams();
+		payload.append('action', 'groq_ai_generate_term_text');
+		payload.append('nonce', GroqAITermGenerator.nonce);
+		payload.append('taxonomy', GroqAITermGenerator.taxonomy);
+		payload.append('term_id', GroqAITermGenerator.termId);
+		payload.append('prompt', prompt);
+		payload.append('include_top_products', includeTopProducts && includeTopProducts.checked ? '1' : '0');
+		payload.append('top_products_limit', topProductsLimit ? String(topProductsLimit.value || '') : '10');
+		return payload;
+	}
+
+	if (applyButton) {
+		applyButton.addEventListener('click', () => {
+			const descriptionField = document.getElementById('description');
+			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;
+			}
+
+			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');
+		});
+	}
+
+	form.addEventListener('submit', (event) => {
+		event.preventDefault();
+		const prompt = promptField ? (promptField.value || '').trim() : '';
+		if (!prompt) {
+			setStatus('Vul eerst een prompt in.', 'error');
+			return;
+		}
+
+		setLoading(true);
+		setStatus('AI is bezig met schrijven...', 'loading');
+		if (rawField) {
+			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: {
+				'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+			},
+			body: buildPayload(prompt).toString(),
+		})
+			.then((response) => response.json())
+			.then((json) => {
+				if (!json.success) {
+					const errorMessage = json.data && json.data.message ? json.data.message : 'Onbekende fout';
+					throw new Error(errorMessage);
+				}
+
+				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();
+				}
+
+				setStatus('Tekst gegenereerd. Je kunt hem toepassen en opslaan.', 'success');
+			})
+			.catch((error) => {
+				setStatus(error && error.message ? error.message : 'Er ging iets mis bij het genereren.', 'error');
+			})
+			.finally(() => {
+				setLoading(false);
+			});
+	});
+})();
--- 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.3.0
+ * Version: 1.6.4
 * Author: SitiAI
 * Text Domain: siti-ai-product-content-generator
 * Domain Path: /languages
@@ -54,6 +54,10 @@ require_once __DIR__ . '/includes/Services/Settings/class-groq-ai-settings-manag
 require_once __DIR__ . '/includes/Services/Prompt/class-groq-ai-prompt-builder.php';
 require_once __DIR__ . '/includes/Services/Conversations/class-groq-ai-conversation-manager.php';
 require_once __DIR__ . '/includes/Services/Logging/class-groq-ai-generation-logger.php';
+require_once __DIR__ . '/includes/Services/Google/class-groq-ai-google-oauth-client.php';
+require_once __DIR__ . '/includes/Services/Google/class-groq-ai-google-search-console-client.php';
+require_once __DIR__ . '/includes/Services/Google/class-groq-ai-google-analytics-data-client.php';
+require_once __DIR__ . '/includes/Services/Google/class-groq-ai-google-context-builder.php';
 require_once __DIR__ . '/includes/Admin/class-groq-ai-settings-page.php';
 require_once __DIR__ . '/includes/Admin/class-groq-ai-logs-table.php';
 require_once __DIR__ . '/includes/Admin/class-groq-ai-product-ui.php';
@@ -104,10 +108,10 @@ final class Groq_AI_Product_Text_Plugin {
 		$this->settings_page    = new Groq_AI_Product_Text_Settings_Page( $this, $this->get_provider_manager() );
 		$this->product_ui       = new Groq_AI_Product_Text_Product_UI( $this );

-		add_action( 'plugins_loaded', [ $this, 'maybe_load_textdomain_early' ], 0 );
 		add_action( 'init', [ $this, 'load_textdomain' ] );
 		add_action( 'plugins_loaded', [ $this, 'maybe_create_logs_table' ] );
 		add_action( 'load-plugins.php', [ $this, 'maybe_deactivate_if_woocommerce_missing' ] );
+		add_filter( 'groq_ai_term_google_context', [ $this, 'inject_google_term_context' ], 10, 3 );
 	}

 	public function load_textdomain() {
@@ -126,14 +130,6 @@ final class Groq_AI_Product_Text_Plugin {
 		$this->textdomain_loaded = true;
 	}

-	public function maybe_load_textdomain_early() {
-		if ( did_action( 'init' ) ) {
-			return;
-		}
-
-		$this->load_textdomain();
-	}
-
 	private function register_services() {
 		$this->container = new Groq_AI_Service_Container();

@@ -179,10 +175,47 @@ final class Groq_AI_Product_Text_Plugin {
 			}
 		);

+		$this->container->set(
+			'google_oauth_client',
+			function () {
+				return new Groq_AI_Google_OAuth_Client();
+			}
+		);
+
+		$this->container->set(
+			'gsc_client',
+			function ( Groq_AI_Service_Container $container ) {
+				return new Groq_AI_Google_Search_Console_Client( $container->get( 'google_oauth_client' ) );
+			}
+		);
+
+		$this->container->set(
+			'ga_client',
+			function ( Groq_AI_Service_Container $container ) {
+				return new Groq_AI_Google_Analytics_Data_Client( $container->get( 'google_oauth_client' ) );
+			}
+		);
+
+		$this->container->set(
+			'google_context_builder',
+			function ( Groq_AI_Service_Container $container ) {
+				return new Groq_AI_Google_Context_Builder( $container->get( 'gsc_client' ), $container->get( 'ga_client' ) );
+			}
+		);
+
 		// Instantiate controller immediately so hooks are registered.
 		$this->container->get( 'ajax_controller' );
 	}

+	public function inject_google_term_context( $existing, $term, $settings ) {
+		$builder = $this->container->get( 'google_context_builder' );
+		if ( ! $builder ) {
+			return (string) $existing;
+		}
+
+		return $builder->build_term_google_context( $existing, $term, $settings );
+	}
+
 	public function get_option_key() {
 		return self::OPTION_KEY;
 	}
--- a/includes/Admin/class-groq-ai-logs-table.php
+++ b/includes/Admin/class-groq-ai-logs-table.php
@@ -136,28 +136,15 @@ class Groq_AI_Logs_Table extends WP_List_Table {

 	protected function column_created_at( $item ) {
 		$date = esc_html( mysql2date( get_option( 'date_format' ) . ' ' . get_option( 'time_format' ), $item['created_at'] ) );
-		$usage = $this->get_usage_meta( $item );
-		$payload = [
-			'created_at'        => $item['created_at'],
-			'user'              => $this->column_default( $item, 'user_id' ),
-			'post_title'        => $item['post_title'],
-			'provider'          => $item['provider'],
-			'model'             => $item['model'],
-			'status'            => $item['status'],
-			'tokens_prompt'     => isset( $item['tokens_prompt'] ) ? (int) $item['tokens_prompt'] : null,
-			'tokens_completion' => isset( $item['tokens_completion'] ) ? (int) $item['tokens_completion'] : null,
-			'tokens_total'      => isset( $item['tokens_total'] ) ? (int) $item['tokens_total'] : null,
-			'prompt'            => $item['prompt'],
-			'response'          => $item['response'],
-			'error_message'     => $item['error_message'],
-			'image_context'     => isset( $usage['image_context'] ) ? $usage['image_context'] : null,
-		];
-		$encoded = esc_attr( wp_json_encode( $payload ) );
-		return sprintf(
-			'<a href="#" class="groq-ai-log-row" data-groq-log="%s">%s</a>',
-			$encoded,
-			$date
+		$url  = add_query_arg(
+			[
+				'page'   => 'groq-ai-product-text-log',
+				'log_id' => isset( $item['id'] ) ? (int) $item['id'] : 0,
+			],
+			admin_url( 'options-general.php' )
 		);
+
+		return sprintf( '<a href="%s">%s</a>', esc_url( $url ), $date );
 	}

 	private function get_usage_meta( $item ) {
--- 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
--- a/includes/Core/class-groq-ai-ajax-controller.php
+++ b/includes/Core/class-groq-ai-ajax-controller.php
@@ -9,6 +9,395 @@ 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() {
+		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_generate_term', 'nonce' );
+
+		$prompt   = isset( $_POST['prompt'] ) ? sanitize_textarea_field( wp_unslash( $_POST['prompt'] ) ) : '';
+		$taxonomy = isset( $_POST['taxonomy'] ) ? sanitize_key( wp_unslash( $_POST['taxonomy'] ) ) : '';
+		$term_id  = isset( $_POST['term_id'] ) ? absint( $_POST['term_id'] ) : 0;
+		$include_top_products = ! empty( $_POST['include_top_products'] );
+		$top_products_limit   = isset( $_POST['top_products_limit'] ) ? absint( $_POST['top_products_limit'] ) : 10;
+		$top_products_limit   = max( 1, min( 25, $top_products_limit ) );
+
+		if ( '' === $prompt || '' === $taxonomy || ! taxonomy_exists( $taxonomy ) || ! $term_id ) {
+			wp_send_json_error( [ 'message' => __( 'Prompt, taxonomy 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 );
+		}
+
+		$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'];
+		$provider         = $provider_manager->get_provider( $provider_key );
+
+		if ( ! $provider ) {
+			$provider     = $provider_manager->get_provider( 'groq' );
+			$provider_key = 'groq';
+		}
+
+		$conversation_id = $this->plugin->get_conversation_manager()->ensure_id( $provider_key, $settings['store_context'] );
+		$prompt_builder  = $this->plugin->get_prompt_builder();
+		$system_prompt   = method_exists( $prompt_builder, 'build_term_system_prompt' )
+			? $prompt_builder->build_term_system_prompt( $settings, $conversation_id, $term )
+			: $prompt_builder->build_system_prompt( $settings, $conversation_id );
+
+		$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,
+				],
+				$settings
+			);
+		}
+		$prompt_with_context = method_exists( $prompt_builder, 'prepend_term_context_to_prompt' )
+			? $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' ) ) {
+			$response_format = $prompt_builder->get_term_response_format_definition( $settings );
+			$final_prompt    = $prompt_with_context;
+		} elseif ( method_exists( $prompt_builder, 'append_term_response_instructions' ) ) {
+			$final_prompt = $prompt_builder->append_term_response_instructions( $prompt_with_context, $settings );
+		} else {
+			$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,
+				'system_prompt'   => $system_prompt,
+				'model'           => $model,
+				'settings'        => $settings,
+				'temperature'     => 0.7,
+				'conversation_id' => $conversation_id,
+				'response_format' => $response_format,
+			]
+		);
+
+		if ( is_wp_error( $result ) ) {
+			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 );
+		$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 ),
+			];
+		}
+
+		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,
+			[
+				'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() {
@@ -36,6 +425,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 );

@@ -61,7 +467,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/Providers/class-groq-ai-abstract-openai-provider.php
+++ b/includes/Providers/class-groq-ai-abstract-openai-provider.php
@@ -80,11 +80,20 @@ abstract class Groq_AI_Abstract_OpenAI_Provider implements Groq_AI_Provider_Inte
 			],
 		];

+		$max_tokens = isset( $args['max_tokens'] ) ? absint( $args['max_tokens'] ) : 0;
+		if ( $max_tokens <= 0 ) {
+			$max_tokens = isset( $settings['max_output_tokens'] ) ? absint( $settings['max_output_tokens'] ) : 0;
+		}
+		if ( $max_tokens <= 0 ) {
+			$max_tokens = 2048;
+		}
+		$max_tokens = max( 128, min( 8192, $max_tokens ) );
+
 		$request_body = [
 			'model'       => $model,
 			'messages'    => $messages,
 			'temperature' => isset( $args['temperature'] ) ? (float) $args['temperature'] : 0.7,
-			'max_tokens'  => 1024,
+			'max_tokens'  => $max_tokens,
 		];

 		if ( ! empty( $args['response_format'] ) ) {
@@ -122,6 +131,10 @@ abstract class Groq_AI_Abstract_OpenAI_Provider implements Groq_AI_Provider_Inte

 		$content = trim( $body['choices'][0]['message']['content'] );
 		$usage   = isset( $body['usage'] ) && is_array( $body['usage'] ) ? $body['usage'] : [];
+		$finish_reason = isset( $body['choices'][0]['finish_reason'] ) ? sanitize_text_field( (string) $body['choices'][0]['finish_reason'] ) : '';
+		if ( '' !== $finish_reason ) {
+			$usage['finish_reason'] = $finish_reason;
+		}

 		return [
 			'content'      => $content,
--- a/includes/Providers/class-groq-ai-provider-google.php
+++ b/includes/Providers/class-groq-ai-provider-google.php
@@ -144,6 +144,15 @@ class Groq_AI_Provider_Google implements Groq_AI_Provider_Interface {
 			];
 		}

+		$max_tokens = isset( $args['max_tokens'] ) ? absint( $args['max_tokens'] ) : 0;
+		if ( $max_tokens <= 0 ) {
+			$max_tokens = isset( $settings['max_output_tokens'] ) ? absint( $settings['max_output_tokens'] ) : 0;
+		}
+		if ( $max_tokens <= 0 ) {
+			$max_tokens = 2048;
+		}
+		$max_tokens = max( 128, min( 8192, $max_tokens ) );
+
 		$payload = [
 			'contents'         => [
 				[
@@ -153,7 +162,7 @@ class Groq_AI_Provider_Google implements Groq_AI_Provider_Interface {
 			],
 			'generationConfig' => [
 				'temperature'     => isset( $args['temperature'] ) ? (float) $args['temperature'] : 0.7,
-				'maxOutputTokens' => 1024,
+				'maxOutputTokens' => $max_tokens,
 			],
 		];

@@ -196,6 +205,10 @@ class Groq_AI_Provider_Google implements Groq_AI_Provider_Interface {

 		$content = trim( implode( "\n\n", array_filter( $texts ) ) );
 		$usage   = isset( $body['usageMetadata'] ) && is_array( $body['usageMetadata'] ) ? $body['usageMetadata'] : [];
+		$finish_reason = isset( $body['candidates'][0]['finishReason'] ) ? sanitize_text_field( (string) $body['candidates'][0]['finishReason'] ) : '';
+		if ( '' !== $finish_reason ) {
+			$usage['finish_reason'] = $finish_reason;
+		}

 		return [
 			'content'      => $content,
--- a/includes/Services/Google/class-groq-ai-google-analytics-data-client.php
+++ b/includes/Services/Google/class-groq-ai-google-analytics-data-client.php
@@ -0,0 +1,182 @@
+<?php
+
+class Groq_AI_Google_Analytics_Data_Client {
+	/** @var Groq_AI_Google_OAuth_Client */
+	private $oauth;
+
+	public function __construct( Groq_AI_Google_OAuth_Client $oauth ) {
+		$this->oauth = $oauth;
+	}
+
+	/**
+	 * Simple connectivity check for GA4 Data API.
+	 *
+	 * @param array $settings
+	 * @param string $property_id
+	 * @param string $start_date
+	 * @param string $end_date
+	 * @return array|WP_Error
+	 */
+	public function get_property_sessions_summary( $settings, $property_id, $start_date, $end_date ) {
+		$property_id = trim( (string) $property_id );
+		if ( '' === $property_id ) {
+			return new WP_Error( 'groq_ai_ga_missing', __( 'GA4 property ID ontbreekt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$token = $this->oauth->get_access_token( $settings );
+		if ( is_wp_error( $token ) ) {
+			return $token;
+		}
+
+		$endpoint = 'https://analyticsdata.googleapis.com/v1beta/properties/' . rawurlencode( $property_id ) . ':runReport';
+		$body = [
+			'dateRanges' => [
+				[
+					'startDate' => $start_date,
+					'endDate' => $end_date,
+				],
+			],
+			'metrics' => [
+				[ 'name' => 'sessions' ],
+				[ 'name' => 'engagedSessions' ],
+			],
+			'limit' => 1,
+		];
+
+		$response = wp_remote_post(
+			$endpoint,
+			[
+				'timeout' => 20,
+				'headers' => [
+					'Authorization' => 'Bearer ' . $token,
+					'Content-Type' => 'application/json',
+				],
+				'body' => wp_json_encode( $body ),
+			]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$raw_body    = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $raw_body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return new WP_Error( 'groq_ai_ga_error', __( 'GA4 Data API call mislukt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$rows = isset( $data['rows'] ) && is_array( $data['rows'] ) ? $data['rows'] : [];
+		$sessions = 0;
+		$engaged  = 0;
+		foreach ( $rows as $row ) {
+			$metric_values = isset( $row['metricValues'] ) && is_array( $row['metricValues'] ) ? $row['metricValues'] : [];
+			if ( isset( $metric_values[0]['value'] ) ) {
+				$sessions += absint( $metric_values[0]['value'] );
+			}
+			if ( isset( $metric_values[1]['value'] ) ) {
+				$engaged += absint( $metric_values[1]['value'] );
+			}
+		}
+
+		return [
+			'sessions' => $sessions,
+			'engagedSessions' => $engaged,
+		];
+	}
+
+	/**
+	 * Returns approximate GA4 sessions for a landing page path.
+	 *
+	 * @param array $settings
+	 * @param string $property_id
+	 * @param string $page_path e.g. /product-category/foo/
+	 * @param string $start_date YYYY-MM-DD
+	 * @param string $end_date YYYY-MM-DD
+	 * @return array|WP_Error
+	 */
+	public function get_sessions_for_landing_page_path( $settings, $property_id, $page_path, $start_date, $end_date ) {
+		$property_id = trim( (string) $property_id );
+		$page_path   = trim( (string) $page_path );
+
+		if ( '' === $property_id || '' === $page_path ) {
+			return new WP_Error( 'groq_ai_ga_missing', __( 'GA4 property ID of page path ontbreekt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$token = $this->oauth->get_access_token( $settings );
+		if ( is_wp_error( $token ) ) {
+			return $token;
+		}
+
+		$endpoint = 'https://analyticsdata.googleapis.com/v1beta/properties/' . rawurlencode( $property_id ) . ':runReport';
+
+		$body = [
+			'dateRanges' => [
+				[
+					'startDate' => $start_date,
+					'endDate' => $end_date,
+				],
+			],
+			'dimensions' => [
+				[ 'name' => 'landingPagePlusQueryString' ],
+			],
+			'metrics' => [
+				[ 'name' => 'sessions' ],
+				[ 'name' => 'engagedSessions' ],
+			],
+			'dimensionFilter' => [
+				'filter' => [
+					'fieldName' => 'landingPagePlusQueryString',
+					'stringFilter' => [
+						'matchType' => 'CONTAINS',
+						'value' => $page_path,
+					],
+				],
+			],
+			'limit' => 5,
+		];
+
+		$response = wp_remote_post(
+			$endpoint,
+			[
+				'timeout' => 20,
+				'headers' => [
+					'Authorization' => 'Bearer ' . $token,
+					'Content-Type' => 'application/json',
+				],
+				'body' => wp_json_encode( $body ),
+			]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$raw_body    = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $raw_body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return new WP_Error( 'groq_ai_ga_error', __( 'GA4 Data API call mislukt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$rows = isset( $data['rows'] ) && is_array( $data['rows'] ) ? $data['rows'] : [];
+		$sessions = 0;
+		$engaged  = 0;
+		foreach ( $rows as $row ) {
+			$metric_values = isset( $row['metricValues'] ) && is_array( $row['metricValues'] ) ? $row['metricValues'] : [];
+			if ( isset( $metric_values[0]['value'] ) ) {
+				$sessions += absint( $metric_values[0]['value'] );
+			}
+			if ( isset( $metric_values[1]['value'] ) ) {
+				$engaged += absint( $metric_values[1]['value'] );
+			}
+		}
+
+		return [
+			'sessions' => $sessions,
+			'engagedSessions' => $engaged,
+		];
+	}
+}
--- a/includes/Services/Google/class-groq-ai-google-context-builder.php
+++ b/includes/Services/Google/class-groq-ai-google-context-builder.php
@@ -0,0 +1,113 @@
+<?php
+
+class Groq_AI_Google_Context_Builder {
+	/** @var Groq_AI_Google_Search_Console_Client */
+	private $gsc;
+
+	/** @var Groq_AI_Google_Analytics_Data_Client */
+	private $ga;
+
+	public function __construct( Groq_AI_Google_Search_Console_Client $gsc, Groq_AI_Google_Analytics_Data_Client $ga ) {
+		$this->gsc = $gsc;
+		$this->ga  = $ga;
+	}
+
+	/**
+	 * @param string $existing
+	 * @param WP_Term $term
+	 * @param array $settings
+	 * @return string
+	 */
+	public function build_term_google_context( $existing, $term, $settings ) {
+		if ( ! $term || ! is_object( $term ) ) {
+			return (string) $existing;
+		}
+
+		$enabled_gsc = ! empty( $settings['google_enable_gsc'] );
+		$enabled_ga  = ! empty( $settings['google_enable_ga'] );
+
+		if ( ! $enabled_gsc && ! $enabled_ga ) {
+			return (string) $existing;
+		}
+
+		$term_id  = isset( $term->term_id ) ? absint( $term->term_id ) : 0;
+		$taxonomy = isset( $term->taxonomy ) ? sanitize_key( (string) $term->taxonomy ) : '';
+
+		$range_days = 28;
+		$end_date   = gmdate( 'Y-m-d' );
+		$start_date = gmdate( 'Y-m-d', time() - ( $range_days * DAY_IN_SECONDS ) );
+
+		$term_link = get_term_link( $term );
+		if ( is_wp_error( $term_link ) ) {
+			$term_link = '';
+		}
+
+		$page_path = '';
+		if ( is_string( $term_link ) && '' !== $term_link ) {
+			$parts = wp_parse_url( $term_link );
+			if ( is_array( $parts ) && isset( $parts['path'] ) ) {
+				$page_path = (string) $parts['path'];
+			}
+		}
+
+		$cache_key = 'groq_ai_google_term_ctx_' . md5( $taxonomy . '|' . $term_id . '|' . $start_date . '|' . $end_date );
+		$cached = get_transient( $cache_key );
+		if ( is_string( $cached ) && '' !== $cached ) {
+			return trim( (string) $existing . "\n\n" . $cached );
+		}
+
+		$lines = [];
+		$lines[] = sprintf(
+			/* translators: %d: days */
+			__( 'Google data (laatste %d dagen):', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+			$range_days
+		);
+
+		if ( $enabled_gsc ) {
+			$site_url = isset( $settings['google_gsc_site_url'] ) ? trim( (string) $settings['google_gsc_site_url'] ) : '';
+			if ( '' !== $site_url && '' !== $term_link ) {
+				$queries = $this->gsc->get_top_queries_for_page( $settings, $site_url, $term_link, $start_date, $end_date, 10 );
+				if ( is_wp_error( $queries ) ) {
+					$lines[] = __( 'Search Console: kon queries niet ophalen.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+				} elseif ( empty( $queries ) ) {
+					$lines[] = __( 'Search Console: geen query data gevonden voor deze pagina.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+				} else {
+					$lines[] = __( 'Search Console top zoekopdrachten (query → clicks/impr):', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+					foreach ( $queries as $row ) {
+						$q = isset( $row['query'] ) ? (string) $row['query'] : '';
+						$c = isset( $row['clicks'] ) ? (float) $row['clicks'] : 0.0;
+						$i = isset( $row['impressions'] ) ? (float) $row['impressions'] : 0.0;
+						if ( '' === $q ) {
+							continue;
+						}
+						$lines[] = sprintf( '- %s → %d/%d', $q, (int) round( $c ), (int) round( $i ) );
+					}
+				}
+			}
+		}
+
+		if ( $enabled_ga ) {
+			$property_id = isset( $settings['google_ga4_property_id'] ) ? trim( (string) $settings['google_ga4_property_id'] ) : '';
+			if ( '' !== $property_id && '' !== $page_path ) {
+				$stats = $this->ga->get_sessions_for_landing_page_path( $settings, $property_id, $page_path, $start_date, $end_date );
+				if ( is_wp_error( $stats ) ) {
+					$lines[] = __( 'Analytics: kon sessies niet ophalen.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+				} else {
+					$sessions = isset( $stats['sessions'] ) ? absint( $stats['sessions'] ) : 0;
+					$engaged  = isset( $stats['engagedSessions'] ) ? absint( $stats['engagedSessions'] ) : 0;
+					$lines[] = sprintf( __( 'Analytics (GA4): sessies ~%1$d, engaged sessies ~%2$d', GROQ_AI_PRODUCT_TEXT_DOMAIN ), $sessions, $engaged );
+				}
+			}
+		}
+
+		// If we only have the header, skip.
+		if ( count( $lines ) <= 1 ) {
+			return (string) $existing;
+		}
+
+		$context = implode( "\n", $lines );
+		set_transient( $cache_key, $context, 15 * MINUTE_IN_SECONDS );
+
+		return trim( (string) $existing . "\n\n" . $context );
+	}
+}
--- a/includes/Services/Google/class-groq-ai-google-oauth-client.php
+++ b/includes/Services/Google/class-groq-ai-google-oauth-client.php
@@ -0,0 +1,101 @@
+<?php
+
+class Groq_AI_Google_OAuth_Client {
+	/**
+	 * @param array $settings
+	 * @return string|WP_Error
+	 */
+	public function get_access_token( $settings ) {
+		$client_id     = isset( $settings['google_oauth_client_id'] ) ? trim( (string) $settings['google_oauth_client_id'] ) : '';
+		$client_secret = isset( $settings['google_oauth_client_secret'] ) ? trim( (string) $settings['google_oauth_client_secret'] ) : '';
+		$refresh_token = isset( $settings['google_oauth_refresh_token'] ) ? trim( (string) $settings['google_oauth_refresh_token'] ) : '';
+
+		if ( '' === $client_id || '' === $client_secret || '' === $refresh_token ) {
+			return new WP_Error( 'groq_ai_google_oauth_missing', __( 'Google OAuth is niet (volledig) geconfigureerd.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$cache_key = 'groq_ai_google_access_token_' . md5( $client_id . '|' . $refresh_token );
+		$cached    = get_transient( $cache_key );
+		if ( is_string( $cached ) && '' !== $cached ) {
+			return $cached;
+		}
+
+		$response = wp_remote_post(
+			'https://oauth2.googleapis.com/token',
+			[
+				'timeout' => 20,
+				'headers' => [
+					'Content-Type' => 'application/x-www-form-urlencoded',
+				],
+				'body' => [
+					'client_id' => $client_id,
+					'client_secret' => $client_secret,
+					'refresh_token' => $refresh_token,
+					'grant_type' => 'refresh_token',
+				],
+			]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$body        = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return new WP_Error( 'groq_ai_google_oauth_refresh_failed', __( 'Google token refresh mislukt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$access_token = isset( $data['access_token'] ) ? sanitize_text_field( (string) $data['access_token'] ) : '';
+		$expires_in   = isset( $data['expires_in'] ) ? absint( $data['expires_in'] ) : 0;
+
+		if ( '' === $access_token ) {
+			return new WP_Error( 'groq_ai_google_oauth_refresh_failed', __( 'Geen access token ontvangen van Google.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$ttl = max( 60, $expires_in - 60 );
+		set_transient( $cache_key, $access_token, $ttl );
+
+		return $access_token;
+	}
+
+	/**
+	 * Diagnostics helper: returns scopes for a given access token.
+	 *
+	 * @param string $access_token
+	 * @return array|WP_Error { 'scope' => string, 'expires_in' => int }
+	 */
+	public function get_access_token_info( $access_token ) {
+		$access_token = trim( (string) $access_token );
+		if ( '' === $access_token ) {
+			return new WP_Error( 'groq_ai_google_tokeninfo_missing', __( 'Geen access token om te inspecteren.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$response = wp_remote_get(
+			add_query_arg( [ 'access_token' => $access_token ], 'https://oauth2.googleapis.com/tokeninfo' ),
+			[ 'timeout' => 15 ]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$body        = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return new WP_Error( 'groq_ai_google_tokeninfo_failed', __( 'Kon tokeninfo niet ophalen.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$scope      = isset( $data['scope'] ) ? trim( (string) $data['scope'] ) : '';
+		$expires_in = isset( $data['expires_in'] ) ? absint( $data['expires_in'] ) : 0;
+
+		return [
+			'scope' => $scope,
+			'expires_in' => $expires_in,
+		];
+	}
+}
--- a/includes/Services/Google/class-groq-ai-google-search-console-client.php
+++ b/includes/Services/Google/class-groq-ai-google-search-console-client.php
@@ -0,0 +1,195 @@
+<?php
+
+class Groq_AI_Google_Search_Console_Client {
+	/** @var Groq_AI_Google_OAuth_Client */
+	private $oauth;
+
+	public function __construct( Groq_AI_Google_OAuth_Client $oauth ) {
+		$this->oauth = $oauth;
+	}
+
+	/**
+	 * @param int $status_code
+	 * @param string $raw_body
+	 * @return WP_Error
+	 */
+	private function build_http_error( $status_code, $raw_body ) {
+		$status_code = absint( $status_code );
+		$raw_body    = (string) $raw_body;
+
+		$message = __( 'Search Console API call mislukt.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		$details = '';
+
+		$data = json_decode( $raw_body, true );
+		if ( is_array( $data ) ) {
+			// Google APIs often respond with: { error: { code, message, status, details/errors } }
+			$err = isset( $data['error'] ) && is_array( $data['error'] ) ? $data['error'] : [];
+			$google_message = isset( $err['message'] ) ? trim( (string) $err['message'] ) : '';
+			$google_status  = isset( $err['status'] ) ? trim( (string) $err['status'] ) : '';
+			if ( '' !== $google_status || '' !== $google_message ) {
+				$details = trim( $google_status . ( $google_status && $google_message ? ': ' : '' ) . $google_message );
+			}
+		}
+
+		if ( '' !== $details ) {
+			$message = sprintf(
+				/* translators: 1: HTTP status, 2: details */
+				__( 'Search Console API call mislukt (HTTP %1$d): %2$s', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				$status_code,
+				$details
+			);
+		} else {
+			$message = sprintf(
+				/* translators: %d: HTTP status */
+				__( 'Search Console API call mislukt (HTTP %d).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				$status_code
+			);
+		}
+
+		return new WP_Error( 'groq_ai_gsc_error', $message );
+	}
+
+	/**
+	 * @param array $settings
+	 * @return array|WP_Error Array of siteUrl strings.
+	 */
+	public function list_sites( $settings ) {
+		$token = $this->oauth->get_access_token( $settings );
+		if ( is_wp_error( $token ) ) {
+			return $token;
+		}
+
+		$response = wp_remote_get(
+			'https://searchconsole.googleapis.com/webmasters/v3/sites',
+			[
+				'timeout' => 20,
+				'headers' => [
+					'Authorization' => 'Bearer ' . $token,
+					'Accept' => 'application/json',
+				],
+			]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$raw_body    = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $raw_body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return $this->build_http_error( $status_code, $raw_body );
+		}
+
+		$entries = isset( $data['siteEntry'] ) && is_array( $data['siteEntry'] ) ? $data['siteEntry'] : [];
+		$sites = [];
+		foreach ( $entries as $entry ) {
+			if ( ! is_array( $entry ) ) {
+				continue;
+			}
+			$site_url = isset( $entry['siteUrl'] ) ? trim( (string) $entry['siteUrl'] ) : '';
+			if ( '' !== $site_url ) {
+				$sites[] = $site_url;
+			}
+		}
+
+		$sites = array_values( array_unique( $sites ) );
+		sort( $sites, SORT_NATURAL | SORT_FLAG_CASE );
+
+		return $sites;
+	}
+
+	/**
+	 * @param array $settings
+	 * @param string $site_url
+	 * @param string $page_url
+	 * @param string $start_date YYYY-MM-DD
+	 * @param string $end_date YYYY-MM-DD
+	 * @param int $limit
+	 * @return array|WP_Error
+	 */
+	public function get_top_queries_for_page( $settings, $site_url, $page_url, $start_date, $end_date, $limit = 10 ) {
+		$site_url = trim( (string) $site_url );
+		$page_url = trim( (string) $page_url );
+		$limit    = max( 1, min( 25, absint( $limit ) ) );
+
+		if ( '' === $site_url || '' === $page_url ) {
+			return new WP_Error( 'groq_ai_gsc_missing', __( 'Search Console site URL of pagina URL ontbreekt.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$token = $this->oauth->get_access_token( $settings );
+		if ( is_wp_error( $token ) ) {
+			return $token;
+		}
+
+		$endpoint = 'https://searchconsole.googleapis.com/webmasters/v3/sites/' . rawurlencode( $site_url ) . '/searchAnalytics/query';
+
+		$body = [
+			'startDate' => $start_date,
+			'endDate' => $end_date,
+			'dimensions' => [ 'query' ],
+			'rowLimit' => $limit,
+			'dimensionFilterGroups' => [
+				[
+					'filters' => [
+						[
+							'dimension' => 'page',
+							'operator' => 'equals',
+							'expression' => $page_url,
+						],
+					],
+				],
+			],
+			'aggregationType' => 'auto',
+		];
+
+		$response = wp_remote_post(
+			$endpoint,
+			[
+				'timeout' => 20,
+				'headers' => [
+					'Authorization' => 'Bearer ' . $token,
+					'Content-Type' => 'application/json',
+					'Accept' => 'application/json',
+				],
+				'body' => wp_json_encode( $body ),
+			]
+		);
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$status_code = wp_remote_retrieve_response_code( $response );
+		$raw_body    = wp_remote_retrieve_body( $response );
+		$data        = json_decode( (string) $raw_body, true );
+
+		if ( 200 !== $status_code || ! is_array( $data ) ) {
+			return $this->build_http_error( $status_code, $raw_body );
+		}
+
+		$rows = isset( $data['rows'] ) && is_array( $data['rows'] ) ? $data['rows'] : [];
+		$result = [];
+
+		foreach ( $rows as $row ) {
+			if ( ! is_array( $row ) ) {
+				continue;
+			}
+			$keys = isset( $row['keys'] ) && is_array( $row['keys'] ) ? $row['keys'] : [];
+			$query = isset( $keys[0] ) ? sanitize_text_field( (string) $keys[0] ) : '';
+			if ( '' === $query ) {
+				continue;
+			}
+			$result[] = [
+				'query' => $query,
+				'clicks' => isset( $row['clicks'] ) ? (float) $row['clicks'] : 0.0,
+				'impressions' => isset( $row['impressions'] ) ? (float) $row['impressions'] : 0.0,
+				'ctr' => isset( $row['ctr'] ) ? (float) $row['ctr'] : 0.0,
+				'position' => isset( $row['position'] ) ? (float) $row['position'] : 0.0,
+			];
+		}
+
+		return $result;
+	}
+}
--- a/includes/Services/Prompt/class-groq-ai-prompt-builder.php
+++ b/includes/Services/Prompt/class-groq-ai-prompt-builder.php
@@ -29,6 +29,171 @@ class Groq_AI_Prompt_Builder {
 		);
 	}

+	public function build_term_system_prompt( $settings, $conversation_id, $term ) {
+		$context          = isset( $settings['store_context'] ) ? trim( $settings['store_context'] ) : '';
+		$term_name        = is_object( $term ) && isset( $term->name ) ? (string) $term->name : '';
+		$base_instruction = __( 'Je bent een copywriter voor een WooCommerce winkel en schrijft SEO-vriendelijke categorie- en merkpagina teksten.', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+
+		if ( $context ) {
+			$base_instruction = sprintf(
+				__( 'Je bent een copywriter voor een WooCommerce winkel. Gebruik de volgende winkelcontext indien beschikbaar: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				$context
+			);
+		}
+
+		if ( '' !== $term_name ) {
+			$base_instruction .= ' ' . sprintf(
+				__( 'Je schrijft nu voor de term: %s.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				$term_name
+			);
+		}
+
+		return sprintf(
+			__( 'Conversatie-ID: %1$s. %2$s', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+			$conversation_id,
+			$base_instruction
+		);
+	}
+
+	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 );
@@ -173,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 ) {
@@ -203,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 );
 			}
@@ -217,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 );

@@ -232,6 +460,287 @@ class Groq_AI_Prompt_Builder {
 		return $intro . "\n" . $context . "\n\n" . $prompt;
 	}

+	public function build_term_context_block( $term, $options = [], $settings = null ) {
+		if ( ! $term || ! is_object( $term ) ) {
+			return '';
+		}
+
+		$taxonomy = isset( $term->taxonomy ) ? sanitize_key( (string) $term->taxonomy ) : '';
+		$term_id  = isset( $term->term_id ) ? absint( $term->term_id ) : 0;
+		if ( '' === $taxonomy || ! $term_id ) {
+			return '';
+		}
+
+		$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 ) );
+
+		$parts = [];
+		$parts[] = sprintf( __( 'Term: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), wp_strip_all_tags( (string) $term->name ) );
+		if ( isset( $term->slug ) && '' !== (string) $term->slug ) {
+			$parts[] = sprintf( __( 'Slug: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), sanitize_title( (string) $term->slug ) );
+		}
+		if ( isset( $term->count ) ) {
+			$parts[] = sprintf( __( 'Aantal producten: %s', GROQ_AI_PRODUCT_TEXT_DOMAIN ), (string) absint( $term->count ) );
+		}
+		if ( isset( $term->description ) && '' !== trim( (string) $term->description ) ) {
+			$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 ) ) {
+				$lines = [];
+				foreach ( $top_products as $product_row ) {
+					$lines[] = sprintf( '- %s', $product_row );
+				}
+				$parts[] = __( 'Top verkochte producten (indicatief):', GROQ_AI_PRODUCT_TEXT_DOMAIN ) . "\n" . implode( "\n", $lines );
+			}
+		}
+
+		$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 ) {
+			$parts[] = $google_context;
+		}
+
+		return implode( "\n\n", array_filter( $parts ) );
+	}
+
+	public function prepend_term_context_to_prompt( $prompt, $context ) {
+		$context = trim( (string) $context );
+		if ( '' === $context ) {
+			return $prompt;
+		}
+		$intro = __( 'Gebruik de volgende categorie/term-context bij het schrijven:', GROQ_AI_PRODUCT_TEXT_DOMAIN );
+		return $intro . "\n" . $context . "\n\n" . $prompt;
+	}
+
+	public function get_term_response_format_definition( $settings = null ) {
+		$rankmath_enabled = $this->settings_manager->is_module_enabled( 'rankmath', $settings );
+		$keyword_limit    = $this->settings_manager->get_rankmath_focus_keyword_limit( $settings );
+		$title_pixels     = $this->settings_manager->get_rankmath_meta_title_pixel_limit( $settings );
+		$desc_pixels      = $this->settings_manager->get_rankmath_meta_description_pixel_limit( $settings );
+
+		$properties = [
+			'top_description' => [
+				'type'        => 'string',
+				'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,
+			],
+		];
+
+		if ( $rankmath_enabled ) {
+			$properties['meta_title'] = [
+				'type'        => 'string',
+				'description' => sprintf(
+					__( 'SEO-meta title (max. %1$d tekens en %2$d pixels).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					60,
+					$title_pixels
+				),
+				'maxLength'   => 120,
+			];
+			$properties['meta_description'] = [
+				'type'        => 'string',
+				'description' => sprintf(
+					__( 'SEO-meta description (max. %1$d tekens en %2$d pixels).', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+					160,
+					$desc_pixels
+				),
+				'maxLength'   => 320,
+			];
+			$properties['focus_keywords'] = [
+				'type'        => 'array',
+				'description' => __( 'Lijst met korte zoekwoorden zonder hashtags of extra tekst.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+				'maxItems'    => max( 1, $keyword_limit ),
+				'items'       => [
+					'type'      => 'string',
+					'minLength' => 1,
+				],
+			];
+		}
+
+		$schema = [
+			'type'                 => 'object',
+			'properties'           => $properties,
+			'required'             => [ 'top_description', 'bottom_description' ],
+			'additionalProperties' => false,
+		];
+
+		return [
+			'type'        => 'json_schema',
+			'json_schema' => [
+				'name'   => 'groq_ai_term_text',
+				'schema' => $schema,
+			],
+		];
+	}
+
+	public function append_term_response_instructions( $prompt, $settings ) {
+		$instructions = (string) ( $this->get_term_structured_response_instructions( $settings ) ?? '' );
+		$prompt       = trim( (string) $prompt );
+		if ( '' === $instructions ) {
+			return $prompt;
+		}
+		if ( false !== strpos( $prompt, $instructions ) ) {
+			return $prompt;
+		}
+		return $prompt . "\n\n" . $instructions;
+	}
+
+	public function parse_term_structured_response( $raw, $settings = null ) {
+		if ( empty( $raw ) ) {
+			return new WP_Error( 'groq_ai_empty_response', __( 'Geen data ontvangen van de AI.', GROQ_AI_PRODUCT_TEXT_DOMAIN ) );
+		}
+
+		$clean = trim( (string) $raw );
+		if ( preg_match( '/```(?:json)?\s*(.*?)```/is', $clean, $matches ) ) {
+			$clean = trim( $matches[1] );
+		}
+
+		$decoded = json_decode( $clean, true );
+		if ( ! is_array( $decoded ) ) {
+			// Fallback: treat as plain text.
+			return [
+				'description' => trim( (string) $raw ),
+			];
+		}
+
+		$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 = [];
+		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 );
+		}
+		if ( isset( $decoded['meta_description'] ) ) {
+			$result['meta_description'] = $this->truncate_meta_field( (string) $decoded['meta_description'], 160 );
+		}
+		if ( isset( $decoded['focus_keywords'] ) ) {
+			if ( is_array( $decoded['focus_keywords'] ) ) {
+				$keywords = [];
+				foreach ( $decoded['focus_keywords'] as $kw ) {
+					$kw = trim( (string) $kw );
+					if ( '' !== $kw ) {
+						$keywords[] = $kw;
+					}
+				}
+				$keywords = array_values( array_unique( $keywords ) );
+				$result['focus_keywords'] = implode( ', ', $keywords );
+			}
+		}
+
+		return $result;
+	}
+
+	private function get_term_structured_response_instructions( $settings = null ) {
+		$schema_parts = [
+			'"top_description":"..."',
+			'"bottom_description":"..."',
+		];
+
+		$rankmath_enabled = $this->settings_manager->is_module_enabled( 'rankmath', $settings );
+		if ( $rankmath_enabled ) {
+			$schema_parts[] = '"meta_title":"..."';
+			$schema_parts[] = '"meta_description":"..."';
+			$schema_parts[] = '"focus_keywords":["...","..."]';
+		}
+
+		$json_structure = '{' . implode( ',', $schema_parts ) . '}';
+
+		$instruction = sprintf(
+			__( 'Geef ALLEEN een geldig JSON-object terug met deze structuur: %s. Gebruik dubbele aanhalingstekens, geen Markdown of extra tekst. Gebruik \n voor regeleinden.', GROQ_AI_PRODUCT_TEXT_DOMAIN ),
+			$json_structure
+		);
+
+		$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 );
+		$limit    = max( 1, min( 25, absint( $limit ) ) );
+
+		$query = new WP_Query(
+			[
+				'post_type'      => 'product',
+				'post_status'    => 'publish',
+				'posts_per_page' => $limit,
+				'no_found_rows'  => true,
+				'meta_key'       => 'total_sales',
+				'orderby'        => 'meta_value_num',
+				'order'          => 'DESC',
+				'tax_query'      => [
+					[
+						'taxonomy' => $taxonomy,
+						'field'    => 'term_id',
+						'terms'    => [ $term_id ],
+					],
+				],
+			]
+		);
+
+		$rows = [];
+		if ( $query->have_posts() ) {
+			foreach ( $query->posts as $post ) {
+				$title = isset( $post->post_title ) ? wp_strip_all_tags( (string) $post->post_title ) : '';
+				$rows[] = $title;
+			}
+		}
+		wp_reset_postdata();
+
+		return array_values( array_filter( $rows ) );
+	}
+
 	public function get_response_format_definition( $settings = null ) {
 		$rankmath_enabled = $this->settings_manager->is_module_enabled( 'rankmath', $settings );
 		$keyword_limit    = $this->settings_manager->get_rankmath_focus_keyword_limit( $settings );
@@ -387,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 '';
 		}
@@ -404,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
@@ -32,9 +32,21 @@ class Groq_AI_Settings_Manager {
 			'model'          => '',
 			'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' => '',
+			'google_oauth_client_id' => '',
+			'google_oauth_client_secret' => '',
+			'google_oauth_refresh_token' => '',
+			'google_oauth_connected_email' => '',
+			'google_oauth_connected_at' => 0,
+			'google_enable_gsc' => true,
+			'google_enable_ga' => true,
+			'google_gsc_site_url' => '',
+			'google_ga4_property_id' => '',
 			'context_fields' => $this->get_default_context_fields(),
 			'modules'        => $this->get_default_modules_settings(),
 			'image_context_mode' => 'url',
@@ -63,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;
 	}

@@ -78,9 +94,21 @@ class Groq_AI_Settings_Manager {
 			'model'          => '',
 			'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' => '',
+			'google_oauth_client_id' => '',
+			'google_oauth_client_secret' => '',
+			'google_oauth_refresh_token' => '',
+			'google_oauth_connected_email' => '',
+			'google_oauth_connected_at' => 0,
+			'google_enable_gsc' => true,
+			'google_enable_ga' => true,
+			'google_gsc_site_url' => '',
+			'google_ga4_property_id' => '',
 			'context_fields' => $this->get_default_context_fields(),
 			'modules'        => $this->get_default_modules_settings(),
 			'image_context_mode' => 'url',
@@ -111,6 +139,10 @@ class Groq_AI_Settings_Manager {

 		$image_limit = isset( $input['image_context_limit'] ) ? $this->sanitize_image_context_limit_value( $input['image_context_limit'] ) : $defaults['image_context_limit'];

+		$max_output_tokens = isset( $input['max_output_tokens'] ) ? absint( $input['max_output_tokens'] ) : absint( $defaults['max_output_tokens'] );
+		// Keep within sane bounds across providers.
+		$max_output_tokens = max( 128, min( 8192, $max_output_tokens ) );
+
 		$context_fields = $this->normalize_context_fields( $context_posted ? $raw_input['context_fields'] : $defaults['context_fields'] );

 		if ( 'none' === $image_mode ) {
@@ -124,9 +156,21 @@ class Groq_AI_Settings_Manager {
 			'model'          => $model,
 			'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'] ),
+			'google_oauth_client_id' => sanitize_text_field( $input['google_oauth_client_id'] ),
+			'google_oauth_client_secret' => sanitize_text_field( $input['google_oauth_client_secret'] ),
+			'google_oauth_refresh_token' => sanitize_text_field( $input['google_oauth_refresh_token'] ),
+			'google_oauth_connected_email' => sanitize_text_field( $input['google_oauth_connected_email'] ),
+			'google_oauth_connected_at' => absint( $input['google_oauth_connected_at'] ),
+			'google_enable_gsc' => ! empty( $raw_input['google_enable_gsc'] ),
+			'google_enable_ga' => ! empty( $raw_input['google_enable_ga'] ),
+			'google_gsc_site_url' => esc_url_raw( (string) $input['google_gsc_site_url'] ),
+			'google_ga4_property_id' => sanitize_text_field( (string) $input['google_ga4_property_id'] ),
 			'response_format_compat' => ! empty( $raw_input['response_format_compat'] ),
 			'image_context_mode' => $image_mode,
 			'image_context_limit' => $image_limit,
@@ -140,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 = [
@@ -163,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 ),
@@ -190,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 ) ) {
@@ -248,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 ) {
@@ -341,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	9df41ca85c	chore: Bump version to 1.6.4 and update OAuth redirect URI descriptions	2026-01-26 19:50:38 +00:00
Roberto Guagliardo	934cbf0f73	chore: Bump version to 1.6.3	2026-01-26 19:26:20 +00:00
Roberto Guagliardo	5cc6e869bf	Refactor code structure for improved readability and maintainability	2026-01-26 19:25:42 +00:00
Roberto Guagliardo	79d411f35a	feat: Register plugin settings with WordPress	2026-01-23 19:02:11 +00:00
Roberto Guagliardo	58a9b37ccf	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.	2026-01-23 18:55:52 +00:00
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
Roberto Guagliardo	1bb10f4b45	feat: Add max output tokens setting and integrate with AI content generation	2026-01-16 18:08:46 +00:00
Roberto Guagliardo	95f7983e70	Add Google Analytics and Search Console integration - Implemented Groq_AI_Google_Analytics_Data_Client for fetching GA4 data. - Created Groq_AI_Google_Search_Console_Client for retrieving Search Console data. - Added Google OAuth client for authentication with Google APIs. - Enhanced Groq_AI_Settings_Manager to include Google OAuth settings. - Introduced term context building methods in Groq_AI_Google_Context_Builder. - Developed JavaScript functionality for term generation in the admin interface. - Added methods for generating term prompts and handling responses. - Improved error handling and response parsing for Google API interactions.	2026-01-16 17:48:34 +00:00