MevvCode — Mevvsoft 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.

Kütüphane ve paketler

Kütüphane sekmesi, insanların normalde bir forum gönderisinden kopyaladığı sıradan işler için gözden geçirilmiş altmış parçacık taşıyor: XML-RPC'yi kapatmak, emoji dosyalarını atmak, atlama bağlantısı eklemek, dış bağlantıları noopener yapmak, WooCommerce ayarları. Bir tanesini eklemek onu çalışma alanınıza pasif bir kayıt olarak kopyalar — okur, sonra açarsınız. Hiçbir şey kendini çalışır hâlde kurmaz.

Altı paket bunları kategoriye göre değil işe göre gruplar: mağaza açılışı, ödeme sayfası temizliği, katalog ayarı, mağaza hızı, temel sertleştirme ve yönetim düzeni. Paket ya hep ya hiçtir — parçacıklarından biri yazılamazsa yazılmış olanlar geri alınır, böylece elinizde yarım bir paket ve hangi yarısı olduğunu anlamanın yolu kalmaz.

Kütüphane kayıtları kopyadır. Çalışma alanınızdaki bir kaydı düzenlemek kütüphaneyi değiştirmez, sonraki bir eklenti güncellemesi de sizin özelleştirdiğinizi düzenlemez.

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 teslim 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 derlemeleri ve dış varlıklar; canlı izleyicili e-ticaret pixel olayları; imzalı otomasyon; eklenti dışa aktarımı; yerel toplu içgörüler; şifreli bulut çalışma alanları; isteğe bağlı AI incelemesi ve kendi sağlayıcı anahtarınızla AI taslağı; bir de eylem kapılı, REST/MCP uyumlu bir 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.

AI ile parça taslağı üretmek

Pro, ihtiyacınızı anlattığınız bir açıklamadan parça taslağı üretebiliyor. Kesinlikle kendi hesabınızla: sağlayıcıyı siz seçiyorsunuz — OpenAI ya da Anthropic — ve kendi API anahtarınızı yapıştırıyorsunuz; istek sitenizden doğrudan o sağlayıcıya gidiyor. Üretim bizim sunucularımızdan hiç geçmiyor. AI, siz açana kadar kapalı.

Dönen şey her zaman pasif taslak olarak kaydediliyor. Üretilen kod kendiliğinden hiçbir zaman uygulanmıyor, etkinleştirilmiyor ya da çalıştırılmıyor.
Ücretsiz derleyicinin etkinleştirmeden önce uyguladığı PHP sözdizimi kapısından geçemeyen bir öneri hiç kaydedilmiyor; böylece siteyi ölümcül hataya düşürecek bir parça listenize hiç ulaşmıyor.
Beş parça tipinin hepsi taslak olarak üretilebiliyor: PHP, JavaScript, CSS, HTML ve metin.

AI incelemesi ile AI taslağı farklı özellikler ve farklı yollardan gidiyor. İnceleme, elinizde zaten olan kodun sansürlenmiş bir kopyasını lisans anahtarınızla bizim kendi ucumuza gönderiyor ve bir fark döndürüyor; taslak üretimi ise yalnız sizin seçtiğiniz sağlayıcıyla, sizin anahtarınızla konuşuyor. İkisi de ayrı ayrı açılıyor ve hiçbiri kendiliğinden bir şey uygulamıyor.

Ülke koşulu ve SCSS (Pro)

Bir parçacığı yalnız bazı ülkelerde koşturmak

Pro, ücretsiz sürümün kullandığı aynı kural düzenleyicisine bir ülke koşulu ekliyor. Ülke, WooCommerce müşterisinin kendi fatura ya da teslimat adresinden, o da yoksa sunucunuza kurulmuş bir konum veritabanından çözülüyor. Üçüncü taraf bir sorgu servisine hiç sorulmuyor ve hiçbir ziyaretçi adresi saklanmıyor — soru yerelde yanıtlanıyor ya da hiç yanıtlanmıyor.

SCSS yazmak

Stiller ekranı SCSS ya da LESS derliyor ve sonucu, açmadan önce okuyabilesiniz diye pasif bir CSS parçacığı olarak kaydediyor. Bu, CSS düzenleyicisine takılmış bir kanca değil, bilinçli bir dolambaç: sitenizde koşan şey açıp okuyabileceğiniz düz CSS olarak kalıyor.

Derleyici bu tek iş için yazıldı — değişkenler, iç içe yazım, ve işareti, ayrıca medya, supports, layer ve konteyner kurallarının dışarı taşınması. Uygulamadığını hata vererek reddediyor: mixin, extend, import, denetim direktifleri ve interpolasyon. Reddetmek işin özü. Bir direktifi yarım destekleyen derleyici, yazdığınızdan az farklı bir CSS üretir ve bunu ön yüzde öğrenirsiniz.

Canlı pixel olayları

Pro, e-ticaret olaylarını Meta, Google ve TikTok için normalleştiriyor — ürün görüntüleme, sepete ekleme, ödemeye başlama ve satın alma — ve siz çalışırken bunların geldiğini gösterebiliyor; böylece bir olayın gerçekten tetiklendiğini ve beklediğiniz değerleri taşıdığını görüyorsunuz. Yakalama varsayılan olarak kapalı ve bilerek açılması gerekiyor.

Olaylar kendi sitenizde kalıyor. Bu yolun hiçbir yerinde üçüncü taraf bir toplayıcı yok.
Yalnız son iki yüz olay, dönen bir tamponda tutuluyor. Daha eskisi kalmıyor ve büyüyecek bir tablo yok.
Hiçbir IP adresi, çerez, kimlik ya da sorgu dizesi saklanmıyor. Olaya bir e-posta adresi ya da telefon numarası ait olduğunda, önce SHA-256 ile özetleniyor.

Bu, olaylarınızı denetlemek için bir izleyici; analitik değil. Rapor üretebileceğiniz bir geçmiş tutmuyor ve tutması da amaçlanmıyor.

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.

Güncellemeler

Güncellemeler WordPress'in kendisi üzerinden geliyor. Eklenti mağazamıza daha yeni bir sürüm olup olmadığını soruyor ve yanıtı WordPress'in kendi güncelleme akışına veriyor; böylece yeni sürüm, birinin elle zip indirmesini beklemek yerine eklentiler ekranında sıradan bir Güncelle düğmesiyle beliriyor. Ücretsiz sürümde bu istek yalnız paket adını ve kurulu sürümü taşıyor — site adresi yok, e-posta adresi yok, lisans anahtarı yok, eklenti envanteri yok. İçinde sizi tanımlayan hiçbir şey olmadığı için güven imzaya dayanıyor: yanıt Ed25519 anahtarımızla imzalı; imzasız, imzası tutmayan, eski bir zaman damgasından tekrar oynatılan ya da indirmeyi bizimki dışında bir konağa yönlendiren bir yanıt siteye hiç dokunulmadan atılıyor.

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.