MevvCode Belgeleri

MevvCode ne içindir?

MevvCode, sitenize özel küçük davranışların evidir: WooCommerce kargo kuralı, ödeme alanı, doğrulama etiketi, kısa yönetim aracı, görsel CSS düzeltmesi ya da yeniden kullanılabilir HTML/metin. Koda bir sahip, konum, koşul, geçmiş ve yayına korumalı giriş verir.

Ne zaman kullanın?: Değişiklik tam bir eklentiden küçük ama tema dosyasının içinde kaybolmayacak kadar önemliyse.
Ne zaman kullanmayın?: Gereksinim kendi veri modeli, ekranları ve sürüm döngüsü olan eksiksiz bir alan ürünüyse olağan bir eklenti geliştirin.
Kodun sahipliği: Kodu kendiniz yazın veya geliştirici ya da güvendiğiniz kaynaktan incelenmiş kod alın. MevvCode kodu yönetir ve korur; bilinmeyen bir kodu güvenilir hâle getirmez.

Dışarıdan alınan her kodu devre dışı başlatın. Okuyun, sırları ve siteye özel kimlikleri çıkarın, sonra doğrulayıp etkinleştirin.

Kurulum

Önce ücretsiz MevvCode eklentisini kurup etkinleştirin. WordPress 6.6 veya yenisini ve PHP 8.1 veya yenisini ister. Pro ayrı bir yardımcı eklentidir; ücretsiz çalışma zamanının yerine geçmez.

mevvcode-1.1.0.zip paketini yükleyip etkinleştirin.
MevvCode → Kod Parçaları ekranını açın. Depolama klasörü ve web sunucusu koruma dosyaları otomatik oluşur.
Etkin olmayan bir kod parçası oluşturun; türünü ve konumunu seçip kaydedin.
Etkinleştirmeden önce önizleme ve sözdizimi sonucunu okuyun.
Yalnız Pro yüzeylerine ihtiyacınız varsa mevvcode-pro-1.1.0.zip paketini kurun ve MevvCode → Lisans altında MEVD lisansınızı etkinleştirin.

Pro kuruluyken ücretsiz eklentiyi açık tutun. Çalıştırılabilir yol Free tarafındadır; biten lisans yayındaki davranışı ortadan kaldırmaz.

İlk kod parçanız

İlk kaydı devre dışı oluşturun. Amacı anlatan bir ad verin; kod kendi içinde dar bir WordPress veya WooCommerce kancasına bağlanıyorsa PHP ve genel konumu seçip kaydedin.

add_filter( 'woocommerce_package_rates', function ( $rates ) {
    if ( ! WC()->cart || WC()->cart->get_subtotal() < 1000 ) {
        return $rates;
    }
    return array_filter( $rates, function ( $rate ) {
        return 'free_shipping' === $rate->method_id;
    } );
} );

Doğrulama sonucunu okuyun; ayrıştırma hatası kaydı devre dışı bırakmalıdır.
Mağazanızda ücretsiz kargo yönteminin zaten tanımlı olduğunu doğrulayın.
Kodu hazırlık ortamında etkinleştirip eşiğin altındaki ve üstündeki sepetleri deneyin.
Kaydı üretime taşımadan önce JSON kopyasını dışa aktarın.
Yayımlayın, ardından açık sepeti ve MevvCode sağlık ucunu doğrulayın.

Örnek, evrensel kargo politikası değil iş akışı gösterir. Vergi, kupon, para birimi ve kargo bölgeleri iş kuralınızın hangi ara toplamı kullanacağını değiştirebilir.

Türkçe yönetim paneli ve eklenti satırı

Ücretsiz ve Pro 1.1.0 paketleri düzenlenebilir PO, derlenmiş MO ve POT kataloglarıyla gelir. WordPress site dili Türkçe (tr_TR) olduğunda yönetim paneli, geçiş durumları, doğrulama hataları ve lisans ekranı otomatik Türkçe yüklenir.

Eklentiler ekranında açıklama Türkçe görünür.
Ayarlar doğrudan MevvCode ayar sekmesini açar.
Belgeler bu sayfayı, Destek iletişim sayfasını açar.
WordPress bağımlılık yönetimi, MevvCode Pro ona gerek duyarken Ücretsiz paketin kaldırılmasını engeller.

Türkçe panel yüklenmezse Ayarlar → Genel → Site Dili alanını denetleyin; ardından Ücretsiz ve Pro’yu aynı sürüme güncelleyin. languages klasöründeki dosyaları yeniden adlandırmayın.

Çalışma zamanı modeli

