Newsletter interface ¶
Siso\Bundle\NewsletterBundle\Api\NewsletterInterface
is the common interface for newsletter providers.
subscribeNewsletter/unsubscribeNewsletter¶
The subscribeNewsletter
and unsubscribeNewsletter
methods subscribe or unsubscribe to/from a newsletter with given params
.
You can pass the method any data that is, for example, posted from a form.
If customerProfileData
is provided, attributes from customerProfileData
are used to (un)subscribe to/from the newsletter.
Otherwise, the required attributes must be specified in params
.
Returns a list with the newsletter IDs and whether the action was successful (true/false).
updateNewsletter¶
The updateNewsletter
method updates newsletter details with given params
.
The implementation of this method must dispatch UpdateNewsletterEvent
.
Returns a list with the newsletter IDs and whether the action was successful (true/false).
updateUserEmail¶
The updateUserEmail
method updates newsletter user's email address.
Returns a list with the newsletter IDs and whether the action was successful (true/false).
getEmail¶
The getEmail
method returns the email address.
If CustomerProfileData
is provided, the email from SesUser
is used.
If CustomerProfileData
is not provided, the email from params
is used.
doesUserExistInNewsletter¶
The doesUserExistInNewsletter
method returns true if a user exists in the newsletter provider.
This method checks if the user is known to the newsletter provider, but does not evaluate the status
(whether the user subscribes to the newsletter).
The goal of this method is to find out whether a user exists in the database of the newsletter provider (active/inactive), because even if the user is inactive, they probably already confirmed their email address in the past (e.g. through the double opt-in process).
doesUserSubscribeNewsletter¶
The doesUserSubscribeNewsletter
method reads the user newsletter status - whether the user subscribes to the newsletter - from the provider.
If customerProfileData
is given, attributes from customerProfileData
are used to check the newsletter status.
Otherwise, the required attributes must be specified in params
.
Returns a list with the newsletter IDs and whether the action was successful (true/false).
doesUserSubscribeAtLeastOneNewsletter¶
The doesUserSubscribeAtLeastOneNewsletter
method returns true if the user subscribes to at least one newsletter.
No call to API is done. Instead the result of one of the methods above should be passed as parameter.
getSubscribedNewsletterIds¶
The getSubscribedNewsletterIds
method returns a list of newsletter IDs that a user subscribes to.
No call to API is done. Instead the result of one of the methods above should be passed as parameter.