How are the «send_email» (setSendEmail, getSendEmail) / «email_sent» (setEmailSent, getEmailSent) flags used for an order?

dmitry_fedyuk · July 20, 2017, 1:37pm

The definitions

magento/magento2/blob/2.2.0-RC1.4/app/code/Magento/Sales/Setup/InstallSchema.php#L470-L481


)->addColumn(
    'email_sent',
    \Magento\Framework\DB\Ddl\Table::TYPE_SMALLINT,
    null,
    ['unsigned' => true],
    'Email Sent'
)->addColumn(
    'send_email',
    \Magento\Framework\DB\Ddl\Table::TYPE_SMALLINT,
    null,
    ['unsigned' => true],
    'Send Email'

How are they set?

1. Magento\Sales\Model\Order\Email\Sender\OrderSender::send()

github.com

magento/magento2/blob/2.2.0-RC1.4/app/code/Magento/Sales/Model/Order/Email/Sender/OrderSender.php#L82-L115


/**
 * Sends order email to the customer.
 *
 * Email will be sent immediately in two cases:
 *
 * - if asynchronous email sending is disabled in global settings
 * - if $forceSyncMode parameter is set to TRUE
 *
 * Otherwise, email will be sent later during running of
 * corresponding cron job.
 *
 * @param Order $order
 * @param bool $forceSyncMode
 * @return bool
 */
public function send(Order $order, $forceSyncMode = false)
{
    $order->setSendEmail(true);


    if (!$this->globalConfig->getValue('sales_email/general/async_sending') || $forceSyncMode) {
        if ($this->checkAndSend($order)) {
            $order->setEmailSent(true);
            $this->orderResource->saveAttribute($order, ['send_email', 'email_sent']);
            return true;
        }
    } else {
        $order->setEmailSent(null);
        $this->orderResource->saveAttribute($order, 'email_sent');
    }


    $this->orderResource->saveAttribute($order, 'send_email');


    return false;
}

Magento\Sales\Model\EmailSenderHandler::sendEmails()

github.com

magento/magento2/blob/2.2.0-RC1.4/app/code/Magento/Sales/Model/EmailSenderHandler.php#L62-L81


/**
 * Handles asynchronous email sending
 * @return void
 */
public function sendEmails()
{
    if ($this->globalConfig->getValue('sales_email/general/async_sending')) {
        $this->entityCollection->addFieldToFilter('send_email', ['eq' => 1]);
        $this->entityCollection->addFieldToFilter('email_sent', ['null' => true]);


        /** @var \Magento\Sales\Model\AbstractModel $item */
        foreach ($this->entityCollection->getItems() as $item) {
            if ($this->emailSender->send($item, true)) {
                $this->entityResource->save(
                    $item->setEmailSent(true)
                );
            }
        }
    }
}

dmitry_fedyuk · July 20, 2017, 1:48pm