Modul SMTP Kustom menambahkan pengaturan dasar untuk memungkinkan Anda mengirim email langsung dari aplikasi Anda.
Untuk membuat formulir pengiriman surat muncul di aplikasi, Anda perlu menambahkan pengaturan yang hilang dan elemen yang diperlukan. Algoritma tindakan akan menjadi sebagai berikut:
- Tambahkan halaman atau jendela tempat formulir surat akan ditempatkan.
- Hubungkan modul, tambahkan parameter server SMTP ke dalamnya, serta nama pengguna dan kata sandi Anda.
- Buat proses bisnis, titik akhir, dan formulir terkait modul.
Mari kita tunjukkan bagaimana melakukan ini dalam aplikasi web menggunakan layanan email Gmail sebagai contoh.
Buat Halaman
Buka editor dan buat halaman baru dari mana Anda akan memposting. Tunjukkan nama halaman Anda ("Judul"), alamatnya ("URL Halaman"), dan grup pengguna yang dapat mengirim pesan ("Tampilkan untuk grup"). Klik "Simpan".
Simpan perubahan Anda dan pergi ke blok modul.
Menambah dan mengonfigurasi modul
Temukan modul SMTP Kustom di tab Marketplace dan klik tombol Instal untuk menambahkannya ke aplikasi.
Buka tab "Terpasang", tempat semua modul yang diinstal di aplikasi Anda berada, dan klik kotak "SMTP Kustom" untuk membuka pengaturannya. Informasi dasar tentang modul dan tombol untuk menghapusnya dari aplikasi ditampilkan di sebelah kiri. Di sebelah kanan adalah bidang yang perlu Anda isi:
- Di bidang "Masuk" dan "Kata Sandi" masukkan data kotak surat tempat Anda akan mengirim pesan.
- Tentukan pengaturan koneksi SMTP - pengaturan tersebut berbeda untuk setiap layanan email. Secara default, pengaturan Gmail ditambahkan ke modul.
- Di bidang "Dari Nama", masukkan nama yang akan ditampilkan kepada penerima surat Anda.
Penting! Untuk mengirim pesan melalui Gmail, Anda harus mengaktifkan aplikasi pihak ketiga di akun Google Anda.
Untuk informasi lebih lanjut tentang modul apa, cara memperbarui dan menyesuaikannya, lihat dokumentasi kami .
Ingatlah untuk menyimpan perubahan Anda.
Pembuatan proses bisnis, titik akhir, dan bentuk
Proses bisnis , titik akhir , dan bentuk adalah elemen yang saling terkait yang penting untuk diatur secara konsisten. Dengan berinteraksi satu sama lain, mereka akan menyelesaikan konfigurasi aplikasi Anda - dan formulir untuk mengirim pesan akan muncul di halaman.
Anda dapat membaca lebih lanjut tentang elemen-elemen ini dalam dokumentasi kami .
Proses bisnis
Buka tab "Logika bisnis" dan klik tombol untuk membuat proses bisnis baru.
Masukkan nama proses (wajib), deskripsinya (opsional), dan klik tombol "Buat".
Setiap proses bisnis di editor secara visual dibagi menjadi blok - bagian penyusun yang bertanggung jawab untuk fungsi yang berbeda. Ketika proses baru dibuat, "Start" dan "End" muncul secara otomatis di dalamnya. Semua blok lain yang dapat Anda tambahkan akan ditampilkan di sebelah kiri.
Setelah instalasi, modul "SMTP Kustom" menambahkan "SMTP Kustom: Kirim Email" ke daftar ini. Untuk menyertakan blok ini dalam proses bisnis, seret ke bidang editor menggunakan penunjuk tetikus. Jendela "SMTP Kustom: Kirim Email" akan muncul, bidang yang berisi variabel yang menjadi dasar isi formulir pengiriman pesan Anda di masa mendatang:
- "Subjek" - subjek surat;
- "Tubuh" - bidang dengan teks surat;
- "Ke" - alamat penerima;
- "Cc" - alamat untuk mengirim salinan;
- "Dari nama" - nama pengirim;
- "Bcc" adalah alamat untuk mengirim blind carbon copy.
Sekarang Anda perlu menautkan "Mulai", "SMTP Khusus: Kirim Email" dan "Akhiri" - untuk menunjukkan bahwa keduanya merupakan proses bisnis tunggal:
1. Gerakkan penunjuk mouse ke bidang "Mulai" di blok "Mulai", tahan tombol kiri mouse, dan geser ke bidang "Dalam" di blok "SMTP Khusus: Kirim Email" - koneksi terbentuk antara blok.
2. Demikian pula, buat tautan antara bidang "Keluar" dari blok "SMTP Khusus: Kirim Email" dan bidang "Akhir" dari blok "Akhir"
Sekarang, di blok "Mulai", Anda perlu membuat bidang (variabel) baru dan mengaitkannya dengan variabel di blok "SMTP Kustom: Kirim Email". Bidang yang Anda tambahkan ke blok "Mulai" akan muncul di formulir pengiriman pesan Anda. Bayangkan Anda tidak akan mengirim salinan dan salinan buta, sehingga blok "Mulai" akan berisi bidang-bidang berikut:
- "Pengirim" (nama pengirim) - terkait dengan from_name;
- "Alamat" (kepada siapa itu dikirim) - terkait dengan "kepada";
- "Subjek" (topik); - terkait dengan "subjek" (nama variabel di blok yang berbeda mungkin sama);
- "Pesan" (teks surat) - terkait dengan "tubuh".
Untuk mengikat variabel, mereka harus cocok satu sama lain dalam tipe. Jenis variabel dapat dilihat dengan mengklik blok di mana variabel tersebut berada dan membuka menu edit.
Di bidang blok, di sebelah setiap variabel ada ikon, warna, dan bentuknya tergantung pada jenisnya - untuk memudahkan navigasi di dalamnya. Dalam contoh kita, ada dua jenis variabel:
- "Subjek", "tubuh" dan "from_name" bertipe "String",
- To, cc dan bcc bertipe Email Array.
Membuat Variabel
Untuk membuat variabel pertama di blok "Mulai", klik di atasnya - daftar akan ditampilkan (saat kosong). Klik "+".
Di jendela yang terbuka, masukkan nama variabel: nama "pengirim", ketik "String". Klik "Buat".
Demikian pula tambahkan "alamat", "subjek" dan "pesan". Sekarang daftar variabel di blok "Mulai" terlihat seperti ini:
Tautkan mereka ke variabel terkait di SMTP Kustom: Blok Kirim Email:
Ini adalah bagaimana hubungan antara variabel akan terlihat seperti pada akhirnya. Simpan perubahan Anda dan lanjutkan untuk membuat titik akhir.
Titik akhir
Klik "Buat titik akhir" - Anda akan menemukan diri Anda dalam pengaturan pada tab "Logika Bisnis", di sini Anda perlu menentukan pengaturan berikut:
- "Rute titik akhir" - nama titik akhir, yang dengannya Anda akan memahami fungsinya;
- "Grup Titik Akhir" - nama grup di mana ia akan ditempatkan;
- "Jenis permintaan" - pilih "POST";
- "Proses Bisnis" - pilih proses bisnis send_email yang Anda buat.
Lalu pergi ke tab "Middleware".
Pada tab "Middleware", Anda perlu mengonfigurasi hak untuk melakukan tindakan dengan titik akhir ini (dan, karenanya, meluncurkan proses bisnis terkait). Dengan kata lain, Anda akan menentukan siapa yang dapat mengirim email dari aplikasi Anda. Untuk melakukan ini, Anda perlu mengubah pengaturan token otorisasi "Token Auth".
Perhatian! Jika pengaturan ini tidak diubah, maka semua pengguna berhak mengirim email!
Klik pada ikon roda gigi di sebelah "Token Auth". Di jendela yang terbuka, aktifkan pemilih, di bidang "Grup yang diizinkan", pilih grup "Admin" (atau grup lain yang ingin Anda beri akses). Klik "Simpan"
Sekarang simpan titik akhir dengan mengklik "Buat".
Proses pengiriman pesan dikonfigurasi. Sekarang Anda dapat membuat representasi visual dari formulir pengiriman pesan.
Membentuk
Untuk membuat formulir, kembali ke editor aplikasi web, ke tab yang Anda buat sebelumnya. Seret elemen Formulir ke kanvas halaman.
Di jendela yang terbuka, klik "Buat catatan", daftar titik akhir yang tersedia akan ditampilkan di bidang "Simpan Catatan ke" - pilih yang baru saja Anda buat. Klik "Tugaskan".
Bentuk yang Anda buat muncul di kanvas. Klik gambar roda gigi untuk membuka pengaturannya.
Pada tab “Lihat & Biaya”l, masukkan judul untuk formulir di bidang “Judul”. Di sini Anda juga dapat mengubah tampilannya dan melihat nama yang direkam dalam pengaturan.
Pada tab "Data" - informasi tentang mode formulir dan titik akhir. Juga di sini Anda dapat mengubah lokasi bidang dengan memindahkannya relatif satu sama lain.
Atur bidang dalam urutan logis: Pengirim, Alamat, Subjek, Pesan. Untuk mengubah pengaturan terperinci untuk setiap bidang (misalnya, namanya) - klik ikon roda gigi di sebelahnya. Klik "Simpan" untuk menyimpan perubahan Anda.
Menambahkan tombol untuk formulir
Agar formulir berfungsi, Anda perlu menambahkan tombol konfirmasi kirim. Gunakan elemen "Tombol" - seret dengan penunjuk mouse ke area di bawah formulir.
Buka pengaturan tombol dengan mengkliknya. Pada tab “Look & Feel”, ubah “Label” (nama tombol yang akan terlihat di aplikasi) dan “Name” (nama yang akan ditampilkan di pengaturan).
Pada tab "Pemicu", tambahkan tindakan ke pemicu onClick: di bidang "Target", pilih formulir Anda, di bidang "Tindakan", pilih "Kirim formulir". Klik "Simpan".
Pelestarian, publikasi, dan verifikasi
Simpan semua perubahan yang dibuat, publikasikan, klik ikon pergi ke aplikasi.
Masukkan data untuk mengirim pesan. Jika Anda membiarkan kolom pengirim kosong, nama yang Anda masukkan dalam pengaturan modul akan ditambahkan secara otomatis. Kirim pesan percobaan ke alamat email mana pun yang dapat Anda akses.
Setelah mengirim, pesan konfirmasi akan muncul, dan surat dengan data yang ditentukan akan muncul di alamat penerima di folder Kotak Masuk.
Jika Anda melakukan semuanya sesuai dengan instruksi, tetapi alih-alih mengonfirmasi kesalahan yang keluar atau surat itu berakhir di folder "Spam", tulis ke saluran telegram dukungan teknis kami.
