netresearch/nr-image-sitemap

Provides a data provider to use with the typo3/cms-seo extension, to create an image sitemap

14.0.0 2026-07-30 09:30 UTC

Requires

• php: ^8.2
• ext-json: *
• typo3/cms-core: ^13.4 || ^14.3
• typo3/cms-seo: ^13.4 || ^14.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.65
• netresearch/typo3-ci-workflows: ^1.0
• overtrue/phplint: ^9.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• saschaegerer/phpstan-typo3: ^2.0 || ^3.0
• ssch/typo3-rector: ^3.0

AGPL-3.0-or-later

• Rico Sonntag
• Philipp Altmann

Published on Packagist.org on 2026-07-30 09:30 UTC

README

This extension provides a data provider to use with the typo3/cms-seo extension, to create an image sitemap.

Requirements

• TYPO3 13.4 LTS or 14.3 LTS
• typo3/cms-seo in the matching version
• PHP 8.2 - 8.5

Installation

1. Install the extension via composer .. code-block:: bash

composer require netresearch/nr-image-sitemap

Loading the TypoScript

The extension's TypoScript can be loaded in either of the two ways TYPO3 supports.

Site set (recommended, TYPO3 13.4 and 14.3)

Add the set to the dependencies of your site package set, or to config/sites/<identifier>/config.yaml:

dependencies:
  - netresearch/image-sitemap

The set depends on typo3/seo-sitemap, so core's sitemap TypoScript is pulled in automatically.

Static template (sys_template)

Alternatively include the static template Netresearch: Image Sitemap in the template record of your root page.

Configuration

Before using the extension, ensure that the start page with the lowest ID is configured as the root page. This ID serves as the starting point for the sitemap generation.

Configuration via Backend Constants Editor

1. Navigate to the Template module in the TYPO3 backend.
2. Select the topmost page in your site tree (this should be the root page).
3. Switch on Constant Editor.
4. In the Constant Editor, choose the correct extension context, which in this case is for PLUGIN.TX_NRIMAGESITEMAP.
5. Locate the field labeled The Root page ID.
6. Enter the value 1 (or the ID of your root page).

This ensures that the extension knows the correct starting point for generating the sitemap.

Generating the Image Sitemap

The extension introduces a new page type 1642072014 specifically for generating an image sitemap.

To view the generated sitemap, open:

https://<YOUR-DOMAIN>/?type=1642072014

Integrating with CMS-SEO Sitemap

If you want to integrate the image sitemap into the sitemap generated by the CMS-SEO extension, use the following URL:

https://<YOUR-DOMAIN>/?type=1533906435

This will embed the image sitemap within the main sitemap provided by the CMS-SEO extension.