/meteor-accounts-guest

Automatically add visitor as anonymous guest with userId fo MeteorJS

Primary LanguageJavaScriptMIT LicenseMIT

accounts-guest

Automatically add visitor as anonymous guest with userId

##Features

  • each non-logged in visitor gets a userId, accessible via Accounts and Meteor:userId()
  • includes configurable cleanup function

##Installation

meteor add accounts-base
meteor add accounts-password
meteor add artwells:accounts-guest

and you are done!

optionally (to clean out old guest accounts) in server-only code

Accounts.removeOldGuests([time before]);

Now Meteor.userId() will be populated for each new visitor, including across reloads

##Examples

/* clean out all guest accounts more than 24 hours old (default behavior) */
Accounts.removeOldGuests();

or

/* clean out all guest accounts more than 2 hours old */
var before = new Date();
before.setHours(before.getHours() - 2);
Accounts.removeOldGuests(before);

##Options (Set in server code at start up)

  • AccountsGuest.enabled, default true. Automatically logs in all visitors.
  • AccountsGuest.forced, default true. Will force recently logged out accounts into guest mode.

##Option Examples

In code available to server, to temporarily or conditionally disable guest login

AccountsGuest.enabled = false

In code available to client, to temporarily or conditionally disable guest login after user logout

AccountsGuest.enabled = true

##TODO

  • tests for forced, and enabled options
  • Allow guest session merged into new session if a visitor logs in
  • Allow merged session/other variables to be specified in config