WebBlocks Redirect Manager ile URL Yönlendirmelerini Yönetin

Kurulum için test sitesi ve Super admin hesabı kullanın. Resmî katalog, Redirect Manager 0.1.28 için CMS ^1.100.0, PHP ^8.3 ve Laravel ^13.0 uyumluluğu bildirir. CMS sürümünüz ek gereksinimler getirebilir; bu rehber PHP 8.4 üzerinde çalışır. Sunucunuzun uyumluluk sonucunu resmî Redirect Manager kataloğundan kontrol edin.

Önce hedef sayfayı hazırlayıp yayımlayın. Örneğimizde /workshops zaten sorunsuz açılır. Eklenti bir yönlendirme yanıtı gönderir; hedefi oluşturmaz, taslağı yayımlamaz, mevcut bağlantıları güncellemez veya uzaktaki bir sitenin erişilebilirliğini doğrulamaz.

Kaydetmeden önce eski yolu, istenen hedefi ve eski bağlantının ait olduğu siteyi ya da alan adını belirleyin. Tek bir web sitesindeki olağan değişiklik için site kapsamını kullanın. Genel kural, kurulumun tamamında eşleşen istekleri etkiler; yalnızca bu geniş davranışı istediğinizde seçin.

1. Super admin olarak System → Plugins ekranını açın.
2. Browse Plugin Catalog seçeneğiyle WebBlocks Redirect Manager eklentisini bulun.
3. Sürümü, sürüm notlarını ve uyumluluğu inceleyip Install from Catalog seçeneğini kullanın.
4. Yöneticiniz resmî yayımlanmış arşivi sağlıyorsa Plugin ZIP alanından seçip Upload Plugin ZIP düğmesine basın.
5. Etkinleştirmeden önce kurulan paketi inceleyin.

Örneğimiz resmî yayımlanmış ZIP’i kullanır. Yeni kurulan eklenti Disabled durumundadır. Güncel CMS, veritabanı değişikliklerini normal kurulum ve etkinleştirme yaşam döngüsünde uygular.

WebBlocks Redirect Manager ayrıntılarını açıp Enable Plugin seçeneğini kullanın. Enabled, Healthy depolama ve Migrations Up to Date durumlarını doğrulayın. Sağlıklı kurulum, yönlendirme depolamasının hazır ve genel yönlendirme işlemenin etkin olduğunu bildirir.

Maintenance → Redirects ekranını açın. Yeni kurulumda listede No redirects have been created yet. yazar. Create redirect işlemi kural formunu açar.

Etkinleştirmeden sonra menü hemen görünmezse paneli yenileyin. Depolama hazır değilse kural oluşturmadan önce eklentinin veritabanı güncellemesini veya uyumluluk uyarısını çözün.

Redirect Manager, listeyi okumayı kuralları değiştirmekten ayırır:

Kural yöneten operatör genellikle iki izne de ihtiyaç duyar. Kurulum ve eklenti yaşam döngüsü işlemleri yöneticiye aittir. Ekibinize uygun erişimi atamak için Roller ve İzinler rehberini kullanın.

Panel listesi, kurulumdaki tüm kuralları içerir. Applies to, hangi genel isteklerin kuralla eşleşeceğini belirler; panel operatörünün görebileceği veya yönetebileceği kuralları sınırlamaz. Kural yönetme iznini, kurulum genelinde yönlendirme değişikliği yapma yetkisi olarak değerlendirin. Internal API site kısıtlamaları ayrı bir entegrasyon denetimidir.

Create redirect seçeneğini kullanıp şu değerleri girin:

Form başlangıçta All sites and domains, 301 permanent ve Enabled seçer. Bu örnek için varsayılanları bilinçli olarak değiştirin. Yönlendirme kuralının ayrı yayımlama işlemi yoktur: etkin kuralı kaydetmek, istek etkin eklentiye ulaşır ulaşmaz genel yönlendirmeyi değiştirir.

Create redirect düğmesine basın. Başarı mesajı kaydı doğrular; yeni satır kapsamı, kaynağı, hedefi, durumu, etkinliği, Hits ve Last hit değerlerini gösterir. Yeni kural sıfır hitle başlar; son hit zamanı çizgidir.

Etkinleştirmeden hazırlamak istediğiniz kuralda, kaydetmeden önce Enabled işaretini kaldırın. Kaynağı, kapsamı ve hedefi inceledikten sonra etkinleştirebilirsiniz.

