jekcms'de Shortcode Yok — Yerine Ne Var

Bir Shortcode Sistemi Yok

jekcms'de bir [gallery] veya [youtube] shortcode'unun nasıl kaydedileceğini arıyorsanız, kısa cevap şu: yapamazsınız, çünkü kaydedecek bir shortcode ayrıştırıcısı yok. Kod tabanında bir ShortcodeParser sınıfı, bir process_shortcodes() hook'u veya köşeli-parantez sözdizimi ayrıştırma yok. Bu, özelliğin belgelenmemiş olması değil — basitçe orada değil.

Bunu düzeltmekle yetinmek yerine açıklamaya değer, çünkü shortcode'lar eski CMS'lerde belirli bir sorunu çözüyordu: düz metin bir içerik alanının içine dinamik, metin-olmayan bir öğeyi nasıl gömersiniz? jekcms'in bu sorunu baştan yok, çünkü editörü düz metin bir alan değil.

jekcms Bunun Yerine Neyi Kullanıyor: Gerçek Bir WYSIWYG Editör

jekcms'in post editörü, jekcms'in kendi jek-editor sarmalayıcısına sarılmış bir zengin metin düzenleme motoru olan Tiptap üzerine kuruludur. Görseller editörde doğrudan eklenir, boyutlandırılır, hizalanır ve altyazılanır — render sırasında genişletilen bir shortcode olarak değil, birinci sınıf <figure>/<figcaption> elemanları olarak. Düzenlerken gördüğünüz şey sayfada render edilen şeydir; ayrıştırılacak, doğrulanacak veya bir yazım hatasıyla yanlışlıkla bozulabilecek ara bir köşeli-parantez sözdizimi yoktur.

Shortcode'ların geleneksel olarak kullanıldığı belirli şeyler için:

• Görsel galerileri: editörün yerel görsel eklemesi üzerinden, satır içinde boyutlandırılmış ve hizalanmış olarak yönetilir. Ayrı bir galeri bloğu veya shortcode yok — görselleri modern herhangi bir zengin metin editöründe yerleştireceğiniz gibi yerleştirirsiniz.
• Video gömme: içeriğe doğrudan standart HTML olarak yapıştırılır veya gömülür (örneğin YouTube için bir <iframe>), tıpkı elle yazılmış herhangi bir HTML sayfasına video gömdüğünüz gibi.
• Bilgi kutuları ve özel biçimlendirme: yerleşik bir callout/bilgi kutusu blok tipi yoktur. Temanız buna ihtiyaç duyuyorsa, bu editör çıktısındaki standart bir HTML elemanı üzerinde bir CSS sınıfıdır, jekcms özelliği değil.

Gerçekten Yeniden Kullanılabilir, Tema-Seviyesi Bloklara İhtiyacınız Varsa

Shortcode'lar bazen medya gömmekten çok, birçok posta aynı anda yeniden kullanılabilir bir işaretleme parçası enjekte etmek için kullanılır — bir eylem çağrısı kutusu, bir fiyatlandırma tablosu. jekcms'de bu iş post içerik katmanına değil tema katmanına aittir. Her temanın functions.php dosyası, tema geliştiricilerinin yeniden kullanılabilir şablon parçalarını render etmek için kullandığı bir get_partial($name) yardımcısı sunar; Tema Özelleştirici seçenekleri bildiren temalar da renkler, özel CSS ve düzen tercihleri gibi şeyleri post içeriğine hiç dokunmadan düzenlemenize izin verir. Belirli bir bloğun post gövdelerinin İÇİNDE görünmesi gerekiyorsa (yalnızca etrafında değil), bu bugün editörde manuel bir HTML eklemesidir — yerine geçecek dinamik bir etiket sistemi yoktur.

Bu Neden Bilinçli Bir Ödünleşim

Bir shortcode ayrıştırıcısı aynı zamanda kullanıcı tarafından üretilen içeriğin içinde yaşayan küçük bir şablon dilidir — her ek köşeli-parantez sözdizimi, kaçırılmamış girdide bozulabilecek, bir yazarın gerçekten yazmak istediği düz köşeli parantezlerle çakışabilecek veya kendi XSS-sertleştirme geçişine ihtiyaç duyabilecek bir şey daha demektir. jekcms'in editörü, içeriği yazıldığı andan itibaren daha sonra genişletilen bir yer tutucu sözdizimi yerine gerçek, render edilebilir HTML olarak tutarak bu sorun sınıfının tamamının önüne geçer. Ödünleşim şu: birçok post arasında gerçekten dinamik ve yeniden kullanılabilir olması gereken her şeyin post içeriğinde değil temada yaşaması gerekir.