From 902155da4cc48dbb99c7f975fb98efef81663c22 Mon Sep 17 00:00:00 2001 From: Schuyler Jager Date: Mon, 16 Mar 2015 16:57:52 -0400 Subject: [PATCH 1/4] Update gmail.rst There are issues with the current docs as they don't address certain user configurations that prevent Symfony from emailing from their app. Mentioning two factor authentication and the less secure app setting is in my opinion, paramount. Reference: http://stackoverflow.com/q/29085617/1188035 --- cookbook/email/gmail.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/cookbook/email/gmail.rst b/cookbook/email/gmail.rst index 6a64a82e1ea..1898e7c9b29 100644 --- a/cookbook/email/gmail.rst +++ b/cookbook/email/gmail.rst @@ -75,3 +75,9 @@ You're done! The ``gmail`` transport is simply a shortcut that uses the ``smtp`` transport and sets ``encryption``, ``auth_mode`` and ``host`` to work with Gmail. + +.. note:: + + Depending on your Gmail account settings, you may get authentication errors within your app. + You should ensure two-factor authentication and [also allow less secure apps to access your + account](https://support.google.com/accounts/answer/6010255) From 1818223a8757040172d6a9ed7e1bf7ae6c0f5f65 Mon Sep 17 00:00:00 2001 From: Schuyler Jager Date: Wed, 25 Mar 2015 14:45:28 -0400 Subject: [PATCH 2/4] Revisions to the gmail.rst doc Revisions concerning the 2-Step-Verification and correct documentation syntax. Thanks @WouterJ and @javiereguiluz --- cookbook/email/gmail.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/cookbook/email/gmail.rst b/cookbook/email/gmail.rst index 1898e7c9b29..7524847b62a 100644 --- a/cookbook/email/gmail.rst +++ b/cookbook/email/gmail.rst @@ -79,5 +79,9 @@ You're done! .. note:: Depending on your Gmail account settings, you may get authentication errors within your app. - You should ensure two-factor authentication and [also allow less secure apps to access your - account](https://support.google.com/accounts/answer/6010255) + If your Gmail account uses 2-Step-Verification, you should `generate an App password`_ to use for your + ``mailer_password`` parameter. + You should also ensure that you `allow less secure apps to access your Gmail account`_. + +.. _`generate an App password`: https://support.google.com/accounts/answer/185833 +.. _`also allow less secure apps to access your account`: https://support.google.com/accounts/answer/6010255 From 4098376e67a38fe9ec3ff4443a0cc044aabfa309 Mon Sep 17 00:00:00 2001 From: Schuyler Jager Date: Wed, 25 Mar 2015 14:46:25 -0400 Subject: [PATCH 3/4] Reflect links correctly in gmail.rst --- cookbook/email/gmail.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cookbook/email/gmail.rst b/cookbook/email/gmail.rst index 7524847b62a..637bc7b6445 100644 --- a/cookbook/email/gmail.rst +++ b/cookbook/email/gmail.rst @@ -84,4 +84,4 @@ You're done! You should also ensure that you `allow less secure apps to access your Gmail account`_. .. _`generate an App password`: https://support.google.com/accounts/answer/185833 -.. _`also allow less secure apps to access your account`: https://support.google.com/accounts/answer/6010255 +.. _`allow less secure apps to access your Gmail account`: https://support.google.com/accounts/answer/6010255 From c9024d6ed74de3861194404d11233c785f439607 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Tue, 23 Jun 2015 17:29:46 +0200 Subject: [PATCH 4/4] Fixed some minor syntax issues. --- cookbook/email/gmail.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/cookbook/email/gmail.rst b/cookbook/email/gmail.rst index 637bc7b6445..9f925cad224 100644 --- a/cookbook/email/gmail.rst +++ b/cookbook/email/gmail.rst @@ -78,10 +78,10 @@ You're done! .. note:: - Depending on your Gmail account settings, you may get authentication errors within your app. - If your Gmail account uses 2-Step-Verification, you should `generate an App password`_ to use for your - ``mailer_password`` parameter. + Depending on your Gmail account settings, you may get authentication errors + within your app. If your Gmail account uses 2-Step-Verification, you should + `generate an App password`_ to use for your ``mailer_password`` parameter. You should also ensure that you `allow less secure apps to access your Gmail account`_. - + .. _`generate an App password`: https://support.google.com/accounts/answer/185833 .. _`allow less secure apps to access your Gmail account`: https://support.google.com/accounts/answer/6010255