Developer 

Architecture Overview 

The LLMS TXT Generator extension follows modern TYPO3 development practices and supports TYPO3 v12, v13, and v14 LTS.

Core Components 

Services 

ConfigurationService
Handles all site configuration reading and provides typed access to configuration values. Uses the TYPO3 core request injection pattern - request is set once via setRequest() and all methods access it internally.
LlmsTxtGeneratorService
Main application service that orchestrates the generation of llms.txt content by coordinating other services.
MarkdownConverterService
Converts HTML content to Markdown format using the league/html-to-markdown library.
NavigationBuilder
Builds the site navigation structure for inclusion in llms.txt files.

Repository 

PageRepository
Provides database access for page records with proper respect for TYPO3's language and workspace handling.

Controller 

LlmsTxtController
Thin controller layer that handles HTTP requests and delegates business logic to services. Provides entry points for TypoScript USER objects.

API Reference 

Controller Methods 

WebVision\LlmsTxt\Controller\LlmsTxtController 

generateAction ( string $content = '', array $conf = []) : string

Generates llms.txt content for TypoScript USER object.

param string $content

Content passed from TypoScript (usually empty)

param array $conf

Configuration array from TypoScript

throws

Exception on generation failures

Returns

Generated llms.txt content as string

renderPageAsMarkdown ( string $content = '', array $conf = []) : string

Renders current page as Markdown by leveraging TYPO3's frontend rendering.

param string $content

Content passed from TypoScript (usually empty)

param array $conf

Configuration array from TypoScript

throws

Exception on rendering or conversion failures

Returns

Page content converted to Markdown format

Service Classes 

WebVision\LlmsTxt\Service\LlmsTxtGeneratorService 

generateLlmsTxt ( int $currentPageId) : string

Generates complete llms.txt content for a given page context.

param int $currentPageId

Current page ID for context

Returns

Complete llms.txt formatted content

WebVision\LlmsTxt\Service\ConfigurationService 

setRequest ( ServerRequestInterface $request) : void

Sets the request for the service. Must be called before using other methods. Follows the TYPO3 core pattern used by ContentObjectRenderer.

param ServerRequestInterface $request

The current PSR-7 request

isEnabled ( ) : bool

Checks if llms.txt generation is enabled.

Returns

True if enabled, false otherwise

getCurrentPageId ( ) : int

Gets the current page ID from the request. Handles TYPO3 v12/v13 via TSFE and v14+ via frontend.page.information request attribute.

throws

RuntimeException if page ID cannot be determined

Returns

Current page ID

getMaxDepth ( ) : int

Gets maximum navigation depth setting.

Returns

Maximum depth as integer

getTitleOverride ( ) : string

Gets custom title override if configured.

Returns

Custom title or empty string

getDescriptionOverride ( ) : string

Gets custom description override if configured.

Returns

Custom description or empty string

getKeywords ( ) : array

Gets configured keywords/topics.

Returns

Array of keyword strings

getContactEmail ( ) : string

Gets configured contact email.

Returns

Contact email or empty string

getAdditionalInfo ( ) : string

Gets additional information text.

Returns

Additional info or empty string

getSiteUrl ( ) : string

Gets the current site's base URL.

Returns

Site URL as string

Extending the Extension 

tbd.

Hooks and Events 

The extension doesn't currently provide PSR-14 events, but you can extend functionality through:

  1. Service replacement - Override services through dependency injection
  2. TypoScript configuration - Extend configuration options
  3. Custom page types - Create additional page types using the same controller methods

Testing 

Unit Testing 

The extension includes comprehensive unit tests, particularly for the ConfigurationService. Tests can be run against all supported TYPO3 versions:

# Run unit tests with TYPO3 v12
Build/Scripts/runTests.sh -s unit -t 12

# Run unit tests with TYPO3 v13
Build/Scripts/runTests.sh -s unit -t 13

# Run unit tests with TYPO3 v14
Build/Scripts/runTests.sh -s unit -t 14

# Run with specific PHP version
Build/Scripts/runTests.sh -s unit -t 14 -p 8.3
Copied!

The ConfigurationService tests cover:

  • Request injection and retrieval
  • Fallback to $GLOBALS['TYPO3_REQUEST']
  • All configuration getters (isEnabled, getMaxDepth, getTitleOverride, etc.)
  • Default values and type casting

Functional Testing 

Functional tests can be run using:

Build/Scripts/runTests.sh -s functional
Copied!

Performance Considerations 

Navigation Building

Navigation structure generation scales with site size. For large sites (1000+ pages), consider:

  • Reducing maxDepth setting
  • Implementing custom navigation filtering
  • Adding caching layers
Content Rendering

Markdown conversion processes all content elements. For content-heavy pages:

  • Consider selective content rendering
  • Implement content type filtering
  • Use caching for expensive conversions
Memory Usage

The HTML-to-Markdown conversion can be memory-intensive for large pages. Monitor memory usage and consider:

  • Chunked processing for very large pages
  • Custom memory-efficient conversion strategies

Contributing 

When contributing to the extension:

  1. Follow TYPO3 coding standards - Use php-cs-fixer with TYPO3 ruleset
  2. Write tests - Include unit and functional tests for new features
  3. Document changes - Update documentation for new configuration options
  4. Use dependency injection - Prefer constructor injection over service location
  5. Type everything - Use strict types and comprehensive type hints