WordPress

Plugin formulir menangani kiriman di dalam WordPress: formulirnya mengirim kembali ke situs Anda sendiri, lalu plugin menyimpan dan mengirim hasilnya lewat email. Formulir HTML biasa yang diarahkan ke Ikiform melewati plugin, database, dan penyiapan email, serta tetap berfungsi di halaman yang di-cache karena tidak membawa nonce WordPress.

Siapa yang bisa menempel formulir

WordPress memfilter HTML di post dan page. Untuk siapa pun yang tidak punya kapabilitas unfiltered_html, WordPress menghapus <form> dan <input> saat konten disimpan.

Blok Custom HTML

1. Tambahkan blok

   Di block editor, ketik /html dan pilih Custom HTML. Untuk menaruh formulir di setiap halaman, tambahkan blok ke template part seperti footer di Site Editor.

2. Tempel formulir

   <form class="ikiform" action="https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx" method="post">
     <p><label>Name <input name="name" autocomplete="name" required></label></p>
     <p><label>Email <input name="email" type="email" autocomplete="email" required></label></p>
     <p><label>Message <textarea name="message" rows="5"></textarea></label></p>
     <input type="hidden" name="_redirect" value="https://example.com/thank-you/">
     <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden>
     <p><button type="submit" class="wp-element-button">Send</button></p>
   </form>

   wp-element-button memberi tombol gaya tombol tema Anda di block theme. Formulir mewarisi font dan gaya input tema Anda, jadi biasanya tidak butuh CSS.

3. Pratinjau, lalu perbarui

   Gunakan tab Preview pada blok, lalu simpan. Muat ulang editor dan buka bloknya lagi: jika tag <form> dan <input> hilang, akun Anda tidak bisa menyimpannya. Gunakan shortcode di bawah.

_redirect hanya berfungsi jika formulir punya domain yang diizinkan yang mencakup situs Anda; jika tidak, pengunjung melihat halaman terima kasih Ikiform. Anda juga bisa mengatur Redirect after submit di pengaturan formulir dan menghapus input tersembunyinya.

Shortcode

Shortcode menyimpan HTML di PHP, yang tidak disentuh filter konten, jadi author dan contributor juga bisa menaruh formulir. Simpan ini sebagai must-use plugin, yang dimuat WordPress secara otomatis:

<?php

add_shortcode('ikiform', function ($atts) {
    $atts = shortcode_atts([
        'id' => 'frm_xxxxxxxxxxxxxxxx',
        'subject' => '',
        'redirect' => '',
        'button' => 'Send',
    ], $atts, 'ikiform');

    ob_start();
    ?>
    <form class="ikiform" action="<?php echo esc_url('https://ikiform.com/f/' . rawurlencode($atts['id'])); ?>" method="post">
      <p><label>Email <input name="email" type="email" autocomplete="email" required></label></p>
      <p><label>Message <textarea name="message" rows="5"></textarea></label></p>
      <?php if ($atts['subject']) : ?>
        <input type="hidden" name="_subject" value="<?php echo esc_attr($atts['subject']); ?>">
      <?php endif; ?>
      <?php if ($atts['redirect']) : ?>
        <input type="hidden" name="_redirect" value="<?php echo esc_url($atts['redirect']); ?>">
      <?php endif; ?>
      <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden>
      <p><button type="submit" class="wp-element-button"><?php echo esc_html($atts['button']); ?></button></p>
    </form>
    <?php
    return ob_get_clean();
});

Lalu tambahkan blok Shortcode, atau ketik shortcode di konten mana pun:

[ikiform subject="New enquiry" redirect="https://example.com/thank-you/"]

• Berikan id untuk memakai formulir lain: [ikiform id="frm_..."].
• Ubah field di PHP agar sesuai dengan formulir Anda. Setiap input yang punya name akan disimpan.
• Di classic editor, tempel HTML mentah hanya di tab Text. Visual editor menambahkan tag <p> dan <br> di dalam formulir. Shortcode menghindari masalah ini.

Domain yang diizinkan

Cantumkan setiap alamat tempat situs merespons. Situs WordPress sering punya beberapa alamat selama Anda membangunnya.

• Jangan pernah menambahkan wordpress.com atau wpcomstaging.com saja. Setiap situs di host itu akan cocok, termasuk milik orang lain.

Daftar periksa pengujian

1. Keluar, atau buka jendela privat. Admin yang sedang masuk melewati sebagian cache dan melihat halaman yang sedikit berbeda.
2. Kirim formulir dan pastikan kirimannya ada di Ikiform, sebagai diterima, bukan spam.
3. Pastikan Anda mendarat di halaman terima kasih Anda. Jika Anda melihat halaman Ikiform, situs belum ada di domain yang diizinkan atau URL _redirect bukan https:.
4. Edit halaman sebagai pengguna non-admin dan pastikan formulir tetap utuh setelah disimpan, atau gunakan shortcode.

Pemecahan masalah

Terkait

• Formulir HTMLRedirect, field reserved, dan honeypot.
• Pembuat situsEmbed yang berfungsi di pembuat situs mana pun.
• Perlindungan spamHoneypot, penilaian, dan pemeriksaan manusia.
• Pemecahan masalahCORS, ketidakcocokan origin, dan 429.