Change record status: 
Project: 
Introduced in branch: 
4.x
Introduced in version: 
4.0.0-alpha2
Description: 

Several fixes have changed how confirmation works, and the names/comments in some places are confusing. In many places, reference to "combined" should now be "subscribe".

User interface changes

The "newsletter" routes (previously /newsletter/xxx) have been corrected and simplified. These routes were not really related to newsletters, so they are now named simplenews.subscriptions_xxx and the paths are /simplenews/xxx to avoid clashes with other modules. The outdated reference to "combined" has been removed for confirm routes. The reference to "confirm" has been removed from the subscription routes because they indicate a new action rather than a confirmation of a previous one.

  • simplenews.newsletter_confirm_combined => simplenews.subscriptions_confirm
  • /newsletter/confirm/combined/{snid}/{timestamp}/{hash} => /simplenews/confirm/{snid}/{timestamp}/{hash}
  • simplenews.newsletter_confirm_subscription => simplenews.subscriptions_remove or simplenews.subscriptions_add
  • /newsletter/confirm/{action}/{snid}/{newsletter_id}/{timestamp}/{hash} => /simplenews/{action}/{snid}/{newsletter_id}/{timestamp}/{hash}
  • Same for the "immediate" variations
  • simplenews.newsletter_subscriptions_arguments => simplenews.subscriptions_manage
  • /newsletter/subscriptions/{snid}/{timestamp}/{hash} => /simplenews/manage/{snid}/{timestamp}/{hash}
  • simplenews.newsletter_subscriptions => simplenews.subscriptions
  • /newsletter/subscriptions => /simplenews/subscriptions

API changes

  • MailBuilderInterface::buildCombinedMail() changed to buildSubscribeMail()
  • MailerInterface::sendCombinedConfirmation() changed to sendSubscribeConfirmation()
  • Token combined-url changed to confirm-url. The old value still works with a deprecation notice.

Data model changes

In simplenews.settings there some changes to subscriptions settings. Sites are automatically migrated on upgrade, including fixing any references to the changed token.

  • confirm_combined_subject => confirm_subject
  • confirm_combined_body => confirm_body
  • Remove combined_body_unchanged
Impacts: 
Site builders, administrators, editors
Module developers