افزونه‌ی وردپرس پرسینو

🧩 افزونه چه می‌کند

افزونه‌ی «فرم‌های پرسینو» فرم‌ها، نظرسنجی‌ها و آزمون‌هایی را که در پرسینو می‌سازید به نوشته‌ها و برگه‌های وردپرس می‌آورد: با کدِ کوتاه، بلوکِ «فرمِ پرسینو» در گوتنبرگ، ابزارکِ المنتور یا دکمه‌ی «افزودن فرم پرسینو» در ویرایشگرِ کلاسیک؛ درونِ صفحه یا با دکمه و پنجره.

فرم همچنان روی پرسینو اجرا می‌شود و پاسخ‌ها در پنلِ پرسینو می‌نشینند، نه در پایگاه‌داده‌ی وردپرس؛ پس منطقِ شرطی، فیلدهای ایرانی، گزارش‌ها و خروجی‌ها همان است که در پرسینو دارید. افزونه رایگان است و قفلی ندارد.

📥 نصب

1. ۱ فایلِ zip را بگیرید از صفحه‌ی «افزونه فرم ساز وردپرس» در سایت، یا از کارتِ «افزونه‌ی وردپرس» در زبانه‌ی «اشتراک‌گذاری»ِ هر فرم.
2. ۲ در پیشخوانِ وردپرس به «افزونه‌ها › افزودن › بارگذاریِ افزونه» بروید فایل را انتخاب کنید و «هم‌اکنون نصب کن» را بزنید.
3. ۳ «فعال‌سازی» را بزنید منوی «تنظیمات › پرسینو» اضافه می‌شود؛ پیش‌فرضِ حالت، ارتفاع، متن و رنگِ دکمه همان‌جاست.

🔗 اتصالِ حسابِ پرسینو

اتصال فقط خواندنی است: عنوانِ فرم‌ها و آزمون‌های شما و تیم‌هایتان، نشانیِ لینک، وضعیتِ انتشار و شمارِ پاسخ‌ها. خودِ پاسخ‌ها، فایل‌ها، گزارش‌ها، تنظیمات و صورت‌حساب هرگز به وردپرس نمی‌رسند و افزونه نمی‌تواند چیزی بسازد یا تغییر دهد.

برای قطعِ اتصال در خودِ افزونه «قطع اتصال» را بزنید، یا در پرسینو به «تنظیمات › API و اتصال‌ها» بروید و کنارِ همان سایت «قطع اتصال» را بزنید. اتصالِ دوباره‌ی همان سایت کلیدِ قبلی را خودبه‌خود باطل می‌کند.

1. ۱ در «تنظیمات › پرسینو» دکمه‌ی «اتصال حساب» را بزنید مرورگر به صفحه‌ی اجازه‌ی پرسینو می‌رود؛ اگر وارد نیستید، اول وارد شوید یا رایگان ثبت‌نام کنید.
2. ۲ نامِ سایت و فهرستِ دسترسی‌ها را بخوانید و «اجازه می‌دهم» را بزنید به پیشخوانِ وردپرس برمی‌گردید و نامِ حسابِ وصل‌شده را می‌بینید.
3. ۳ حالا در بلوک، ابزارکِ المنتور و ویرایشگرِ کلاسیک فرم را از فهرست انتخاب کنید با جست‌وجوی عنوان، نشانی یا کدِ کوتاه.

📝 گذاشتنِ فرم در نوشته و برگه

گوتنبرگ: بلوکِ «فرمِ پرسینو» را اضافه کنید و فرم را از فهرست بردارید (یا نشانی‌اش را بچسبانید).

المنتور: ابزارکِ «فرمِ پرسینو» را در صفحه بکشید.

ویرایشگرِ کلاسیک: دکمه‌ی «افزودن فرم پرسینو» بالای ویرایشگر کدِ کوتاه را می‌گذارد.

یا کدِ کوتاهِ هر فرم را از کارتِ «افزونه‌ی وردپرس» در زبانه‌ی «اشتراک‌گذاری» کپی کنید. نشانیِ فرم می‌تواند نامکِ لینک، کدِ کوتاهِ همیشگی یا خودِ لینک باشد.

[porsino form="14050721-3"]
[porsino form="14050721-3" mode="popup" label="Answer the form"]
[porsino form="14050721-3" utm="1" page="1" params="source=blog"]
[porsino form="14050721-5" type="quiz"]

🏷️ ویژگی‌های کدِ کوتاه

form — نامک، کدِ کوتاه یا لینکِ فرم (لازم).

