NewsLoopVersion 1.0.0 · offline copyGuides

Newsletter, push notifications and statistics ​

Newsletter ​

Go to Readers → Newsletter.

The Newsletter screen

Before you start ​

Newsletters go through your site's email settings (System → Site settings → Email). For more than a few hundred subscribers, use a sending service with SMTP, such as Mailgun, Amazon SES, Brevo or Postmark, rather than your host's mail server. While email is not set up, the Newsletter screen says so and emails are only written to the log.

Add your postal address under Footer: many countries require it. The unsubscribe link is added for you.

How readers sign up ​

Sending ​

The automatic digest ​

Under Automatic digest, choose every day or every week, the day and the time. NewsLoop sends the most read articles of the period, topped up with the latest ones.

Subscribers ​

Subscribers lists everyone, with a CSV download for moving to another service. Add subscribers takes a pasted list, only of people who agreed to get your newsletter. Removing someone deletes their address for good.

Mailchimp is optional: add your API key and audience ID, and every sign-up and departure is copied there.

Push notifications ​

Go to Readers → Push notifications. Push uses Firebase Cloud Messaging, which is free.

The Push notifications screen

Set up Firebase (admin) ​

  1. Create a project at console.firebase.google.com.
  2. Project settings → Service accounts → Generate new private key. Paste the whole file into Service account and save. Click Test the connection.
  3. For alerts on the website: in Project settings → General, add a web app and copy its API key, app ID and sender ID. In Cloud Messaging → Web push certificates, generate a key pair and copy it. Tick Offer alerts to website readers.

The mobile app gets alerts through the same Firebase project.

Sending ​

On the website, readers are offered alerts once, after they have read an article for a while, and can turn them off with the link in the footer.

Statistics ​

Readers → Statistics shows article views counted by the site itself, without cookies, for the last 7, 30 or 90 days:

The Statistics screen: views over time and the most read articles

The dashboard shows today's views, the most read articles, and what needs attention, such as articles waiting for review, comments to check, new feed stories, members and newsletter subscribers. Each person sees only the cards for work they can do.

Troubleshooting ​

Emails:

Newsletters:

Push notifications: