/jsl_django_sitemap

JSL Django Sitemap is a sitemap.xml creator for Django projects which iterates over all the url patterns in your main Django project and creates a ready to use sitemap. The sitemap.xml is useful in crawlers such as Google, Bing, Yahoo. We hope you like our app! Leave a star on our GitHub repository. Thanks!

Primary LanguagePythonMIT LicenseMIT

J Software Labs (JSL) Django Sitemap application

Upload Python Package

A sitemap is an XML file on your website that tells search-engine crawlers or indexers how frequently your pages change and how “important” certain pages are in relation to other pages on your site. This information helps search engines index your site.

This Django sitemap framework library automates the creation of this XML file by letting you express this information in Python code. You have the ability to chnge and mention settings in your Django project's settings.py file. It is very convinent and easy to use library which detects the changes in your Django url configuration and reloads the new configuration making absolutely no manual interventions for your sitemap.

JSL Django Sitemap is a sitemap.xml creator for Django projects which iterates over all the url patterns in your main Django project and creates a ready to use sitemap. The sitemap.xml is useful in crawlers such as Google, Bing, Yahoo. We hope you like our app! Leave a star on our GitHub repository. Thanks!

Our Home page

PyPi package Name: jsl-django-sitemap

Installation

You can install the JSL Django Sitemap from PyPI:

pip install jsl-django-sitemap

Example Usage

  • Add necessary imports

    from jsl_django_sitemap.views import sitemaps
    from django.contrib.sitemaps.views import sitemap
    from django.urls import path
  • In your main django project urls.py file add below in urlpatterns

    path('sitemap.xml', sitemap, {'sitemaps': sitemaps},
    name='django.contrib.sitemaps.views.sitemap'),
  • In your main settings.py file add below

    JSL_DJANGO_SITEMAP_SETTINGS = {
        "ENABLE": True,
        "FETCH_URL_FROM": "pattern",
        "INCLUDE_APPS": ("ALL",),
        "IGNORE_URL_PATTERNS": (".*/api/v1.*", )
    }
  • Add django built in sitemap in the INSTALLED_APPS

     INSTALLED_APPS = [
     	# ...
     	'django.contrib.sitemaps',
     ]

NOTE:

  1. "ALL" means to include all the urls from all apps in Django project.
  1. If you want specific apps to be included in sitemap use below. Provide comma separated tuple containing your app name
  1. "INCLUDE_APPS": ("myapp1","myapp2")
  1. FETCH_URL_FROM: should be one value from the list ["name", "pattern"]
  1. default for FETCH_URL_FROM is "pattern"
  1. By default, if pattern is provided then "^" prefix and "$" suffix in urlpattern is removed.
  1. "IGNORE_URL_PATTERNS": ("./api/v1.", ) This flag is used to ignore certain urls matching the provided tuple of patterns which are regex compatible

NOTE: The sitemap application doesn't install any database tables. The only reason it needs to go into INSTALLED_APPS is so that the Loader() template loader can find the default templates.

View generated sitemap:

Start the development server and visit http://127.0.0.1:8000/sitemap.xml


Current Releases

1.2.4

How to build and distribute using sdist setup.py and twine

python3 -m pip install --upgrade twine
python setup.py sdist
twine upload dist/*