.. include:: /Includes.rst.txt

.. _send-mail-manually:

=========
Send mail
=========

With finishing the schedule step of the wizard, the mailing is added to the MAIL queue, which has its own backend
module. Watch out for the clock icon inside the mail modules on the left side. If you click it, you should see your
mailing in the list now.

.. include:: /Images/MailQueue.rst.txt

The mailing is not sent yet, its progress shows 0%. Normally the mails are sent by the TYPO3 scheduler with the
command :bash:`mail:mass-mailing`, see :ref:`command-controller`.

.. _send-mail-manual-delivery:

Send the mail manually
----------------------

In case you did not have configured the sending command inside the TYPO3 scheduler module yet, you can send the mail
manually for now. The manual delivery is switched off by default, so the queue module shows no button yet. To switch it
on:

#. Click the gear icon at the top right of the queue module to open the configuration dialog.

#. Enter a value greater than 0 in the field "Send per click", for example 50. It is the number of mails that are sent
   with every click on the button.

   .. include:: /Images/MailQueueSendPerClick.rst.txt

#. Press :guilabel:`Save`. The dialog closes and the module is reloaded.

The box "Manual delivery" is shown above the mailing now. Press :guilabel:`Start sending manually`.

.. include:: /Images/MailQueueManualDelivery.rst.txt

This will send the mail immediately to the members of the recipient group you choose in the last step of the MAIL
wizard. If the group has more recipients than "Send per click", press the button again until the progress shows 100%.

.. note::
   The box is only shown, if "Send per click" is greater than 0. Set it to 0 again to switch off the manual delivery,
   for example if mails should only be sent by the scheduler. You can change the value at any time, see
   :ref:`sendPerCycle <confval-sendpercycle>`.

.. note::
   Since MAIL v4 the final recipients are recalculated at the time of delivery start **once** again to add/remove new/removed
   recipients from the given recipient group(s). To stay at the old behaviour go the the extension settings and activate the
   specifyFinalRecipientsInWizard checkbox.

Now go to the mail program of your trust, to receive the recently generated mail.

.. _failed-deliveries:

Failed deliveries
=================

If a mail cannot be delivered to a recipient, for example because the mail server is not reachable, the recipient is
not lost. The delivery is tried again later with increasing waiting times.

Recipients that are waiting for a retry or that failed for good are listed in the queue module below the sending
queue, in the section "Deliveries to be retried or failed". Failed entries are red, waiting entries yellow.

.. include:: /Images/MailQueueFailedDeliveries.rst.txt

Press :guilabel:`Send again` to deliver the mail again with the next run of the sending command. The delete button
drops an entry after you confirmed it in a dialog.

If you enable the extension setting :ref:`enableEmailCorrection <extension-configuration-enable-email-correction>`
(it is disabled by default), you can also correct the email address in the column "Recipient" before you press
:guilabel:`Send again`.

Read more about the :ref:`retry schedule, the alerting and the commands <send-queue>`.