Django documentation says:
get_absolute_url()
method to tell Django how to calculate the canonical URL for an object.
What is canonical URL mean in this is context?
I know from an SEO perspective that canonical URL means picking the best URL from the similar looking URLs (example.com
, example.com/index.html
). But this meaning doesn’t fit in this context.
I know this method provides some additional functionality in Django admin, redirection etc. And I am fully aware of how to use this method.
But what is the philosophy behind it? I have never actually used it in my projects. Does it serve any special purpose?
4
Answers
get_absolute_url
allows to keep your object DRY. To have a url which defines that object instance. In most case a detail page for that object.Couple this with
models.permalink
and you can define the object detail url very easily.What is @permalink and get_absolute_url in Django?
Later if you change the structure of the url you have to modify only in one place, the urls.
First of all, when it comes to web development you really want to avoid hard coding paths in your templates. The reason for this is that paths might change, and it will be a hassle to go through all your HTML and templates to find every single URL or path and update it manually. It makes your code much harder to maintain.
The solution to this is to define functions that return the URL instead. This is where
get_absolute_url()
comes into the picture.Example:
Canonical URL
Your second question is what a canonical URL is. A canonical URL is “the official” url to a certain page. Sometimes an asset can be displayed in multiple different URL’s, for example:
Here we have the same asset displayed in 3 different URL’s. The “Canonical URL” would be the one we defined as the main one. E.g.
/en/shoes/1-nike-shoes/
.Its very useful to define what a official or “main” URL to a certain asset is. It will allow you to prevent duplicate content when search engines index your website.
In the context of the quote you are using from the Django Documentation. “Canonical” in this case means “the official URL where this model is displayed”.
You create models for your website. When a new instance is made for a model, django must know where to go when a new post is created or a new instance is created.
Here
get_absolute_url
comes in picture. It tells the django where to go when new post is created.See this example:
I want to generate a unique URL for each product, the pattern will be – http://…../products/abcdefg/ (after ‘/products/’ it’s my slug value).
In models.py, I created the ‘get_absolute_url’ that will generate url in the above pattern
models.py
productlist.html – get_absolute_url referred in anchor tag
urls.py – my url pattern