Düzenlenebilir kayıtlar wp-content/mevvcode-snippets/records altında durur. Etkin bir değişiklik kaydedilince geçici klasörde yeni bir nesil oluşturulur, bütün PHP dosyaları doğrulanır, manifest yazılır ve ancak bundan sonra güncel işaretçisi değiştirilir.

Kayıtlar: Düzenlenebilir kaynak kod, üst veri, koşullar ve geçmiş.
Nesil: Çalıştığı bilinen tek bir duruma ait değişmez derlenmiş dosyalar.
Manifest: İstek yolunun güncel nesli bulmak için okuduğu küçük harita.

Derleme hatası siteyi yarım güncellemez. Eski manifest güncel kalır, hatalı kaynak düzenlenebilir durumda tutulur ve panel hatayı gösterir. Kod parçacığını okumak için istek başına sorgu açılmaz.

Üretilmiş dosyaları elle düzenlemeyin. Bunlar atılabilir derleme çıktısıdır ve sonraki başarılı derlemede değiştirilir.

Türler, konumlar ve koşullar

PHP, WordPress kancaları üzerinden çalışır. JavaScript, CSS, HTML ve metin yalnız açıkça seçtiğiniz konumda basılır: head, body-open, footer, içerik öncesi/sonrası, shortcode, elle ya da bir kez.

Tek koşul grubunda AND uygulanır; gruplar OR ile birleşir.
Yönetim, ön yüz, URL, kullanıcı, rol ve istek bağlamı birlikte kullanılabilir.
Etiketler ve gruplar kayıtları düzenler; kilit, yanlışlıkla düzenlemeyi ve toplu işlemi engeller.
Elle çalıştırılan kod, kendi kodunuz çağırmadıkça hiçbir istek kancasına katılmaz.

Gereksinimi anlatan en dar konum ve koşulu seçin. Genel PHP kancası, destek yanıtından kopyalanan her kodun varsayılan evi değil, bilinçli karar olmalıdır.

Code Snippets’tan geçiş

MevvCode → Geçiş ekranını açın. İçe aktarıcı site önekli snippets tablosunu okur, her kaynak kimliğini ve kod baytlarını birebir korur; hangi eklentinin etkin olduğunu değiştirmeden hazırlık kayıtlarını oluşturur.

Tespiti çalıştırıp kayıt sayısını inceleyin.
Etkin olmayan hazırlık kümesine içe aktarın.
Code Snippets’ta etkin olan her kodu ayrıştırın.
Etkin eklenti listesi ve güncel MevvCode manifestinin geri dönüş görüntüsünü alın.
Tek ve eksiksiz bir nesil derleyin.
Devri başlatın. Code Snippets ancak manifest hazır olduktan sonra kapanır.
İmzalı geri döngü isteği açık siteyi denetler. Başarı işlemi kesinleştirir; hata eklenti listesini ve manifesti otomatik geri yükler.

Kaynak tablolar silinmez. Başarılı devirden sonra da elle geri alma vardır ve önceki etkin eklenti listesini birebir yeniden kurar. mevvshop.com üzerinde 1 Eylül 2026’daki ölçülmüş üretim geçişinde 9 kayıt, 6 etkin durum korundu; ad/kod/öncelik/durum karşılaştırmasında 0 eşleşme hatası çıktı. Bu o mağazanın kanıtıdır, evrensel kıyaslama değildir.

İçe alınan bir kod ayrıştırma hatası verirse hazırlık kopyasını düzeltin ya da kapalı bırakın. Devir sağlıklı nesil bildirmeden Code Snippets’ı elle kapatmayın.

Güvenli mod ve kurtarma

Belgelenmiş sabitle veya yönetici için üretilen kısa ömürlü imzalı adresle güvenli moda girilebilir. Güvenli modda kod parçacığı çalıştırma durur; onarım için panel açık kalır.

PHP ayrıştırma hatası hiçbir zaman güncel nesil olamaz.
Çalışma zamanı istisnası sorumlu kaydı kapatır; diğer kod parçacıkları kullanılabilir kalır.
Kritik hata koruması yalnız kurtarmaya gereken kayıt kimliği ve durumu yazar; kaynak kodu veya istek sırlarını asla yazmaz.
Yeni nesil tüm kontrolleri geçene kadar önceki çalıştığı bilinen nesil saklanır.

define( 'MEVVCODE_SAFE_MODE', true );

Bozuk kayıt düzeltildikten veya kapatıldıktan sonra sabiti kaldırın. Sabiti bırakmak bilerek tüm kod parçacıklarını kapalı tutar.

Taşıma ve yedek

Kayıpsız gidiş dönüş için seçilen kayıtları MevvCode JSON v1 olarak, hedefin MevvCode’a bağımlı olmaması için okunabilir PHP olarak dışa aktarın. Code Snippets ve WPCode içe aktarıcıları aynı kanonik kayıt biçimine bağdaştırır.