mode — inline (درونِ صفحه با ارتفاعِ خودکار) یا popup (دکمه و پنجره).

height — ارتفاعِ اولیه‌ی قاب به پیکسل؛ label — متنِ دکمه؛ color — رنگِ دکمه (hex).

type — quiz برای آزمون (دکمه‌ی زبانه‌ی تازه، حتی بی اتصالِ حساب) یا form.

utm، page و user با مقدارِ 1 — فرستادنِ داده به فیلدهای مخفی؛ params — مقدارهای ثابت به شکلِ key=value&key2=value2.

base — نشانیِ دامنه‌ی اختصاصیِ پرسینو برای همین فرم.

🕵️ فرستادنِ اطلاعاتِ صفحه و کاربر به فیلدِ مخفی

افزونه داده را به نشانیِ فرم اضافه می‌کند و فرم آن را در «فیلد مخفی» ذخیره می‌کند؛ هر مقدار فقط وقتی ذخیره می‌شود که فرم فیلدِ مخفی با همان نام داشته باشد. هیچ‌کدام پیش‌فرض روشن نیست.

utm="1" — پارامترهای utm_source، utm_medium، utm_campaign، utm_term و utm_content صفحه؛ فیلدِ مخفی با منبعِ «UTM» و همان نام.

page="1" — wp_page (نشانیِ صفحه بی پارامتر) و wp_title؛ فیلدِ مخفی با منبعِ «پارامتر URL».

user="1" — wp_name و wp_email فقط برای کاربرِ واردشده‌ی وردپرس؛ آن صفحه برای افزونه‌های کش «کش نشود» علامت می‌خورد.

params — هر کلیدِ دلخواه با حروفِ کوچکِ لاتین، رقم و «_» (تا ۲۰ جفت، هر مقدار تا ۲۰۰ نویسه)؛ edit و resume پذیرفته نمی‌شوند.

💬 دکمه‌ی شناور و پنجره‌ی خودکار

در «تنظیمات › پرسینو» یک فرم را برای دکمه‌ی شناورِ گوشه‌ی صفحه بگذارید؛ فرم در پنجره باز می‌شود.

پنجره‌ی خودکار با یکی از سه شروع‌کننده باز می‌شود: پس از چند ثانیه، پس از پیمایشِ درصدی از صفحه، یا هنگامِ ترکِ صفحه. دفعاتِ نمایش: هر بار، یک بار در هر بازدید یا هر چند روز یک بار.

هر دو را می‌شود فقط برای صفحه‌ی نخست، نوشته‌ها، برگه‌ها یا شناسه‌های دلخواه روشن کرد و صفحه‌هایی را کنار گذاشت. تصمیم‌ها در مرورگر گرفته می‌شود، پس کشِ صفحه خراب نمی‌شود.

🛒 نظرسنجی پس از خرید در ووکامرس

اگر ووکامرس فعال است، در «تنظیمات › پرسینو» فرمی را برای صفحه‌ی «سفارش دریافت شد» انتخاب کنید. فرم order_id را می‌گیرد و اگر روشن کنید order_total، customer_name و customer_email را هم؛ برای هرکدام فیلدِ مخفی با منبعِ «پارامتر URL» و همان نام بسازید.

فرم فقط وقتی نشان داده می‌شود که کلیدِ همان سفارش در نشانی باشد — همان بررسی‌ای که خودِ ووکامرس روی این صفحه می‌کند.

🎓 آزمون

آزمون داخلِ صفحه‌ی سایت برگزار نمی‌شود: افزونه دکمه‌ی «شروع آزمون» می‌گذارد که آزمون را در زبانه‌ی تازه باز می‌کند تا زمان‌سنجِ سمتِ سرور، تمام‌صفحه و ضدتقلب درست کار کنند. کدِ کوتاهِ آزمون در پرسینو خودش type="quiz" دارد.

🛠️ اگر کار نکرد

فرم نمایش داده نمی‌شود: فرم باید منتشر شده و لینکش فعال باشد؛ وضعیت را در زبانه‌ی «اشتراک‌گذاری» ببینید.

دکمه‌ی پنجره کاری نمی‌کند یا ارتفاعِ فرم درست نمی‌شود: افزونه‌های بهینه‌سازی که جاوااسکریپت را ادغام یا به تأخیر می‌اندازند را برای اسکریپتِ porsino-forms مستثنا کنید.

فرم روی دامنه‌ی اختصاصی باز نمی‌شود: نشانیِ دامنه را در «تنظیمات › پرسینو» یا با ویژگیِ base بدهید و مطمئن شوید دامنه در پرسینو فعال است.