Alan türlerine genel bakış

Son güncelleme 3 Eki 20265 dk okuma

Alan türü, bir alan hakkında dört şeyi belirler: editörlerin gördüğü denetim, değerin saklandığı veritabanı sütunu, değerin kaydedilmeden önce nasıl temizlendiği ve sitenizde nasıl yazdırıldığı. Mass Custom Fields, ücretsiz eklentide 32 alan türü sunar. Pro eklenti dört tür daha ekler (bkz. Pro alan türleri).

Türü, WPM Fields › Field Groups ekranında bir alan eklerken seçersiniz (bkz. Alan grupları). Seçici türleri şu gruplara ayırır: Basic, Choice, Content, Relational ve Layout.

Bir değer nasıl yol alır

Bir editör düzenleme ekranında bir değer yazar veya seçer (ya da wpmcf_update_field() veya REST API ile bir değer gönderilir).
Alan türü değeri temizler. Türün kabul edemediği her şey atılır ve alan boş (NULL) kaydedilir. Bir değer asla yarı geçerli kaydedilmez.
Değer, alan grubu tablosunda alanın sütununa yazılır.
wpmcf_get_field() sütunu okur ve bir PHP değeri (string, sayı, boolean veya dizi) döndürür. wpmcf_the_field() ve [wpmcf_field] kısa kodu ise biçimlendirilmiş ve escape edilmiş bir sürümünü (bağlantı, etiket, gömülü içerik) yazdırır.

Okuma, Çıktı, biçimler ve escape işlemi sayfasında anlatılır; fonksiyonların kendisi Geliştirici API'si bölümünde belgelenmiştir.

Tüm ücretsiz türler

Tür kimliği (Type id), dışa aktarmalarda, REST API'de ve PHP'de kullanılan değerdir. "Döndürür" sütunu, wpmcf_get_field() fonksiyonunun size verdiği değerdir.

Basic

Tür (arayüz etiketi)	Tür kimliği	Sütun	Döndürür	Çıktı biçimi	Sayfa
Text	`text`	`VARCHAR(255)`	string	metin	Metin alanları
Text area	`textarea`	`LONGTEXT`	string (satır sonları korunur)	metin	Metin alanları
Number	`number`	`DECIMAL(20,6)`	`int` veya `float`	sayı	Sayı ve aralık
Range	`range`	`DECIMAL(20,6)`	`int` veya `float`	sayı	Sayı ve aralık
Email	`email`	`VARCHAR(254)`	string	adres	Metin alanları
URL	`url`	`TEXT`	string	URL	Metin alanları
Password	`password`	`VARCHAR(255)`	saklanan karma (hash) veya mühürlenmiş metin, parolanın kendisi asla	hiçbir şey (izin verilmedikçe)	Password
Color picker	`color_picker`	`VARCHAR(9)`	şu biçimde string: `#ff0000`	onaltılık renk kodu	Renk ve simge

Choice

Tür (arayüz etiketi)	Tür kimliği	Sütun	Döndürür	Çıktı biçimi	Sayfa
Select	`select`	`VARCHAR(191)`	saklanan değer (string)	seçenek etiketi	Seçim alanları
Radio buttons	`radio`	`VARCHAR(191)`	saklanan değer	seçenek etiketi	Seçim alanları
Checkboxes	`checkbox`	`JSON`	saklanan değerlerin dizisi	etiketler, virgülle ayrılmış	Seçim alanları
Button group	`button_group`	`VARCHAR(191)`	saklanan değer	seçenek etiketi	Seçim alanları
True / false	`true_false`	`TINYINT(1)`	`true` / `false`	"Yes" / "No" veya kendi etiketleriniz	Seçim alanları

Content

Tür (arayüz etiketi)	Tür kimliği	Sütun	Döndürür	Çıktı biçimi	Sayfa
Date	`date_picker`	`DATE`	string `Y-m-d`	biçimlendirilmiş tarih	Tarih ve saat
Tarih ve saat	`date_time_picker`	`DATETIME`	string `Y-m-d H:i:s`	biçimlendirilmiş tarih ve saat	Tarih ve saat
Time	`time_picker`	`TIME`	string `H:i:s`	biçimlendirilmiş saat	Tarih ve saat
Link	`link`	`JSON`	dizi: `url`, `title`, `target`	bir `<a>` öğesi	Zengin içerik
WYSIWYG editor	`wysiwyg`	`LONGTEXT`	HTML string	paragraflar ve kısa kodlar içeren HTML	Zengin içerik
oEmbed	`oembed`	`TEXT`	URL string	sağlayıcının gömülü içeriği	Zengin içerik
Image	`image`	`BIGINT(20) UNSIGNED`	ek kimliği (int)	bir `<img>` öğesi	Görsel ve dosya
File	`file`	`BIGINT(20) UNSIGNED`	ek kimliği (int)	dosyaya bir bağlantı	Görsel ve dosya
Icon picker	`icon_picker`	`VARCHAR(191)`	`dashicons-…` sınıfı	simge	Renk ve simge
Map	`map`	`JSON` + 2 koordinat sütunu	dizi: `address`, `lat`, `lng`, `zoom`	adres, harita ve bağlantı	Map

