You are here

class SubscriberMassSubscribeForm in Simplenews 8.2

Same name and namespace in other branches
  1. 8 src/Form/SubscriberMassSubscribeForm.php \Drupal\simplenews\Form\SubscriberMassSubscribeForm
  2. 3.x src/Form/SubscriberMassSubscribeForm.php \Drupal\simplenews\Form\SubscriberMassSubscribeForm

Do a mass subscription for a list of email addresses.

Hierarchy

Expanded class hierarchy of SubscriberMassSubscribeForm

1 string reference to 'SubscriberMassSubscribeForm'
simplenews.routing.yml in ./simplenews.routing.yml
simplenews.routing.yml

File

src/Form/SubscriberMassSubscribeForm.php, line 18

Namespace

Drupal\simplenews\Form
View source
class SubscriberMassSubscribeForm extends FormBase {

  /**
   * The language manager.
   *
   * @var \Drupal\Core\Language\LanguageManagerInterface
   */
  protected $languageManager;

  /**
   * The subscription manager.
   *
   * @var \Drupal\simplenews\Subscription\SubscriptionManagerInterface
   */
  protected $subscriptionManager;

  /**
   * The email validator.
   *
   * @var \Drupal\Component\Utility\EmailValidatorInterface
   */
  protected $emailValidator;

