Facebook Extension for Newsletter

The Facebook Extension for Newsletter is a module which enables subscriptions to your newsletter via the Facebook Connect technology. Users with a Facebook account can subscribe with almost one single click.

Note: your site must use HTTPS to use the Facebook Login.

Getting a Facebook App ID and App Secret

An app ID is required to use the Facebook connect for subscriptions. Here the steps you need to follows on Facebook.

Open the Facebook developer page and on top right find “My apps” and select “Add a new app”. Input an app name and you contact email address and press “Create App ID”.

On next screen, select on the left “Settings/Basic” and you can get the App ID and the App Secret. Copy those values in the extension configuration.

Staying on that page, press “Add a platform” button below the form and select “Website”.

Enter you site home url in the new box. Pay attention to use the correct http or https version.

Save and on the left menu you should see, under products, “Facebook Login”. Click on it and insert in the “Valid OAuth redirect URIs” the URL you can find in the help tab on our Facebook extension configuration.

Save. Now it’s time to make the app available to the public.

On left side menu, choose “App Review” and set to yes the option:

That’s all, now everything should work.

How to offer the Facebook sign up

Nothing happens on your subscription form when this module is active but a new tag will be available. The tag is {facebook_url} and you can add it on subscription page text or on widget text and it will be replaced by an URL which starts the subscription via Facebook.

I used a tag so you’re free to put it where you prefer (on texts managed by Newsletter), but on extension panel the final URL is available if you want to use it directly everywhere else.

Another tag is the {facebook_button} tag, which generates a link that looks like a blue button. This tag should be more immediate to use, but less felxible.

An example of insertion of that tag on the subscription page: select a piece of text which will be the link to subscribe with Facebook, use the link toolbar button and insert as “href” the tag {facebook_url}.

Of course you can add that link around an image and may be on future releases there will be some options to directly add a graphical button.



On widget configuration, since there is not a visual editor, the code to create a link is:

<a href="{facebook_url}">Sign up with Facebook</a>


The tag does not work in the middle of a post content, of course, but you can use the direct link generated by the tag. For example on my site the link generated is:


so in your site it will look like:


but it depend on how and where the blog is installed. The easy way to find how the link looks like is to add the tag on the subscription text or in the subscription widget and copy it or copy it directly from the help tab in the configuration page.

Welcome email or not?

Since Facebook already certified the email address, we do not need to force a double opt in. This is a big advantage over a regular subscription but remember that many users don’t like to use their Facebook account to “connect” to sites, so be sure to always offer the standard subscription alternative.

So when a user subscribes with Facebook it will be stored as confirmed and he should receive the welcome email. If you prefer to not send that email, you can deactivate it on Facebook module configuration. If enabled the standard welcome email will be used.

Pay attention: if you use the welcome email to deliver access to reserved contents, be sure to send it!