Troubleshooting

“Generate Link button is disabled”

Problem: Button stays grayed out, can’t click

Cause: Offer not saved yet

Solution:

1. Click 💾 Save button first !
2. Wait for success message
3. Generate Link button becomes enabled
4. Now you can generate link

“Link not found” error when client opens

Problem: Client sees 404 error or “Invalid link”

Possible causes:

1. Offer was deleted

• Check if offer still exists in Quotes → All Quotes
• If deleted, recreate offer and generate new link

2. WordPress permalinks not flushed

• Go to Settings → Permalinks
• Click “Save Changes” (no changes needed)
• Test link again

3. Rewrite rules not registered

• Deactivate plugin
• Reactivate plugin
• Test link again

4. Server configuration issue

• Check .htaccess file exists in WordPress root
• Ensure mod_rewrite enabled on Apache
• For Nginx, ensure rewrite rules configured

“Link has expired” message

Problem: Link worked before, now shows expiration notice

Cause: 30 days elapsed since generation

Solution:

1. Load offer in editor
2. Click Generate Link again
3. New link created with fresh 30-day validity
4. Send new link to client

Prevention:

• Generate link closer to when client needs it
• Or modify code to extend validity period (see “Changing Validity Period” above)

Email notifications not arriving

Problem: No email when client accepts

Diagnosis steps:

1. Check notification email setting

• Go to Quotes → Company Data
• Verify “Notification Email” field
• If empty, uses WordPress admin email
• Test: send test email to this address

2. Check WordPress email logs

• Install “Email Log” plugin
• Check if email was sent by WordPress
• If yes, check spam folder
• If no, WordPress email is broken

3. Test WordPress email

• Go to Settings → General
• Change admin email to test address
• WordPress sends verification email
• If not received, email system broken

4. Fix WordPress email

• Install “WP Mail SMTP” plugin
• Configure with Gmail or SendGrid
• Test sending email
• Re-test acceptance notification

5. Check acceptance data

• After client accepts, go to Quotes → All Quotes
• Check if Status shows “Accepted”
• If not, acceptance might have failed
• Check browser console for JavaScript errors

Link copies “undefined” or blank

Problem: Copy Link button copies wrong text

Cause: Link not generated yet, or JavaScript error

Solution:

1. Generate link first – Click “Generate Link” button
2. Wait for success – See “Link generated successfully!” message
3. Link panel appears – URL should be visible
4. Then click Copy – Now it should work

If still fails:

• Try manual copy: Select URL text → Ctrl+C
• Check browser console for errors (F12 → Console tab)
• Try different browser (Chrome, Firefox)
• Disable browser extensions that might interfere

Views not tracking

Problem: Link works but view count stays at 0

Possible causes:

1. You’re logged into WordPress

• Logged-in admin views don’t count
• Solution: Open link in incognito/private window

2. Bot detection triggered

• Your IP might be flagged as bot
• Check User-Agent string in browser
• Try from different device/network

3. JavaScript disabled

• Some tracking requires JavaScript
• Enable JavaScript in browser
• Try different browser

4. Database write failed

• Check WordPress debug log
• Verify database permissions
• Check if wp_postmeta table writable