Eski genel URL’yi sitenin gerçek alan adında açın. Örneğimizde /old-workshops ziyareti, yeni sayfanın normal açıldığı /workshops adresine gider. Sayfa içeriğinin yanında tarayıcı adresini de kontrol edin; yalnızca hedefin görünmesi yanıtın 301 mi 302 mi olduğunu göstermez.

Maintenance → Redirects ekranına dönüp listeyi yenileyin. Örnekte artık 1 hit ve dolu Last hit değeri vardır. Bu, elle girilmiş sayaç değil, yönlendirmeden geçmiş gerçek bir istektir.

Yanıtı tam olarak kontrol etmek için tarayıcınızın Network panelini veya kendi sitenize istek gönderen bir HTTP istemcisini kullanın. HEAD isteği, hedef sayfayı indirmeden yanıt başlıklarını kontrol eder:

Örnek sunucu adını kendinizinkiyle değiştirin. Yukarıdaki kural için 302 ve /workshops adresini gösteren Location başlığı bekleyin. Komut yönlendirmeyi takip etmez. Hedefi ayrıca kontrol edip istediğiniz sayfayı döndürdüğünü doğrulayın.

GET ve HEAD isteklerinin ikisi de hit sayılır. İzleme araçları, tarayıcı botları ve tekrar testleri toplamı artırabilir. Hitler uygulamaya ulaşan yönlendirme eşleşmeleridir; tekil kişi, başarılı hedef ziyareti veya tamamlanmış dönüşüm sayısı değildir.

Applies to seçicisi üç kapsam türü sunar. Site ve alan adı seçenekleri CMS kayıtlarından gelir. Gereken alan adı görünmüyorsa önce ilgili sitenin etkin alan adlarını yapılandırın; yeni sunucu adı yönlendirme formunda kaydedilmez. Birden Fazla Site rehberine bakın.

Genel kural, kurulumda eşleşen yol için ortak geri dönüş kuralıdır. Burada daha özel etkin kural kazanmadığında /programme, /contact adresine gider.

Site kuralı, sitenin kayıtlı etkin alan adlarıyla eşleşir. Site düzeyindeki /programme kuralımız /workshops adresine gider ve Northstar Studio alan adlarında genel kuraldan önce gelir.

Bu kapsam sitenin etkin alan adı kayıtlarını izler. Alan adı eklendiğinde, kaldırıldığında veya devre dışı bırakıldığında yönlendirmeyi inceleyin. Bilinmeyen sunucu adı, ana site kurulumun varsayılanı olduğu için o sitenin kapsamlı kurallarını devralmaz.

Alan adı kuralı yalnızca seçili sunucu adıyla eşleşir. events.example.test istisnamız /programme yolunu /summer-workshops adresine gönderir. studio.example.test, www çeşidi veya diğer alt alan adları otomatik olarak kapsanmaz.

Kaynak yolun kurulumdaki tüm kapsamlar arasında değil, kendi kapsamında benzersiz olması gerektiğinden bu üç kural birlikte bulunabilir.

Aynı kaynak yol için etkin eşleşen kurallar şu sırada değerlendirilir:

1. Tam alan adı.
2. Gelen sunucu adına bağlı site.
3. Tüm siteler ve alan adları.

Üç /programme örneğinin sonucu şöyledir:

Son satır, istek CMS’ye ulaştıktan sonraki eklenti eşleşmesini açıklar; DNS yapılandırmaz veya kayıtsız sunucu adından sitenizi sunmayı sağlamaz. Barındırma, alan adı ve birincil alan adı ayarlarınız geçerliliğini korur.

İlgili sunucu adlarını test ettikten sonra ayrı sayaçlar hangi kuralların istekleri işlediğini gösterir. Daha özel kuralı kapatmak, alttaki daha geniş etkin kuralı devreye sokabilir. Alan adı istisnasını kapatırken site ve genel geri dönüş kurallarını kontrol edin.

Dağıtımınızdaki takma ad ve birincil alan adı davranışları dâhil, tam genel sunucu adını test edin. Web sunucusu, CDN veya alan adı düzeyindeki yönlendirme, istek Redirect Manager’a ulaşmadan yanıt verebilir.

