Honeypot Guard for Shopify - Installation Guide
==============================================

QUICK INSTALL (5 minutes):

1. Log in to your Shopify Admin panel

2. Navigate to: Online Store > Themes

3. Click "Actions" > "Edit code" on your active theme

4. In the left sidebar, find the "Assets" folder and click "Add a new asset"

5. Upload the honeypot-guard-shopify.js file

6. Open your theme.liquid file (under Layout folder)

7. Add this line just before the closing </body> tag:

   {{ 'honeypot-guard-shopify.js' | asset_url | script_tag }}

8. Click Save

That's it! Honeypot Guard is now protecting your contact forms.

CONFIGURATION:
--------------
Open honeypot-guard-shopify.js and modify the OpenHoneypotConfig object
at the top of the file to customize:

- honeypotEnabled: Enable/disable honeypot fields
- timestampEnabled: Enable/disable timestamp check
- minSubmissionTime: Minimum seconds before submission (default: 2)
- maxSubmissionTime: Maximum form session time (default: 3600)
- cookieCheckEnabled: Verify JavaScript execution via cookie
- rateLimitEnabled: Enable rate limiting
- blockCyrillic: Block Cyrillic characters
- blockHanzi: Block Chinese characters
- blockBengali: Block South Asian scripts
- keywordBlacklist: Comma-separated spam keywords
- emailBlacklist: Block specific emails (*@spam.com for wildcards)
- domainBlacklist: Block specific domains
- gibberishDetectionEnabled: Detect keyboard mashing
- spamThreshold: Spam score threshold (default: 70)
- debug: Enable console logging

MANAGING BLOCKED ENTRIES:
-------------------------
Open browser DevTools console and use:

  OpenHoneypot.viewBlockedEntries()     - View all blocked entries
  OpenHoneypot.unblockEntry(0)          - Unblock entry by index
  OpenHoneypot.removeEntry(0)           - Remove entry completely
  OpenHoneypot.clearBlockedEntries()    - Clear all entries
  OpenHoneypot.exportBlockedEntries()   - Export as JSON
  OpenHoneypot.importBlockedEntries()   - Import from JSON

SUPPORT:
--------
For professional support or custom development:
https://www.mantasdigital.com/

