summaryrefslogtreecommitdiff
path: root/docs/howto/index.txt
AgeCommit message (Collapse)Author
2026-05-13Fixed #35514 -- Implemented dictionary-based MAILERS.Mike Edmunds
See DEP 0018. Added: * MAILERS setting. * django.core.mail.mailers dict-like EmailBackend factory. * `using` argument to mail sending APIs. * `sent_using` attribute to mail.outbox messages in locmem backend. * MAILERS in startproject settings template, set to console backend. * AdminLogHandler.using argument. * BrokenLinkEmailsMiddleware.send_mail() method. Updated: * BaseEmailBackend to track the MAILERS alias used to construct it, and to report errors for unknown kwargs (OPTIONS). * EmailBackend implementations to initialize from kwargs (OPTIONS) only when MAILERS is being used. * smtp.EmailBackend to require `host` option and to default `port` option based on SSL/TLS options. * SimpleTestCase setup to substitute the locmem backend for all defined MAILERS configurations. * Django's tests that send mail to define MAILERS. Deprecated: * EMAIL_BACKEND and other backend-related EMAIL_* settings. * mail.get_connection(). * The `connection`, `fail_silently`, `auth_user`, and `auth_password` arguments to mail functions. * The EmailMessage.connection attribute. * BaseEmailBackend support for `fail_silently`. Backends that support fail_silently (SMTP, console, file) now implement it directly. * AdminEmailHandler.email_backend argument. Removed undocumented features without deprecation: * EmailMessage.get_connection() method. (send() now raises an error if a subclass has attempted to override it.) * EmailMessage.send() no longer sets self.connection to the connection used for sending. (It still _uses_ a pre-existing self.connection.) * AdminEmailHandler.connection() method. (Init now raises an error if a subclass has attempted to override it.) Thanks to Natalia Bidart for shepherding DEP 0018 and for extensive reviews and suggestions on the implementation. Thanks to Jacob Rief for the initial implementation and multiple iterations while refining the design. Co-authored-by: Jacob Rief <jacob.rief@gmail.com>
2025-06-27Fixed #15727 -- Added Content Security Policy (CSP) support.Rob Hudson
This initial work adds a pair of settings to configure specific CSP directives for enforcing or reporting policy violations, a new `django.middleware.csp.ContentSecurityPolicyMiddleware` to apply the appropriate headers to responses, and a context processor to support CSP nonces in templates for safely inlining assets. Relevant documentation has been added for the 6.0 release notes, security overview, a new how-to page, and a dedicated reference section. Thanks to the multiple reviewers for their precise and valuable feedback. Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2025-01-09Fixed #35515 -- Added automatic model imports to shell management command.Salvo Polizzi
Thanks to Bhuvnesh Sharma and Adam Johnson for mentoring this Google Summer of Code 2024 project. Thanks to Sarah Boyce, David Smith, Jacob Walls and Natalia Bidart for reviews.
2024-10-22Restructured how-to docs landing page.Daniele Procida
Previously, this was a bare list of sub-pages, not in any discernible order, and hard to parse. Now the sub-pages are grouped in sections by topic. It's unlikely to be the final word on how this material is arranged, but it's a clear improvement on the existing arrangement and provides a good basis for next steps.
2023-07-11Fixed #34309 -- Doc'd how to fully delete an app.Marcelo Galigniana
Co-authored-by: nessita <124304+nessita@users.noreply.github.com> Co-authored-by: shangxiao <shang.xiao.sanders@gmail.com> Co-authored-by: sarahboyce <42296566+sarahboyce@users.noreply.github.com> Co-authored-by: felixxm <felisiak.mariusz@gmail.com>
2022-03-17Refs #28592 -- Created a new CSRF how-to document.tommcn
2021-07-12Refs #32880 -- Created a new logging how-to document.Daniele Procida
Moved how-to material from topic document into a new document, and added new material. Introduced minor improvements to logging reference document.
2020-04-30Fixed #25712 -- Reorganized templates docs.David Smith
2019-12-19Refs #28954 -- Remove remaining Jython documentation.Nick Pope
There is still no further progress on Jython 3 since support for Jython was stripped in Django 2.0. The developers experimenting with Jython 3 have stated that they would need to start from scratch, so it doesn't look as though it will materialize for years to come. Python 2 and Django 1.11, the last version to support Python 2.7, will both be end-of-life before Django 3.1 is released. We should no longer instruct users to use an unsupported version of Django.
2017-06-02Fixed #26028 -- Added overriding templates howto.Philip James
2016-01-22Fixed #26020 -- Normalized header stylings in docs.Elif T. Kus
2015-02-03Added a "Writing migrations" how-to.Tim Graham
2014-07-08Fixed #22812 -- Refactored lookup API documentation.Jorge C. Leitão
Thanks Anssi and Tim for reviews.
2014-04-08Fixed #16205 -- Added an installation for Windows.Anubhav Joshi
2013-05-22Fixed #17048 - Added docs for upgrading Django.Tim Graham
Thanks Donald Stufft for the suggestion and Susan Tan and Brian Fabian Crain for the patch.
2013-03-29Fixed #19897 - Updated static files howto.Tim Graham
Thanks Jan Murre, Reinout van Rees and Wim Feijen, plus Remco Wendt for reviewing.
2012-09-27fixed #10809 -- add a mod_wsgi authentication handlerPreston Holmes
Thanks to baumer1122 for the suggestion and initial patch and David Fischer for the contributions and long term patch maintenance and docs.
2012-03-13Replaced http by https in djangoproject.com linksClaude Paroz
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17703 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-10-22Fixed #17087 -- Re-organized the i18n docs to reduce confusion between ↵Aymeric Augustin
USE_I18N/USE_L10N and the concepts of internationalization/localisation. Re moved some duplicate content. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17026 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-05-27Fixed #15796 -- Restructured the contributing documentation and added note ↵Jannis Leidel
about newly added Trac abilities. Many thanks to Julien Phalip. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16284 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-02-25Fixed #14401 -- Added a contributing howto guide for new users. Thank you to ↵Gabriel Hurley
everyone who added their advice, feedback, and wisdom to the wiki article while constructing this new guide. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15645 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-08-19Fixed #14141: docs now use the :doc: construct for links between documents.Jacob Kaplan-Moss
Thanks, Ramiro Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-02-16Fixed #10260 - Refactored internationalization documentation. Thanks, Ramiro ↵Jannis Leidel
Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12440 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2009-03-15Fixed #689 -- Added a middleware and authentication backend to contrib.auth ↵Gary Wilson Jr
for supporting external authentication solutions. Thanks to all who contributed to this patch, including Ian Holsman, garthk, Koen Biermans, Marc Fargas, ekarulf, and Ramiro Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@10063 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2008-08-26Fixed #8326: added documentation about running Django on Jython. Docs ↵Jacob Kaplan-Moss
originally written by Leo Soto, and then cleaned up a bit by me. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8582 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2008-08-23Massive reorganization of the docs. See the new docs online at ↵Jacob Kaplan-Moss
http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37
generated by cgit v1.3 (git 2.53.0) at 2026-07-10 21:37:11 +0000