Flipbook yang indah
di situs WordPress Anda

Apa yang ditambahkan plugin ini ke situs Anda — dan apa yang tidak

Sebuah plugin Anda izinkan masuk ke pemasangan Anda sendiri, jadi wajar bertanya apa yang dibawanya. Yang ini sengaja dibuat kecil. Di sisi pengunjung ia menghasilkan satu <div> berisi satu <iframe> bertanda loading="lazy", sehingga flipbook yang berada jauh di bawah halaman panjang baru diambil ketika pembaca sampai di sana.

Ia tidak memuat lembar gaya maupun JavaScript di sisi pengunjung. Ia tidak membuat tabel basis data dan tidak menambah menu di dasbor. Ia tidak menelepon pulang, tidak menghitung apa pun, dan tidak meminta kunci API. Semua yang membuat flipbook bekerja berjalan di dalam iframe, di sisi kami — itu pula sebabnya skor kecepatan halaman Anda tidak bergeser ketika Anda menambahkannya.

Menonaktifkannya sama tenangnya: shortcode berhenti dikenali, sehingga [toombler id="…"] muncul sebagai teks biasa di tulisan Anda sampai Anda menghapusnya. Tidak ada yang tertinggal di basis data, karena tidak pernah ada yang ditaruh di sana.

Versi teks, dan mengapa layak dinyalakan

Flipbook adalah gambar dari halaman Anda. Bagus untuk pembaca yang matanya berfungsi dan punya tetikus, dan tidak berguna bagi pembaca layar, yang hanya menemukan bingkai tanpa apa pun untuk dibaca. Menambahkan text="1" ke shortcode akan memunculkan panel lipat Read the text version di bawah buku, berisi lapisan teks asli dari PDF Anda.

Pengambilan terjadi di server Anda, bukan di peramban pengunjung, dan hasilnya disimpan dalam transient WordPress: dua belas jam bila teks ditemukan, satu jam bila tidak — sehingga flipbook yang teksnya masih diekstrak akan mendapatkannya tak lama kemudian, bukan keesokan harinya. Paling banyak 60.000 karakter yang disimpan, lebih dari brosur biasa, dan cukup untuk mencegah manual empat ratus halaman memenuhi tabel opsi Anda.

Ada alasan kedua, kurang mulia tetapi nyata: teks itu berada di halaman Anda, di HTML Anda, di bawah domain Anda. Mesin pencari yang membaca tulisan itu melihat apa yang benar-benar dikatakan dokumen, alih-alih bingkai yang tak bisa dimasukinya. Jika Anda menerbitkan katalog atau buletin yang ingin ditemukan orang, satu atribut ini berbuat lebih banyak daripada semua hal lain di halaman ini.

Ini hanya bekerja untuk PDF yang memuat teks sungguhan. Pindaian tanpa OCR tidak punya lapisan teks, jadi panelnya tidak muncul alih-alih terbuka kosong.

Persyaratan, versi, dan lisensi

Plugin ini memerlukan WordPress 5.8 atau lebih baru dan PHP 7.4 atau lebih baru, dan diuji terhadap rilis WordPress saat ini. Ambang itu sengaja rendah: kodenya tidak memakai apa pun yang eksotis, sehingga tetap bekerja di hosting yang tertinggal beberapa tahun.

Karena ini shortcode biasa, ia bekerja di editor blok, di editor klasik, di widget teks, dan di pembangun halaman seperti Elementor, Divi, Beaver Builder, dan Bricks — di mana pun shortcode diproses. Blok Gutenberg adalah kemudahan tambahan, bukan syarat.

Ini perangkat lunak bebas di bawah GPL versi 2 atau setelahnya, lisensi yang sama dengan WordPress sendiri. Anda boleh membacanya, mengubahnya, dan menjalankan versi Anda sendiri di situs Anda sendiri.

Bagaimana ia memperlakukan apa yang Anda ketik

Segala sesuatu yang berakhir di HTML sebuah halaman pantas dicurigai, jadi inilah yang terjadi pada atribut Anda. ID berkas harus cocok dengan [A-Za-z0-9_-] dan panjangnya antara sepuluh dan enam puluh karakter; selain itu ditolak dengan pesan yang terlihat, bukan ditempelkan ke dalam URL. Lebar dan tinggi melewati absint(), sehingga huruf yang tersasar menghasilkan nilai bawaan alih-alih merusak tata letak. URL yang tersusun di-escape sebelum sampai ke src.

Satu hal perlu diketahui karena kerap mengejutkan: WordPress diam-diam membuang atribut shortcode yang tidak dikenalinya. Tulis hight="600" dan tidak ada yang rusak — Anda hanya mendapat tinggi bawaan tanpa peringatan di mana pun. Kalau sebuah opsi tampak tak berbuat apa-apa, periksa dulu ejaannya pada tabel di atas.

Plugin ini membuat tepat satu permintaan dari server Anda ke server kami, dan hanya ketika text="1" disetel: ia meminta teks dari satu flipbook itu. Tidak ada apa pun tentang pengunjung Anda yang dikirim, karena ia memang tidak tahu apa-apa tentang mereka.

Blok atau shortcode?

Keduanya menghasilkan HTML yang sama, jadi ini soal cara kerja yang Anda sukai. Blok memberi pratinjau langsung di editor dan bilah sisi dengan opsi sebagai kendali sungguhan, yang lebih enak saat Anda mencoba-coba ukuran. Shortcode berupa teks, sehingga mudah disalin antar tulisan, ditempel ke pembangun halaman, dan dicari kemudian ketika Anda ingin menemukan setiap flipbook di situs.

Kalau Anda mengurus situs milik orang lain, shortcode punya satu keunggulan praktis: ia selamat dari pergantian tema, pergantian editor, dan perpindahan ke pembangun halaman tanpa perlu disusun ulang. Untuk perbandingan plugin ini dengan tiga cara penyematan lainnya — iframe polos, potongan JavaScript, dan oEmbed — lihat panduan tentang menyematkan PDF di WordPress.