Sitemap Generator - Contensio Plugin

Configures the XML sitemap at /sitemap.xml. Set changefreq and priority per content type, include or exclude whole types, and automatically ping Google and Bing when content is published.

Features

• Per-type configuration - set changefreq and priority independently for the homepage, blog index, pages, posts, and taxonomy archive pages
• Include / exclude - toggle each content type on or off without affecting others
• Search engine pings - automatically pings Google and Bing whenever a content item is published or a scheduled item goes live
• Live sitemap preview - link to /sitemap.xml directly from the settings page
• Zero configuration - sensible defaults work out of the box; install and forget

How it works

The core Contensio sitemap at /sitemap.xml builds a URL list and passes it through the contensio/seo/sitemap-urls filter. This plugin hooks into that filter to:

1. Remove URLs whose type is disabled in settings.
2. Override changefreq and priority with the configured values.

On publish, the plugin listens on contensio/content/status-changed (and contensio/content/published for scheduled items). When content transitions to published, it fires HTTP pings to the configured search engines in a best-effort manner - a failed ping is logged but never interrupts the publish action.

Installation

Via admin panel

Go to Plugins in your Contensio admin, find Sitemap Generator, and click Install.

Via Composer

composer require contensio/plugin-sitemap

The plugin is auto-discovered. Go to Plugins in the admin and enable it. No migration is needed - settings are stored in the core settings table.

Admin settings (/account/settings/sitemap)

Content types

For each type you can:

• Include - check to include in the sitemap; uncheck to exclude entirely
• Change frequency - hint to crawlers how often the content changes (always / hourly / daily / weekly / monthly / yearly / never)
• Priority - relative importance within your site (1.0 = highest, 0.1 = lowest)

Search engine pings

Default values

Routes

The sitemap itself is served by the core at /sitemap.xml - this plugin configures it, not replaces it.

Developer: filter hook

Other plugins can also modify the sitemap URL list by registering on the same filter:

use Contensio\Support\Hook;

Hook::addFilter('contensio/seo/sitemap-urls', function (array $urls): array {
    // Add a custom URL
    $urls[] = [
        'type'       => 'custom',
        'loc'        => url('/my-custom-page'),
        'lastmod'    => now()->toAtomString(),
        'changefreq' => 'monthly',
        'priority'   => '0.4',
    ];
    return $urls;
});

Each URL entry is an associative array with loc, lastmod, changefreq, priority, and an optional type key. The type key is internal metadata - it is stripped before XML output.

Requirements

• PHP 8.2+
• Contensio 2.0+

License

AGPL-3.0-or-later - see LICENSE.