پیکربندی ایمیل

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

به طور پیش فرض، پورتال Developer Services ایمیل هایی را در پاسخ به رویدادهای خاص ارسال می کند. به عنوان مثال، هنگامی که یک توسعه دهنده جدید در پورتال ثبت نام می کند، پورتال به طور خودکار یک ایمیل خوش آمدگویی به توسعه دهنده ارسال می کند. یا اگر برنامه‌نویس رمز عبور خود را گم کند، توسعه‌دهنده می‌تواند یک ایمیل با رمز عبور موقت درخواست کند.

به عنوان یک ارائه دهنده API، می توانید تمام جنبه های ایمیل های تولید شده توسط پورتال را کنترل کنید، از جمله:

  • قالب بندی ایمیل های خودکار ارسال شده توسط پورتال
  • تعیین سرور SMTP مورد استفاده توسط پورتال
  • افزودن قوانین برای ایجاد ایمیل در پاسخ به رویدادهای در پورتال

ارسال ایمیل از یک پورتال مبتنی بر ابر

پیکربندی پیش‌فرض ایمیل برای یک پورتال مبتنی بر ابر که در Pantheon یا Acquia مستقر شده است فقط باید در محیط‌های غیر تولیدی استفاده شود. ایمیل ارسال شده از یک سرور ابری ناشناس ممکن است مسدود یا به عنوان هرزنامه علامت گذاری شود.

برای پورتال های تولیدی، از یکی از گزینه های زیر برای ارسال ایمیل استفاده کنید:

ارسال ایمیل از یک پورتال داخلی

به طور پیش فرض، نامه با استفاده از تابع PHP mail ارسال می شود. PHP سعی می کند با استفاده از sendmail در سیستم محلی، که می تواند در فایل php.ini PHP پیکربندی شود، ایمیل ارسال کند.

برای پورتال های تولید، می توانید از ماژول SMTP که در زیر توضیح داده شده است برای ارسال ایمیل از طریق سرور SMTP یا سرور شرکت استفاده کنید.

پیکربندی سرور SMTP

پورتال توسعه دهنده نیاز دارد که یک سرور SMTP را برای ارسال پیام های ایمیل پیکربندی کنید. برای پیکربندی سرور SMTP، ابتدا باید ماژول Drupal SMTP Authentication Support را در پورتال توسعه دهنده فعال کنید.

پس از پیکربندی سرور SMTP، تمام ایمیل های ارسال شده توسط پورتال توسعه دهنده از سرور SMTP استفاده می کنند. این ایمیل ها شامل ایمیل های ارسال شده به توسعه دهندگان جدید، ایمیل های ارسال شده به توسعه دهندگانی است که رمز عبور خود را گم می کنند و ایمیل هایی که برای توسعه دهندگان با حساب های مسدود شده ارسال می شوند.

