Dalam artikel sebelum ini, kami telah membincangkan asas-asas pemetaan kod pendek (shortcode) dan bagaimana anda boleh menikmati manfaat hebatnya. Kami telah memutuskan untuk membahagikan artikel yang menampilkan pemetaan Kod Pendek versi Page Builder Sandwich, memandangkan penulisan berikut mungkin agak lebih teknikal.
Di bawah ialah penerangan yang lebih mendalam mengenai cara kerja dalaman ciri pemetaan kod pendek kami, dan bagaimana kami menjayakannya.
Proses Automatik
Bagi memutuskan pemalam mana yang perlu disertakan dalam pemeta kod pendek, kami telah membina skrip automatik yang akan mengumpulkan pemalam teratas dalam direktori pemalam WordPress berdasarkan kriteria berikut:
- Dalam lingkungan 1,000 pemalam popular, dinilai tertinggi dan dikemas kini,Dengan sekurang-kurangnya 4,000 pemasangan aktif,
- Dengan sekurang-kurangnya 4,000 pemasangan aktif,
- Dengan sekurang-kurangnya 20 penilaian, dan;
- Dengan sekurang-kurangnya purata penilaian 3 bintang
Kami menjalankan pertanyaan ini setiap hari pada direktori pemalam WordPress. Penapis ini memastikan bahawa kami mendapat senarai pemalam berkualiti baik yang digunakan oleh ramai orang. Semasa artikel ini ditulis, kriteria ini menghasilkan 800 pemalam. Jumlah itu amat banyak. Sungguh, sangat banyak.
Kami kemudiannya menjalankan siri semakan automatik pada kod sumber setiap pemalam untuk mengetahui sama ada ia mengandungi sebarang kod pendek, dan kemudian kami cuba mencari kesemua kod pendek tersebut, termasuk semua atributnya. Selepas memproses data, ini menghasilkan lebih daripada 2,000 kod pendek. Wah, hebat sekali. Kod pendek yang dikesan kemudiannya dimasukkan ke dalam pangkalan data pemetaan kod pendek untuk pemeriksaan manual.
Menjelang akhir proses ini, kami akan memperoleh senarai pemalam yang besar, berserta kemungkinan kod pendek masing-masing. Kini ia hanya tentang membersihkan data ini untuk memastikan semuanya betul.
Proses Manual
Ini mungkin bahagian paling sukar dalam keseluruhan sistem pemetaan. Kod pemalam hadir dalam pelbagai bentuk dan saiz, tidak semua kod pendek dikesan secara automatik oleh skrip kami. Walaupun WordPress Codex menyatakan supaya menggunakan fungsi `shortcode_atts` untuk menapis atribut kod pendek, ini hanyalah cadangan dan bukan semua orang melakukannya. Tiada juga cara yang pasti untuk memeriksa bahagian dalaman sesuatu kod pendek apabila pemalam dipasang.
Bagi memastikan kami memperoleh kesemua kod pendek dan atributnya dengan betul, kami telah mencipta kawasan bahagian hadapan (front end) khusus untuk menyunting kod pendek dan atribut serta dibina menggunakan AngularJS dan Bootstrap.
Kami perlu menyemak setiap pemalam satu persatu secara manual dan memeriksa dokumentasi kod pendeknya serta memastikan bahawa semua data yang kami ada adalah betul.
Walaupun ini amat merumitkan dan membosankan, terdapat beberapa sudut positif dalam menggunakan proses automatik:
- Menurut statistik awal kami, hanya sekitar 1 daripada setiap 2 pemalam mempunyai kod pendek.
- Separuh daripada kod pendek yang dikesan tidak mempunyai atribut (tetapi sebahagian daripadanya mungkin positif palsu)
- Dengan hanya mendapatkan pemalam berkualiti baik, kemungkinan besar ia mempunyai dokumentasi kod pendek
Apabila semua kod pendek sesuatu pemalam telah diperiksa, barulah pelayan akan mula mengedarkan pemetaan kod pendek pemalam tersebut kepada pengguna.
Panggilan API Rest
Kepingan teka-teki yang terakhir ialah pemalam itu sendiri. Konsepnya di sini mudah: ketahui pemalam apa yang aktif, tema apa yang sedang digunakan oleh laman web dan apakah kod pendek yang tersedia, kemudian tanya pangkalan data pemetaan kod pendek sama ada ia mempunyai pemetaan. Untuk ini, kami telah mencipta titik akhir WP REST API tersuai yang diping oleh semua klien untuk mendapatkan pemetaan kod pendek terkini mereka.
Masa Depan: Penyumberan Khalayak
Memeriksa setiap pemalam secara manual memerlukan banyak masa dan usaha. Sebaik sahaja platform pemetaan kod pendek ini stabil, kami merancang untuk membuka pemetaan kod pendek kepada semua orang. Ini bermakna semua orang boleh membantu dalam menambah kod pendek.
Anda mungkin berfikir, “mengapa saya perlu membantu memetakan kod pendek? Apa faedahnya untuk saya?” Sebenarnya, terdapat beberapa sebab mengapa orang ramai ingin membantu:
- Jika anda telah mencipta pemalam, dan kami belum mengesannya disebabkan kriteria di atas, (dan ia berada dalam direktori pemalam WordPress) maka anda boleh menambah pemetaan itu sendiri. Pemalam anda akan disokong sepenuhnya oleh PBS!
- Memandangkan kami hanya akan mengendalikan pemalam yang berada dalam direktori pemalam WordPress dalam proses automatik, pengarang pemalam & tema premium tidak akan disertakan. Jadi jika anda memilikinya, anda juga boleh menambah pemetaan kod pendek anda untuk perkara tersebut.
- Dan bagi mereka yang bukan pencipta pemalam, kami boleh memberi ganjaran kepada mereka yang membantu. Untuk menjadikan pemetaan kod pendek suatu usaha yang menarik, kami boleh memberi ganjaran kepada pembantu yang gembira dengan lesen peribadi, atau naik taraf kepada lesen premium PBS!
Langgan Surat Berita Kami
Fungsi pemetaan kod pendek akan dikeluarkan untuk pelanggan kami secara tentatif pada 12 Ogos 15 Ogos 16 Ogos 2016. Bukan semua kod pendek akan dipetakan pada masa ini (anggaran kami mungkin 100 pemalam), tetapi pemetaan akan dilakukan secara berterusan dan pelanggan akan mendapatkannya sebaik sahaja yang baharu dilancarkan.
Langgan surat berita kami untuk mendapatkan berita mengenai pemetaan kod pendek, tarikh pelancarannya, dan apabila kami membuka pemetaan kod pendek kepada orang ramai!