SendGrid Click Tracking Exclusion

Here's how you can achieve this:

### 1. Add the `data-unsubscribe` Attribute
For any link you want to exclude from click tracking, include the `data-unsubscribe` attribute in the “ tag. For example:

<a href="https://example.com/specific-link" data-unsubscribe>Visit this page</a>

This tells SendGrid to bypass click tracking for that particular link.

### 2. Apply It in WordPress
In WordPress, there are two primary ways to add the `data-unsubscribe` attribute:

#### a. If the Link is Hardcoded in a Template
Edit the template file where the link is defined and add the `data-unsubscribe` attribute:

<a href="https://example.com/specific-link" data-unsubscribe>Visit this page</a>

#### b. If the Link is in the Editor (Gutenberg or Classic Editor)
You can manually add the attribute in the HTML view of the block editor:
1. Open the WordPress block editor.
2. Switch to the HTML view of the block where the link is.
3. Add the `data-unsubscribe` attribute to the desired “ tag.

For example:

<a href="https://example.com/specific-link" data-unsubscribe>Visit this page</a>

### 3. Programmatically Add the Attribute
If you want to programmatically exclude specific URLs or links from tracking, you can use WordPress filters to modify the content dynamically. For example:

add_filter('the_content', function($content) {
    $excluded_urls = ['https://example.com/specific-link'];
    
    foreach ($excluded_urls as $url) {
        $pattern = '/<as+href="' . preg_quote($url, '/') . '"/i';
        $replacement = '<a href="' . $url . '" data-unsubscribe';
        $content = preg_replace($pattern, $replacement, $content);
    }
    
    return $content;
});

### 4. Use SendGrid Suppression Features
If you’re using an API or plugin to send emails, ensure that your integration respects the `data-unsubscribe` attribute or has a feature for excluding specific URLs from click tracking.

By combining these methods, you can control which links are excluded from click tracking without disabling the feature for all links.

### 1. Override the Default Password Reset Email

WordPress uses the `retrieve_password` function to send password reset emails. You can modify the email content and add the `data-unsubscribe` attribute to the password reset link using the `retrieve_password_message` filter.

Add the following code to your theme's `functions.php` file or a custom plugin:

add_filter('retrieve_password_message', function($message, $key, $user_email) {
    // Get the site name
    $site_name = wp_specialchars_decode(get_option('blogname'), ENT_QUOTES);

    // Generate the password reset link
    $reset_link = network_site_url("wp-login.php?action=rp&key=$key&login=" . rawurlencode($user_email), 'login');

    // Customize the email message with the data-unsubscribe attribute
    $message = "Someone requested a password reset for your account at $site_name.nn";
    $message .= "If this was you, you can reset your password using the link below:nn";
    $message .= '<a href="' . esc_url($reset_link) . '" data-unsubscribe>Reset Your Password</a>' . "nn";
    $message .= "If you did not request this, you can safely ignore this email.";

    return $message;
}, 10, 3);

