npm install apostrophe-signup
// in app.jsmodules:'apostrophe-signup':// How long a signup email remains validhours: 48// Apostophe group newly signed-up users are added to,// with optional permissionsgroup:title: 'signup'// Let them create apostrophe blog posts (which would need// to be a module enabled in your project) and upload files// to attach to thempermissions: 'edit-apostrophe-blog' 'edit-attachment'// defaultssignupUrl: '/signup'signupConfirmUrl: '/signup-confirm'afterSignupUrl: '/'// Allow the user to enter a subset of the// fields in your `apostrophe-users` schema as// they are signing up. These are the defaults.// They will always be asked for their email address// and password. If you leave `username` off this list,// the user can only log in with their email address.fields: 'firstName' 'lastName' 'username'// The apostrophe-email module must be configured'apostrophe-email':// See the nodemailer documentation, many// different transports are available, this one// matches how PHP does it on Linux serversnodemailer:sendmail: truenewline: 'unix'path: '/usr/sbin/sendmail'
Lets the public sign up for accounts. The user must receive an email at a unique address and confirm their account.
The apostrophe-email module must be configured. See sending email from your Apostrophe project.
Try going to
Overriding and styling the signup page
You may override the
views/signup.html template of this module by copying it to
lib/modules/apostrophe-signup/views in your own project. As always, do not edit the copy in
You may output the signup form markup yourself, but each input element must be nested in a "fieldset" element, which need not be of that type but must have the right
data-name attribute. Inspect the standard markup to see what this looks like. Tolerance for changes of this kind varies from schema field type to schema field type.
Overriding the signup confirmation email
views/signupEmail.html from this module to the
lib/modules/apostrophe-signup/views/signupEmail.html folder of your own project. As usual, HTML in email is extremely limited, so keep your expectations basic. This has nothing to do with Apostrophe and everything to do with email clients.
If confirmation emails do not arrive
You need a better
nodemailer configuration. The example configuration above assumes
postfix or a similar service is installed on your server and well-configured for reliable delivery. For best results, configure nodemailer to send mail via a legitimate account or, for higher volumes, via a trusted transactional email service like Postmark or Amazon Simple Email Service. For more information see sending email from your Apostrophe project.
If the signup form yields an error
As the message shown to the user says, this may be as simple as a duplicate email address or username. That is the most common reason.
However if this always occurs your
nodemailer configuration might not be working at all. Review the server console error messages, and see above.
Giving the user special attention after signup
You can set the
afterSignupUrl option to any URL you wish.
req.session.signup is set to
true for the duration of
the user's first session. You can detect this in middleware,