Chapters
  1. Overview
  2. Installation
  3. Presets
  4. Post types, series and code
  5. Custom settings
  6. Members and comments
  7. Navigation
  8. Translations
  9. Demo content
  10. Customising
  11. Self-hosting
  12. Troubleshooting
  13. Changelog

Members and comments

Readers sign up through Ghost's Portal or four pages Logbuch adds, the signup and paywall boxes look like a command line, and comments sit at the end of every entry.

Members are readers who sign up with their e-mail address. They get your new entries by mail, can read posts you keep for members, and can comment. Ghost handles all of it, and Logbuch sets it in the same fonts and colours as the rest of your site.

How signing up works

Ghost's sign-up window is called Portal. It opens over your page when a reader clicks Sign in or Get new entries by mail in the header, or a button in a signup card. Ghost draws Portal, so you set its look in Ghost Admin:

  • Settings → Membership → Signup portal → Customize: which fields the window asks for, which tiers it offers, the texts it shows.
  • Settings → Site → Design & branding → Customize → Brand → Accent color: the colour of Portal's buttons. Use a dark colour, because Ghost writes white on it. Each preset's own accent colour works (see Presets).

In the header, readers who aren't signed in see Sign in and the button Get new entries by mail. On phones both are in the menu. Signed-in members see Account instead. If you turn members off entirely (Settings → Membership → Access, "Who should be able to subscribe to your site?" set to Nobody), they disappear, and so do the signup block at the end of posts and the signup box on newsletter posts.

Members pages

Besides Portal, Logbuch has full pages for signing in, signing up, the account and the prices. You only need them if you want a link that opens a page instead of a window, for example "Sign up" in the footer, or a pricing page in the navigation. Ghost shows each one when a page has the matching URL:

Page URLWhat it shows
signina form that sends a sign-in link by e-mail, and a link to sign up
signupa form with name and e-mail, and a link to sign in
accountthe member's address, whether they're a free or paid member, and buttons to manage the account or sign out; visitors who aren't signed in get the sign-in form
pricingyour tiers with their description and benefits, the free one with Join for free, paid ones with a button per monthly and yearly price

To create one, add a page in Ghost Admin (Pages → New page), give it a title such as "Sign in", open the page settings and set the URL to signin. Publish it. The theme draws the heading and the form and ignores the page's own text. The forms send the e-mails through Ghost, as Portal does, so they need Portal to be running (see Self-hosting if you host Ghost yourself).

The demo content includes all four pages and links them in the footer. The pricing page lists your tiers as Ghost knows them: give each tier a description and benefits under Settings → Membership → Tiers.

The signup block

At the end of every post, chapter, release, incident note and TIL, readers who aren't members see a signup block shaped like a command line. It opens with your wordmark's prompt and the command, ~/mira-okafor $ subscribe, then one sentence, "New entries and the next chapter by mail, nothing else.", and a field for the e-mail address after a >, with the button Get new entries by mail. Members don't see it, and posts with the Video Header template leave it out.

The block sends the address to Ghost like Portal's sign-up does, and confirms with "Done. New entries come to your inbox." A newsletter post has its own box instead, "Get the next letter by mail", which asks for name and e-mail.

Posts for members only

In a post's settings, Post access decides who can read it: everyone, members, paid members or specific tiers. Readers without access see the start of the post and, in place of the rest, the same command line with read --rest:

  • For a post for members: "This entry continues for members. Free, by mail, with every new entry.", the button Sign up to read on and "Already a member? Sign in" below it.
  • For a post for paid members or certain tiers, the sentence names the tiers, for example "This entry continues for members on Sponsor."
  • A signed-in member whose tier doesn't include the post gets Upgrade to read on, which opens their plans in Portal.

Ghost decides where the public part ends: in the editor, that's the public preview line. Everything above it stays readable for everyone, so put the opening paragraph and, on a release, the breaking change above it.

Posts for members in lists

When you set a post's access to Members only or Paid-members only in Ghost, every list marks it for visitors who can't read it in full: a dark label with a lock under the post's type, "Members" or "Paid". A post for specific tiers counts as paid. Members whose access covers the post see no label. A TIL note for members shows its excerpt in lists instead of its text, so write one.

Comments

  1. Go to Settings → Membership → Access.
  2. Under "Who can comment on posts?", choose All members or Paid-members only. Nobody turns comments off.
  3. Click Save.

Comments need members, since only signed-in members can write. Once they're on, the meta line of posts, chapters and incident notes shows Comments with their number, and a button # Comments with the number sits at the end of the post. Both open the comments in a panel from the right, over the dimmed page. Escape, Close or a click beside the panel closes it, and a link to #comments, such as https://example.com/my-post/#comments, opens it straight away. The comments only load when a reader opens the panel.

Posts, chapters, releases, incident notes, TIL notes, letters and posts with the Video Header template have comments. Pages and the page variants Wide and Landing don't.

When comments are for paid members only, readers who aren't paid members see "Paid members can join the discussion." in the panel, with a sign-in link. On a post the reader has no access to, it says "The discussion is open to members with access to this post." instead.

Logbuch styles the comments in the theme's fonts and colours, in light and dark mode, and they follow the reader's switch between the two. Ghost controls how they work: the form, the replies, the votes and the menu for each comment.