diff --git a/docs/ref/contrib/redirects.txt b/docs/ref/contrib/redirects.txt index 6fa5fc51eb..45b7fe1a0e 100644 --- a/docs/ref/contrib/redirects.txt +++ b/docs/ref/contrib/redirects.txt @@ -74,6 +74,24 @@ Via the Python API Redirects are represented by a standard :doc:`Django model `, which lives in :source:`django/contrib/redirects/models.py`. You can access redirect objects via the :doc:`Django database API `. + For example:: + + >>> from django.conf import settings + >>> from django.contrib.redirects.models import Redirect + >>> # Add a new redirect. + >>> redirect = Redirect.objects.create( + ... site_id=1, + ... old_path='/contact-us/', + ... new_path='/contact/', + ... ) + >>> # Change a redirect. + >>> redirect.new_path = '/contact-details/' + >>> redirect.save() + >>> redirect + /contact-details/> + >>> # Delete a redirect. + >>> Redirect.objects.filter(site_id=1, old_path='/contact-us/').delete() + (1, {'redirects.Redirect': 1}) Middleware ==========