### Explanation:
1. **Filter Hook**: The `retrieve_password_message` filter modifies the email content generated for password reset requests.
2. **Custom Reset Link**: The reset link is generated using the `$key` (reset key) and the `$user_email` (user's email).
3. **Added `data-unsubscribe` Attribute**: The `data-unsubscribe` attribute is added directly to the “ tag in the email.

### 2. Test the Password Reset Email
1. Go to the WordPress login page and click "Forgot Password."
2. Enter a valid email address and request a password reset.
3. Check the email to ensure the link includes the `data-unsubscribe` attribute.

This method ensures that SendGrid will not track the password reset link while leaving tracking enabled for other links in your emails.

Here's how to send the password reset email as an HTML email with the `data-unsubscribe` attribute:

—

### 1. Send HTML Emails for Password Reset
Use the `wp_mail` function to send the email as HTML. Modify the `retrieve_password_message` filter to include the appropriate headers for an HTML email.

Update your code in `functions.php` or a custom plugin:

add_filter('retrieve_password_message', function($message, $key, $user_email) {
    $user = get_user_by('email', $user_email);

    if (!$user) {
        return $message; // Return the default message if user is not found
    }

    // Generate the reset password link
    $reset_link = network_site_url("wp-login.php?action=rp&key=$key&login=" . rawurlencode($user->user_login), 'login');

    // HTML email content
    $html_message = '<p>Someone requested a password reset for your account at ' . get_bloginfo('name') . '.</p>';
    $html_message .= '<p>If this was you, you can reset your password using the link below:</p>';
    $html_message .= '<p><a href="' . esc_url($reset_link) . '" data-unsubscribe>Reset Your Password</a></p>';
    $html_message .= '<p>If you did not request this, you can safely ignore this email.</p>';

    // Return the HTML message
    return $html_message;
}, 10, 3);

add_filter('wp_mail_content_type', function() {
    return 'text/html'; // Set email content type to HTML
});

—

### 2. Explanation of Changes
– **HTML Email**: The `wp_mail_content_type` filter sets the content type to `text/html`, allowing HTML tags in emails.
– **Password Reset Link**: The reset link is wrapped in an “ tag with the `data-unsubscribe` attribute.
– **HTML Content**: The email body is written in HTML to include rich formatting and the `data-unsubscribe` attribute.

—

### 3. Test the Changes
1. Trigger a password reset email through the WordPress login page.
2. Check the email in your inbox to verify:
– It is in HTML format.
– The reset link includes the `data-unsubscribe` attribute.

—

### 4. Alternative: Debugging SendGrid Click Tracking
If the `data-unsubscribe` attribute is still not respected, confirm that:
– SendGrid supports the attribute in your email plan.
– No other plugins or configurations (like caching plugins) modify the email before it reaches SendGrid.

You can also use a unique URL parameter (e.g., `?skip_tracking=true`) to identify links in SendGrid that should be excluded and configure exclusions directly in your SendGrid dashboard if the above doesn't work.

Here’s how you can do it:

—

### 1. Customize the WooCommerce Password Reset Email
WooCommerce uses email templates for its email notifications. You can override the password reset email template and include the `clicktracking=false` attribute.

#### Steps:
1. **Locate WooCommerce Email Templates**
WooCommerce's email templates are located in:
`wp-content/plugins/woocommerce/templates/emails/`.

2. **Copy the Password Reset Template**
Copy the `customer-reset-password.php` file to your theme or child theme directory:
`wp-content/themes/your-theme/woocommerce/emails/customer-reset-password.php`.

3. **Modify the Template**
Open the copied file and locate the reset password link. Modify it to include the `clicktracking=false` attribute:

<p><?php printf(
       /* translators: %s: Reset password link */
       esc_html__('Click here to reset your password: %s', 'woocommerce'),
       '<a href="' . esc_url($reset_url) . '" clicktracking="false">' . esc_html__('Reset Password', 'woocommerce') . '</a>'
   ); ?></p>

This adds the `clicktracking="false"` attribute to the link.

—

### 2. Alternative: Use a Hook to Modify the Email Content
If you prefer not to override the template, you can use a WordPress filter to modify the email content dynamically.

Add the following code to your theme’s `functions.php` file or a custom plugin:

add_filter('woocommerce_email_content_customer_reset_password', function($content, $email) {
    // Add the clicktracking attribute to the reset password link
    $content = preg_replace(
        '/<a href="([^"]+)"/',
        '<a href="$1" clicktracking="false"',
        $content
    );

    return $content;
}, 10, 2);

This dynamically adds the `clicktracking="false"` attribute to all links in the "Customer Reset Password" email sent by WooCommerce.

—

### 3. Test the Changes
1. Trigger a password reset email in WooCommerce by attempting to reset a customer's password.
2. Check the email to verify that the password reset link contains `clicktracking="false"`.
3. Confirm that the email is received correctly, and the link works as expected.

—

### 4. Notes
– The `clicktracking="false"` attribute is specific to SendGrid and tells it to skip tracking for that link.
– Make sure SendGrid is configured to respect this attribute in your email configuration.
– If you're using other plugins that modify WooCommerce emails, test thoroughly to avoid conflicts.