Oomph.register_guestmode() call is required only for Lockout Authenticators.
You can call the
dismiss_authenticator_dialog() method if you wish, but you are not required to do so unless you are using a lockout authenticator with no Done button. Calling this method will close the msite dialog inside the Oomph app.
The initial msite page should prompt the user for their authorisation credentials, such as a username and password.
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Unlock Issues</title> </head> <body> <h1> Login </h1> <form action='/login' method='post'> <fieldset> <h3>Please enter your details:</h3> <input name='username' /> <input name='password' /> <input type='submit' value='Submit' /> </fieldset> </form> </body> </html>
On the "login" page specified as the action for the form, you should use the credentials supplied to determine whether or not the user is valid.
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Login failed</title> </head> <body> <h1> Could not grant access to the content. Please try logging in again. </h1> <form action='/login' method='post'> <fieldset> <h3>Please enter your details:</h3> <input name='username' /> <input name='password' /> <input type='submit' value='Submit' /> </fieldset> </form> </body> </html>
You must ensure that you register all subscriptions that the user has access to, by calling register_subscription() once for each subscription time period that the user is allowed to access. This includes subscriptions that have expired. If you do not do this, the user will not be able to restore their purchased issues.
Note that the