BStudio Plugin

Better Contact Form

Wersja: 2.0.0 Autor: Biegun.Studio Wymaga: WordPress 5.9+, PHP 8.0+

Zaawansowany konstruktor formularzy kontaktowych. Wiele formularzy, 14 typów pól, kontrola szerokości kolumn, wysyłka AJAX, ochrona antyspamowa, auto-odpowiedź.

Co robi ta wtyczka?

Pozwala tworzyć dowolną liczbę formularzy kontaktowych w wizualnym konstruktorze bez pisania kodu. Każdy formularz osadzasz shortcodem [bstudio_contact_form id="X"] na dowolnej stronie lub wpisie.

Wysyłka przez AJAX — strona się nie przeładowuje. Ochrona przed spamem (honeypot + WordPress nonce). Walidacja zarówno w JavaScript jak i PHP.

Wiele formularzy

Każdy formularz ma własne ustawienia e-mail, prefiks tematu, komunikat sukcesu i auto-odpowiedź. Po zapisaniu formularz dostaje unikalny ID.

Shortcode — parametry

ParametrOpis
idID formularza z panelu admina. Pomijając — wyświetla pierwszy formularz na liście.
titleOpcjonalny nagłówek wyświetlany nad formularzem.

Przykłady: [bstudio_contact_form id="1"]  ·  [bstudio_contact_form id="2" title="Napisz do nas"]

14 typów pól

TypOpis
textTekst jednoliniowy
emailE-mail — walidacja formatu (JS + PHP)
telNumer telefonu
numberLiczba
urlAdres URL
textareaWieloliniowy obszar tekstu
selectLista rozwijana — opcje z konstruktora
radioWybór jednokrotny
checkboxPojedynczy checkbox (zgody regulaminowe)
multicheckboxWiele checkboxów z opcjami
dateWybór daty
timeWybór godziny
headingDekoracyjny nagłówek — nie wysyłany w e-mailu
paragraphDekoracyjny tekst / instrukcja — nie wysyłany w e-mailu

System szerokości kolumn

Formularz renderuje się na siatce 12-kolumnowej (CSS Grid). Każde pole ma ustawienie szerokości:

WartośćKolumn (z 12)Typowe zastosowanie
100%12Pełna szerokość — textarea, wiadomość
75%9Szerokie pole + wąski element obok
66%8Dwie trzecie
50%6Dwa pola obok siebie (Imię + Nazwisko)
33%4Trzy pola w jednym wierszu
25%3Cztery pola w jednym wierszu

Na mobile (≤ 640 px) wszystkie pola automatycznie przechodzą na pełną szerokość.

Konstruktor pól — obsługa

Konfiguracja formularza

Menu BS Contact Form → Edytuj (lub + Dodaj formularz).

OpcjaOpis
Nazwa formularzaWewnętrzna nazwa widoczna tylko w adminie.
E-mail odbiorcyAdres docelowy. Puste = adres administratora WordPress.
Prefiks tematuDołączany przed tematem każdego e-maila.
Komunikat sukcesuTekst widoczny po udanej wysyłce. Obsługuje HTML.
Auto-odpowiedźWłącza wysyłkę potwierdzenia na adres nadawcy. Wymaga pola typu email w formularzu.
Temat auto-odpowiedziTemat e-maila z potwierdzeniem.
Treść auto-odpowiedziZmienne: {name} (pierwsza wartość z pola tekstowego), {site_name}.

Instalacja

  1. Skopiuj folder bstudio-contact-form do /wp-content/plugins/.
  2. Aktywuj wtyczkę — tabele wp_bscf_forms i wp_bscf_fields tworzą się automatycznie.
  3. Przejdź do BS Contact Form → + Dodaj formularz w menu admina.
  4. Skonfiguruj ustawienia, dodaj pola, kliknij „Zapisz formularz".
  5. Skopiuj shortcode z listy formularzy (kliknij shortcode) i wklej go na wybraną stronę.

Debugowanie wysyłki

Struktura plików

bstudio-contact-form/
├── bstudio-contact-form.php ← Bootstrap, autoload, activation hook
├── includes/
│ ├── class-bstudio-cf-installer.php ← Schemat DB v2, maybe_upgrade
│ ├── class-bstudio-cf-core.php ← Shortcode, enqueue, AJAX submit
│ └── class-bstudio-cf-fields.php ← 14 typów pól, render frontend
├── admin/
│ ├── class-bstudio-cf-admin.php ← Lista formularzy, edytor, save/delete
│ └── assets/
│ ├── css/cf-admin.css
│ └── js/cf-admin.js ← Sortable, live preview, opcje
└── public/assets/
    ├── css/contact-form.css ← CSS Grid, 14 typów, walidacja
    └── js/contact-form.js ← AJAX submit, walidacja JS

Wsparcie i zgłoszenia

Masz pytanie, napotkałeś problem albo chcesz rozwinąć to rozwiązanie pod swój sklep? Pomożemy.

Pomoc techniczna

Problemy z instalacją, konfiguracją lub działaniem wtyczki — opisz zgłoszenie, a wrócimy z rozwiązaniem.

Zgłoszenie (ticket)

Wyślij e-mail na shop@biegun.studio. W temacie podaj nazwę wtyczki i krótki opis. Dołącz wersje WordPressa, WooCommerce i PHP oraz kroki odtworzenia problemu.

Rozwój i modyfikacje

Potrzebujesz dodatkowej funkcji albo integracji? Realizujemy rozszerzenia i wdrożenia na zamówienie — napisz na shop@biegun.studio.

Pełna oferta wtyczek: biegun.studio/sklep