@kddy/sitemap

    2.0.1 • Public • Published

    Sitemap Module

    npm (scoped with tag) Downloads Build Status Coverage Status License

    Automatically generate or serve dynamic sitemap.xml for Nuxt.js projects!

    📖 Release Notes

    Features

    • Module based on the awesome sitemap.js package ❤️
    • Create sitemap or sitemap index
    • Automatically add the static routes to each sitemap
    • Works with all modes (universal, spa, generate)
    • For Nuxt 2.x and higher

    Table of Contents

    Installation

    npm install @nuxtjs/sitemap

    or

    yarn add @nuxtjs/sitemap

    Usage

    • Add @nuxtjs/sitemap to the modules section of your nuxt.config.js file:
      modules: [
        '@nuxtjs/sitemap'
      ]

    notice:
    If you use other modules (eg. nuxt-i18n), always declare the sitemap module at end of array
    eg. modules: ['nuxt-i18n', '@nuxtjs/sitemap']

    • Add a custom configuration with the sitemap property.

    You can set a single item of sitemap or sitemap index or an array of item.

    // nuxt.config.js
    
    {
      modules: [
        '@nuxtjs/sitemap'
      ],
      sitemap: {
        // custom configuration
      }
    }

    Setup a Sitemap

    By default, the sitemap is setup to the following path: /sitemap.xml
    All static routes (eg. /pages/about.vue) are automatically add to the sitemap, but you can exclude each of them with the exclude property.
    For dynamic routes (eg. /pages/_id.vue), you have to declare them with the routes property. This option can be an array or a function.

    // nuxt.config.js
    
    {
      sitemap: {
        hostname: 'https://example.com',
        gzip: true,
        exclude: [
          '/secret',
          '/admin/**'
        ],
        routes: [
          '/page/1',
          '/page/2',
          {
            url: '/page/3',
            changefreq: 'daily',
            priority: 1,
            lastmod: '2017-06-30T13:30:00.000Z'
          }
        ]
      }
    }

    Setup a Sitemap Index

    To declare a sitemap index and its linked sitemaps, use the sitemaps property.
    By default, the sitemap index is setup to the following path: /sitemapindex.xml
    Each item of the sitemaps array can be setup with its own sitemap options.

    // nuxt.config.js
    
    {
      sitemap: {
        hostname: 'https://example.com',
        lastmod: '2017-06-30',
        sitemaps: [
          {
            path: '/sitemap-foo.xml',
            routes: ['foo/1', 'foo/2'],
            gzip: true
          }, {
            path: '/folder/sitemap-bar.xml',
            routes: ['bar/1', 'bar/2'],
            exclude: ['/**']
          }
        ]
      }
    }

    Setup a list of sitemaps

    To declare a list of sitemaps, use an array to setup each sitemap with its own configuration.
    You can combine sitemap and sitemap index configurations.

    // nuxt.config.js
    
    {
      sitemap: [
        {
          path: '/sitemap-products.xml',
          routes: [
            // array of URL
          ]
        }, {
          path: '/sitemap-news.xml',
          routes: () => // promise or function
        }, {
          path: '/sitemapindex.xml',
          sitemaps: [{
            // array of Sitemap configuration
          }]
        }
      }
    }

    Sitemap Options

    routes (optional) - array | function

    The routes parameter follows the same way than the generate configuration.

    See as well the routes declaration examples below.

    path (optional) - string

    • Default: /sitemap.xml

    The URL path of the generated sitemap.

    hostname (optional) - string

    • Default:
      1. sitemap.hostname value from your nuxt.config.js
      2. build.publicPath value from your nuxt.config.js
      3. os.hostname() for generate or spa mode, or dynamically based on request URL (headers.host) for universal mode

    This value is mandatory for generation sitemap file, and you should explicitly provide it for generate or spa mode.

    cacheTime (optional) - number

    • Default: 1000 * 60 * 15 (15 Minutes)

    Defines how frequently should sitemap routes being updated (value in milliseconds).

    Please note that after each invalidation, routes will be evaluated again. (See routes declaration section)

    This option is enable only for the nuxt "universal" mode.

    exclude (optional) - string array

    • Default: []

    The exclude parameter is an array of glob patterns to exclude static routes from the generated sitemap.

    filter (optional) - function

    • Default: undefined

    If filter option is set as a function, all routes will be filtered through it.

    Examples:

    // nuxt.config.js
    
    // Filter routes by language
    {
      sitemap: {
        filter ({ routes, options }) {
          if (options.hostname === 'example.com') {
            return routes.filter(route => route.locale === 'en')
          }
          return routes.filter(route => route.locale === 'fr')
        }
      }
    }
    
    // Add a trailing slash to each route
    {
      sitemap: {
        filter ({ routes }) {
          return routes.map(route => {
            route.url = `${route.url}/`
            return route
          })
        }
      }
    }

    gzip (optional) - boolean

    • Default: false

    Enable the creation of the .xml.gz sitemap compressed with gzip.

    xmlNs (optional) - string

    • Default: undefined

    Set the XML namespaces by override all default xmlns attributes in <urlset> element.

    // nuxt.config.js
    
    {
      sitemap: {
        xmlNs: 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"'
      }
    }

    xslUrl (optional) - string

    • Default: undefined

    The URL path of the XSL file to style the sitemap.

    trailingSlash (optional) - boolean

    • Default: false

    Add a trailing slash to each route URL (eg. /page/1 => /page/1/)

    notice: To avoid duplicate content detection from crawlers, you have to configure an HTTP 301 redirect between the 2 URLs (see redirect-module or nuxt-trailingslash-module).

    defaults (optional) - object

    • Default: {}

    The defaults parameter set the default options for all routes.

    // nuxt.config.js
    
    {
      sitemap: {
        defaults: {
          changefreq: 'daily',
          priority: 1,
          lastmod: new Date(),
          lastmodrealtime: true
        }
      }
    }

    See available options: https://github.com/ekalinin/sitemap.js#usage

    Sitemap Index Options

    path (optional) - string

    • Default: /sitemapindex.xml

    The URL path of the generated sitemap index.

    hostname (optional) - string

    Set the hostname value to each sitemap linked to its sitemap index.

    sitemaps - array of object

    • Default: []

    Array of sitemap configuration linked to the sitemap index.

    // nuxt.config.js
    
    {
      sitemap: {
        path: '/sitemapindex.xml',
        hostname: 'https://example.com',
        sitemaps: [
          {
            path: '/sitemap-foo.xml',
            // ...
          }, {
            path: '/folder/sitemap-bar.xml',
            // ...
          }
        ]
      }
    }
    <!-- generated sitemapindex.xml -->
    
    <?xml version="1.0" encoding="UTF-8"?>
    <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
      <sitemap>
        <loc>https://example.com/sitemap-foo.xml</loc>
      </sitemap>
      <sitemap>
        <loc>https://example.com/folder/sitemap-bar.xml</loc>
      </sitemap>
    </sitemapindex>

    See more examples above.

    gzip (optional) - boolean

    • Default: false

    Enable the creation of the .xml.gz sitemap index compressed with gzip.

    xmlNs (optional) - string

    • Default: undefined

    Set the XML namespaces by override all default xmlns attributes in <sitemapindex> element.

    // nuxt.config.js
    
    {
      sitemap: {
        xmlNs: 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"'
      }
    }

    xslUrl (optional) - string

    • Default: undefined

    The URL path of the XSL file to style the sitemap index.

    Routes Declaration

    By default, the dynamic routes are ignored by the sitemap module.
    Nuxt cannot automatically provide this type of complex routes.

    Example:

    -| pages/
    ---| index.vue  --> static route
    ---| about.vue  --> static route
    ---| users/
    -----| _id.vue  --> dynamic route
    

    If you want the module to add any route with dynamic parameters, you have to set an array of dynamic routes.

    eg. add routes for /users/:id in the configuration:

    From a static list

    // nuxt.config.js
    
    {
      sitemap: {
        routes: [
          '/users/1',
          '/users/2',
          '/users/3'
        ]
      }
    }

    From a function which returns a Promise

    // nuxt.config.js
    
    const axios = require('axios')
    
    {
      sitemap: {
        routes: async () => {
          const { data } = await axios.get('https://jsonplaceholder.typicode.com/users')
          return data.map(user => `/users/${user.username}`)
        }
      }
    }

    License

    MIT License

    Contributors

    Install

    npm i @kddy/sitemap

    DownloadsWeekly Downloads

    4

    Version

    2.0.1

    License

    MIT

    Unpacked Size

    39.9 kB

    Total Files

    12

    Last publish

    Collaborators

    • fauzymk