Saat Segalanya Menjadi Sedikit Teknis: Bagaimana Kami Mewujudkan Pemetaan Shortcode Versi Kami

Ditulis oleh

dalam

,

How-We-Made-Our-Version-Of-Shortcode-Mapping-Happen-2Pada artikel sebelumnya, kami telah membahas dasar-dasar pemetaan shortcode dan bagaimana Anda bisa mendapatkan manfaat manisnya. Kami telah memutuskan untuk memisahkan artikel yang menampilkan fitur Pemetaan Shortcode versi Page Builder Sandwich, karena ulasan berikut mungkin menjadi sedikit lebih teknis.

Berikut adalah penjelasan lebih mendalam mengenai cara kerja internal dari fitur pemetaan shortcode kami, dan bagaimana kami membuatnya berfungsi.

Proses Otomatis

Untuk menentukan plugin mana yang akan disertakan dalam pemeta shortcode, kami membangun skrip otomatis yang akan mengumpulkan plugin teratas di direktori plugin WordPress berdasarkan kriteria berikut:

  • Termasuk dalam 1.000 plugin populer, berperingkat teratas, dan diperbarui, Dengan setidaknya 4.000 instalasi aktif,
  • Dengan setidaknya 4.000 instalasi aktif,
  • Dengan setidaknya 20 penilaian, dan;
  • Dengan peringkat rata-rata setidaknya bintang 3

Kami menjalankan kueri ini setiap hari terhadap direktori plugin WordPress. Filter-filter ini memastikan bahwa kami mendapatkan daftar plugin berkualitas baik yang digunakan oleh banyak orang. Pada saat tulisan ini dibuat, kriteria ini menghasilkan 800 plugin. Itu sangat banyak. Benar-benar banyak.

Beberapa plugin paling populer yang terdeteksi untuk pemetaan shortcode.
Beberapa plugin paling populer yang terdeteksi untuk pemetaan shortcode.

Kami kemudian menjalankan serangkaian pemeriksaan otomatis pada kode sumber setiap plugin untuk mencari tahu apakah plugin tersebut memuat shortcode, dan kemudian kami mencoba menemukan semua shortcode tersebut, termasuk seluruh atributnya. Setelah mengolah datanya, ini menghasilkan lebih dari 2.000 shortcode. Sungguh luar biasa. Shortcode yang terdeteksi kemudian dimasukkan ke dalam basis data pemetaan shortcode untuk diperiksa secara manual.

Pada akhir proses ini, kami memperoleh daftar plugin yang sangat banyak beserta kemungkinan shortcode-nya. Sekarang tinggal membersihkan data ini guna memastikan semuanya benar.

Proses Manual

Ini mungkin merupakan bagian tersulit dari keseluruhan sistem pemetaan. Kode plugin hadir dalam berbagai bentuk dan ukuran, tidak semua shortcode terdeteksi secara otomatis oleh skrip kami. Meskipun WordPress Codex menyarankan untuk menggunakan fungsi `shortcode_atts` guna menyaring atribut shortcode, ini hanyalah rekomendasi dan tidak semua orang menerapkannya. Selain itu, tidak ada cara pasti untuk memeriksa isi dari sebuah shortcode ketika sebuah plugin dipasang.

Untuk memastikan bahwa kami mendapatkan semua shortcode dan atributnya dengan benar, kami membuat area antarmuka (front end) khusus untuk mengedit shortcode dan atribut yang dibangun menggunakan AngularJS dan Bootstrap.

Antarmuka Bootstrap & AngularJS untuk memperbaiki semua shortcode yang dipetakan.
Antarmuka Bootstrap & AngularJS untuk memperbaiki semua shortcode yang dipetakan.

Kami harus memeriksa setiap plugin secara manual satu per satu, meninjau dokumentasi shortcode-nya, dan memastikan bahwa semua data yang kami miliki sudah tepat.

Meskipun hal ini sangat melelahkan dan memakan waktu, ada beberapa keuntungan dari adanya proses otomatis:

  • Menurut statistik awal kami, hanya sekitar 1 dari setiap 2 plugin yang memiliki shortcode.
  • Separuh dari shortcode yang terdeteksi tidak memiliki atribut (meski sebagian di antaranya mungkin merupakan positif palsu)
  • Dengan hanya memilih plugin berkualitas baik, kemungkinan besar plugin tersebut memiliki dokumentasi shortcode

Ketika semua shortcode dari suatu plugin telah selesai diperiksa, barulah server mulai mendistribusikan pemetaan shortcode plugin tersebut kepada para pengguna.

Panggilan REST API

Bagian terakhir dari teka-teki ini adalah plugin itu sendiri. Konsepnya sederhana: cari tahu plugin apa saja yang aktif, tema apa yang digunakan situs, dan shortcode apa saja yang tersedia, lalu tanyakan kepada basis data pemetaan shortcode apakah ia memiliki pemetaannya. Untuk ini, kami membuat endpoint kustom WP REST API yang dihubungi oleh semua klien untuk mendapatkan pemetaan shortcode terbaru mereka.

Masa Depan: Crowdsourcing

Memeriksa setiap plugin secara manual membutuhkan banyak waktu dan usaha. Setelah platform pemetaan shortcode ini stabil, kami berencana untuk membuka pemetaan shortcode kepada semua orang. Ini berarti siapa saja dapat ikut membantu menambahkan shortcode.

Anda mungkin berpikir, “mengapa saya harus membantu memetakan shortcode? Apa keuntungan bagi saya?” Ada beberapa alasan mengapa orang-orang bersedia membantu:

  1. Jika Anda telah membuat plugin, dan kami belum menjaringnya karena kriteria di atas (dan plugin tersebut ada di direktori plugin WordPress), maka Anda dapat menambahkan pemetaannya sendiri. Plugin Anda akan didukung penuh oleh PBS!
  2. Karena kami hanya akan memproses plugin yang ada di direktori plugin WordPress dalam proses otomatis, pengembang plugin & tema premium tidak akan disertakan. Jadi, jika Anda memilikinya, Anda juga dapat menambahkan pemetaan shortcode Anda sendiri.
  3. Dan bagi yang bukan pembuat plugin, kami dapat memberi penghargaan kepada siapa pun yang membantu. Untuk menjadikan pemetaan shortcode sebagai kegiatan yang menarik, kami dapat memberikan penghargaan kepada para pembantu setia berupa lisensi personal, atau peningkatan ke lisensi premium PBS!

Daftar ke Buletin Kami

Fungsi pemetaan shortcode untuk pelanggan kami direncanakan akan hadir secara tentatif pada 12 Agustus  15 Agustus  16 Agustus 2016. Belum semua shortcode akan selesai dipetakan pada saat ini (perkiraan kami mungkin sekitar 100 plugin), tetapi proses pemetaan akan terus berjalan secara berkesinambungan dan pelanggan akan langsung menerimanya segera setelah pemetaan baru dirilis.

Daftarlah ke buletin kami untuk mendapatkan kabar terbaru seputar pemetaan shortcode, jadwal perilisannya, serta saat kami membukanya untuk umum!