Image ve File

Her iki tür de bir ortam kitaplığı öğesini, ek kimliğiyle (attachment ID) saklar. Dosyanın kendisi ortam kitaplığında kalır; alan yalnızca hangisi olduğunu hatırlar.

Birden çok görsel mi gerekiyor? Gallery türü (Pro) bir liste saklar; bkz. Pro alan türleri.

Tür ayarları

Türler sınırlandırıldığında ortam kitaplığı iletişim kutusu yalnızca eşleşen dosyaları sunar ve boş düğme izin verilen uzantıları gösterir (örneğin JPG, PNG). Bir ek, uzantısı veya MIME türü eşleşirse kabul edilir.

Düzenleme ekranı

Düğmeye tıklamak ortam kitaplığını açar; editörler burada yeni bir dosya da yükleyebilir. İzin verilen türlerle eşleşmeyen bir dosya, alanın altında bir iletiyle reddedilir.

Ön yüz formlarında (Pro) alan düz bir dosya yüklemesi olur; form dosyayı gönderildiğinde yükler ve mevcut dosya için bir Remove onay kutusu gösterir.

Kaydederken nelerin kabul edildiği

Değer, doğru türde mevcut bir ek kimliği olmalı ve (sınırlandırılmışsa) izin verilen bir türde olmalıdır. Bunun dışındaki her şey alanı temizler.

Şablonda kullanım

$id = wpmcf_get_field( 'team', 'photo' );          // 712  (int) or null

if ( $id ) {
    echo wp_get_attachment_image( $id, 'large', false, [ 'class' => 'team-photo' ] );
    $url = wp_get_attachment_image_url( $id, 'full' );      // "http://example.com/wp-content/uploads/2026/10/photo.jpg"
}

wpmcf_the_field( 'team', 'photo' );
// <span class="wpmcf-field-value"><img width="300" height="200" src="…/photo-300x200.jpg"
//   class="attachment-medium size-medium" alt="…" decoding="async" srcset="…" /></span>

[wpmcf_field group="team" field="photo" wrap="false"]
[wpmcf_field group="docs" field="brochure" wrap="false"]
→ <a href="http://example.com/wp-content/uploads/2026/10/brochure.pdf">Product brochure</a>

• Image çıktısı WordPress'in kendi wp_get_attachment_image() işlevidir; bu nedenle srcset, sizes, tembel yükleme ve ekin Alternative Text değeri dahildir.
• File çıktısı, metni ekin Title değeri olan (başlık boşsa dosya adı) bir bağlantıdır.
• Ek ortam kitaplığından silinmişse saklanan kimlik kalır ama hiçbir şey yazdırılmaz (wpmcf_get_field() yine eski kimliği döndürür). Önemliyse wp_get_attachment_url( $id ) ile kontrol edin.
• Görsel olmayan bir ek tutan Image alanı veya eki silinmiş bir File alanı hiçbir şey yazdırmaz.

Ayrıca WPM Field bloğu ve WPM Fields blok bağlaması, bir Image alanını görsel kaynağı olarak kullanabilir (bkz. Bloklar ve blok bağlamaları).

İçe aktarma

CSV içe aktarmaları sayısal bir ek kimliğini veya bu sitenin ortam kitaplığındaki bir dosyanın URL'sini kabul eder; URL kimliğe çevrilir. Kitaplıkta olmayan dosyalar indirilmez.

Sorun giderme

• Görsel çok küçük veya çok büyük görünüyor. Image size on the site ayarını değiştirin veya wp_get_attachment_image() içindeki bir boyutla kendiniz yazdırın.
• SVG veya başka bir dosya seçemiyorum. WordPress, dosya türüne yüklemede izin vermeli ve bir tane belirlediyseniz tür Allowed file types içinde olmalıdır.
• Dosyayı sildikten sonra alanda hiçbir şey seçili görünmüyor. Ek artık yok; yeni bir dosya seçip kaydedin.
• Bağlantıyı değil, dosyanın URL'sini istiyorum. wp_get_attachment_url( wpmcf_get_field(...) ) kullanın.