Color picker ve Icon picker

Bu sayfa iki küçük seçici türünü kapsar: onaltılık renk saklayan Color picker ve bir Dashicons sınıf adı saklayan Icon picker.

Color picker

WordPress'in kendi renk seçicisiyle seçilen, #ff0000 gibi tek bir hex renk saklar.

Nelerin kabul edildiği

Değer bir hex renk olmalıdır: # ardından 3 veya 6 onaltılık rakam. Harf büyüklüğü küçük harfe çevrilir.

Saydamlık (alfa) desteklenmez. Reddedilen değer alanı boş kaydeder.

Bu tür için uzunluk kuralları yok sayılır (oluşturucu bunları sunmaz).

Şablonda kullanım

$color = wpmcf_get_field( 'brand', 'accent' );      // "#ff6600" or null

if ( $color ) {
    printf( '<div style="background-color:%s">Sale</div>', esc_attr( $color ) );
}

[wpmcf_field group="brand" field="accent" wrap="false"]   → #ff6600

Shortcode ve wpmcf_the_field() yalnızca kodu yazdırır, renkli bir kutu değil. Bir style niteliğinin veya CSS değişkeninin içinde kullanın:

echo '<style>:root{--accent:' . esc_html( (string) wpmcf_get_field( 'brand', 'accent', 'option' ) ) . ';}</style>';

Düzenleme ekranı

Bir metin kutusunun yanında küçük bir renk örneği. Tıklamak çekirdek renk seçiciyi açar (bir renk çarkı ve hex kodu için bir metin kutusu). Ön yüz formlarında (Pro) alan, #000000 yer tutucusuyla düz bir metin kutusudur.

Icon picker

WordPress ile birlikte gelen Dashicons setinden (yönetim menüsünün simgeleri) tek bir simge saklar.

Düzenleme ekranı

Bir Choose icon düğmesi, aranabilir bir simge ızgarası açar. Seçimden sonra düğme simgeyi ve adını gösterir; Clear simgeyi kaldırır.

Nelerin kabul edildiği

dashicons-admin-home ve admin-home ikisi de dashicons-admin-home olarak kaydedilir. Dashicons simgesi olmayan bir ad (nope-icon) veya yalnızca önek reddedilir ve alan boş kaydedilir. Geçerli adların listesi WordPress kurulumunuzdan okunur; bu yüzden WordPress sürümüne göre değişir.

Şablonda kullanım

$icon = wpmcf_get_field( 'service', 'icon' );          // "dashicons-admin-home"
if ( $icon ) {
    printf( '<span class="dashicons %s" aria-hidden="true"></span>', esc_attr( $icon ) );
}

[wpmcf_field group="service" field="icon" wrap="false"]

Alanı yazdırmak, çekirdeğin normalde yalnızca oturum açmış kullanıcılar için yüklediği dashicons stil dosyasını ön yüzde yükler. Yalnızca sınıf adına ihtiyacınız varsa (örneğin başka bir simge yazı tipi kullanmak için), onu wpmcf_get_field() ile okuyun ve eşlemeyi kendiniz yapın.

Dashicons, WordPress'in yönetim simgeleridir. Marka simgeleri veya özel SVG'ler için SVG dosyalı bir Image alanı ya da simge kitaplığınızın sınıfını tutan bir Text alanı kullanın.

Sorun giderme

• Renk alanı kaydettikten sonra boş. Değer, başında # olan 3 veya 6 haneli bir hex renk değildi.
• Simge sitede görünmüyor. Shortcode'u veya wpmcf_the_field() işlevini kullanın (Dashicons stil dosyasını yüklerler) ya da sınıfı yazdırırken dashicons dosyasını kendiniz kuyruğa ekleyin.
• Simgemi seçicide bulamıyorum. Yalnızca çekirdek Dashicons listelenir.