# Main settings for the Semantic Suggestion functionality
settings {
# ID of the parent page from which to start the analysis
parentPageId = 1 # Example: The homepage often has ID 1
# Threshold for considering pages as similar (0.0 to 1.0)
proximityThreshold = 0.5 # Example: A higher threshold means stricter suggestions
# Maximum number of suggestions to display
maxSuggestions = 3
# Depth of recursion in the page tree (0 = only direct children)
recursive = 1 # Example: 1 means include direct children of the parent page
# Comma-separated list of page UIDs to exclude from suggestions
excludePages = "4, 7, 12" # Example: Exclude specific pages by their UIDs
# Length of the text excerpt for each suggestion
excerptLength = 150
# Weight for recency in similarity calculation
recencyWeight = 0.2 # Example: Give more weight to recently modified pages
# Enable or disable the display of general statistics
showStatistics = 1
# Enable or disable the display of performance metrics
showPerformanceMetrics = 0
# Enable or disable the display of language statistics
showLanguageStatistics = 0
# Enable or disable the calculation of content distribution
calculateDistribution = 1
# Enable or disable the calculation of top similar page pairs
calculateTopSimilarPairs = 1
# Enable or disable the display of top similar page pairs
showTopSimilarPairs = 1
# Enable or disable the display of distribution scores
showDistributionScores = 1
# Enable or disable the display of top similar pages
showTopSimilarPages = 1
# Weights for different page fields in similarity calculation
analyzedFields {
title = 0.8
description = 0.5
keywords = 0.4
abstract = 0.3
content = 1.0
}
}
Install with composer or the classic TER
Composer Installation (recommended)
Install the extension via composer:
composer require talan-hdf/semantic-suggestion
- Activate the extension in the TYPO3 Extension Manager
Manual Installation
- Download the extension from the TYPO3 Extension Repository (TER) or the GitHub repository.
- Upload the extension file to your TYPO3 installation's typo3conf/ext/ directory.
- In the TYPO3 backend, go to the Extension Manager and activate the "Semantic Suggestion" extension.
Add the extension in your FLUID template or with TypoScript
In Fluid Templates
To add the plugin directly in your Fluid template, use:
<f:cObject typoscriptObjectPath='lib.semantic_suggestion' />
This method uses the TypoScript configuration and is suitable for simple integrations.
TypoScript Integration
You can also integrate the Semantic Suggestions plugin using TypoScript. Add the following TypoScript setup to your configuration:
lib.semantic_suggestion = USER
lib.semantic_suggestion {
userFunc = TYPO3\CMS\Extbase\Core\Bootstrap->run
extensionName = SemanticSuggestion
pluginName = Suggestions
vendorName = TalanHdf
controller = Suggestions
action = list
}
Then, you can use it in your TypoScript template like this:
page.10 = < lib.semantic_suggestion
Or in specific content elements:
tt_content.semantic_suggestion = COA
tt_content.semantic_suggestion {
10 = < lib.semantic_suggestion
}
Remember to include your TypoScript template in your site configuration or page setup.
