Add email default settings, examples, formatting and images added (#128)

* Update default_settings.rst

* Create gmail.rst

* Create smtp2go.rst

* Update smtp2go.rst

* Update gmail.rst

* Update gmail.rst

* Update gmail.rst

* add images

* images add

* image add

* Update smtp2go.rst

* Update smtp2go.rst

* Update gmail.rst

* Update gmail.rst

* Update smtp2go.rst

* Update smtp2go.rst

* Update smtp2go.rst

* image add

source/advanced/default_settings.rst

@@ -165,7 +165,36 @@ Editor
 Email
 ^^^^^^^
 
-
+This is where you configure email settings to receive email notifications of voicemail, missed calls and faxes.
+
+Here are some example settings for some of the most common email providers.
+
+*  `SMTP2GO <http://docs.fusionpbx.com/en/latest/advanced/default_settings/smtp2go.html>`_
+*  `GMAIL <http://docs.fusionpbx.com/en/latest/advanced/default_settings/gmail.html>`_
+
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| Default Setting Subcategory | Default Setting Name | Default Setting Value          | Default Setting Enabled | Default Setting Description                                                       |
++=============================+======================+================================+=========================+===================================================================================+
+| smtp_host                   | text                 | mail.server.provider.com       | TRUE                    |  email providers server address                                                   |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from                   | text                 | [email protected] | TRUE                    |  smtp from emaill address                                                         |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_port                   | numeric              | 587                            | TRUE                    | port number of the mail server provider                                           |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from_name              | text                 | Voicemail                      | TRUE                    |  smtp from name                                                                   |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_auth                   | text                 | TRUE                           | TRUE                    |  If smtp auth is required                                                         |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_username               | text                 |  user name                     | TRUE                    |  typically the email user name                                                    |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_password               | text                 |  supersecurepassword!          | TRUE                    |   typically the email password                                                    |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_secure                 | text                 | tls                            | TRUE                    |  tls or ssl depending on the provider.                                            |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_validate_certificate   | boolean              | TRUE                           | TRUE                    | set to false to ignore SSL certificate warnings e.g. for self-signed certificates |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| method                      | text                 | smtp                           | TRUE                    | smtp|sendmail|mail|qmail                                                          |
++-----------------------------+----------------------+--------------------------------+-------------------------+-----------------------------------------------------------------------------------+
 
 Fax
 ^^^^^^^

source/advanced/default_settings/gmail.rst

@@ -0,0 +1,47 @@
+#########
+Gmail
+#########
+
+
+Goto Advanced > Default Settings and under the ``Email`` Section. Make sure these settings are enabled. Once these values are set press the **Reload** button at the top right of the page.
+
+* There is a good chance you will have to do this via command line on your FusionPBX install https://accounts.google.com/b/0/DisplayUnlockCaptcha
+* If you have a headless install(no desktop gui) then you will have to install lynx.  Lynx is a command line web browser.  For Debian you would type the example below.  Follow the prompts for email address and password.
+
+::
+
+ apt-get install lynx
+ lynx https://accounts.google.com/b/0/DisplayUnlockCaptcha
+
+
+* You may also have to enable less secure apps https://support.google.com/accounts/answer/6010255?hl=en
+
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| Default Setting Subcategory | Default Setting Name | Default Setting Value      | Default Setting Enabled | Default Setting Description                                                       |
++=============================+======================+============================+=========================+===================================================================================+
+| smtp_host                   | text                 | smtp.gmail.com             | False                   |  email providers server address                                                   |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from                   | text                 | [email protected]     | True                    |  smtp from emaill address                                                         |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_port                   | numeric              | 587                        | True                    | port number of the mail server provider                                           |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from_name              | text                 | Voicemail                  | True                    |  smtp from name                                                                   |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_auth                   | text                 | TRUE                       | True                    |  smtp auth is required                                                            |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_username               | text                 | [email protected]     | True                    |  Use the full email address                                                       |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_password               | text                 | ************************** | True                    |   typically the email password                                                    |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_secure                 | text                 | tls                        | True                    |  tls or ssl depending on the provider.                                            |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_validate_certificate   | boolean              | TRUE                       | True                    | set to false to ignore SSL certificate warnings e.g. for self-signed certificates |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| method                      | text                 | smtp                       | True                    | smtp|sendmail|mail|qmail                                                          |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+
+To see if there are any failed email attempts goto Status > Emails.  Once the issue causing the emails to fail is found you can click to resent them.
+
+.. Note::
+       The log is stored in the /tmp directory.
+

source/advanced/default_settings/smtp2go.rst

@@ -0,0 +1,62 @@
+#########
+SMTP2GO
+#########
+
+
+SMTP2GO is a paid email service for sending email.  They do however have 1,000 free messages a month and paid plans that are reasonable.
+
+1. Sign up for the service
+
+.. image:: ../../_static/images/advanced/default_settings/fusionpbx_smtp2go.jpg
+        :scale: 85%
+
+
+
+2. After you confirm your email, sign in. You can create an smtp user at this screen or in the next step.
+
+.. image:: ../../_static/images/advanced/default_settings/fusionpbx_smtp2go3.jpg
+        :scale: 85%
+
+
+3. Go to Settings > Users and create an smtp user or additional smtp users.
+
+.. image:: ../../_static/images/advanced/default_settings/fusionpbx_smtp2go_users.jpg
+        :scale: 85%
+
+4. You can set authentication by ip address. It's a good idea to set the limit here also from Unlimited to match which plan you choose.
+
+.. image:: ../../_static/images/advanced/default_settings/fusionpbx_smtp2go1.jpg
+        :scale: 85%
+
+5. Set the domain to your domain to make delivery seem as it came right from your own mail server.  This can help sending to strict email domains.
+
+.. image:: ../../_static/images/advanced/default_settings/fusionpbx_smtp2go2.jpg
+        :scale: 85%
+
+
+6. From your FusionPBX server install go to Advanced > Default Settings > Email section.
+
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| Default Setting Subcategory | Default Setting Name | Default Setting Value      | Default Setting Enabled | Default Setting Description                                                       |
++=============================+======================+============================+=========================+===================================================================================+
+| smtp_host                   | text                 | mail.smtp2go.com           | True                    |  email providers server address                                                   |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from                   | text                 | [email protected]     | True                    |  smtp from emaill address                                                         |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_port                   | numeric              | 587                        | True                    | port number of the mail server provider                                           |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_from_name              | text                 | Voicemail                  | True                    |  smtp from name                                                                   |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_auth                   | text                 | TRUE                       | True                    |  smtp auth is required                                                            |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_username               | text                 | [email protected]     | True                    |  Use the full email address                                                       |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_password               | text                 | ************************** | True                    |   typically the email password                                                    |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_secure                 | text                 | tls                        | True                    |  tls or ssl depending on the provider.                                            |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| smtp_validate_certificate   | boolean              | TRUE                       | True                    | set to false to ignore SSL certificate warnings e.g. for self-signed certificates |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+| method                      | text                 | sendmail                   | False                   | smtp|sendmail|mail|qmail                                                          |
++-----------------------------+----------------------+----------------------------+-------------------------+-----------------------------------------------------------------------------------+
+