JSON dışa aktarımı üst veriyi, koşulları ve durumu içerir.
PHP dışa aktarımı inceleme ve elle sahiplenme içindir; gizli üst veriyi geri almak için değildir.
Normal eklentinin kaldırılması gerektiğinde MU yükleyici derlenmiş davranışı taşıyabilir.
Pro, seçilen kodları ad, yol ve PHP doğrulamasından sonra olağan işlev eklentisi ZIP’ine paketleyebilir.

Büyük içe aktarma, toplu etkinleştirme veya geçişten önce dışa aktarımların site dışı kopyasını tutun. Sürümler düzenleme geçmişidir; felaket kurtarma yedeği değildir.

Ücretsiz ve Pro

Ücretsiz sürüm, eksiksiz güvenli yerel kod parçacığı yöneticisidir. Beş türün tamamı, atomik çalışma zamanı, konum ve temel koşullar, kritik hata koruması, güvenli mod, Code Snippets geçişi, içe/dışa aktarma, üreteçler, sürümler, rol yetkileri, salt okunur REST ve MU yükleyici dahildir.

Pro, işbirliği ve teslimat katmanıdır. Yeniden kullanılabilir ve zamanlanmış koşullar; cihaz, yönlendiren, coğrafya, sepet ve sipariş bağlamı; sınırsız denetim geçmişi; CSS/JS derleme ve dış varlıklar; e-ticaret piksel olayları; imzalı otomasyon; eklenti dışa aktarma; yerel toplu içgörüler; şifreli bulut; isteğe bağlı yapay zekâ incelemesi ve eylem bazlı REST/MCP uyumlu API ekler.

Bulut ve yapay zekâ ayrı ayrı izin ister. Yapay zekâ sırları karartılmış kopyayı alır ve inceleme farkı döndürür; farkı hiçbir zaman otomatik uygulamaz. Bulut yazmaları lisans anahtarıyla HMAC imzalanır, iyimser sürümler eski yazmayı reddeder.

Pro lisansını bulma ve etkinleştirme

Satın alınan lisans ödeme e-postasına bağlanır ve mevvsoft.com/hesap altında görünür. Anahtar MEVD ile başlar; destek talebine, adrese veya açık kayda hiçbir zaman yapıştırmayın.

Ücretsiz MevvCode paketini kurup etkinleştirin.
Aynı sürümdeki MevvCode Pro paketini kurup etkinleştirin.
Ödeme e-postası için açılan hesaba girip MevvCode Pro anahtarını kopyalayın.
MevvCode → Lisans ekranında MEVD anahtarını girip etkinleştirin.
Durumun etkin olduğunu ve sitenin hesabınızdaki lisans altında göründüğünü doğrulayın.

Lisans hesapta yoksa önce ödeme sırasında kullanılan e-postayla giriş yaptığınızı doğrulayın. Lisans görünüyor ama site sınırı hatası veriyorsa eski siteyi hesaptan serbest bırakın veya tam anahtarı göndermeden destek isteyin.

SSS ve sorun giderme

Kod kaydedildi ama çalışmadı: Etkin olduğunu, konumun isteğe uyduğunu, en az bir koşul grubunun sağlanabildiğini ve güvenli modun kapalı olduğunu denetleyin.
Geçişten sonra eski eklenti hâlâ etkin: Devir kesinleşmedi. Geçiş sonucunu okuyun; ayrıştırma, derleme veya geri döngü sağlık kontrolü başarısız olmuş ve geri alma siteyi korumuştur.
Site güvenli moda girdi: İmzalı kurtarma adresiyle paneli açın, en son kapatılan kaydı inceleyin, düzeltin ya da kapalı bırakın, derleyin ve güvenli moddan çıkın.
Bulut çakışma bildiriyor: Başka bir istemci yüklediğiniz sürümden sonra çalışma alanını değiştirdi. Uzak ve yerel kaydı karşılaştırıp yeni taban sürümüyle yeniden gönderin.
Yapay zekâ incelemesi kullanılamıyor: Hem Pro lisansı hem açık yapay zekâ izni etkin olmalı ve servis bağdaştırıcısı yapılandırılmalıdır. Yerel kod parçacıkları çalışmaya devam eder.

Destek isterken eklenti sürümlerini, WordPress/PHP sürümlerini, kayıt UUID’sini ve hata metnini gönderin. Sırları ve müşteri verisini çıkarın. Gerekli değilse ve incelemediyseniz üretim lisans anahtarını veya kaynak kodun tamamını göndermeyin.

Küçük kodları gerçek bir güvenlik sınırıyla çalıştırın.