Templat e-mel
From LimeSurvey Manual
Pengenalan
Templat e-mel digunakan untuk menghantar e-mel jemputan, peringatan, pengesahan dan pendaftaran yang diperibadikan kepada peserta anda (daripada jadual peserta tinjauan). Anda juga boleh mengedit pemberitahuan pentadbir asas (atau terperinci) standard yang dihantar kepada pentadbir tinjauan.
Templat e-mel: Tetapan > Menu tinjauan > Templat e-mel
Jika anda mempunyai kebenaran superadministrator (anda mempunyai akses kepada tetapan global pemasangan LimeSurvey anda), anda boleh menukar Mod editor HTML lalai untuk semua pengguna LimeSurvey anda. Untuk butiran lanjut, teruskan membaca subseksyen wiki berikut.
Perhatian : Jika anda ingin menggunakan editor HTML timbul/sebaris, jangan lupa mengaktifkan format HTML untuk e-mel token! Ini terletak dalam menu Tetapan tinjauan anda, di bawah tab Tetapan peserta.
Panel Templat E-mel
Panel templat e-mel:
Dalam tangkapan skrin di atas, mod editor "Sumber HTML" digunakan. Untuk menukarnya, pergi ke tetapan akaun peribadi anda.
Untuk mengedit medan teks, pergi ke tetapan akaun anda dan pilih mod editor HTML sebaris.
Lima jenis e-mel boleh dihantar kepada pengguna atau pentadbir:
Jemputan
Fungsi ini digunakan untuk menghantar e-mel secara pukal kepada semua peserta tinjauan dalam jadual peserta tinjauan yang belum menerima jemputan untuk melengkapkan tinjauan anda.
Daripada panel templat e-mel, anda boleh mengedit mesej yang dihantar kepada peserta tinjauan. Untuk menyemak pemegang tempat e-mel yang boleh digunakan, teruskan membaca subseksyen wiki berikut. Anda juga boleh menggunakan ExpressionScript untuk menyesuaikan lagi templat e-mel jemputan anda.
Peringatan
Fungsi Peringatan menyediakan cara bagi pentadbir tinjauan untuk mengingatkan peserta daripada jadual peserta tinjauan supaya menjawab tinjauan.
Anda boleh mengedit format lalai e-mel peringatan daripada panel Templat e-mel. Untuk menyemak pemegang tempat e-mel yang boleh digunakan, teruskan membaca subseksyen wiki berikut. ExpressionScript boleh membantu anda menyesuaikan isi teks templat e-mel ini.
Nota: Peringatan hanya akan dihantar kepada peserta dalam jadual peserta tinjauan yang medan "Selesai" dimatikan. Ini bermakna responden belum mengambil atau belum melengkapkan tinjauan tersebut.
Pengesahan
Jika token digunakan dan seorang peserta melengkapkan tinjauan, e-mel pengesahan akan dihantar ke alamat e-mel beliau. Anda boleh menyahaktifkan fungsi ini daripada panel Tetapan peserta.
Klik tab Pengesahan jika anda ingin mengedit templat e-mel. Semak pemegang tempat e-mel untuk melihat yang mana boleh digunakan dalam jenis e-mel ini. Anda juga boleh menggunakan ExpressionScript untuk menyesuaikan e-mel anda.
Pendaftaran
Jika mod akses tertutup diaktifkan (terdapat jadual peserta tinjauan), ini bermakna hanya peserta yang mempunyai entri yang diperuntukkan dan kod token unik yang dikaitkan dengannya boleh melengkapkan tinjauan berkenaan. Jika anda membenarkan peserta mendaftar secara umum untuk tinjauan anda, entri baharu dalam jadual peserta tinjauan anda akan dicipta sebaik sahaja responden menghantar nama dan alamat e-mel mereka. Skrip yang berjalan di latar belakang akan menghantar e-mel pendaftaran kepada responden berkenaan secara automatik. E-mel ini mengandungi URL dengan token yang perlu diakses oleh pengguna yang baru mendaftar.
Klik tab pendaftaran untuk mengedit format e-mel ini. Jangan lupa menyemak dahulu pemegang tempat e-mel yang boleh digunakan dalam isi teks. ExpressionScript boleh menyediakan penyesuaian lanjut kepada isi teks yang ingin anda gunakan.
Pemberitahuan Pentadbir Asas & Terperinci
Untuk mendapatkan pemberitahuan pentadbir, klik tab Pemberitahuan & data dan taip alamat e-mel dalam medan "Hantar e-mel pemberitahuan pentadbir asas kepada" dan satu lagi (atau yang sama) dalam medan "Hantar e-mel pemberitahuan pentadbir terperinci kepada".
Secara lalai, satu-satunya perbezaan antara keduanya berkaitan dengan pemegang tempat tambahan {ANSWERTABLE} yang disertakan dalam templat e-mel pemberitahuan pentadbir terperinci. Ini membolehkan pengguna yang menerima e-mel sedemikian turut menyemak jawapan yang dihantar. Mereka tidak perlu mengakses pemasangan LimeSurvey.
Walau bagaimanapun, dengan menggunakan ExpressionScript dan pemegang tempat e-mel, anda boleh menyesuaikan kedua-dua templat e-mel ini.
Medan Templat E-mel
Setiap templat e-mel mengandungi:
- Subjek e-mel: Tajuk e-mel/kumpulan e-mel yang ingin anda hantar;
- Kandungan e-mel: Kotak teks yang mengandungi mesej teks yang ingin anda hantar kepada peserta. Ia boleh mengandungi teks, imej dan pemegang tempat e-mel. ExpressionScript juga boleh digunakan untuk menyesuaikan lagi mesej yang ingin anda sampaikan;
Nota: Tab lain dipaparkan di atas tab templat e-mel jika tinjauan anda menggunakan bahasa tambahan. Jika anda mengklik mana-mana tab bahasa selain tab bahasa lalai, templat e-mel akan memuatkan teks yang sepadan dalam bahasa berkenaan. Akses setiap templat e-mel untuk mula mengeditnya. Jangan lupa klik butang Simpan yang terletak di bahagian kanan atas skrin untuk menyimpan perubahan anda.
- Tindakan e-mel: Dua tindakan tersedia:
- Tetapkan semula templat ini: Apabila diklik, kod HTML akan ditetapkan semula. Tiada teks dipadamkan;
- Sahkan ungkapan: Menyemak logik e-mel - sama ada pemegang tempat digunakan dengan betul atau tidak. Kami sangat mengesyorkan anda menggunakannya sebelum menghantar kumpulan e-mel. Dengan cara ini anda dapat melihat sama ada pemegang tempat ditakrifkan dengan betul atau tidak. Dalam contoh di bawah, terdapat satu kesilapan taip kecil - ia ditonjolkan dengan warna merah.
Pemegang Tempat E-mel
Perhatian : Sila ambil perhatian bahawa sesetengah pemegang tempat e-mel hanya boleh digunakan dalam templat e-mel tertentu! Baca di bawah untuk butiran lanjut.
Dalam templat e-mel lalai, pelbagai pemegang tempat e-mel digunakan dalam kandungan dan/atau subjek e-mel. Peranannya ialah menghubungkan e-mel yang ingin anda hantar kepada setiap peserta dalam senarai peserta tinjauan anda. Data daripada jadual peserta tinjauan (cth., e-mel, nama pertama, nama keluarga, token, dll.) diambil secara automatik dan dimasukkan ke dalam e-mel unik yang berbeza sebelum dihantar kepada setiap peserta daripada senarai peserta tinjauan anda.
Berikut ialah pemegang tempat e-mel yang boleh digunakan dalam kandungan mesej templat e-mel jemputan dan peringatan anda. Semasa menghantar e-mel, pemegang tempat e-mel ini akan digantikan dalam pratonton e-mel jemputan/peringatan anda dengan data daripada tinjauan dan jadual peserta tinjauan anda.
| {ADMINEMAIL} | E-mel pentadbir tinjauan |
| {ADMINNAME} | Nama pentadbir tinjauan |
| {SURVEYNAME} | Tajuk tinjauan anda |
| {SURVEYDESCRIPTION} | Keterangan tinjauan anda |
Pemegang tempat berikut dibenarkan dalam templat e-mel jemputan/peringatan (medan subjek dan/atau kandungan) dan akan digantikan semasa e-mel dihantar:
| {EMAIL} | E-mel penerima |
| {FIRSTNAME} | Nama pertama |
| {LASTNAME} | Nama akhir |
| {SURVEYURL} | URL untuk memulakan tinjauan - jika anda menghantar e-mel HTML, URL penuh akan dipaparkan kepada peserta tinjauan |
| @@SURVEYURL@@ | URL untuk memulakan tinjauan - ini ialah pautan asas. Gunakan ini jika anda ingin menyepadukan pautan dalam elemen HTML tersuai anda di mana-mana (tersedia dalam v1.90 dan ke atas) |
| {OPTOUTURL} | URL untuk menyahaktifkan penghantaran e-mel bagi tinjauan berkenaan - pautan penuh akan dipaparkan dalam versi HTML templat e-mel |
| {OPTINURL} | Jika pengguna disenaraihitamkan dan ingin menyertai tinjauan berkenaan, mereka perlu mengklik URL masuk untuk menerima jemputan/peringatan tinjauan semula. |
| {GLOBALOPTOUTURL} | URL untuk responden keluar daripada senarai peserta pusat bagi laman ini - pautan penuh akan dipaparkan dalam versi HTML templat e-mel |
| {TOKEN} | Token untuk mengakses tinjauan |
| {USESLEFT} | Bilangan penggunaan yang tinggal bagi token |
| {VALIDFROM} | Tarikh token sah dari |
| {VALIDUNTIL} | Tarikh token sah hingga |
| {EMAILSTATUS} | Digunakan untuk melangkau e-mel semasa penghantaran e-mel. Status e-mel lalai ialah "OK". |
| {LANGUAGE} | Digunakan untuk menentukan bahasa yang akan digunakan bagi e-mel dan URL tinjauan apabila menggunakan tinjauan berbilang bahasa |
| {SENT} | Tarikh hantar jemputan dalam format ISO8601 dengan masa (Y-m-d H:i:s dalam PHP) |
| {REMINDERSENT } | Tarikh hantar peringatan dalam format ISO8601 dengan masa (Y-m-d H:i:s dalam PHP) |
| {REMINDERCOUNT} | Bilangan peringatan yang telah dihantar |
| {COMPLETED } | Tarikh tinjauan selesai |
| {TID} | ID dalaman pada jadual token |
| {ATTRIBUTE_1} | Atribut 1 |
| {ATTRIBUTE_2} | Atribut 2 (...dan seterusnya untuk lebih banyak medan atribut) |
Jika tinjauan anda tidak tanpa nama, pemegang tempat e-mel boleh digunakan untuk menambah data entri/peserta tertentu ke dalam panel Elemen teks tinjauan (cth., keterangan tinjauan, mesej alu-aluan, mesej akhir).
| {TOKEN:EMAIL} | Memaparkan e-mel peserta daripada jadual peserta tinjauan |
| {TOKEN:FIRSTNAME} | Memaparkan nama pertama peserta daripada jadual peserta tinjauan |
| {TOKEN:LASTNAME} | Memaparkan nama keluarga peserta daripada jadual peserta tinjauan |
| {TOKEN} | Memaparkan kod token peserta daripada jadual peserta tinjauan |
| {TOKEN:ATTRIBUTE_1} | Memaparkan "Atribut 1" peserta daripada jadual peserta tinjauan |
| {TOKEN:ATTRIBUTE_2} | Memaparkan "Atribut 2" peserta daripada jadual peserta tinjauan (dan seterusnya untuk lebih banyak medan atribut) |
Untuk mengetahui lebih lanjut tentang atribut, baca bahagian wiki berikut.Pemegang tempat e-mel ini juga boleh digunakan dalam templat e-mel pengesahan dan pemberitahuan pentadbir.
Pemegang tempat tertentu hanya boleh digunakan dalam templat pemberitahuan pentadbir. Sila ambil perhatian bahawa satu e-mel bagi setiap jawapan akan dihantar ke alamat e-mel pentadbir!
Sebahagian daripada pemegang tempat yang hanya boleh digunakan dalam panel pemberitahuan pentadbir disebut di bawah:
| {VIEWRESPONSEURL} | Memaparkan URL yang mengubah hala anda ke jawapan yang dihantar oleh responden |
| {EDITRESPONSEURL} | Memaparkan URL yang mengubah hala anda ke halaman LimeSurvey tempat anda boleh mengedit jawapan yang dihantar oleh peserta tinjauan berkenaan |
| {STATISTICSURL} | Klik URL ini untuk mengakses statistik tinjauan |
| {ANSWERTABLE} | Jika anda ingin memaparkan jawapan yang dihantar oleh peserta dalam e-mel pemberitahuan pentadbir, gunakan pemegang tempat e-mel ini. Dengan cara ini, anda tidak lagi perlu mengakses pemasangan LimeSurvey anda untuk menyemak jawapan yang dihantar oleh responden berkenaan (seperti yang dilakukan oleh pemegang tempat {VIEWRESPONSEURL}). |
Petua:
- Jika tinjauan anda menggunakan jawapan tanpa nama, pemegang tempat berkaitan token tidak akan berfungsi dalam templat e-mel pemberitahuan.
- Anda boleh menggunakan ExpressionScript untuk menggunakan ungkapan bagi menyesuaikan e-mel (New in 1.92 ). Sila lihat panduan cara ExpressionScript untuk contoh.
- Lihat juga contoh penggunaan Maklumat daripada jadual peserta tinjauan.
Peserta Keluar
Apabila anda menggunakan tag {OPTOUTURL} dalam e-mel jemputan/peringatan anda, peserta anda boleh keluar daripada tinjauan ini dengan mengklik URL berkaitan dalam e-mel - supaya anda tidak menghantar e-mel peringatan kepada mereka. Peserta yang keluar daripada tinjauan anda akan mempunyai status e-mel 'OptOut' ditetapkan dalam senarai peserta tinjauan.
URL Asas
Pemegang tempat URL mempunyai URL asas yang sepadan. Cth., @@SURVEYURL@@: anda boleh menggunakan @@OPTOUTURL@@, @@OPTINURL@@ …
Menggunakan Fungsi Penggantian
Beberapa kata kunci tertentu boleh digunakan dalam templat e-mel anda. Contohnya, kata kunci tertentu boleh digunakan untuk menggantikan alamat URL token.
Contoh di bawah menggunakan pautan biasa ke tinjauan dan bukannya URL yang panjang:
1) Pertama, akses panel templat e-mel dan pilih Jemputan.
2) Tulis teks yang anda mahu paparkan sebagai pautan untuk memulakan tinjauan.
3) Kemudian pilih teks tersebut.
4) Tambahkan pemegang tempat untuk pautan biasa @@SURVEYURL@@ dan pilih "other" daripada kotak pilihan protokol.
Sekarang, apabila anda menghantar e-mel jemputan, pautan untuk memulakan tinjauan akan menjadi lebih pendek.
Lampiran E-mel
Tindakan Fail
Apabila anda mengklik Menambah fail, tetingkap berikut akan dipaparkan dan meminta anda memilih dokumen daripada folder fail yang ingin anda hantar melalui e-mel:
Lampiran boleh ditambah di bahagian bawah antara muka penyuntingan templat e-mel. Sila ambil perhatian bahawa lampiran e-mel dimuat naik bagi setiap tinjauan.
Anda juga boleh memuat naik fail terus dari desktop ke pemasangan LimeSurvey anda dengan mengklik butang Muat naik dan kemudian memilih fail yang ingin anda lampirkan pada templat e-mel berkenaan.
Setelah dipilih, klik dua kali pada fail tersebut dan fail itu akan terus dipaparkan dalam jadual Fail, di bawah butang Menambah fail:
Untuk melampirkannya secara kekal pada templat e-mel berkenaan, jangan lupa klik butang Simpan yang terletak di bahagian kanan atas tetingkap.
Untuk menentukan sama ada sesuatu lampiran perlu dihantar secara individu, anda boleh menambah persamaan kaitan pada setiap lampiran.
Semua fungsi yang disokong oleh ExpressionScript boleh digunakan, begitu juga atribut token jika tinjauan menggunakan token.
Dengan templat pemberitahuan atau pengesahan, anda juga boleh menggunakan kod soalan yang digunakan dalam tinjauan.
Jika anda ingin menghapus fail, klik butang tong sampah merah di bawah lajur Tindakan dan simpan perubahan.
Perhatian :
- Apabila fail tidak dapat ditemui dalam sistem fail, e-mel akan dihantar tanpa lampiran.
- Mengeksport/mengimport tinjauan tidak mengeksport/mengimport fail lampiran yang telah dimuat naik. Walau bagaimanapun, tetapan untuk lampiran akan dikekalkan, begitu juga persamaan kaitan.
Lampiran Imej
Anda boleh melampirkan satu atau lebih imej jika anda menghantar e-mel HTML. Untuk berbuat demikian, anda perlu mengemas kini sumber URL imej dengan menetapkan laluannya ke direktori awam pemasangan LimeSurvey anda.
Sumber mestilah relatif kepada direktori awam anda pada pelayan. Jika pemasangan LimeSurvey anda dipasang dalam subdirektori, imej tidak akan dipaparkan dalam Editor HTML anda.