Pular para o conteúdo principal
Versão: 1.x

← Anterior · Voltar ao README · Próximo →

Sitemap

Esta receita mostra como criar um feed de sitemap de produtos com o Laravel Feeds. Você vai:

  • Gerar as classes necessárias.
  • Implementar a lógica do feed.
  • Disponibilizar os arquivos pelo sistema de arquivos.
  • Referenciar opcionalmente o sitemap gerado em um arquivo sitemap.xml raiz.

Criar os arquivos​

Gere o feed e a classe do item com o seguinte comando de console:

php artisan make:feed Sitemaps/Product

Preencher o feed​

Substitua extends Feed por extends SitemapFeedPreset na classe gerada:

<?php

declare(strict_types=1);

namespace App\Feeds\Sitemaps;

use App\Models\Product;
use DragonCode\LaravelFeed\Feeds\Items\FeedItem;
use DragonCode\LaravelFeed\Presets\SitemapFeedPreset;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

class ProductFeed extends SitemapFeedPreset
{
    public function builder(): Builder
    {
        return Product::query();
    }

    public function item(Model $model): FeedItem
    {
        return parent::item($model)
            ->url($model->url)
            ->modifiedAt($model->updated_at) // By default, $model->updated_at
            ->priority(0.9); // By default, 0.9
    }

    public function filename(): string
    {
        return 'sitemaps/' . parent::filename();
    }
}

Métodos disponíveis na classe FeedItem:

  • url - preenchimento obrigatório
  • modifiedAt - por padrão, $model->updated_at
  • priority - por padrão, 0.9

Ativar​

Revise o arquivo de operação ou migration gerado e execute o comando de console adequado:

# For Laravel Deploy Operations
php artisan operations

# For Laravel Migrations
php artisan migrate

Adicione ao arquivo de configuração config/filesystems.php um disco do sistema de arquivos que aponte para o diretório dos seus sitemaps:

return [
    'links' => [
        public_path('storage')  => storage_path('app/public'),
        public_path('sitemaps') => storage_path('app/public/sitemaps'),
    ],
];

Depois, crie o link simbólico público para que os arquivos fiquem acessíveis pelo navegador:

php artisan storage:link

Gerar o feed​

Gere o feed com o seguinte comando de console:

php artisan feed:generate

Se você mantém um arquivo sitemap.xml raiz que referencia outros sitemaps, adicione uma entrada como esta:

<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <sitemap>
        <loc>https://example.com/sitemaps/products.xml</loc>
    </sitemap>
    <sitemap>
        <loc>https://example.com/sitemaps/other-sitemaps.xml</loc>
    </sitemap>
</sitemapindex>

Resultado​

O sitemap.xml gerado para os seus produtos terá esta aparência:

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9">

<url>
  <loc>https://example.com/products/ea-voluptatum-fuga-odio-expedita</loc>
  <lastmod>2025-08-31T20:00:00+00:00</lastmod>
  <priority>0.9</priority>
</url>
<url>
  <loc>https://example.com/products/dolores-rerum-ut-consequatur-in</loc>
  <lastmod>2025-08-30T19:00:00+00:00</lastmod>
  <priority>0.9</priority>
</url>

</urlset>

Veja também​