sitemap)Lien vers cette rubrique#Django est livré avec un système de génération de plans de site à haut niveau qui permet de créer des fichiers XML sitemap.
\nUn plan de site « sitemap » est un fichier XML sur un site web indiquant aux robots des moteurs de recherche à quelle fréquence les pages changent et comment certaines pages « importantes » sont en relation avec d’autres pages du site. Cette information aide les moteurs de recherche à indexer un site.
\nL’application sitemap de Django automatise la création de ce fichier XML en permettant d’exprimer cette information sous forme de code Python.
\nCela fonctionne un peu comme le système de syndication de Django. Pour créer un plan de site, écrivez une classe Sitemap et référencez-la dans la configuration d’URL.
Pour installer l’application sitemap, procédez comme suit :
\nAjoutez 'django.contrib.sitemaps' au réglage INSTALLED_APPS.
Vérifiez la présence d’un moteur DjangoTemplates``dont l'option ``APP_DIRS vaut True dans le réglage TEMPLATES. Il y est par défaut, de sorte que vous aurez uniquement besoin de l’ajouter si vous avez modifié ce réglage.
Assurez-vous d’avoir installé le gestionnaire de sites.
(Remarque : l’application sitemap n’installe aucune table de base de données. La seule raison pour laquelle elle doit être présente dans INSTALLED_APPS est que la fonction de chargement des gabarits Loader() doit pouvoir trouver les gabarits par défaut.)
Pour activer la génération du plan du site d’un site Django, ajoutez cette ligne à la configuration d’URL:
\nfrom django.contrib.sitemaps.views import sitemap\n\npath(\n "sitemap.xml",\n sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n)\nCela indique à Django de construire un plan de site lorsqu’un client accède à /sitemap.xml.
Le nom du fichier sitemap n’est pas important, mais l’emplacement l’est. Les moteurs de recherche n’indexeront que les liens du plan de site à partir du niveau actuel de l’URL et en-dessous. Par exemple, si sitemap.xml réside dans le répertoire racine, il peut faire référence à n’importe quelle URL du site. Cependant, si le fichier sitemap réside dans /content/sitemap.xml, il ne peut référencer que des URL qui commencent par /content/.
La vue sitemap accepte un paramètre supplémentaire obligatoire : {'sitemaps': sitemaps}. sitemaps doit être un dictionnaire qui associe une étiquette de section courte (par exemple, blog ou nouvelles) à sa classe Sitemap (par exemple, BlogSitemap ou NewsSitemap). Il peut également s’appliquer à une instance de classe Sitemap (par exemple, BlogSitemap(ma_variable)).
SitemapLien vers cette rubrique#Une classe Sitemap est une classe Python qui représente une « section » d’entrées dans votre plan de site. Par exemple, une classe Sitemap pourrait représenter toutes les entrées de votre blog, tandis qu’une autre pourrait représenter tous les évènements d’un calendrier d’évènements.
Dans le cas le plus simple, toutes ces sections sont regroupées dans un seul sitemap.xml, mais il est également possible d’utiliser le système pour générer un index de sitemap qui référence d’autres fichiers sitemap individuels, un par section (voir Création d’un index de plan de site ci-dessous).
Les classes Sitemap doivent être des sous-classes de django.contrib.sitemaps.Sitemap. Elles peuvent résider n’importe où dans votre code source.
Supposons que vous avez un système de blog, avec un modèle Entry. Vous souhaitez que le plan de site contienne les liens vers tous les articles de blog. Voici à quoi la classe de plan de site pourrait ressembler :
from django.contrib.sitemaps import Sitemap\nfrom blog.models import Entry\n\n\nclass BlogSitemap(Sitemap):\n changefreq = "never"\n priority = 0.5\n\n def items(self):\n return Entry.objects.filter(is_draft=False)\n\n def lastmod(self, obj):\n return obj.pub_date\nRemarque :
\nchangefreq et priority sont des attributs de classe correspondant respectivement aux éléments <changefreq> et <priority>. Il est possible qu’ils correspondent à des fonctions, comme pour lastmod dans l’exemple ci-dessus.
items() est une méthode qui renvoie une séquence ou une requête QuerySet d’objets. Les objets renvoyés seront transmis à toute méthode exécutable correspondant à une propriété de sitemap (location, lastmod, changefreq et priority).
Il n’y a pas de méthode location dans cet exemple, mais vous pouvez la fournir afin de préciser l’URL de l’objet. Par défaut, location appelle get_absolute_url() pour chaque objet et renvoie le résultat.
SitemapLien vers cette rubrique#Une classe Sitemap peut définir les méthodes/attributs suivants :
Obligatoire. Une méthode qui renvoie une séquence ou une requête QuerySet d’objets. Le système ne se soucie pas de quel type d’objet il s’agit ; tout ce qui compte, c’est que ces objets sont transmis aux méthodes location, lastmod, changefreq et priority.
Facultatif. Soit une méthode, soit un attribut.
\nSi c’est une méthode, elle doit renvoyer le chemin absolu pour le dit objet renvoyé par items().
Si c’est un attribut, sa valeur doit être une chaîne représentant un chemin absolu à utiliser pour chaque objet renvoyé par items().
Dans les deux cas, « chemin absolu » signifie une URL qui ne comprend ni le protocole ni le domaine. Exemples :
\nBon : '/foo/bar/'
Mauvais : 'example.com/foo/bar/'
Mauvais : 'https://example.com/foo/bar/'
Si location n’est pas fourni, le système appelle la méthode get_absolute_url() de chaque objet renvoyé par items().
Pour indiquer un protocole autre que 'http', utilisez protocol.
Facultatif. Soit une méthode, soit un attribut.
\nSi c’est une méthode, elle doit accepter un paramètre, un objet renvoyé par items(), et renvoyer la date/heure de dernière modification de cet objet, en tant que datetime.
Si c’est un attribut, sa valeur doit être un objet datetime représentant la date/heure de dernière modification pour chaque objet renvoyé par items().
Si tous les éléments d’un plan de site possèdent lastmod, le plan de site généré par views.sitemap() comportera un en-tête Last-Modified égal à la valeur lastmod la plus récente. Vous pouvez activer l’intergiciel ConditionalGetMiddleware pour que Django réponde de manière appropriée aux requêtes contenant un en-tête If-Modified-Since, ce qui évitera d’envoyer le plan de site si celui-ci n’a pas changé.
Facultatif.
\nCette propriété renvoie un Paginator pour items(). Si vous générez des plans de site en lots, il peut être utile de surcharger cette propriété en en faisant une propriété en cache afin d’éviter de multiples appels à items().
Facultatif. Soit une méthode, soit un attribut.
\nSi c’est une méthode, elle doit accepter un paramètre, un objet renvoyé par items(), et renvoyer la fréquence de modification de cet objet, en tant que chaîne.
Si c’est un attribut, sa valeur doit être une chaîne représentant la fréquence de modification de chaque objet renvoyé par items().
Les valeurs possibles pour changefreq, que ce soit une méthode ou un attribut, sont :
'always' (toujours)
'hourly' (chaque heure)
'daily' (quotidiennement)
'weekly' (chaque semaine)
'monthly' (chaque mois)
'yearly' (annuellement)
'never' (jamais)
Facultatif. Soit une méthode, soit un attribut.
\nSi c’est une méthode, elle doit accepter un paramètre, un objet renvoyé par items(), et renvoyer la priorité de cet objet, en tant que chaîne ou nombre à virgule.
Si c’est un attribut, sa valeur doit être une chaîne ou un nombre à virgule représentant la priorité de chaque objet renvoyé par items().
Exemples de valeurs pour priority: 0.4, 1.0. La priorité par défaut d’une page est de 0.5. Voir la documentation de sitemaps.org pour plus d’informations.
Facultatif.
\nCet attribut définit le protocole ('http' ou 'https') des URL dans le plan du site. S’il n’est pas défini, le protocole avec lequel le plan du site a été demandé sera utilisé. Si le plan du site est construit en dehors du contexte d’une requête, la valeur par défaut est 'https'.
Facultatif.
\nCet attribut définit le nombre maximum d’URL incluses sur chaque page du plan de site. Sa valeur ne doit pas dépasser la valeur par défaut de 50000, qui est la valeur limite supérieure autorisée par le protocole des plans de site.
Facultatif.
\nUn attribut booléen qui définit si les URL de ce plan de site doivent être générées en utilisant toutes les langues de LANGUAGES. La valeur par défaut est False.
Facultatif.
\nUne suite de codes de langues à utiliser pour la génération de liens alternatifs lorsque i18n est activé. La valeur par défaut correspond à LANGUAGES.
Facultatif.
\nUn attribut booléen. Lorsqu’il est est employé de concert avec i18n, les URL produites auront chacune une liste de liens alternatifs pointant vers d’autres versions linguistiques à l’aide de l”attribut hreflang. La valeur par défaut est False.
Facultatif.
\nUn attribut booléen. Lorsqu’il vaut True, les liens alternatifs générés par alternates contiendront une entrée hreflang="x-default" avec la valeur LANGUAGE_CODE. La valeur par défaut est False.
Facultatif. Une méthode qui renvoie la dernière valeur renvoyée par lastmod. Cette fonction est utilisée pour ajouter l’attribut lastmod aux variables de contexte de l’index de plan de site.
Par défaut, get_latest_lastmod() renvoie :
Facultatif Une méthode renvoyant la liste des codes de langues pour lesquels un élément est affiché. Par défaut, get_languages_for_item() renvoie languages.
L’infrastructure sitemap fournit une classe pratique pour un cas courant :
\nThe django.contrib.sitemaps.GenericSitemap class allows you to\ncreate a sitemap by passing it a dictionary which has to contain at least\na queryset entry. This queryset will be used to generate the items\nof the sitemap. It may also have a date_field entry that\nspecifies a date field for objects retrieved from the queryset.\nThis will be used for the lastmod attribute and\nget_latest_lastmod() methods in the generated sitemap.
Les paramètres nommés priority, changefreq et protocol permettent de définir ces attributs pour toutes les URL.
Voici un exemple de configuration d’URL utilisant GenericSitemap:
from django.contrib.sitemaps import GenericSitemap\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\nfrom blog.models import Entry\n\ninfo_dict = {\n "queryset": Entry.objects.all(),\n "date_field": "pub_date",\n}\n\nurlpatterns = [\n # some generic view using info_dict\n # ...\n # the sitemap\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": {"blog": GenericSitemap(info_dict, priority=0.6)}},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nIl peut souvent être nécessaire de faire indexer par les robots des moteurs de recherche des vues qui ne sont ni des pages de détail d’un objet, ni des pages statiques. La solution est de fournir une liste explicite de noms d’URL pour ces vues dans items et d’appeler reverse() dans la méthode location du sitemap. Par exemple :
# sitemaps.py\nfrom django.contrib import sitemaps\nfrom django.urls import reverse\n\n\nclass StaticViewSitemap(sitemaps.Sitemap):\n priority = 0.5\n changefreq = "daily"\n\n def items(self):\n return ["main", "about", "license"]\n\n def location(self, item):\n return reverse(item)\n\n\n# urls.py\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\n\nfrom .sitemaps import StaticViewSitemap\nfrom . import views\n\nsitemaps = {\n "static": StaticViewSitemap,\n}\n\nurlpatterns = [\n path("", views.main, name="main"),\n path("about/", views.about, name="about"),\n path("license/", views.license, name="license"),\n # ...\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nLe système sitemap a également la possibilité de créer un index de plan de site qui référence des fichiers sitemap individuels, un pour chaque section définie dans le dictionnaire sitemaps. Les seules différences dans l’utilisation sont les suivantes :
Vous utilisez deux vues dans la configuration d’URL : django.contrib.sitemaps.views.index() et django.contrib.sitemaps.views.sitemap().
La vue django.contrib.sitemaps.views.sitemap() doit accepter un paramètre nommé section.
Voici à quoi ressembleraient les lignes appropriées de la configuration d’URL pour l’exemple ci-dessus :
\nfrom django.contrib.sitemaps import views\n\nurlpatterns = [\n path(\n "sitemap.xml",\n views.index,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.index",\n ),\n path(\n "sitemap-<section>.xml",\n views.sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nCela générera automatiquement un fichier sitemap.xml faisant référence à la fois à sitemap-flatpages.xml et à sitemap-blog.xml. Les classes Sitemap et le dictionnaire sitemaps ne changent aucunement.
Si tous les plans de site possèdent un lastmod renvoyé par get_latest_lastmod(), l’index de plan de site contiendra un en-tête Last-Modified égal au lastmod le plus récent.
Vous devriez créer un fichier d’index lorsqu’un plan de site contient plus de 50 000 URL. Dans ce cas, Django pagine automatiquement le plan du site et l’index reflétera cette situation.
\nSi vous n’utilisez pas la vue sitemap ordinaire – par exemple, si elle est enveloppée par un décorateur de mise en cache – vous devez nommer votre vue sitemap et passer sitemap_url_name à la vue d’index :
from django.contrib.sitemaps import views as sitemaps_views\nfrom django.views.decorators.cache import cache_page\n\nurlpatterns = [\n path(\n "sitemap.xml",\n cache_page(86400)(sitemaps_views.index),\n {"sitemaps": sitemaps, "sitemap_url_name": "sitemaps"},\n ),\n path(\n "sitemap-<section>.xml",\n cache_page(86400)(sitemaps_views.sitemap),\n {"sitemaps": sitemaps},\n name="sitemaps",\n ),\n]\nSi vous souhaitez utiliser un gabarit différent pour chaque plan de site ou d’index de plan de site disponible sur un site, vous pouvez l’indiquer en passant un paramètre template_name aux vues sitemap et index via la configuration d’URL :
from django.contrib.sitemaps import views\n\nurlpatterns = [\n path(\n "custom-sitemap.xml",\n views.index,\n {"sitemaps": sitemaps, "template_name": "custom_sitemap.html"},\n name="django.contrib.sitemaps.views.index",\n ),\n path(\n "custom-sitemap-<section>.xml",\n views.sitemap,\n {"sitemaps": sitemaps, "template_name": "custom_sitemap.html"},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nCes vues renvoient des instances TemplateResponse permettant de personnaliser facilement les données de réponse avant le processus de rendu. Pour plus de détails, consultez la documentation de TemplateResponse.
Lors de la personnalisation des gabarits pour les vues index() et sitemap(), vous pouvez compter sur les variables de contexte suivantes.
La variable sitemaps est une liste d’objets contenant les attributs location et lastmod pour chaque plan de site. Chaque URL expose les attributs suivants :
location: l’emplacement (URL et page) du plan de site.
lastmod: rempli par la méthode get_latest_lastmod() pour chaque plan de site.
La variable urlset est une liste d’URL devant apparaître dans le plan du site. Chaque URL expose des attributs tels que définis dans la classe Sitemap:
alternates
changefreq (fréquence de modification)
item (élément)
lastmod (date de dernière modification)
location (adresse)
priority (priorité)
L’attribut alternates est disponible lorsque i18n et alternates sont activés. Il s’agit d’une liste d’autres versions linguistiques, y compris la valeur par défaut facultative x_default, pour chaque URL. Chaque alternate est un dictionnaire avec les clés location et lang_code.
L’attribut item a été ajouté pour chaque URL afin de permettre une personnalisation plus souple des gabarits, comme pour les Google news sitemaps. En supposant que items() de Sitemap renvoie une liste d’éléments avec des champs publication_date et tags, le code ci-dessous devrait générer un plan de site compatible avec Google News :
<?xml version="1.0" encoding="UTF-8"?>\n<urlset\n xmlns="https://www.sitemaps.org/schemas/sitemap/0.9"\n xmlns:news="https://www.google.com/schemas/sitemap-news/0.9">\n{% spaceless %}\n{% for url in urlset %}\n <url>\n <loc>{{ url.location }}</loc>\n {% if url.lastmod %}<lastmod>{{ url.lastmod|date:"Y-m-d" }}</lastmod>{% endif %}\n {% if url.changefreq %}<changefreq>{{ url.changefreq }}</changefreq>{% endif %}\n {% if url.priority %}<priority>{{ url.priority }}</priority>{% endif %}\n <news:news>\n {% if url.item.publication_date %}<news:publication_date>{{ url.item.publication_date|date:"Y-m-d" }}</news:publication_date>{% endif %}\n {% if url.item.tags %}<news:keywords>{{ url.item.tags }}</news:keywords>{% endif %}\n </news:news>\n </url>\n{% endfor %}\n{% endspaceless %}\n</urlset>\n