ProcessWire'a Asyntai AI Chatbot Nasıl Eklenir

ProcessWire CMS web siteleri için adım adım kılavuz

Platform:

Adım 1: Yerleştirme Kodunuzu Alın

Önce Asyntai Dashboard'unuza gidin ve "Yerleştirme Kodu" bölümüne inin. Şuna benzeyen benzersiz yerleştirme kodunuzu kopyalayın:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Not: Yukarıdaki kod yalnızca bir örnektir. Kişisel widget kimliğinizi içerdiğinden, kendi benzersiz yerleştirme kodunuzu Dashboard'unuzdan kopyalamanız gerekir.

Adım 2: Şablon Dosyasına Ekleme (Önerilen)

ProcessWire, site/templates/ dizininde bulunan PHP şablon dosyalarını kullanır. En kolay yaklaşım, gömme kodunu doğrudan ana şablon dosyanıza eklemektir:

ProcessWire kurulum dosyalarınıza FTP, SSH veya dosya yöneticiniz üzerinden erişin
site/templates/ dizinine gidin
Ana şablon dosyanızı açın — bu genellikle site profilinize bağlı olarak _main.php veya basic-page.php dosyasıdır
Gecikmeli çıktı stratejisini (çoğu site profili için varsayılan) kullanıyorsanız, _main.php dosyasını açın
Kapanış </body> etiketini bulun
Asyntai gömme kodunuzu hemen önüne yapıştırın:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>

İpucu: Scripti kapanış </body> etiketinden hemen önce yerleştirmek, chatbot'un sayfa içeriğinden sonra yüklenmesini sağlar; bu, optimum performans için önerilir ve sayfa oluşturmanızı yavaşlatmaz.

Alternatif Yöntem 1: _foot.inc veya _main.php Ekleme Dosyası Kullanma

ProcessWire siteniz ekleme dosyası yaklaşımını kullanıyorsa (birçok site profilinde yaygın), gömme kodunu paylaşılan footer include dosyasına ekleyebilirsiniz:

site/templates/ dizinine gidin
_foot.inc dosyasını (veya eşdeğer footer include dosyanızı) açın
Asyntai gömme kodunuzu kapanış </body> etiketinden hemen önce yapıştırın
Dosyayı kaydedin

ProcessWire'ın gecikmeli çıktı stratejisi tipik olarak üç temel dosyayla çalışır:

_init.php — her şablondan önce çalışır, değişkenleri başlatır
Şablon dosyanız (ör. basic-page.php) — içerik değişkenlerini doldurur
_main.php — bu değişkenleri kullanarak son HTML işaretlemesini çıktılar

Siteniz bu yaklaşımı kullanıyorsa, scripti _main.php dosyasında </body> etiketinden önce eklemek her sayfada görünmesini sağlar.

Not: _init.php ve _main.php dosya adları, site/config.php dosyanızda $config->prependTemplateFile ve $config->appendTemplateFile ayarları aracılığıyla yapılandırılır. Dosyalarınız farklı adlandırılmışsa yapılandırmanızı kontrol edin.

Alternatif Yöntem 2: $config->scripts Dizisi Kullanma

ProcessWire, JavaScript dosyalarını yönetmek için kullanabileceğiniz bir $config->scripts FilenameArray sağlar. _init.php veya bireysel şablon dosyanıza ekleyin:

<?php
$config->scripts->add('https://asyntai.com/static/js/chat-widget.js');
?>

Ardından _main.php dosyanızda (veya footer include'da), scriptleri çıktılamak için scripts dizisinde döngü oluşturun:

<?php foreach($config->scripts as $file): ?>
<script src="<?php echo $file; ?>"></script>
<?php endforeach; ?>

Önemli: $config->scripts yaklaşımı script src özniteliğini işler, ancak data-asyntai-id özniteliğinin ayrıca işlenmesi gerekir. Ya döngü çıktısında data özniteliğini manuel olarak eklemeniz ya da en basit kurulum için bunun yerine Adım 2'deki doğrudan script etiketi yöntemini kullanmanız gerekecektir.

Alternatif Yöntem 3: Hook Kullanma (ready.php)

Daha gelişmiş bir yaklaşım için, chatbot scriptini her sayfaya otomatik olarak enjekte etmek üzere ProcessWire'ın hook sistemini kullanabilirsiniz. Aşağıdakileri site/ready.php dosyanıza ekleyin:

<?php
$wire->addHookAfter('Page::render', function(HookEvent $event) {
    $html = $event->return;
    $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
    $html = str_replace('</body>', $script . '</body>', $html);
    $event->return = $html;
});
?>

Bu hook, her sayfanın oluşturulan HTML çıktısını yakalar ve Asyntai scriptini kapanış </body> etiketinden hemen önce otomatik olarak enjekte eder.

İpucu: ready.php hook yaklaşımı, herhangi bir şablon dosyasını değiştirmeden chatbot'u her sayfada istiyorsanız idealdir. Şablon dosyalarının dışında yaşadığı için şablon değişikliklerine ve tema güncellemelerine de dayanıklıdır.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydettikten sonra, ProcessWire sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede sohbet widget düğmesini görmelisiniz. Doğru şekilde açıldığından ve çalıştığından emin olmak için üzerine tıklayın.

Widget'ı göremiyor musunuz? Tüm değiştirilen dosyaları kaydettiğinizden emin olun. Tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. ProcessWire'ın şablon önbelleği etkinse, Modules → Core → Template Engine Cache bölümüne giderek veya URL'nize ?nocache=1 ekleyerek temizlemeniz gerekebilir. Ayrıca şablon dosyanızın görüntülediğiniz sayfalar tarafından gerçekten kullanıldığını doğrulayın.