برای پیکربندی سرور SMTP :

  1. به عنوان یک کاربر با امتیازات مدیریت یا ایجاد محتوا وارد پورتال خود شوید.
  2. Modules را در منوی مدیریت دروپال انتخاب کنید.
    صفحه ماژول ها باز می شود.
  3. ماژول SMTP Authentication Support را فعال کنید.
  4. پیکربندی را ذخیره کنید.
  5. پس از فعال شدن ماژول، در ورودی SMTP Authentication Support در صفحه ماژول ها، Configure را انتخاب کنید.
    صفحه پیکربندی پشتیبانی احراز هویت SMTP ظاهر می شود.
  6. در قسمت Turn this module on or of f، روشن را انتخاب کنید.
  7. در قسمت تنظیمات سرور SMTP اطلاعات زیر را وارد کنید:
    • آدرس سرور SMTP به عنوان مثال، برای سرور SMTP خروجی Gmail، از smtp.gmail.com استفاده کنید.
    • به صورت اختیاری آدرس سرور SMTP پشتیبان را وارد کنید. این مقدار مورد نیاز نیست.
    • پورت SMTP را وارد کنید. مقدار این پورت بر اساس پروتکل رمزگذاری انتخاب شده می تواند متفاوت باشد. به عنوان مثال، برای Gmail، پورت 465 هنگام استفاده از SSL و 587 برای TLS است.
    • پروتکل رمزگذاری را به عنوان None ، SSL یا TLS انتخاب کنید.
  8. در ناحیه SMTP Authentication ، نام کاربری و رمز عبور مورد استفاده برای احراز هویت SMTP را مشخص کنید. این باید یک نام کاربری و رمز عبور معتبر در سرور SMTP باشد.
  9. در قسمت گزینه های ایمیل ، آدرس ایمیل و نام کاربری که پیام ایمیل را ایجاد می کند را وارد کنید. این مقادیر مربوط به آدرس "از" ایمیل است.
  10. در صورت تمایل، در بخش ارسال پیام ایمیل آزمایشی ، آدرس ایمیلی را وارد کنید که در آن پورتال یک پیام آزمایشی ارسال می کند.
  11. پیکربندی را ذخیره کنید.
    ذخیره پیکربندی پیام ایمیل آزمایشی را تولید می کند و هرگونه خطای پیکربندی را نمایش می دهد. صندوق ورودی آدرس ایمیل پیام آزمایشی را بررسی کنید تا مطمئن شوید که می رسد.
  12. پیکربندی > سیستم > اطلاعات سایت را در منوی مدیریت دروپال انتخاب کنید.
  13. در قسمت جزئیات سایت ، آدرس ایمیل را به همان آدرس ایمیلی که در مرحله 9 مشخص کرده اید، تنظیم کنید.
    برخی از ماژول‌های دروپال که ایمیل تولید می‌کنند، از این فیلد برای تعیین آدرس «از» ایمیل استفاده می‌کنند، نه مقدار صفحه پشتیبانی تأیید اعتبار SMTP.
  14. پیکربندی را ذخیره کنید.

پیکربندی و قالب بندی اعلان های ایمیل

می‌توانید اعلان‌های ایمیل مختلفی را که در پاسخ به فعالیت‌های خاصی مانند ثبت، حذف، مسدود کردن و رفع انسداد حساب‌های برنامه‌نویس ارسال می‌شوند، پیکربندی کنید.

همچنین می‌توانید آدرس «از» ایمیل‌ها را کنترل کنید.

برای پیکربندی اعلان‌های ایمیل:

  1. به عنوان یک کاربر با امتیازات مدیریت یا ایجاد محتوا وارد پورتال خود شوید.
  2. پیکربندی > افراد > تنظیمات حساب را در منوی مدیریت دروپال انتخاب کنید. با این کار صفحه تنظیمات حساب باز می شود.
  3. در قسمت E-Mails در صفحه تنظیمات حساب ها، یک نوع اعلان ایمیل را انتخاب کنید. به عنوان مثال، می‌توانید «Welcome (بدون نیاز به تأیید)» را انتخاب کنید، که وقتی حساب توسعه‌دهنده به‌طور خودکار در طول فرآیند ثبت‌نام توسعه‌دهنده تأیید شد، ایمیلی ارسال می‌کند.

  4. موضوع و متن اعلان ایمیل را ویرایش کنید.
    مکان نما را در یک فیلد مانند موضوع قرار دهید و سپس پیوند Browse available tokens را در پایین فرم انتخاب کنید تا لیست نشانه هایی را که می توانید در فیلد استفاده کنید مشاهده کنید. پنجره‌ای ظاهر می‌شود که به شما امکان می‌دهد یک نشانه را برای افزودن انتخاب کنید، مانند [user:name] ، که با نام کاربری توسعه‌دهنده مطابقت دارد.
  5. روی Save configuration کلیک کنید.

همچنین می‌توانید نام و آدرس «از» را در اعلان ایمیل تغییر دهید.

