algolia-sitemap

    2.2.0 • Public • Published

    Algolia sitemap generator

    This is a node library allowing you to generate sitemaps from an Algolia index.

    Requires node v6+ (make an issue if this is a problem for you).

    It will create sitemaps, and a sitemap index in a folder of your choosing (for example /sitemaps). Then you can upload /sitemaps/sitemap-index.xml to Google for good indexing of your pages!

    How does it work?

    1. Browse over all entries in an Algolia index
    2. Per 50 000 links, a sitemap.n.xml is generated in the chosen folder (where n is the index)
    3. Once all Algolia data has been browsed over, a final sitemap-index.xml is being generated
    4. Let search engines know about sitemap-index.xml either by letting them know or putting it in robots.txt

    This process is a script that should be ran periodically to keep the sitemaps up to date, no "watch" feature has been put in place (yet?)

    How to use

    First install the module from npm (or with yarn):

    $ npm install algolia-sitemap --save[-dev]
    $ yarn add algolia-sitemap [--dev]
    // import the dependency
    const algoliaSitemap = require('algolia-sitemap');
     
    algoliaSitemap({
      algoliaConfig,
      sitemapLoc: 'https://yoursite.com/sitemaps',
      outputFolder: 'sitemaps',
      hitToParams,
    });

    Where algoliaConfig holds the setup for your index. Make sure that the API key you use has the "browse" capability

    // set up your API keys
    const algoliaConfig = {
      appId: 'XXXXX',
      apiKey: 'xxxxxx', // make sure the key has "browse" capability
      indexName: 'xxxxxx',
    };

    And hitToParams is a function that transforms a hit into a parameters object. This function can return an object of type Param, an array of Params or false.

    function hitToParams({ objectID, modified, downloadsRatio }) {
      const url = ({ lang, objectID }) =>
        `https://${lang}.yoursite.com/${lang}/detail/${objectID}`;
      const loc = url({ lang: 'en', objectID });
      const lastmod = new Date().toISOString();
      const priority = Math.random();
      return {
        loc,
        lastmod,
        priority,
        alternates: {
          languages: ['fr', 'pt-BR', 'zh-Hans'],
          hitToURL: lang => url({ lang, objectID }),
        },
      };
    }

    These parameters mean:

    /**
     * @typedef {Object} Params
     * @property {string} loc the link of this hit
     * @property {string} [lastmod] the last time this link was modified (ISO8601)
     * @property {number} [priority] the priority you give to this link (between 0 and 1)
     * @property {Object} [alternates] alternative versions of this link (useful for multi-language)
     * @property {Array} [alternates.languages] list of languages that are enabled
     * @property {Array} [images] list of images links related to the hit
     * @property {function} [alternates.hitToURL] function to transform a language into a url of this object
     */

    Image Sitemaps

    If you want your sitemap to include Google image extensions, return an array for each hit containing objects with the following keys:

    /**
     * @typedef {Object} Image
     * @property {string} loc the link of this image
     * @property {string} [title] image title
     * @property {string} [caption] image caption
     * @property {string} [geo_location] geographic location (e.g. 'Limerick, Ireland')
     * @property {string} [license] the link to the image's license
     */

    For example:

    function hitToParams({
      objectID,
      modified,
      downloadsRatio,
      profilePic,
      coverPhoto,
      name,
    }) {
      const url = ({ lang, objectID }) =>
        `https://${lang}.yoursite.com/${lang}/detail/${objectID}`;
      const loc = url({ lang: 'en', objectID });
      const lastmod = new Date().toISOString();
      const priority = Math.random();
      return {
        loc,
        lastmod,
        priority,
        images: [
          {
            loc: `https://media.yoursite.com/images/${profilePic}`,
            title: name,
          },
          {
            loc: `https://media.yoursite.com/images/${coverPhoto}`,
            title: name,
          },
        ],
        alternates: {
          languages: ['fr', 'pt-BR', 'zh-Hans'],
          hitToURL: lang => url({ lang, objectID }),
        },
      };
    }

    For more information, see https://support.google.com/webmasters/answer/178636?hl=en

    Custom queries

    You can pass a params parameter to algoliaSitemap. This allows you to narrow down the returned results. For instance, in order to have hitToParams called for every products in the phone category, we could do:

    algoliaSitemap({
      algoliaConfig,
      sitemapLoc: 'https://yoursite.com/sitemaps',
      outputFolder: 'sitemaps',
      params: {
        filters: 'category: phone',
      },
      hitToParams,
    });

    Note that a query can also be passed to params.

    Examples

    You can also take a look at examples folder for how it works.

    License

    MIT

    Keywords

    none

    Install

    npm i algolia-sitemap

    DownloadsWeekly Downloads

    332

    Version

    2.2.0

    License

    MIT

    Unpacked Size

    19.8 kB

    Total Files

    9

    Last publish

    Collaborators

    • dhaya.b
    • spy-seth
    • alejandrouda
    • thomaslef
    • lukyvj
    • sepehrf
    • kosai106
    • marielaure
    • mthuret
    • haroenv
    • rayrutjes
    • speedblue
    • jerska
    • raphi
    • cbaptiste
    • ronanlevesque
    • samouss
    • therealwebby
    • francoischalifour
    • jonmontane
    • mikaa123
    • valentindotxyz
    • shipow
    • tkrugg
    • seafoox
    • sylvainh
    • clemfromspace
    • lorrissaintgenez
    • broujo
    • marieglr
    • e-krebs
    • eunjae-lee
    • kombucha
    • h1fra
    • sylvain
    • crawler-team
    • amcdaid106
    • devinalgolia
    • dispix
    • jvenezia
    • otomatik
    • julienbourdeau
    • sophiem03
    • mschreiber
    • sarahdayan
    • alexandremeunier
    • dcoates
    • maximehuang
    • netgusto
    • guitek
    • matthewbond
    • cyril.descossy
    • tatsuro
    • danajeremy
    • mathougui
    • xavdh
    • agdavid
    • rasemotte
    • plnech
    • shortcuts
    • praagyajoshi
    • loicsay
    • svensoldin
    • alphonseb
    • leodau
    • fabienmotte
    • sarahfranc
    • millotp
    • vvo