Source path, tam URL değil dahili yoldur. /old-workshops girin; https://your-site.example/old-workshops gibi tam URL kullanmayın. Eklenti eksik başlangıç eğik çizgisini ve sondaki eğik çizgileri normalleştirir; old-workshops, /old-workshops ve /old-workshops/ aynı kaynağı belirtir.

Normalleştirmeden sonra eşleşme tamdır. /old-workshops kuralı /old-workshops/photography ile eşleşmez. Formda joker karakter, düzenli ifade, önek değiştirme veya yol sonunu otomatik aktarma yoktur. Büyük/küçük harfi tutarlı kullanın; test sunucumuz /OLD-WORKSHOPS yolunu küçük harfli örnekle eşleştirmedi.

Kaynak eşleşmesinde gelen sorgu parametreleri yok sayılır. /old-workshops ve /old-workshops?utm_source=newsletter aynı kuralla eşleşir. Gelen sorgu dizesi hedefe otomatik kopyalanmaz. Hedef sabit sorgu gerektiriyorsa Target URL içine doğrudan ekleyin; örneğin /workshops?from=legacy.

Hedef /workshops gibi köke göreli yol veya https://destination.example/workshops gibi tam http/https URL olabilir. Köke göreli hedef gelen sunucu adını korur; başka alan adına taşımak için tam URL kullanın. //destination.example/workshops gibi şemaya göreli hedefler reddedilir. URL parçaları tarayıcı tarafındadır; gelen kaynak kurallarını ayıramaz.

Eklentiyi form gönderimleri veya API yazımlarını yeniden yönlendirmek için kullanmayın. Genel GET ve HEAD isteklerini inceler; diğer yöntemler sunucu uygulamasına devam eder. Ayrılmış /admin, /api, /webadmin, /cms, /storage, /assets, /static, /build, /vendor ve /webblocks-ui ad alanları ile alt yollarını da atlar. Web sunucusunun doğrudan sunduğu dosyalar CMS yönlendirmesine hiç girmeyebilir.

Etkin kural aynı yoldaki mevcut genel sayfayı geçersiz kılabilir. Kaydetmeden önce eski sayfanın normal dolaşımdan çıkmasını istediğinizi doğrulayın. Redirect Manager, kaynak sayfanın önce 404 döndürmesini gerektirmez.

Aynı kapsamda aynı normalleştirilmiş kaynağı iki kez oluşturursanız form The source path has already been taken. bildirir. Mevcut kuralı düzenleyin. Devre dışı kural da o kapsamda kaynağı işgal eder.

Eklenti, doğrudan kendine giden dahili yönlendirmeyi reddeder. /loop-check, /loop-check?from=legacy adresine gidemez; sorgu dizesi temel yolu değiştirmez. Hata The target must not redirect this path back to itself. der.

Doğrudan döngü koruması, tüm yönlendirme zincirini incelemenin yerini tutmaz. /a → /b ile /b → /a birleşiminden veya başka sistemin geri gönderdiği alan adları arası yönlendirmeden kaçının. Eski adresleri son hedefe doğrudan yönlendirin ve zincirin tamamını test edin.

Ana sayfa taşımasında kaynak olarak / girip site veya alan adı kapsamı seçin. Etkin genel ana sayfa kuralı Choose a site or domain for a homepage redirect. mesajıyla reddedilir. Böylece genel kök kuralı tüm ana sayfaları ele geçiremez.

Ana sayfa hedeflerini dikkatle inceleyin: göreli hedef mevcut alan adında kalır. Dar kapsamı tercih edin ve hedefin ziyaretçiyi / adresine geri gönderen kuralı olmadığını doğrulayın.

Kaynak, sunucu adı, hedef ve hit sayacını kontrol ederken 302 temporary kullanın. Taşıma kalıcı olacaksa ve testler geçtiyse:

1. Maintenance → Redirects içinde kuralı bulun.
2. Kalem işlemi Edit redirect seçeneğini kullanın.
3. Applies to, Source path ve Target URL değerlerini doğrulayın.
4. Status code alanını 301 permanent yapın.
5. Enabled işaretli kalsın; Save changes düğmesine basın.

Liste artık 301 ve tarayıcı önbelleği hatırlatmasını gösterir. Düzenleme, mevcut hit sayısı ve son hit geçmişini korur.

