Formlar

Hazır iletişim, teklif, randevu ve kayıt formları. Yapay zeka tek bir bileşenle formu yerleştirir — bir submit handler yazmanıza gerek yoktur — ve her gönderim uygulamanızın gönderimler gelen kutusuna düşer.

Proyecta’daki formlar bir yetenektir; yapay zekanın elle yazdığı bir şey değildir. Uygulamanızın ziyaretçilerin size ulaşması için bir yola ihtiyacı olduğunda — bir iletişim formu, teklif talebi, randevu veya etkinlik kaydı — Proyecta hazır bir form tanımı oluşturur ve bunu şablona ait bir blok aracılığıyla render eder. Doğrulama, başarı durumu, gönderim depolama ve sahip bildirimleri otomatik olarak gelir.

Hazır şablonlar

Her form, beş yerleşik hazır şablondan birinden başlar. İstediğiniz formu tanımlayın, Proyecta doğru olanı seçer (ve uyarlar) — alanları sıfırdan oluşturmanıza hiç gerek kalmaz.

Şablon	form api id	Ne için kullanılır	Eşleştiği içerik
İletişim	contactForm	Genel “iletişime geç”: ad, e-posta, isteğe bağlı telefon, mesaj	İşletme bilgileri
Teklif	quoteForm	Teklif talebi: iletişim bilgileri + hangi hizmet + iş detayları	Hizmetler
Randevu	bookingForm	Randevu / cita: hizmet, tercih edilen tarih ve saat, iletişim bilgileri	Hizmetler
Kayıt	registrationForm	Etkinlik veya kurs kaydı (RSVP): katılımcı bilgileri + not	Etkinlikler
Sipariş	orderForm	Sipariş alma: müşterinin ne istediği, iletişim bilgileri, notlar	Menü, katalog

Bir uygulamada birden fazla form bulunabilir (ör. bir iletişim formu ve bir randevu formu) ve yapay zeka bunların herhangi birine alan ekleyebilir, yeniden adlandırabilir veya yeniden şekillendirebilir.

Yapay zeka nasıl bağlar?

Yapay zeka hiçbir zaman bir formu veya submit handler’ı elle oluşturmaz. Şablona ait <FormBlock/> bileşenini ekler ve bunu bir form id’si ya da api id’siyle ilişkilendirir:

import { FormBlock } from '@/components/blocks/FormBlock';

// Herhangi bir genel sayfada — iletişim bölümü, "teklif iste" paneli vb.
<FormBlock form="contactForm" />;

<FormBlock/> her şeyi kendi başına yapar:

• Alanları türe göre render eder — metin / e-posta / telefon girişleri olarak, uzun metin textarea olarak, seçenekler açılır liste olarak, onay kutuları checkbox olarak, tarih ve saatler yerel seçiciler olarak, dosya alanları ise “dosya ekle” kontrolü olarak görüntülenir.
• Tarayıcıda doğrulama yapar — herhangi bir şey gönderilmeden önce zorunlu alanlar kontrol edilir.
• Sunucuda doğrulama yapar — sunucu bir değeri reddederse, ilgili hata o alanın hemen yanında satır içi olarak gösterilir (kayıp gönderim veya sessiz hata olmaz).
• Başarı durumunu gösterir — gönderim sonrasında form, formun kendi onay mesajıyla birlikte başka bir yanıt gönderme seçeneği sunan dostane bir onay ekranıyla değiştirilir.
• Güvenli biçimde başarısız olur — form mevcut değilse veya devre dışı bırakılmışsa, blok hiçbir şey render etmez; bu sayede genel bir sayfayı asla bozmaz.

Blok şablona ait olduğundan, yapay zekanın yapması gereken tek şey onu yerleştirmek ve çevresindeki bölümü şekillendirmektir — arkasındaki altyapı sabit ve doğrudur.

Dosya ekleri

Formlar yüklenen bir dosyayı kabul edebilir (bir makbuz, referans fotoğrafı, bir brifing). Dosya alanları bir “dosya ekle” butonu render eder, dosyayı depolamaya yükler ve genel URL’sini gönderime ekler. Limitler sizin için uygulanır:

• Yalnızca görseller ve PDF, 5 MB’a kadar (büyük görseller önce tarayıcıda küçültülür).
• Bir dosya yüklenirken gönder butonu devre dışı kalır; böylece bir gönderim hiçbir zaman yarım gitmez.

Gönderimlerin gittiği yer

Her gönderim depolanır ve uygulamanızın gönderimler gelen kutusunda görünür — yönetici panelinin bir parçasıdır ve şablonun <SubmissionsInbox/> bileşeniyle render edilir. Buradan siz (sahip) şunları yapabilirsiniz:

• Gönderileri New / Read / Archived sekmeleri altında inceleyin; New üzerinde okunmamış rozeti bulunur.
• Gönderilen alan değerlerini, sayfayı ve tarihi görmek için herhangi bir gönderimi açın.
• Bir gönderimi read olarak işaretleyin, new’e geri taşıyın veya archive edin.
• Gelen kutusunu tek bir formla sınırlayın ya da tüm formların gönderimleri tek bir listede görün.

Gelen kutusu yalnızca yöneticiye özeldir — okuyucu, bir yönetici hesabıyla oturum açmış olmalıdır (sunucu tarafında zorunlu kılınır).

Her gönderimdde e-posta almak

Formlar, biri gönderim yaptığında sizi e-postayla bilgilendirebilir — sahip bildirimlerini açın ve bildirimlerin gönderileceği adresi belirleyin. Uygulamayı açmadan lead’i gelen kutunuzda alırsınız. E-posta, Proyecta’nın e-posta yeteneği aracılığıyla gönderilir; dolayısıyla ekstra kurulum gerektirmez.

Yaygın kullanım örnekleri (yapay zekaya bırakın)

• "Add a contact form to the footer with name, email, and message, and email me at hello@mybiz.com whenever someone submits."
• "Put a 'Request a quote' form on each service page that asks which service they need and the job details."
• "Add a booking form so clients can request an appointment with a preferred date and time."
• "Create an event registration form for the workshop page and let attendees attach a PDF."
• "Show me the submissions inbox and only the ones I haven't read yet."

İlgili konular

• İçerik Yönetimi — formlar, aynı içerik modelinde koleksiyonlarınızın yanında yer alır.
• Yönetici Paneli — gönderimlerin incelendiği yer.
• E-postalar — sahip bildirim e-postalarının nasıl gönderildiği.