Kobe/docupulse
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

SMTP Settings

Browse Source
This commit is contained in:
Kobe
2025-06-02 14:30:20 +02:00
parent 694c8df364
commit 765c07316a
9 changed files with 461 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

311
templates/settings/tabs/smtp_settings.html Normal file
View File

@@ -0,0 +1,311 @@
{% macro smtp_settings_tab(smtp_settings, csrf_token) %}
<div class="row">
<div class="col-12">
<div class="card shadow-sm">
<div class="card-body">
<form id="smtpSettingsForm" method="POST" action="{{ url_for('main.update_smtp_settings') }}">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="row">
<!-- SMTP Server Settings -->
<div class="col-md-6 mb-4">
<h6 class="mb-3">SMTP Server Settings</h6>
<div class="mb-3">
<label for="smtp_host" class="form-label">
SMTP Host
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="SMTP Host Information"
data-bs-content="
<strong>Common SMTP Hosts:</strong><br>
• Gmail: smtp.gmail.com<br>
• Office 365: smtp.office365.com<br>
• Outlook: smtp-mail.outlook.com<br>
• Yahoo: smtp.mail.yahoo.com<br>
• Zoho: smtp.zoho.com<br>
• SendGrid: smtp.sendgrid.net<br>
• Amazon SES: email-smtp.[region].amazonaws.com<br>
• Custom Domain: mail.yourdomain.com or smtp.yourdomain.com<br><br>
<strong>Host Configuration Tips:</strong><br>
• Always use the official SMTP server of your email provider<br>
• For custom domains, check with your hosting provider<br>
• Some providers may require specific subdomains<br>
• Ensure the host is accessible from your server's network"
style="cursor: pointer;"></i>
</label>
<input type="text" class="form-control" id="smtp_host" name="smtp_host"
value="{{ smtp_settings.smtp_host if smtp_settings else '' }}" required>
</div>
<div class="mb-3">
<label for="smtp_port" class="form-label">
SMTP Port
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="SMTP Port Information"
data-bs-content="
<strong>Common SMTP Ports:</strong><br>
<strong>Port 587 (Recommended):</strong><br>
• Default for TLS encryption<br>
• Most widely supported<br>
• Best for modern email systems<br><br>
<strong>Port 465:</strong><br>
• Used for SSL encryption<br>
• Older but still secure<br>
• Some providers prefer this port<br><br>
<strong>Port 25:</strong><br>
• Traditional SMTP port<br>
• Often blocked by ISPs<br>
• Not recommended for modern use<br><br>
<strong>Port 2525:</strong><br>
• Alternative to port 587<br>
• Used when port 587 is blocked<br>
• Common in cloud environments<br><br>
<strong>Port Selection Guidelines:</strong><br>
• Always use encrypted ports (587 or 465) in production<br>
• Check your email provider's documentation<br>
• Some networks may block certain ports<br>
• Port 25 is often blocked by ISPs"
style="cursor: pointer;"></i>
</label>
<input type="number" class="form-control" id="smtp_port" name="smtp_port"
value="{{ smtp_settings.smtp_port if smtp_settings else '587' }}" required>
</div>
<div class="mb-3">
<label for="smtp_security" class="form-label">
Security
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="Security Best Practices"
data-bs-content="
<strong>Security Options:</strong><br>
<strong>TLS (Recommended):</strong><br>
• Uses port 587<br>
• Encrypts connection after establishing it<br>
• Most widely supported<br><br>
<strong>SSL:</strong><br>
• Uses port 465<br>
• Encrypts connection from the start<br>
• Older but still secure<br><br>
<strong>None:</strong><br>
• Not recommended for production use<br>
• May be blocked by many providers<br>
• Only use for testing"
style="cursor: pointer;"></i>
</label>
<select class="form-select" id="smtp_security" name="smtp_security">
<option value="tls" {% if smtp_settings and smtp_settings.smtp_security == 'tls' %}selected{% endif %}>TLS</option>
<option value="ssl" {% if smtp_settings and smtp_settings.smtp_security == 'ssl' %}selected{% endif %}>SSL</option>
<option value="none" {% if smtp_settings and smtp_settings.smtp_security == 'none' %}selected{% endif %}>None</option>
</select>
</div>
</div>
<!-- Authentication Settings -->
<div class="col-md-6 mb-4">
<h6 class="mb-3">Authentication</h6>
<div class="mb-3">
<label for="smtp_username" class="form-label">
Username
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="Username Guidelines"
data-bs-content="
<strong>Username Requirements:</strong><br>
• For Gmail: Use your full email address<br>
• For Office 365: Usually your email address<br>
• For custom domains: Check with your email provider<br>
• If using 2FA, you may need to generate an App Password<br><br>
<strong>Best Practices:</strong><br>
• Always use the email address associated with your SMTP account<br>
• For shared accounts, use a dedicated service account<br>
• Keep track of which username is used for which purpose"
style="cursor: pointer;"></i>
</label>
<input type="text" class="form-control" id="smtp_username" name="smtp_username"
value="{{ smtp_settings.smtp_username if smtp_settings else '' }}" required>
</div>
<div class="mb-3">
<label for="smtp_password" class="form-label">
Password
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="Password Security"
data-bs-content="
<strong>Password Requirements:</strong><br>
• For Gmail with 2FA: Use an App Password<br>
• For Office 365: May require an App Password if 2FA is enabled<br>
• Never use your main account password for SMTP<br>
• Regularly rotate your SMTP passwords<br><br>
<strong>Security Best Practices:</strong><br>
• Use strong, unique passwords<br>
• Store passwords securely<br>
• Monitor for unauthorized access<br>
• Set up alerts for failed login attempts"
style="cursor: pointer;"></i>
</label>
<input type="password" class="form-control" id="smtp_password" name="smtp_password"
value="{{ smtp_settings.smtp_password if smtp_settings else '' }}" required>
</div>
</div>
<!-- Sender Settings -->
<div class="col-md-6 mb-4">
<h6 class="mb-3">Sender Information</h6>
<div class="mb-3">
<label for="smtp_from_email" class="form-label">
From Email
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="From Email Guidelines"
data-bs-content="
<strong>Email Requirements:</strong><br>
• Must match the domain of your SMTP server<br>
• Should be a valid, monitored email address<br>
• Use a dedicated sending address (e.g., no-reply@yourdomain.com)<br>
• Ensure the domain has proper SPF, DKIM, and DMARC records<br><br>
<strong>Best Practices:</strong><br>
• Use a consistent sending address<br>
• Set up proper email forwarding<br>
• Monitor bounce rates and spam reports<br>
• Keep the address active and monitored"
style="cursor: pointer;"></i>
</label>
<input type="email" class="form-control" id="smtp_from_email" name="smtp_from_email"
value="{{ smtp_settings.smtp_from_email if smtp_settings else '' }}" required>
</div>
<div class="mb-3">
<label for="smtp_from_name" class="form-label">
From Name
<i class="fas fa-info-circle ms-1"
style="color: var(--secondary-color); cursor: pointer;"
data-bs-toggle="popover"
data-bs-html="true"
data-bs-title="From Name Best Practices"
data-bs-content="
<strong>Name Guidelines:</strong><br>
• Use your company or application name<br>
• Keep it consistent across all emails<br>
• Include department name if relevant (e.g., 'DocuPulse Support')<br>
• Avoid using personal names unless sending personal communications<br>
• Keep it under 50 characters for best display<br><br>
<strong>Best Practices:</strong><br>
• Make it recognizable to recipients<br>
• Avoid special characters<br>
• Consider mobile display length<br>
• Test how it appears in different email clients"
style="cursor: pointer;"></i>
</label>
<input type="text" class="form-control" id="smtp_from_name" name="smtp_from_name"
value="{{ smtp_settings.smtp_from_name if smtp_settings else '' }}" required>
</div>
</div>
<!-- Email Deliverability Best Practices -->
<div class="col-12 mb-4">
<div class="alert alert-info">
<h6 class="alert-heading mb-2">
<i class="fas fa-info-circle me-2"></i>Email Deliverability Best Practices
</h6>
<p class="mb-2">To prevent your emails from being marked as spam, ensure you have:</p>
<ul class="mb-0">
<li><strong>SPF Record:</strong> Add a TXT record to your domain's DNS settings:
<code>v=spf1 include:_spf.your-email-provider.com ~all</code>
</li>
<li><strong>DKIM:</strong> Add the DKIM record provided by your email provider to your domain's DNS settings</li>
<li><strong>DMARC:</strong> Add a TXT record named "_dmarc" with:
<code>v=DMARC1; p=none; rua=mailto:dmarc-reports@yourdomain.com</code>
</li>
<li><strong>Reverse DNS (PTR):</strong> Ensure your sending IP has a valid reverse DNS record</li>
<li><strong>Domain Age:</strong> Use a domain that's at least 30 days old</li>
<li><strong>Email Volume:</strong> Start with a small volume and gradually increase</li>
</ul>
</div>
</div>
</div>
<!-- Test Connection Button -->
<div class="mb-4">
<button type="button" class="btn btn-outline-primary" onclick="testSmtpConnection()">
<i class="fas fa-plug me-2"></i>Test Connection
</button>
<div id="testConnectionResult" class="mt-2"></div>
</div>
<!-- Save Button -->
<div class="d-flex justify-content-end">
<button type="submit" class="btn btn-primary">
<i class="fas fa-save me-2"></i>Save Settings
</button>
</div>
</form>
</div>
</div>
</div>
</div>
<script>
// Initialize all popovers
document.addEventListener('DOMContentLoaded', function() {
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'));
var popoverList = popoverTriggerList.map(function(popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl, {
html: true,
trigger: 'hover',
placement: 'right'
});
});
});
function testSmtpConnection() {
const form = document.getElementById('smtpSettingsForm');
const resultDiv = document.getElementById('testConnectionResult');
const button = event.target;
const originalText = button.innerHTML;
// Disable button and show loading state
button.disabled = true;
button.innerHTML = '<i class="fas fa-spinner fa-spin me-2"></i>Testing...';
// Get form data
const formData = new FormData(form);
// Send test request
fetch('/settings/test-smtp', {
method: 'POST',
headers: {
'X-CSRF-Token': '{{ csrf_token }}',
'Content-Type': 'application/json',
},
body: JSON.stringify(Object.fromEntries(formData))
})
.then(response => response.json())
.then(data => {
if (data.success) {
resultDiv.innerHTML = '<div class="alert alert-success"><i class="fas fa-check-circle me-2"></i>Connection successful!</div>';
} else {
resultDiv.innerHTML = `<div class="alert alert-danger"><i class="fas fa-times-circle me-2"></i>Connection failed: ${data.error}</div>`;
}
})
.catch(error => {
resultDiv.innerHTML = `<div class="alert alert-danger"><i class="fas fa-times-circle me-2"></i>Error: ${error.message}</div>`;
})
.finally(() => {
// Restore button state
button.disabled = false;
button.innerHTML = originalText;
});
}
</script>
{% endmacro %}