فصل ۵: فانکشنها: کد روی سروردرس ۱۷ از ۲۳
فرم تماس با یک فانکشن
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
یک فرم «تماس با ما» برای بازدیدکنندهی بدون حساب: جدول «پیام تماس» خصوصی میماند و ایمیل و الزامی بودن را خودش چک میکند، و یک فانکشن سهخطی عمومی پیام را از طرف پروژه در آن میگذارد. فانکشن فقط برای کاری که API آماده انجام نمیدهد.
در این درس یاد میگیرید
- اینکه کِی فانکشن لازم است و کِی API آماده کافی است
- چک کردن ورودی با خود جدول: نوع «ایمیل» و «الزامی»
- ساختن یک فانکشن عمومی که با
ctx.db.adminدر جدولی خصوصی مینویسد - صدا زدن فانکشن از صفحهی سایت با کلید فقط خواندنی
برای ادامه بخوانید
- مدت
- ۵ دقیقه۴ قدم
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
contact.js
۸ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
// فرم تماس: بازدیدکنندهی بدون حساب پیام میفرستد
const { email, message } = ctx.request.body || {};
// ذخیره در جدول «پیام تماس»، از طرف پروژه
// چک کردن ایمیل و الزامی بودن، کار خود جدول است
const saved = ctx.db.admin.create("contact_message", { email, message });
ctx.respond(201, { id: saved.id });index.html
۶۲ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
<!doctype html>
<html lang="fa" dir="rtl">
<meta charset="utf-8">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vazirmatn@33.0.3/Vazirmatn-font-face.css">
<style>
body { font: 19px/1.9 Vazirmatn, Tahoma, sans-serif; background: #f5f5f4; color: #1c1917;
max-width: 1040px; margin: 0 auto; padding: 24px; }
main { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; align-items: start; }
.card { background: #fff; border: 1px solid #e7e5e4; border-radius: 14px; padding: 20px; }
h1 { margin: 0 0 16px; } h2 { margin: 0 0 8px; font-size: 20px; }
input, textarea { font: inherit; width: 100%; box-sizing: border-box; margin-bottom: 10px;
padding: 6px 12px; border: 1px solid #d6d3d1; border-radius: 8px; }
button { font: inherit; padding: 4px 16px; border: 0; border-radius: 8px;
background: #ea580c; color: #fff; cursor: pointer; }
ul { list-style: none; padding: 0; margin: 0; }
li { padding: 6px 0; border-top: 1px solid #f0efee; }
#status { margin: 8px 0 0; color: #57534e; }
</style>
<body>
<h1>فروشگاه من</h1>
<main>
<section class="card">
<h2>محصولات</h2>
<ul id="products"></ul>
</section>
<form id="contact" class="card">
<h2>تماس با ما</h2>
<input id="email" placeholder="ایمیل شما">
<textarea id="message" rows="3" placeholder="پیامتان را بنویسید"></textarea>
<button>فرستادن</button>
<p id="status"></p>
</form>
</main>
<script type="module">
import { createClient } from "https://cdn.jsdelivr.net/npm/@fikaro/client/+esm";
const fikaro = createClient({ project: "my-shop", key: "YOUR_KEY" });
const $ = (id) => document.getElementById(id);
const { data } = await fikaro.from("product").list();
$("products").replaceChildren(...data.map((p) => {
const li = document.createElement("li");
li.textContent = `${p.name} — ${p.price.toLocaleString("fa-IR")} تومان`;
return li;
}));
$("contact").onsubmit = async (e) => {
e.preventDefault();
try {
await fikaro.request("POST", "/fn/contact", {
email: $("email").value,
message: $("message").value,
});
$("contact").reset();
$("status").textContent = "پیامتان رسید؛ بهزودی جواب میدهیم.";
} catch (err) {
$("status").textContent = err.message;
}
};
</script>هر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
از منوی کناری «جدولها» را باز کنید.
«موجودیت جدید» را بزنید.
نامش را «پیام تماس» بگذارید و شناسهاش را
contact_message.«ایجاد» را بزنید.
«فیلد جدید» را بزنید.
فیلد اول: «ایمیل» با شناسهی
email.نوعش را «ایمیل» بگذارید.حالا جدول، ایمیلِ نادرست را خودش رد میکند؛ لازم نیست کدی برایش بنویسید.
«الزامی» را تیک بزنید.پیامِ بدون ایمیل هم ذخیره نمیشود.
«افزودن فیلد» را بزنید.
فیلد دوم: «متن پیام» با شناسهی
message؛ نوعش «متن» بماند.این یکی هم «الزامی» است.
«افزودن فیلد» را بزنید.
فیلد سوم: «فرستنده» با شناسهی
user_id.برای اینکه هیچ کاربری پیام دیگران را نبیند.«افزودن فیلد» را بزنید.
زبانهی «تنظیمات» را باز کنید.
«فیلد مالکیت» را
user_idبگذارید.«چه کسی میتواند بخواند» را «فقط رکوردهای خودِ کاربر» بگذارید.پیامها را فقط شما در پنل میبینید، نه کاربرهای اپ.
«ذخیره و اعمال» را بزنید، و بعد «اعمال».
جدول آماده است.ولی بازدیدکنندهای که حساب ندارد نمیتواند در آن بنویسد؛ کلید فقط خواندنی فقط میخواند.
از منوی کناری «فانکشنها» را باز کنید.
«اندپوینت HTTP» را بزنید.یک آدرس تازه در API شما، که کدش را خودتان مینویسید.
نامش را
contactبگذارید.آدرس فانکشن از همین نام ساخته میشود.این آدرس فانکشن شماست.صفحهی سایت همین آدرس را صدا میزند.
کد نمونه را پاک کنید و این کد را جایش paste کنید.متن کاملش در صفحهی همین آموزش در fikaro.ir هست.
خط اول، ایمیل و متن پیام را از درخواست برمیدارد.
ctx.db.admin.createپیام را در جدول میگذارد، از طرف پروژه.چک کردن ایمیل و الزامی بودن را به جدول سپردیم؛ اگر رد کند، همان خطا به فرستنده برمیگردد.و در آخر، جواب: شناسهی پیامِ ذخیرهشده.
«چه کسی صدا بزند؟» را «عمومی» بگذارید.فرم تماس را هر بازدیدکنندهای میفرستد، حتی بدون حساب.
«ذخیره» را بزنید.
حالا کلید «فعال» را بزنید.فانکشن تازه تا فعال نشود، جواب نمیدهد.
فانکشن
contactفعال است.این index.html تازه است؛ متن کاملش را از صفحهی همین آموزش در fikaro.ir کپی کنید.کلید فقط خواندنی قسمت ۳ را دوباره بهجای
YOUR_KEYبگذارید.یک فرم ساده: ایمیل، متن پیام، و دکمهی «فرستادن».
این چند خط، فانکشن
contactرا صدا میزنند.همان کلید فقط خواندنی کافی است، چون فانکشن را عمومی کردیم.اگر فانکشن خطا بدهد، متن خطا زیر فرم میآید.
فایل را ذخیره کنید (Ctrl+S).
صفحه را تازه کنید.فرم «تماس با ما» کنار محصولها آمده.
اول یک ایمیل نادرست بنویسید، با یک پیام.
«فرستادن» را بزنید.
جدول، ایمیل نادرست را رد کرد.این پیام را خود جدول داد، نه کد ما؛ همان تنظیم «ایمیل» در قدم اول.
ایمیل را درست کنید و دوباره «فرستادن» را بزنید.
پیام رسید.بدون حساب کاربری، و بدون اینکه جدول برای کسی باز باشد.
در پنل، از منوی کناری «رکوردها» را باز کنید.
جدول «پیام تماس» را انتخاب کنید.
پیام سارا اینجاست.فقط شما در پنل میبینیدش؛ نه بازدیدکنندهها و نه کاربرهای اپ.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.