Allowed Email Domains - User Guide

The "Allowed Email Domains" setting lets you control which email addresses can subscribe to your stock notifications. It's like having a bouncer at your email subscription door - only emails from approved domains get in.

When you configure SMTP with a specific mail service, some providers restrict the use of certain or uncommon domains to prevent spam or misuse. As a result, email addresses using unsupported or random domains may not be allowed to subscribe to product notifications.

And this approach proved to be the best solution.

How does it work?

Simple Example
If you set allowed domains to: `com, net, org`

✅ These emails WILL work:
- customer@example.com
- user@shop.net
- info@company.org

❌ These emails will NOT work:
- customer@example.de
- user@shop.fr
- info@company.co.uk

### What gets checked?
The system only looks at the **ending part** of the email address (called the domain extension):
- `customer@example.com` → checks "com"
- `user@shop.co.uk` → checks "uk"
- `info@company.de` → checks "de"

## Where to find this setting

1. Go to your Shopware admin panel
2. Click Extensions → My Extensions
3. Find ZeobvGetNotified plugin
4. Click Configuration
5. Look for "Allowed Email Domains" field

## How to configure it

### Default setting
The plugin comes with these domains already allowed:
```
com,net,org,de,co,io,gov,edu,uk,us,ca,biz,info,nl,fr,ch,es,it,in,au,pl,cz,eu
```

### Adding more domains
Simply add them separated by commas:
```
com,net,org,de,fr,es,it,nl,be
```

### Allow all domains
Leave the field **completely empty** to allow any email domain.

## What happens when someone tries to subscribe?

### ✅ Allowed domain
- Customer enters: `john@example.com`
- System checks: "com" is in allowed list
- Result: Subscription works normally

### ❌ Blocked domain  
- Customer enters: `john@example.xyz`
- System checks: "xyz" is NOT in allowed list
- Result: Shows error message "Invalid email address"

## Important things to know

### This is a basic filter
- It only checks the email ending (like .com, .de, .fr)
- It doesn't check the full email address
- Someone could still use fake emails from allowed domains

### It works in the customer's browser
- The check happens when the customer clicks "Subscribe"
- If someone disables JavaScript, this check won't work
- It's meant to help reduce spam, not provide security

### No effect on existing subscribers
- This only affects NEW subscriptions
- Existing subscribers are not affected
- Past subscriptions remain active

## Troubleshooting

### "All my customers get error messages"
Check: Is your allowed domains list correct?
Fix: Make sure you included common domains like `com,net,org`

### "The setting doesn't seem to work"
Check Is the field empty?
Fix: If empty, ALL domains are allowed. Add specific domains to restrict.

## Need help?

If customers report they can't subscribe:
1. Ask for their email domain (the part after @)
2. Check if it's in your allowed list
3. Add it if it's legitimate
4. Test with a sample email from that domain