Banyak yang telah berubah sejak kegilaan yang http://drupal.org/node/1092444 . Untungnya, membuat tema dan mengatur format tampilan untuk entitas file sekarang jauh lebih mudah dan lebih mudah.
Dokumentasi berikut adalah untuk Media 2.x dan Entitas File , meskipun sebagian besar berfungsi dengan Media 1.x dengan sedikit perubahan (misalnya, di Media 1.x, tautan ke halaman "Jenis File" ada di Konfigurasi bukan Struktur. ).
Menampilkan Media
The Berkas Entity dan Media modul bekerja sama untuk menyediakan sebuah metode bersatu untuk menyimpan, mengelola, dan menampilkan Media di Drupal. Mereka memungkinkan pengguna untuk membuat bidang file yang dapat dikonfigurasi untuk menyimpan dan menampilkan berbagai jenis media, termasuk gambar, video, dan audio. diantara yang lain. Untuk menampilkan berbagai jenis media ini, bidang file memerlukan pemformat, seringkali disediakan oleh modul yang menyediakan jenis Media, dan sedikit konfigurasi tambahan.
Definisi
Saya akan menjelaskan beberapa bagian yang bergerak terlebih dahulu, dan kemudian menyesuaikan tampilan file di situs.
Jenis file
File dikelompokkan ke dalam Jenis File . Setiap jenis file ditentukan oleh daftar tipe mime , cara universal menentukan format file di internet. Jenis file default adalah Aplikasi, Audio, Gambar, Teks, Video, dan Lainnya. Saat ini tidak ada cara untuk menentukan jenis file baru di UI.
Lihat Mode
Mode Tampilan digunakan untuk memberi tahu Drupal 7 (dan segera 8) bahwa suatu konten dalam konteks tertentu. Konten kemudian dapat diubah atau ditampilkan dengan cara yang paling sesuai dengan konteks itu. Dua mode tampilan yang kebanyakan orang mungkin akrab dengan adalah penggoda default dan mode penuh . Mode tampilan kustom dapat didefinisikan dengan modul seperti Mode Tampilan Entitas , Tampilan Suite , atau dalam modul kustom dengan hook_entity_info_alter()
.
The Good Stuff, atau: Mengelola tampilan File Field Anda
Tampilan bidang file dikelola per jenis file . Arahkan ke Struktur -> Jenis File. Anda akan melihat daftar jenis file yang tersedia dengan tautan ke "Kelola bidang", "Kelola tampilan", dan "Kelola tampilan file" untuk masing-masing.
Kelola Fields
Modul Entitas File membuat semua file entitas yang dapat diisi penuh, sama dengan node dan istilah taksonomi. Sama seperti di bagian "Jenis konten", Anda dapat menambahkan bidang khusus ke setiap jenis file.
Kelola Tampilan
Sekali lagi, seperti di "Jenis konten", Anda dapat mengelola tampilan bidang khusus pada setiap jenis file. Bagian ini tidak mengontrol pemformatan file itu sendiri , hanya tampilan bidang yang dilampirkan ke entitas file.
Di bagian ini Anda juga akan melihat toggle untuk "Pengaturan Tampilan Kustom". Saat diperluas, Anda dapat mengaktifkan dan menonaktifkan mode tampilan yang tersedia untuk entitas ini. Mode tampilan harus diperiksa di sini agar tersedia di "Kelola Tampilan File". Pada saat ini, disarankan untuk hanya menggunakan mode tampilan khusus yang ditentukan oleh pengguna dan mode tampilan default berikut; sisanya ditinggalkan dari integrasi modul Styles dan pada akhirnya akan dihapus :
- "Teaser" (Saat ini tidak termasuk secara default. Anda dapat menambahkannya dengan tambalan dalam masalah di atas atau mendefinisikannya sebagai mode tampilan khusus)
- "Penuh"
- "Pratinjau" (Digunakan dalam konteks admin, misalnya, untuk placeholder di bidang WYSIWYG, di browser Media, dan di widget bidang Media)
Kelola Tampilan File
Di "Kelola Tampilan File" Anda dapat mengonfigurasi format untuk tipe file Anda (ya!). Banyak modul penyedia Media menambahkan pemformatnya sendiri di sini; misalnya, Media: Youtube dan Media: Vimeo keduanya menyediakan formatter "Pratinjau Gambar" dan "Video".
Pemformat dapat diaktifkan dan dikonfigurasikan untuk setiap mode tampilan yang diaktifkan di bagian "Kelola Tampilan" jenis file mereka. Misalnya, pengguna mungkin ingin menampilkan gambar pratinjau Media: Vimeo saat sebuah simpul dipandang sebagai penggoda, video Vimeo saat simpul penuh dilihat, dan video dengan pengaturan lebar dan tinggi yang berbeda saat pengaturan simpul dilihat oleh mode tampilan khusus yang disebut "galeri video". Banyak pemformat (terutama "Gambar") memungkinkan pengguna untuk memilih gaya gambar yang telah mereka tetapkan dalam Konfigurasi -> Gaya Gambar.
Karena beberapa penyedia media dapat menggunakan bidang yang sama, pembuat format disusun dalam kaskade dari atas ke bawah. Drupal akan menggunakan formatter pertama yang dapat diterapkan pada output bidang. Jika bidang video mengaktifkan format format "Media: Youtube Video", "Media: Vimeo Video", dan "Large filetype ikon" untuk mode tampilan "Penuh", Drupal akan menggunakan formatter Youtube jika tipe mime file adalah video/youtube
, Vimeo formatter jika tipe mime adalah video/vimeo
, dan kembali ke ikon tipe file besar jika tipe mime adalah video/{anything else}
.
Mengkonfigurasi Bidang File untuk ditampilkan menggunakan pengaturan "Kelola Tampilan File"
Agar bidang file ditampilkan menggunakan pemformat yang ditentukan dalam "Kelola Tampilan File", itu harus diatur untuk menampilkan "file yang diberikan". Arahkan ke halaman "Kelola Tampilan" untuk jenis konten yang berisi bidang file Anda. Pilih "File yang Diubah" sebagai format bidang file untuk semua mode tampilan di mana Anda ingin menggunakan pemformat yang didefinisikan dalam "Kelola Tampilan File".
Selanjutnya
Anda dapat membuat fungsi tema khusus dan file templat untuk kontrol lebih lanjut dengan penggantian kait tema . Saran tema yang disediakan oleh modul Entitas File adalah:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Ganti semua '/' dan '__' dalam tipe mime dengan '_' untuk fungsi tema dan '-' untuk file templat.
Beberapa modul penyedia Media menggantinya dengan templat mereka sendiri dan saran tema kait. Anda dapat melihat semua saran kait tema yang tersedia dengan modul Pengembang Tema Devel, Helper Mothership's Poor Themer , atau semoga berkonsultasi dengan dokumen penyedia untuk info lebih lanjut.
Outro
Semoga ini membantu. Saya berencana menambahkan ini ke dokumentasi Media, jadi jika saya melewatkan sesuatu, salah mengeja di suatu tempat, atau bagian perlu klarifikasi, beri tahu saya.
Dan beberapa jawaban singkat untuk pertanyaan spesifik OP:
- Media 1.x vs 2.x: meskipun 2.x tidak stabil, ini dapat diandalkan seperti banyak modul versi stabil di Drupal.org. Saya pikir ini layak digunakan untuk fitur-fitur yang jauh lebih baik, tetapi karena ada begitu banyak pekerjaan yang terjadi pada dukungan dalam antrian masalah lambat, dan karena dengan cabang dev pembaruan baru dapat merusak implementasi Anda. Tetap saja, saya menggunakannya untuk produksi.
- Media sedang dalam pengembangan. Beberapa hal tidak berfungsi seperti yang Anda harapkan (misalnya, integrasi WYSIWYG non-gambar). Tetapi masih bekerja lebih baik pada apa yang dilakukannya daripada kombinasi modul Anda harus menginstal untuk melakukan apa yang dilakukannya tanpa itu. Dan itu semakin baik.