How to use Accounts.onEmailVerificationLink?

Question

I'm a bit confused about how to use Accounts.onEmailVerificationLink.
The docs are somewhat ambiguous:

Accounts.onEmailVerificationLink(callback)

Register a function to call when an email verification link is clicked in an email sent by Accounts.sendVerificationEmail. This function should be called in top-level code, not inside Meteor.startup().

What is meant exactly by "this function", the callback, or Accounts.onEmailVerificationLink itself?

Anyway, no matter where I put things, I always get this error message on the browser console:

Accounts.onEmailVerificationLink was called more than once. Only one callback added will be executed.

Penner

I'm also getting the Accounts.onEmailVerificationLink was called more than once. Only one callback added will be executed. error even when the Accounts.onEmailVerificationLink() function is empty. Have you figured it out yet? – Pigeontoed

I just removed the call and account verification still works, so it must be handled by the useraccounts: package I guess. – Penner

No, found it at last: it was in the accounts:ui package (of course...) – Penner

Answer 1

If you use collection hooks (https://atmospherejs.com/matb33/collection-hooks), you can do something like this:

Meteor.users.after.update(function (userId, doc, fieldNames, modifier, options) {
  if (!!modifier.$set) {
    //check if the email was verified
    if (modifier.$set['emails.$.verified'] === true) {
      //do something
    }
  }
});

After spending some time trying to hook into the onMailVerificationLink, I find the above to be much less finicky.

Ministry

Answer 2

if (Meteor.isClient) {
  //Remove the old callback
  delete Accounts._accountsCallbacks['verify-email'];
  Accounts.onEmailVerificationLink(function (token, done) {
    Accounts.verifyEmail(token, function (error) {
      if (!error) {
        //Do stuff
      }
      done();

    });
  });
}

Giraldo

Answer 3

The function it is referring to is the 'onEmailVerificationLink' one. It needs to be in some high level client side code. Using the code below I was able to change the functionality for once the email has been verified:

// Override the method that fires when the user clicks the link in the verification email
// for our own behavior.
Accounts.onEmailVerificationLink((token, done) => {
    Accounts.verifyEmail(token, (err) => {
        if (err) {
            console.log("Error: ", err);
        } else {
            console.log("Success");
            // Do whatever you want to on completion, the
            // done() call is the default one.
            done();
        }
    });
});

The console message still appears, but the overridden code runs.

Inapplicable

Answer 4

If you can, you should remove accounts:ui package, which is also use it

meteor remove accounts:ui

and then use a callback to add your own logic

Accounts.onEmailVerificationLink(function(token, done) {
  //your own logic
  //Accounts.verifyEmail(token, (error){
  //  if(!error) {
  //    alert('done!');
  //  }
  //});
});

Quixotism

I don't know this particular callback, but shouldn't done be called at some point? – Sethrida