Relational

Tür (arayüz etiketi)	Tür kimliği	Sütun	Döndürür	Çıktı biçimi	Sayfa
Relationship	`relationship`	`JSON`	yazı kimliklerinin dizisi	bağlantılı başlıkların listesi	İlişkisel alanlar
Post object	`post_object`	`BIGINT(20) UNSIGNED`	tek bir yazı kimliği (int)	bağlantılı bir başlık	İlişkisel alanlar
Page link	`page_link`	`BIGINT(20) UNSIGNED`	tek bir yazı kimliği (int)	kalıcı bağlantı, link olarak	İlişkisel alanlar
Taxonomy	`taxonomy`	`JSON`	terim kimliklerinin dizisi	terim adları, bağlantılı	İlişkisel alanlar
User	`user`	`JSON`	kullanıcı kimliklerinin dizisi	görünen adlar	İlişkisel alanlar

Layout

Tür (arayüz etiketi)	Tür kimliği	Sütun	Döndürür	Çıktı biçimi	Sayfa
Group	`group`	`JSON`	alt alana göre anahtarlanmış dizi	hiçbir şey (alt alanı `path` ile okuyun)	Group
Repeater	`repeater`	`JSON`	satır dizilerinin listesi	sıralı bir liste	Repeater
Accordion	`accordion`	yok	yok	hiçbir şey	Akordeon ve sekme
Tab	`tab`	yok	yok	hiçbir şey	Akordeon ve sekme

Accordion ve Tab yalnızca düzenleme ekranını düzenler. Sütun oluşturmaz ve değer tutmaz.

Her sütun türü sizin için ne anlama gelir

Sütun	Pratik etkisi
`VARCHAR`, `CHAR`, `DATE`, `TIME`, `DATETIME`, sayılar, `TINYINT`	Filtrelemesi ve sıralaması hızlıdır. Alanın Constraints bölümünden bir dizin ekleyebilirsiniz (bkz. Alan grupları).
`TEXT`, `LONGTEXT`	Uzun metin saklar. Dizinleme, metnin bir önekini kullanır.
`JSON`	Yapılandırılmış değerleri (listeler, nesneler) saklar. Tek başına dizinlenemez.
Eşlik eden sütunlar (Map)	Harita, enlem ve boylamını iki ek sayı sütununda tutar; böylece uzaklığa göre arama yapabilirsiniz.

MySQL ve MariaDB bir JSON nesnesinin (Group, Map, Link) anahtarlarının sırasını değiştirebilir. Değerleri her zaman konuma göre değil, anahtara göre okuyun.

Tür seçimi

Saklamak istediğiniz	Kullanılacak tür
Kısa bir etiket, bir ad, bir telefon numarası	Text
Biçimlendirmesiz bir paragraf	Text area
Bir fiyat, bir miktar, bir puan	Number (kaydırıcı için Range)
Evet/hayır	True / false
Kısa bir listeden bir seçenek	Select, Radio buttons veya Button group
Bir listeden birkaç seçenek	Checkboxes
Biçimlendirilmiş bir makale bölümü	WYSIWYG editor
Bir düğme veya eylem çağrısı	Link
YouTube veya Vimeo'dan bir video	oEmbed
Bir resim veya indirilebilir bir belge	Image / File
Bir konum	Map
Başka bir yazı, sayfa, terim veya kullanıcı	Post object, Page link, Relationship, Taxonomy, User
Birbiriyle ilgili değerler kümesi (bir adres)	Group
Tekrarlayan blokların listesi (SSS maddeleri, ekip üyeleri)	Repeater
Bir editörün belirlediği ve kodunuzun yalnızca doğruladığı bir gizli bilgi	Password

Her türün ortak ayarları

Tüm türler varsayılan değer, zorunluluk, doğrulama, görünüm ve koşullu mantık için aynı panelleri paylaşır. Bkz. Her alanın ortak ayarları.

Bilmeniz gereken sınırlar

Kapsayıcılar (Group, Repeater) başka bir Group veya Repeater içine yerleştirilemez. Password alanları da alt alan olamaz. Bkz. Group.
Programatik SEO veri kaynakları yalnızca tek bir basit değer saklayan türleri kabul eder: Checkboxes, Link, Map, Relationship, Taxonomy, User, Group veya Repeater kabul edilmez.
Ön yüz formları (Pro) Icon picker, Map, Post object, Page link, Relationship veya User alanlarını gösteremez, çünkü bu alanların denetimleri yönetim panelini gerektirir.
Alan anahtarları SQL sözcükleri veya sistem sütun adları olmamalıdır. on, when, order, group, index, id veya uid gibi anahtarlar ile çift alt çizgi (__) içeren anahtarlar, alt alanlar dahil, grubu kaydederken reddedilir. when yerine start_date, order yerine row_order kullanın.

Geliştiriciler

Kendi alan türlerinizi wpmcf/field_types/register action'ına kaydedebilirsiniz. Bkz. Geliştirici API'si.

Sorun giderme

Bkz. Alan türleri sorun giderme.

Bu sayfa yardımcı oldu mu?

Hâlâ takıldınız mı? Destek ile iletişime geçin