Fixed some ReST errors from e-mail -> email change in docs, and changed some docs that shouldn't have been changed (because translation strings haven't been converted yet)
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15968 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
94af19c43f
commit
9a279edc1c
|
@ -1,5 +1,5 @@
|
||||||
Error reporting via email
|
Error reporting via email
|
||||||
==========================
|
=========================
|
||||||
|
|
||||||
When you're running a public site you should always turn off the
|
When you're running a public site you should always turn off the
|
||||||
:setting:`DEBUG` setting. That will make your server run much faster, and will
|
:setting:`DEBUG` setting. That will make your server run much faster, and will
|
||||||
|
|
|
@ -105,7 +105,7 @@ Access the :attr:`~Form.errors` attribute to get a dictionary of error
|
||||||
messages::
|
messages::
|
||||||
|
|
||||||
>>> f.errors
|
>>> f.errors
|
||||||
{'sender': [u'Enter a valid email address.'], 'subject': [u'This field is required.']}
|
{'sender': [u'Enter a valid e-mail address.'], 'subject': [u'This field is required.']}
|
||||||
|
|
||||||
In this dictionary, the keys are the field names, and the values are lists of
|
In this dictionary, the keys are the field names, and the values are lists of
|
||||||
Unicode strings representing the error messages. The error messages are stored
|
Unicode strings representing the error messages. The error messages are stored
|
||||||
|
@ -537,18 +537,18 @@ method you're using::
|
||||||
>>> print f.as_table()
|
>>> print f.as_table()
|
||||||
<tr><th>Subject:</th><td><ul class="errorlist"><li>This field is required.</li></ul><input type="text" name="subject" maxlength="100" /></td></tr>
|
<tr><th>Subject:</th><td><ul class="errorlist"><li>This field is required.</li></ul><input type="text" name="subject" maxlength="100" /></td></tr>
|
||||||
<tr><th>Message:</th><td><input type="text" name="message" value="Hi there" /></td></tr>
|
<tr><th>Message:</th><td><input type="text" name="message" value="Hi there" /></td></tr>
|
||||||
<tr><th>Sender:</th><td><ul class="errorlist"><li>Enter a valid email address.</li></ul><input type="text" name="sender" value="invalid email address" /></td></tr>
|
<tr><th>Sender:</th><td><ul class="errorlist"><li>Enter a valid e-mail address.</li></ul><input type="text" name="sender" value="invalid email address" /></td></tr>
|
||||||
<tr><th>Cc myself:</th><td><input checked="checked" type="checkbox" name="cc_myself" /></td></tr>
|
<tr><th>Cc myself:</th><td><input checked="checked" type="checkbox" name="cc_myself" /></td></tr>
|
||||||
>>> print f.as_ul()
|
>>> print f.as_ul()
|
||||||
<li><ul class="errorlist"><li>This field is required.</li></ul>Subject: <input type="text" name="subject" maxlength="100" /></li>
|
<li><ul class="errorlist"><li>This field is required.</li></ul>Subject: <input type="text" name="subject" maxlength="100" /></li>
|
||||||
<li>Message: <input type="text" name="message" value="Hi there" /></li>
|
<li>Message: <input type="text" name="message" value="Hi there" /></li>
|
||||||
<li><ul class="errorlist"><li>Enter a valid email address.</li></ul>Sender: <input type="text" name="sender" value="invalid email address" /></li>
|
<li><ul class="errorlist"><li>Enter a valid e-mail address.</li></ul>Sender: <input type="text" name="sender" value="invalid email address" /></li>
|
||||||
<li>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></li>
|
<li>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></li>
|
||||||
>>> print f.as_p()
|
>>> print f.as_p()
|
||||||
<p><ul class="errorlist"><li>This field is required.</li></ul></p>
|
<p><ul class="errorlist"><li>This field is required.</li></ul></p>
|
||||||
<p>Subject: <input type="text" name="subject" maxlength="100" /></p>
|
<p>Subject: <input type="text" name="subject" maxlength="100" /></p>
|
||||||
<p>Message: <input type="text" name="message" value="Hi there" /></p>
|
<p>Message: <input type="text" name="message" value="Hi there" /></p>
|
||||||
<p><ul class="errorlist"><li>Enter a valid email address.</li></ul></p>
|
<p><ul class="errorlist"><li>Enter a valid e-mail address.</li></ul></p>
|
||||||
<p>Sender: <input type="text" name="sender" value="invalid email address" /></p>
|
<p>Sender: <input type="text" name="sender" value="invalid email address" /></p>
|
||||||
<p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
|
<p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
|
||||||
|
|
||||||
|
@ -571,7 +571,7 @@ pass that in at construction time::
|
||||||
<div class="errorlist"><div class="error">This field is required.</div></div>
|
<div class="errorlist"><div class="error">This field is required.</div></div>
|
||||||
<p>Subject: <input type="text" name="subject" maxlength="100" /></p>
|
<p>Subject: <input type="text" name="subject" maxlength="100" /></p>
|
||||||
<p>Message: <input type="text" name="message" value="Hi there" /></p>
|
<p>Message: <input type="text" name="message" value="Hi there" /></p>
|
||||||
<div class="errorlist"><div class="error">Enter a valid email address.</div></div>
|
<div class="errorlist"><div class="error">Enter a valid e-mail address.</div></div>
|
||||||
<p>Sender: <input type="text" name="sender" value="invalid email address" /></p>
|
<p>Sender: <input type="text" name="sender" value="invalid email address" /></p>
|
||||||
<p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
|
<p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
|
||||||
|
|
||||||
|
|
|
@ -30,7 +30,7 @@ exception or returns the clean value::
|
||||||
>>> f.clean('invalid email address')
|
>>> f.clean('invalid email address')
|
||||||
Traceback (most recent call last):
|
Traceback (most recent call last):
|
||||||
...
|
...
|
||||||
ValidationError: [u'Enter a valid email address.']
|
ValidationError: [u'Enter a valid e-mail address.']
|
||||||
|
|
||||||
Core field arguments
|
Core field arguments
|
||||||
--------------------
|
--------------------
|
||||||
|
|
|
@ -187,7 +187,7 @@ a look at Django's ``EmailField``::
|
||||||
|
|
||||||
class EmailField(CharField):
|
class EmailField(CharField):
|
||||||
default_error_messages = {
|
default_error_messages = {
|
||||||
'invalid': _(u'Enter a valid email address.'),
|
'invalid': _(u'Enter a valid e-mail address.'),
|
||||||
}
|
}
|
||||||
default_validators = [validators.validate_email]
|
default_validators = [validators.validate_email]
|
||||||
|
|
||||||
|
@ -200,7 +200,7 @@ on field definition so::
|
||||||
is equivalent to::
|
is equivalent to::
|
||||||
|
|
||||||
email = forms.CharField(validators=[validators.validate_email],
|
email = forms.CharField(validators=[validators.validate_email],
|
||||||
error_messages={'invalid': _(u'Enter a valid email address.')})
|
error_messages={'invalid': _(u'Enter a valid e-mail address.')})
|
||||||
|
|
||||||
|
|
||||||
Form field default cleaning
|
Form field default cleaning
|
||||||
|
|
|
@ -305,7 +305,7 @@ A couple of tips to remember when writing your own template tags and filters:
|
||||||
strings at that point.
|
strings at that point.
|
||||||
|
|
||||||
Email
|
Email
|
||||||
======
|
=====
|
||||||
|
|
||||||
Django's email framework (in ``django.core.mail``) supports Unicode
|
Django's email framework (in ``django.core.mail``) supports Unicode
|
||||||
transparently. You can use Unicode data in the message bodies and any headers.
|
transparently. You can use Unicode data in the message bodies and any headers.
|
||||||
|
|
|
@ -386,7 +386,7 @@ CSRF', where an attacking site tricks a user's browser into logging
|
||||||
into a site with someone else's credentials, is also covered.
|
into a site with someone else's credentials, is also covered.
|
||||||
|
|
||||||
Email Backends
|
Email Backends
|
||||||
---------------
|
--------------
|
||||||
|
|
||||||
You can now :ref:`configure the way that Django sends email
|
You can now :ref:`configure the way that Django sends email
|
||||||
<topic-email-backends>`. Instead of using SMTP to send all email, you
|
<topic-email-backends>`. Instead of using SMTP to send all email, you
|
||||||
|
|
|
@ -185,7 +185,7 @@ The built-in :class:`~django.contrib.auth.models.User` model's
|
||||||
of characters, including ``@``, ``+``, ``.`` and ``-`` characters.
|
of characters, including ``@``, ``+``, ``.`` and ``-`` characters.
|
||||||
|
|
||||||
Email backends
|
Email backends
|
||||||
---------------
|
--------------
|
||||||
|
|
||||||
You can now :ref:`configure the way that Django sends email
|
You can now :ref:`configure the way that Django sends email
|
||||||
<topic-email-backends>`. Instead of using SMTP to send all email, you
|
<topic-email-backends>`. Instead of using SMTP to send all email, you
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
==============
|
=============
|
||||||
Sending email
|
Sending email
|
||||||
==============
|
=============
|
||||||
|
|
||||||
.. module:: django.core.mail
|
.. module:: django.core.mail
|
||||||
:synopsis: Helpers to easily send email.
|
:synopsis: Helpers to easily send email.
|
||||||
|
@ -364,8 +364,8 @@ subtype. For example::
|
||||||
|
|
||||||
.. _topic-email-backends:
|
.. _topic-email-backends:
|
||||||
|
|
||||||
E-Mail Backends
|
Email backends
|
||||||
===============
|
==============
|
||||||
|
|
||||||
.. versionadded:: 1.2
|
.. versionadded:: 1.2
|
||||||
|
|
||||||
|
@ -384,7 +384,7 @@ The email backend class has the following methods:
|
||||||
left open after mail has been sent.
|
left open after mail has been sent.
|
||||||
|
|
||||||
Obtaining an instance of an email backend
|
Obtaining an instance of an email backend
|
||||||
------------------------------------------
|
-----------------------------------------
|
||||||
|
|
||||||
The :meth:`get_connection` function in ``django.core.mail`` returns an
|
The :meth:`get_connection` function in ``django.core.mail`` returns an
|
||||||
instance of the email backend that you can use.
|
instance of the email backend that you can use.
|
||||||
|
@ -506,7 +506,7 @@ convenience that can be used during development.
|
||||||
.. _topic-custom-email-backend:
|
.. _topic-custom-email-backend:
|
||||||
|
|
||||||
Defining a custom email backend
|
Defining a custom email backend
|
||||||
--------------------------------
|
-------------------------------
|
||||||
|
|
||||||
If you need to change how emails are sent you can write your own email
|
If you need to change how emails are sent you can write your own email
|
||||||
backend. The ``EMAIL_BACKEND`` setting in your settings file is then the
|
backend. The ``EMAIL_BACKEND`` setting in your settings file is then the
|
||||||
|
@ -524,7 +524,7 @@ implementation.
|
||||||
.. _topics-sending-multiple-emails:
|
.. _topics-sending-multiple-emails:
|
||||||
|
|
||||||
Sending multiple emails
|
Sending multiple emails
|
||||||
------------------------
|
-----------------------
|
||||||
|
|
||||||
Establishing and closing an SMTP connection (or any other network connection,
|
Establishing and closing an SMTP connection (or any other network connection,
|
||||||
for that matter) is an expensive process. If you have a lot of emails to send,
|
for that matter) is an expensive process. If you have a lot of emails to send,
|
||||||
|
@ -580,7 +580,7 @@ manually open the connection, you can control when it is closed. For example::
|
||||||
|
|
||||||
|
|
||||||
Testing email sending
|
Testing email sending
|
||||||
======================
|
=====================
|
||||||
|
|
||||||
There are times when you do not want Django to send emails at
|
There are times when you do not want Django to send emails at
|
||||||
all. For example, while developing a Web site, you probably don't want
|
all. For example, while developing a Web site, you probably don't want
|
||||||
|
|
|
@ -1464,7 +1464,7 @@ cause of an failure in your test suite.
|
||||||
.. _topics-testing-email:
|
.. _topics-testing-email:
|
||||||
|
|
||||||
Email services
|
Email services
|
||||||
---------------
|
--------------
|
||||||
|
|
||||||
If any of your Django views send email using :doc:`Django's email
|
If any of your Django views send email using :doc:`Django's email
|
||||||
functionality </topics/email>`, you probably don't want to send email each time
|
functionality </topics/email>`, you probably don't want to send email each time
|
||||||
|
|
Loading…
Reference in New Issue