From 2ca2e136b12fcac3aec80a64ff3fabc8141cfbd3 Mon Sep 17 00:00:00 2001 From: Ali Najmabadi Date: Mon, 30 Sep 2024 16:38:55 +0330 Subject: [PATCH] update email-server docs --- src/components/Sidebar/data.js | 12 -- src/pages/email-server/about.mdx | 5 +- .../email-server/details/change-plan.mdx | 12 +- src/pages/email-server/details/plans.mdx | 4 +- .../email-server/how-tos/add-smtp-user.mdx | 2 +- .../email-server/how-tos/block-emails.mdx | 7 +- .../how-tos/connect-via-platform/django.mdx | 2 +- .../how-tos/connect-via-platform/dotnet.mdx | 75 ++++---- .../how-tos/connect-via-platform/flask.mdx | 2 +- .../how-tos/connect-via-platform/go.mdx | 88 ++++++---- .../how-tos/connect-via-platform/nextjs.mdx | 2 +- .../how-tos/connect-via-platform/php.mdx | 2 +- .../connect-via-platform/wordpress.mdx | 8 - .../how-tos/manage-sent-emails.mdx | 5 +- .../how-tos/send-email-via-console.mdx | 2 +- src/pages/email-server/how-tos/set-spam.mdx | 8 +- src/pages/email-server/how-tos/use-tags.mdx | 164 +++++++++++------- src/pages/email-server/quick-setup.mdx | 7 +- 18 files changed, 236 insertions(+), 171 deletions(-) diff --git a/src/components/Sidebar/data.js b/src/components/Sidebar/data.js index 873312a9..84f9c24f 100644 --- a/src/components/Sidebar/data.js +++ b/src/components/Sidebar/data.js @@ -6051,10 +6051,6 @@ export default { title: "کنترل هرزنامه ایمیل‌های ارسالی", link: "/email-server/how-tos/control-spam" }, - { - title: "مدیریت محدودیت‌ها", - link: "/email-server/how-tos/manage-limitations" - }, { title: "تنظیم فوروارد", link: "/email-server/how-tos/set-forward" @@ -6209,10 +6205,6 @@ export default { title: "کنترل هرزنامه ایمیل‌های ارسالی", link: "/email-server/how-tos/control-spam" }, - { - title: "مدیریت محدودیت‌ها", - link: "/email-server/how-tos/manage-limitations" - }, { title: "تنظیم فوروارد", link: "/email-server/how-tos/set-forward" @@ -6367,10 +6359,6 @@ export default { title: "کنترل هرزنامه ایمیل‌های ارسالی", link: "/email-server/how-tos/control-spam" }, - { - title: "مدیریت محدودیت‌ها", - link: "/email-server/how-tos/manage-limitations" - }, { title: "تنظیم فوروارد", link: "/email-server/how-tos/set-forward" diff --git a/src/pages/email-server/about.mdx b/src/pages/email-server/about.mdx index e634db0e..41c3854f 100644 --- a/src/pages/email-server/about.mdx +++ b/src/pages/email-server/about.mdx @@ -77,10 +77,7 @@ import Head from "next/head"; title: "کنترل هرزنامه ایمیل‌های ارسالی", link: "/email-server/how-tos/control-spam" }, - { - title: "مدیریت محدودیت‌ها", - link: "/email-server/how-tos/manage-limitations" - }, + { title: "تنظیم فوروارد", link: "/email-server/how-tos/set-forward" diff --git a/src/pages/email-server/details/change-plan.mdx b/src/pages/email-server/details/change-plan.mdx index dfd2a13d..afec6b76 100644 --- a/src/pages/email-server/details/change-plan.mdx +++ b/src/pages/email-server/details/change-plan.mdx @@ -25,11 +25,15 @@ import Head from "next/head"; برای تغییر پلن ایمیل‌سرور خود در لیارا، کافیست تا وارد قسمت **تغییر اندازه** ایمیل سرور خود، شوید. سپس، پلن مد نظر خود را انتخاب کنید و در نهایت بر روی گزینه **ویرایش**، کلیک کنید. -{/*
-plans -
*/} -
+ + +

برای تغییر پلن به پلن‌های پایین‌تر از پلن فعلی‌تان، نباید بیشتر از حدود تعریف شده نشانی قابل ایجاد و تعداد فوروارد به ازای هر نشانی در پلن diff --git a/src/pages/email-server/details/plans.mdx b/src/pages/email-server/details/plans.mdx index c95c36a2..e295aae7 100644 --- a/src/pages/email-server/details/plans.mdx +++ b/src/pages/email-server/details/plans.mdx @@ -39,9 +39,9 @@ import Head from "next/head";

برای انتخاب بهترین پلن، می‌توانید از حالت آزمون و خطا استفاده کنید؛ به این صورت که یک پلن را با توجه به نیازهای احتمالی خود، انتخاب کرده و سپس پس از گذشت مدتی و به دست آمدن گزارشات، پلن خود را با توجه به نیازهای خود، ارتقا دهید. -{/* +
see-plans -
*/} +
\ No newline at end of file diff --git a/src/pages/email-server/how-tos/add-smtp-user.mdx b/src/pages/email-server/how-tos/add-smtp-user.mdx index 393d9b14..657f9fe7 100644 --- a/src/pages/email-server/how-tos/add-smtp-user.mdx +++ b/src/pages/email-server/how-tos/add-smtp-user.mdx @@ -21,7 +21,7 @@ import Head from "next/head";
SMTP یا Simple Mail Transfer Protocol یک پروتکل استاندارد اینترنتی برای انتقال ایمیل‌ها است. این پروتکل به سرورهای ایمیل اجازه می‌دهد تا پیام‌های ایمیل را بین خود ارسال کنند و همچنین ایمیل‌ها را از کلاینت‌ها (مانند نرم‌افزارهای ایمیل) دریافت کنند. -این پروتکل به صورت متن ساده و بدون رمزنگاری عمل می‌کند، اما می‌تواند با استفاده از TLS یا SSL برای افزایش امنیت استفاده شود. +این پروتکل به صورت متن ساده و بدون رمزنگاری عمل می‌کند، اما می‌تواند با استفاده از TLS یا STARTTLS برای افزایش امنیت استفاده شود.
diff --git a/src/pages/email-server/how-tos/block-emails.mdx b/src/pages/email-server/how-tos/block-emails.mdx index 3f814921..3728b5be 100644 --- a/src/pages/email-server/how-tos/block-emails.mdx +++ b/src/pages/email-server/how-tos/block-emails.mdx @@ -22,7 +22,12 @@ import Head from "next/head"; شما می‌توانید یک آدرس ایمیل یا حتی یک آدرس دامنه را، مسدود کنید تا ایمیل‌هایی که با آن دامنه یا آدرس ایمیل، دریافت می‌کنید، در بخش **هرزنامه‌ها** قرار بگیرد و در صندوق ورودی، به شما نمایش داده نشود. برای این کار، کافیست تا وارد بخش **تنظیمات** شده و در بخش **مسدود کردن**، آدرس ایمیل یا دامنه مدنظر را، وارد کنید:
-email server +
{/*
    diff --git a/src/pages/email-server/how-tos/connect-via-platform/django.mdx b/src/pages/email-server/how-tos/connect-via-platform/django.mdx index ac01b7a2..0fb65be7 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/django.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/django.mdx @@ -42,7 +42,7 @@ import Head from "next/head";
    - {`MAIL_HOST=smtp.liara.ir + {`MAIL_HOST=smtp.c1.liara.email MAIL_PORT=587 MAIL_USER=hopeful_zhukovsky_9daqpv MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d diff --git a/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx b/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx index 300e705e..9037b045 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx @@ -44,12 +44,17 @@ import Head from "next/head"; {`MAIL_HOST=smtp.c1.liara.email MAIL_PORT=587 -MAIL_USERNAME=my-app -MAIL_PASSWORD=my-pass`} +MAIL_USER=hopeful_zhukovsky_9daqpv +MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d +MAIL_FROM_ADDRESS=info@example.com`}
    - + +

    +مقدار فیلد MAIL_FROM_ADDRESS باید یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

    +     در نهایت می‌توانید در پروژه‌ی خود مانند مثال زیر عمل کرده و با استفاده از دسترسی SMTP سرویس ایمیل لیارا، @@ -57,46 +62,58 @@ MAIL_PASSWORD=my-pass`}
    - - {`using System; -using System.Net; + + {`using System.Net; using System.Net.Mail; -using System.IO; using dotenv.net; -class Program +DotEnv.Load(); // Load the environment variables from .env file + +var builder = WebApplication.CreateBuilder(args); +var app = builder.Build(); + +app.MapGet("/send-test-email", async context => { - static void Main() + // Read SMTP settings from environment variables + var smtpHost = Environment.GetEnvironmentVariable("MAIL_HOST"); + int smtpPort = int.Parse(Environment.GetEnvironmentVariable("MAIL_PORT") ?? "587"); + var smtpUser = Environment.GetEnvironmentVariable("MAIL_USER"); + var smtpPassword = Environment.GetEnvironmentVariable("MAIL_PASSWORD"); + var fromAddress = Environment.GetEnvironmentVariable("MAIL_FROM_ADDRESS") ?? "info@example.com"; + var toAddress = "recipient@example.com"; // Replace with recipient's email address + + // Create a new SmtpClient + using (var smtpClient = new SmtpClient(smtpHost, smtpPort)) { - DotEnv.Load(); // loading env variables - - string mailHost = Environment.GetEnvironmentVariable("MAIL_HOST"); - int mailPort = int.Parse(Environment.GetEnvironmentVariable("MAIL_PORT")); - string mailUser = Environment.GetEnvironmentVariable("MAIL_USERNAME"); - string mailPassword = Environment.GetEnvironmentVariable("MAIL_PASSWORD"); + smtpClient.EnableSsl = true; // Use TLS encryption + smtpClient.Credentials = new NetworkCredential(smtpUser, smtpPassword); - // SMTP Conf - SmtpClient client = new SmtpClient(mailHost) + // Create the email message + var mailMessage = new MailMessage(fromAddress, toAddress) { - Port = mailPort, - Credentials = new NetworkCredential(mailUser, mailPassword), - EnableSsl = true + Subject = "Test Email", + Body = "

    This is a test email sent from a .NET Core application using SMTP

    ", + IsBodyHtml = true }; - // Creating and Sending Email - MailMessage message = new MailMessage("from@test.com", "to@test.com", - "hello", "hello from dotnet!"); + // Add custom headers + mailMessage.Headers.Add("x-liara-tag", "test-tag"); + + // Send the email try { - client.Send(message); - Console.WriteLine("email sent successfully"); + await smtpClient.SendMailAsync(mailMessage); + await context.Response.WriteAsync("Test email sent successfully!"); } catch (Exception ex) { - Console.WriteLine($"error in sending email: {ex.Message}"); + await context.Response.WriteAsync($"Failed to send email: {ex.Message}"); } } -}`} +}); + +app.Run(); +`}

    @@ -107,10 +124,10 @@ class Program

    -مقدار پارامتر اول message باید به جای from@test.com، یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا +به جای STARTTLS، از TLS استفاده شود.

    -
    برای استفاده از ایمیل‌سرور در کنترلر، می‌توانید مشابه قطعه کد زیر، عمل کنید: diff --git a/src/pages/email-server/how-tos/connect-via-platform/flask.mdx b/src/pages/email-server/how-tos/connect-via-platform/flask.mdx index 54424566..d9522d74 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/flask.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/flask.mdx @@ -52,7 +52,7 @@ import Head from "next/head";
    - {`MAIL_HOST=smtp.liara.ir + {`MAIL_HOST=smtp.c1.liara.email MAIL_PORT=587 MAIL_USER=hopeful_zhukovsky_9daqpv MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d diff --git a/src/pages/email-server/how-tos/connect-via-platform/go.mdx b/src/pages/email-server/how-tos/connect-via-platform/go.mdx index fc2e2c05..6b3bc13b 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/go.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/go.mdx @@ -19,6 +19,19 @@ import Head from "next/head"; # اتصال به ایمیل‌سرور در برنامه‌های Golang
    +