OTP by Email for Contact Form 7

Descrição

Use this CF7 extension to enable OTP links to be inserted into confirmation/notification emails sent to email addresses submitted through your CF7 forms. The OTP is a unique link the email inbox user needs to click to confirm their address. The link is valid by default for 72 hours and can be customised.

Instalação

  1. Install Contact Form 7 plugin
  2. Install OTP by Email plugin extension
  3. In CF7 forms with email fields, a mail tag [otp-<field-name>] will be available to insert into your notification/confirmation email which will all a unique time-limited URL for users to confirm their email.
  4. In the form editor page, the OTP tab allows you to set the pages to redirect to when an email is validated or fails due to an outdated link.

Perguntas frequentes

1. Is it possible to change the time-limit for the link validity ?

The unique confirmation link has a 3-day (72 hours) validity by default, you can change it with the following filter,

add_filter('otp_by_email_lifetime', 'otp_by_email_validity',10,3);
function otp_by_email_validity($limit, $email, $form_id){
  //you can set different time limits for different email domains or form ID.
  $limit = 24 * HOUR_IN_SECONDS;  //limit is in seconds.
  return $limit;
}

2. How to retrieve an email that has been validated ?

Use the following filter,

add_filter('otp_by_email_validated', 'otp_validated',10,3);
function otp_validated($url, $email, $form_id){
  //you can identify a validated email and the form ID from which it was submitted.
  //you can also change the URL to which you want to redirect.
  return $url;
}

3. How to retrieve an email that failed due to an outdated link ?

Use the following filter,

add_filter('otp_by_email_failed', 'otp_failed',10,3);
function otp_failed($url, $email, $form_id){
  //you can identify a failed email and the form ID from which it was submitted.
  //you can also change the URL to which you want to redirect.
  return $url;
}

4. Is it possible to get an OTP link for an email programmatically ?

Yes, you can use the following function to retrieve a unique link,

/**
* Funiton to get a link for email validation.
* @param String $email a valid email.
* @param String $form_id the id of the form on which this email was submitted. (Defaults to 0).
* @return String a unique link to validate the email, reurns false if the $email is invalid.
* @since 1.0
*/
$link = get_otp_by_email_link($email, $form_id=0);

Avaliações

Este plugin não tem avaliações.

Contribuidores e programadores

“OTP by Email for Contact Form 7” é software de código aberto. As seguintes pessoas contribuíram para este plugin:

Contribuidores

Registo de alterações

1.1.2

  • fix form ID field bug.

1.1.1

  • changed location of action hook otp_by_email_unique_link_created and added nonce field as attribute.

1.1.0

  • added action hook otp_by_email_unique_link_created
  • added nonce field in otp_by_email_validated filter hook attributes.

1.0.1

  • fix display of tab in admin page.