Tarayıcılar 301 yönlendirmelerini önbelleğe alıp CMS’ye ulaşmadan kullanabilir. Bu, değişen hedefi değişmemiş gösterebilir ve yeni sunucu hitinin kaydını engelleyebilir. Yeni istek yapan HTTP istemcisiyle veya tarayıcı ağ araçlarında önbelleği kapatarak kontrol edin. Kuralı kapatmak, istemci veya üst altyapıda önbelleğe alınmış yanıtları geri çağıramaz.

Yapılandırma ve geçmişi koruyarak yönlendirmeyi durdurmak için kuralı düzenleyin, Enabled işaretini kaldırıp Save changes düğmesine basın.

Satır listede Disabled olarak kalır. Yeni istekler artık bu kuralı kullanmaz ve sayaç artmaz. Başka etkin kapsam kuralı veya yönlendirme katmanı yoksa sunucu normal sayfasını veya 404 yanıtını verir. Atölye örneğinde devre dışı bırakıldıktan sonra kullanılmayan eski adres 404 döndürür.

Yönlendirmeyi geri açmak için aynı satırı düzenleyin, Enabled işaretini koyun, hedefi doğrulayıp kaydedin. Böylece yinelenen kaynak oluşturmaz, kuralın geçmişini korursunuz.

Çöp kutusu işlemi Delete redirect, kuralı ve hit geçmişini kaldırır. 0.1.28 sürümünde doğrudan gönderilir; eklentiye ait çöp kutusu veya geri yükleme ekranı yoktur. Gereken bilgiyi silmeden önce kaydedin; geri alınabilir duraklatma için Disabled kullanın.

System → Plugins üzerinden tüm eklentiyi kapatmak yönlendirme işlemeyi durdurur ve katkılarını gizler. Güncel yaşam döngüsü eklenti tablolarını korur. Bu, tek kuralı kapatmaktan daha geniştir; tarayıcı veya CDN önbelleğini temizlemez.

Redirect Manager 0.1.28; tekil kurallar, iki durum kodu, kapsam seçimi ve toplu hit geçmişi sunar. Sayfa oluşturucuya blok eklemez: etkinleşince eşleşen genel istekleri doğrudan işler.

Panelde zamanlanmış kurallar, toplu CSV içe/dışa aktarma, joker eşleme, ziyaretçi bazında analiz veya otomatik bozuk bağlantı bulma akışı yoktur. Source path alanına desteklenmeyen desenler yazmak yerine bu ihtiyaçları ayrıca planlayın. Bu sürümde sayaç sıfırlama işlemi de yoktur.

CMS’de sayfa adresi değiştirirseniz eski URL’yi kendiniz inceleyin. Sayfayı yeniden adlandırmak eklenti listesine otomatik yönlendirme eklemez. Dolaşımı ve dahili bağlantıları son adrese güncelleyin; dış yer imleri ve değiştiremeyeceğiniz bağlantılar için bilinçli eski adres yönlendirmelerini koruyun. Sayfa Adresini Değiştirme rehberine bakın.

Otomasyon için eklenti, kural koleksiyonunu /webadmin/api/redirect-manager/redirects adresindeki Internal Content API üzerinden sunar. Okuma plugins.read; yazma plugins.manage ve ilgili site kısıtlamalarını kullanır. Kurulu uç noktaları ve istek sözleşmesini incelemek için CMS API keşfini kullanın. Panel kullanıcılarının bu rehber için API tokenına ihtiyacı yoktur.

Gerçek taşımayı etkinleştirmeden önce yeni sayfanın yayımlandığını ve hedef sunucuda doğru içeriği döndürdüğünü doğrulayın. 302 ile başlayın; eski adresi yönlendirmeyi takip etmeden test edip durum ve Location başlığını inceleyin, sonra son sayfayı kontrol etmek için takip edin.

İlgili tüm alan adlarını, daha özel kapsam kurallarını, sondaki eğik çizgileri ve sorgu beklentilerini kontrol edin. Hedefin geri yönlendirmediğini ve GET/HEAD testlerinin beklenen sayaç değişimini ürettiğini doğrulayın. Yalnızca kalıcı taşıma kesinleşince 301 yapın.

Yayına aldıktan sonra kontrolünüzdeki bağlantıları güncelleyin, kuralın kapsamını ve amacını kaydedin, hit toplamlarını düzenli inceleyin. Duraklatmak için silmeden önce devre dışı bırakın. Böylece her yönlendirmenin nerede uygulanacağını denetlerken eski URL’leri kullanılabilir tutan tekrarlanabilir bir akışınız olur.