برای تغییر نام و آدرس "از":

  1. به عنوان یک کاربر با امتیازات مدیریت یا ایجاد محتوا وارد پورتال خود شوید.
  2. Configuration > System > SMTP Authentication Support را در منوی مدیریت دروپال انتخاب کنید. با این کار صفحه پشتیبانی SMTP Authentication باز می شود.
  3. در قسمت E-Mail From Address آدرس ایمیل «از» را مشخص کنید.
  4. در قسمت E-Mail From Name یک نام «از» مشخص کنید.
  5. روی Save configuration کلیک کنید.
  6. پیکربندی > سیستم > اطلاعات سایت را در منوی مدیریت دروپال انتخاب کنید.
  7. همان آدرس ایمیلی را که در مرحله 3 استفاده کردید در قسمت آدرس ایمیل مشخص کنید.
  8. روی Save configuration کلیک کنید.

ایجاد ایمیل در هنگام وقوع یک رویداد

یکی از کاربردهای رایج قوانین، ایجاد ایمیل در پاسخ به یک رویداد است. پورتال برای ایجاد ایمیل برای رویدادهای از پیش تعریف شده، مانند زمانی که یک توسعه دهنده جدید یک حساب را ثبت می کند، پشتیبانی ایجاد کرده است. با این حال، می توانید قوانین خود را برای تولید ایمیل اضافه کنید. به عنوان مثال، زمانی که برنامه‌نویس برنامه‌ای را اضافه، حذف یا تغییر می‌دهد، می‌توانید یک ایمیل ایجاد کنید.

این بخش شامل نمونه ای از نحوه ایجاد یک قانون برای ایجاد ایمیل هنگام ثبت برنامه توسط توسعه دهنده است. این روش را در صورت لزوم برای ایجاد ایمیل برای رویدادهای دیگر اصلاح کنید.

برای ایجاد ایمیل هنگام ایجاد برنامه:

  1. به عنوان یک کاربر با امتیازات مدیریت یا ایجاد محتوا وارد پورتال خود شوید.
  2. Modules را در منوی مدیریت دروپال انتخاب کنید.
  3. مطمئن شوید که ماژول Rules UI فعال است.
  4. در منوی مدیریت دروپال ، Configuration > Workflow > Rules را انتخاب کنید. با این کار صفحه قوانین باز می شود.
  5. دکمه Add a new rule را انتخاب کنید.
  6. در صفحه قوانین جدید، مشخص کنید:
    • نام قانون، به عنوان مثال "قانون ارسال ایمیل".
    • به صورت اختیاری هر برچسبی را که برای طبقه بندی قوانین برای جستجو استفاده می شود، مشخص کنید.
    • در منوی کرکره ای React on event ، Devconnect > Upon create a developer app را انتخاب کنید.
  7. قانون را حفظ کنید.
    با ذخیره کردن قانون، فرم ویرایش قوانین با سه پنجره باز می‌شود: رویدادها (که به تازگی ایجاد کرده‌اید)، شرایط و اقدامات .
  8. در بخش Actions ، Add action را انتخاب کنید.
  9. از منوی کشویی Select the Action to Add ، System > send mail را انتخاب کنید.
    این انتخاب صفحه ای را باز می کند که به شما امکان می دهد ایمیل را قالب بندی کنید. از این فرم برای تعیین فیلدهای «به»، «موضوع»، «پیام» و سایر قسمت‌های ایمیل استفاده کنید.

    پیوند الگوهای جایگزین را در زیر هر فیلد گسترش دهید تا لیست الگوهایی را که می‌توانید در فیلد استفاده کنید، ببینید. برای مثال، اگر الگوهای جایگزین را در قسمت To گسترش دهید، فهرستی از الگوها را مشاهده خواهید کرد که شامل [app:developer] است. اگر این الگو را در قسمت To مشخص کنید، ایمیل برای سازنده برنامه ارسال می شود.
  10. فیلدها را مطابق شکل زیر تنظیم کنید:
  11. برای بازگشت به صفحه ویرایش قوانین ، ذخیره را انتخاب کنید.
  12. ذخیره تغییرات را انتخاب کنید.

با افزودن یک برنامه جدید در پورتال، قانون را آزمایش کنید. در پاسخ باید یک اعلان ایمیل دریافت کنید که به صورت زیر ظاهر می شود:

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16