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 tobuildSubscribeMail()MailerInterface::sendCombinedConfirmation()changed tosendSubscribeConfirmation()- Token
combined-urlchanged toconfirm-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