Bagaimana Menambah Parameter pada Proses yang Dilakukan pada wp.media

wp.media adalah library JavaScript yang digunakan oleh WordPress untuk mengelola media, seperti gambar, video, audio, dan dokumen. Library ini memungkinkan Anda untuk membuka media modal, memilih media dari library, mengupload media baru, mengedit media, dan lain-lain. Library ini sangat berguna dan fleksibel, namun juga memiliki beberapa keterbatasan.

Salah satu keterbatasan yang sering dihadapi oleh developer adalah bagaimana menambah parameter pada proses yang dilakukan pada wp.media. Parameter adalah variabel yang digunakan untuk mengirim atau menerima informasi tambahan pada suatu proses. Parameter bisa berguna untuk berbagai keperluan, seperti:

• Mengatur hak akses atau visibilitas dari media yang diupload atau dipilih
• Mengatur jenis atau format dari media yang diupload atau dipilih
• Mengatur metadata atau informasi tambahan dari media yang diupload atau dipilih
• Mengatur filter atau pengurutan dari media yang ditampilkan pada daftar gambar di media modal

Namun, wp.media tidak menyediakan cara mudah untuk menambah parameter pada proses yang dilakukan pada wp.media. Anda tidak bisa langsung menambah parameter pada fungsi wp.media() atau wp.Uploader(). Anda harus menggunakan cara lain untuk menambah parameter pada proses yang dilakukan pada wp.media.

Pada artikel ini, saya akan menjelaskan dua cara untuk menambah parameter pada proses yang dilakukan pada wp.media, yaitu:

• Menggunakan properti multipart_params pada wp.Uploader.defaults
• Menggunakan properti library pada fungsi wp.media()

Menggunakan Properti multipart_params pada wp.Uploader.defaults

menambah parameter pada proses yang dilakukan pada wp.media adalah dengan menggunakan properti multipart_params pada wp.Uploader.defaults. Properti multipart_params ini berguna untuk menambah parameter pada proses upload media. Properti ini berisi objek yang berisi pasangan nama dan nilai dari parameter yang ingin ditambahkan.

Untuk menggunakan properti multipart_params ini, Anda bisa menggunakan kode berikut:

if (typeof window.wp !== "undefined" && typeof window.wp.Uploader !== "undefined") {
  window.wp.Uploader.defaults.multipart_params._file_in_private= "yes";
  window.wp.Uploader.defaults.multipart_params._file_doc_only = "yes";
}

Kode ini akan menambah dua parameter pada proses upload media, yaitu:

• _file_in_private: parameter ini digunakan untuk mengatur bahwa media yang diupload adalah untuk private
• _file_doc_only: parameter ini digunakan untuk mengatur bahwa media yang diupload hanya boleh berformat doc

Anda bisa menyesuaikan nama dan nilai dari parameter sesuai dengan kebutuhan Anda. Anda juga bisa menambah lebih dari dua parameter jika diperlukan.

Menggunakan Properti library pada Fungsi wp.media()

menambah parameter pada proses yang dilakukan pada wp.media adalah dengan menggunakan properti library pada fungsi wp.media(). Fungsi wp.media() adalah fungsi yang digunakan untuk membuat media modal. Properti library ini berguna untuk menambah parameter pada proses pemilihan media dari library. Properti ini berisi objek yang berisi pasangan nama dan nilai dari parameter yang ingin ditambahkan.

Untuk menggunakan properti library ini, Anda bisa menggunakan kode berikut:

// Konfigurasi media uploader
customUploader = wp.media({
    title: 'Pilih File',
    button: {
        text: 'Pilih File'
    },
    library: {
        type: ['application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
        _file_in_private: "yes",
        _file_doc_only: "yes",
    },
    multiple: false
});

Kode ini akan menambah tiga parameter pada proses pemilihan media dari library, yaitu:

• type: parameter ini digunakan untuk mengatur bahwa media yang dipilih hanya boleh berjenis doc
• _file_in_private: parameter ini digunakan untuk mengatur bahwa media yang dipilih adalah untuk private
• _file_doc_only: parameter ini digunakan untuk mengatur bahwa media yang dipilih hanya boleh berformat doc

Anda bisa menyesuaikan nama dan nilai dari parameter sesuai dengan kebutuhan Anda. Anda juga bisa menambah lebih dari tiga parameter jika diperlukan.

Kesimpulan

wp.media adalah library JavaScript yang sangat berguna dan fleksibel untuk mengelola media pada WordPress. Namun, library ini juga memiliki beberapa keterbatasan, salah satunya adalah bagaimana menambah parameter pada proses yang dilakukan pada wp.media. Parameter bisa berguna untuk berbagai keperluan, seperti mengatur hak akses, jenis, format, metadata, filter, atau pengurutan dari media yang diupload atau dipilih.

Untuk menambah parameter pada proses yang dilakukan pada wp.media, Anda bisa memanfaatkan dua code di atas, yaitu:

• Menggunakan properti multipart_params pada wp.Uploader.defaults untuk menambah default parameter pada proses upload media
• Menggunakan properti library pada fungsi wp.media() untuk menambah parameter pada query media