  /**
   * Constructs a new SubscriberMassSubscribeForm.
   *
   * @param \Drupal\Core\Language\LanguageManagerInterface $language_manager
   *   The language manager.
   * @param \Drupal\simplenews\Subscription\SubscriptionManagerInterface $subscription_manager
   *   The subscription manager.
   * @param \Drupal\Component\Utility\EmailValidatorInterface $email_validator
   *   The email validator.
   */
  public function __construct(LanguageManagerInterface $language_manager, SubscriptionManagerInterface $subscription_manager, EmailValidatorInterface $email_validator) {
    $this->languageManager = $language_manager;
    $this->subscriptionManager = $subscription_manager;
    $this->emailValidator = $email_validator;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('language_manager'), $container
      ->get('simplenews.subscription_manager'), $container
      ->get('email.validator'));
  }

  /**
   * {@inheritdoc}
   */
  public function getFormId() {
    return 'simplenews_subscriber_mass_subscribe';
  }

  /**
   * {@inheritdoc}
   */
  public function buildForm(array $form, FormStateInterface $form_state) {
    $form['emails'] = [
      '#type' => 'textarea',
      '#title' => $this
        ->t('Email addresses'),
      '#cols' => 60,
      '#rows' => 5,
      '#description' => $this
        ->t('Email addresses must be separated by comma, space or newline.'),
    ];
    $form['newsletters'] = [
      '#type' => 'checkboxes',
      '#title' => $this
        ->t('Subscribe to'),
      '#options' => simplenews_newsletter_list(),
      '#required' => TRUE,
    ];
    foreach (simplenews_newsletter_get_all() as $id => $newsletter) {
      $form['newsletters'][$id]['#description'] = Html::escape($newsletter->description);
    }
    $form['resubscribe'] = [
      '#type' => 'checkbox',
      '#title' => $this
        ->t('Force resubscription'),
      '#description' => $this
        ->t('If checked, previously unsubscribed e-mail addresses will be resubscribed. Consider that this might be against the will of your users.'),
    ];

    // Include language selection when the site is multilingual.
    // Default value is the empty string which will result in receiving emails
    // in the site's default language.
    if ($this->languageManager
      ->isMultilingual()) {
      $options[''] = $this
        ->t('Site default language');
      $languages = $this->languageManager
        ->getLanguages();
      foreach ($languages as $langcode => $language) {
        $options[$langcode] = $language
          ->getName();
      }
      $form['language'] = [
        '#type' => 'radios',
        '#title' => $this
          ->t('Anonymous user preferred language'),
        '#default_value' => '',
        '#options' => $options,
        '#description' => $this
          ->t('New subscriptions will be subscribed with the selected preferred language. The language of existing subscribers is unchanged.'),
      ];
    }
    else {
      $form['language'] = [
        '#type' => 'value',
        '#value' => '',
      ];
    }
    $form['submit'] = [
      '#type' => 'submit',
      '#value' => $this
        ->t('Subscribe'),
    ];
    return $form;
  }

  /**
   * {@inheritdoc}
   */
  public function submitForm(array &$form, FormStateInterface $form_state) {
    $added = [];
    $invalid = [];
    $unsubscribed = [];
    $checked_newsletters = array_keys(array_filter($form_state
      ->getValue('newsletters')));
    $langcode = $form_state
      ->getValue('language');
    $emails = preg_split("/[\\s,]+/", $form_state
      ->getValue('emails'));
    foreach ($emails as $email) {
      $email = trim($email);
      if ($email == '') {
        continue;
      }
      if ($this->emailValidator
        ->isValid($email)) {
        $subscriber = Subscriber::loadByMail($email);

        /** @var \Drupal\simplenews\Entity\Newsletter $newsletter */
        foreach (Newsletter::loadMultiple($checked_newsletters) as $newsletter) {

          // If there is a valid subscriber, check if there is a subscription
          // for the current newsletter and if this subscription has the status
          // unsubscribed.
          $is_unsubscribed = $subscriber ? $subscriber
            ->isUnsubscribed($newsletter
            ->id()) : FALSE;
          if (!$is_unsubscribed || $form_state
            ->getValue('resubscribe') == TRUE) {
            $this->subscriptionManager
              ->subscribe($email, $newsletter
              ->id(), FALSE, 'mass subscribe', $langcode);
            $added[] = $email;
          }
          else {
            $unsubscribed[$newsletter
              ->label()][] = $email;
          }
        }
      }
      else {
        $invalid[] = $email;
      }
    }
    if ($added) {
      $added = implode(", ", $added);
      $this
        ->messenger()
        ->addMessage($this
        ->t('The following addresses were added or updated: %added.', [
        '%added' => $added,
      ]));
      $list_names = [];
      foreach (Newsletter::loadMultiple($checked_newsletters) as $newsletter) {
        $list_names[] = $newsletter
          ->label();
      }
      $this
        ->messenger()
        ->addMessage($this
        ->t('The addresses were subscribed to the following newsletters: %newsletters.', [
        '%newsletters' => implode(', ', $list_names),
      ]));
    }
    else {
      $this
        ->messenger()
        ->addMessage($this
        ->t('No addresses were added.'));
    }
    if ($invalid) {
      $invalid = implode(", ", $invalid);
      $this
        ->messenger()
        ->addError($this
        ->t('The following addresses were invalid: %invalid.', [
        '%invalid' => $invalid,
      ]));
    }
    foreach ($unsubscribed as $name => $subscribers) {
      $subscribers = implode(", ", $subscribers);
      $this
        ->messenger()
        ->addWarning($this
        ->t('The following addresses were skipped because they have previously unsubscribed from %name: %unsubscribed.', [
        '%name' => $name,
        '%unsubscribed' => $subscribers,
      ]));
    }
    if (!empty($unsubscribed)) {
      $this
        ->messenger()
        ->addWarning($this
        ->t("If you would like to resubscribe them, use the 'Force resubscription' option."));
    }

    // Return to the parent page.
    $form_state
      ->setRedirect('entity.simplenews_subscriber.collection');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DependencySerializationTrait::$_entityStorages protected property An array of entity type IDs keyed by the property name of their storages.
DependencySerializationTrait::$_serviceIds protected property An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
FormBase::$configFactory protected property The config factory. 1
FormBase::$requestStack protected property The request stack. 1
FormBase::$routeMatch protected property The route match.
FormBase::config protected function Retrieves a configuration object.
FormBase::configFactory protected function Gets the config factory for this form. 1
FormBase::container private function Returns the service container.
FormBase::currentUser protected function Gets the current user.
FormBase::getRequest protected function Gets the request object.
FormBase::getRouteMatch protected function Gets the route match.
FormBase::logger protected function Gets the logger for a specific channel.
FormBase::redirect protected function Returns a redirect response object for the specified route. Overrides UrlGeneratorTrait::redirect
FormBase::resetConfigFactory public function Resets the configuration factory.
FormBase::setConfigFactory public function Sets the config factory for this form.
FormBase::setRequestStack public function Sets the request stack object to use.
FormBase::validateForm public function Form validation handler. Overrides FormInterface::validateForm 62
LinkGeneratorTrait::$linkGenerator protected property The link generator. 1
LinkGeneratorTrait::getLinkGenerator Deprecated protected function Returns the link generator.
LinkGeneratorTrait::l Deprecated protected function Renders a link to a route given a route name and its parameters.
LinkGeneratorTrait::setLinkGenerator Deprecated public function Sets the link generator service.
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 29
MessengerTrait::messenger public function Gets the messenger. 29
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 1
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
StringTranslationTrait::$stringTranslation protected property The string translation service. 1
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.
SubscriberMassSubscribeForm::$emailValidator protected property The email validator.
SubscriberMassSubscribeForm::$languageManager protected property The language manager.
SubscriberMassSubscribeForm::$subscriptionManager protected property The subscription manager.
SubscriberMassSubscribeForm::buildForm public function Form constructor. Overrides FormInterface::buildForm
SubscriberMassSubscribeForm::create public static function Instantiates a new instance of this class. Overrides FormBase::create
SubscriberMassSubscribeForm::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
SubscriberMassSubscribeForm::submitForm public function Form submission handler. Overrides FormInterface::submitForm
SubscriberMassSubscribeForm::__construct public function Constructs a new SubscriberMassSubscribeForm.
UrlGeneratorTrait::$urlGenerator protected property The url generator.
UrlGeneratorTrait::getUrlGenerator Deprecated protected function Returns the URL generator service.
UrlGeneratorTrait::setUrlGenerator Deprecated public function Sets the URL generator service.
UrlGeneratorTrait::url Deprecated protected function Generates a URL or path for a specific route based on the given parameters.