No description
Find a file
Jérémy Munsch fd2fbeb232
fix(config): update singlePages key to single_pages
This change corrects the key name for single route names in the configuration.
2026-10-15 11:50:09 +02:00
.intellipest refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
config fix(config): update singlePages key to single_pages 2026-10-15 11:50:09 +02:00
routes refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
src fix(config): update singlePages to single_pages key 2026-10-15 11:49:07 +02:00
tests refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
.editorconfig First workin version without headleass chrome config 2023-08-10 14:48:45 +02:00
.gitattributes refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
.gitignore refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
.gitlab-ci.yml refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
.styleci.yml First workin version without headleass chrome config 2023-08-10 14:48:45 +02:00
CHANGELOG.md refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
composer.json refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
composer.lock refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
phpcs.xml refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
phpstan.neon refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
phpunit.xml refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
pint.json refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00
README.md refactor: refactoring et ajout de tests, la dependance pour traduire les routes est vraiment optionnelle. 2026-10-15 10:18:25 +02:00

Refresh Sitemap

Generates and refreshes your sitemap.xml using a configuration file.

Supports localized routes out of the box with DefaultRouteLocalizer and optionally integrates with mcamara/laravel-localization.

Requirements

  • PHP ^8.5
  • Laravel / Illuminate ^13.0

Installation

Via Composer:

composer require uwil/sitemap-generator

Usage

  1. Publish the configuration file:

    php artisan vendor:publish --tag=sitemap-generator
    
  2. Adjust your settings in config/sitemap-generator.php (locales, routes, output path, CRUD models).

  3. Test your configuration in the console:

    php artisan uwil:sitemap:refresh --dry-run
    
  4. Generate the sitemap file:

    php artisan uwil:sitemap:refresh
    

A route is automatically registered to serve your generated sitemap: GET /sitemap.xml


Model Implementation

Models defined in the cruds config section must implement Uwil\SitemapGenerator\Contracts\Sitemapable.

You only need to define getLocalizedUrl(string $locale) to resolve the full URL for each configured locale. The package automatically generates the main URLs and their respective xhtml:link alternate (hreflang) tags.

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Mcamara\LaravelLocalization\Facades\LaravelLocalization;
use Spatie\Sitemap\Tags\Url;
use Uwil\SitemapGenerator\Contracts\Sitemapable;

class Product extends Model implements Sitemapable
{
    /**
     * Return the localized URL for a given locale.
     */
    public function getLocalizedUrl(string $locale): string
    {
        // Example with mcamara/laravel-localization:
        return LaravelLocalization::getURLFromRouteNameTranslated(
            $locale,
            'routes.product.show',
            ['product' => $this]
        ) ?? route('products.show', ['locale' => $locale, 'product' => $this]);
    }

    /**
     * (Optional) Custom tag definition if using Spatie's native resolution.
     */
    public function toSitemapTag(): Url|string|array
    {
        return route('products.show', $this);
    }
}

Configuration Example

In config/sitemap-generator.php:

use App\Models\Product;
use Illuminate\Database\Eloquent\Builder;

return [
    'single_pages' => [
        'homepage',
        'contact',
    ],

    'cruds' => [
        [
            'model' => Product::class,
            'modelFilters' => [
                ['is_active', '=', true],
            ],
            'relationFilters' => [
                'category' => fn (Builder $query) =>$query->where('published', true),
            ],
            'allowNullRelations' => ['category'],
        ],
    ],

    'supported_locales' => ['fr', 'en', 'es'],

    /**
     * Route localization strategy:
     * - 'default' (or DefaultRouteLocalizer::class): uses Laravel's standard route names with {locale} parameter.
     * - 'mcamara' (or McamaraRouteLocalizer::class): uses mcamara/laravel-localization route translations.
     * - null: auto-detects if mcamara is registered, otherwise falls back to 'default'.
     */
    'localizer' => 'default',

    'schedule' => true,
    'cron' => '45 15 * * *',

    'output_path' => storage_path('app/public/sitemap.xml'),
];

CRUD Relation Filters & Nullable Relations

  • modelFilters: Standard Eloquent where clauses applied to the root model.
  • relationFilters: Filters applied to model relations. Supports:
    • Closure: fn (Builder $q) => $q->where('status', true)
    • array: ['status' => true]
    • string: 'is_active' (shorthand for where('is_active', true))
  • allowNullRelations: Array of relation names where models having null for this relation are still included in the sitemap (using whereDoesntHave() OR whereHas()). Relations not listed here require the related model to exist.

Security

If you discover any security-related issues, please email equipe.web@ldc.fr instead of using the issue tracker.

Changelog

See the CHANGELOG.md file for details.

Sitemap Generator was written by Uwil.

Copyright (c) 2023 and beyond Uwil.