Store Developer Guide
HTML, CSS আর JavaScript দিয়ে fcomurs store সাজাও — editor-এর ভেতরেই। Server, build, deploy কিছু লাগে না।
১.কোথায় কী
Online store → Customize (editor) │ ├─ ⋯ → Edit code · বা যেকোনো section-এ right-click → Edit code / Customize code │ ├─ Header · Footer header.html/.css/.js │ ├─ Your sections + New <নাম>.html · .css · .js · .json │ ├─ Your blocks + New একই চারটা file, block-এর │ ├─ Theme sections / blocks built-in code, শুধু পড়া → Customize │ └─ উপরে: Docs · Pause custom code · Publish code │ ├─ Custom code (উপরে বাঁয়ে) This page · Whole store · Tracking └─ যেকোনো section/block → Style → For developers #section-… / #block-… copy
| কী করতে চাও | কোথায় | কখন live |
|---|---|---|
| নিজের section বানানো | Edit code, Your sections | Publish code |
| যেকোনো section-এর জন্য block | Edit code, Your blocks | Publish code |
| Built-in section/block বদলানো | Right-click, Customize code | Publish code |
| নিজের header / footer | Edit code, Header / Footer | page-এর Publish |
| একটা page-এ একটু CSS | Custom code, This page | page Publish |
| পুরো store-এর CSS / script | Custom code, Whole store | Save |
| Analytics, Pixel, TikTok… | Custom code, Tracking | Save |
টিপস: panel-এর মাঝের কিনারা টেনে চওড়া/সরু করো (double-click = আগের মাপ)।
২.File এক নজরে
| File | Section | Block | কোথায় চলে |
|---|---|---|---|
.html | Handlebars {{settings.x}} | Handlebars | server + editor preview |
.css | ✓ | ✓ | browser |
.js | পায় section, fc | পায় block, fc | শুধু store-এ (আর Preview link-এ) |
.json | settings blocks starter max_blocks | শুধু settings | setting panel বানায় |
৩.প্রথম section — ৫ ধাপ
- Edit code, Your sections, + New, নাম, Enter
.json— merchant কী বদলাতে পারবে.html— সেগুলো বসাও:{{settings.heading}}- Save draft (Ctrl+S), preview দেখো
- Publish code, যোগ করো: Add section, Code sections
৪.settings.json
{
"settings": [
{ "key": "heading", "label": "Heading", "kind": "text", "default": "Why shop with us" },
{ "key": "featured", "label": "Product", "kind": "product" },
{ "key": "layout", "label": "Layout", "kind": "select", "options": ["grid", "list"], "default": "grid" }
],
"blocks": [
{ "type": "card", "label": "Card", "fields": [
{ "key": "title", "label": "Title", "kind": "text" },
{ "key": "image", "label": "Image", "kind": "image" }
] }
],
"starter": [{ "type": "card", "settings": { "title": "Easy returns" } }],
"max_blocks": 12
}kind | Template-এ আসে |
|---|---|
text textarea url color datetime | লেখা |
richtext | HTML — {{{ }}} দিয়ে ছাপো |
image | ছবির ঠিকানা |
select | বাছা মান (options লাগে) |
number range | সংখ্যা (min max step unit) |
checkbox | true / false |
product | title url image price compareAtPrice inStock id slug |
collection | name url image slug products |
collections | collection-এর তালিকা |
form | form-এর id |
আরও: default · help · placeholder। key: অক্ষর দিয়ে শুরু; অক্ষর, সংখ্যা, _।
৫.Template cheat sheet
| নাম | Section | Block |
|---|---|---|
settings.<key> | ✓ | ✓ |
blocks (প্রতিটায় id type settings) | ✓ | — |
section.id / block.id block.type | ✓ | ✓ |
store — name logo phone email address currencySymbol | ✓ | ✓ |
data — built-in-এর নিজের data (customized copy-তে) | ✓ | — |
| Helper | উদাহরণ |
|---|---|
eq ne gt lt | {{#if (eq type "card")}} |
and or not | {{#if (and settings.a (not settings.b))}} |
default | {{default settings.title "Untitled"}} |
money | {{money price}}, ৳1,990 |
embed | {{embed settings.url}}, YouTube/Vimeo player-এর ঠিকানা |
encode | {{encode settings.address}}, URL-এর ভেতরে নিরাপদ |
lines | {{#each (lines settings.items)}}{{this}}{{/each}} |
<section class="cards"> <h2>{{settings.heading}}</h2> {{#each blocks}} {{#if (eq type "card")}}<div class="card">{{settings.title}}</div>{{/if}} {{/each}} {{#with settings.featured}}<a href="{{url}}">{{title}} — {{money price}}</a>{{/with}} </section>
{{x}} escape করে (নিরাপদ)। {{{x}}} HTML যেমন আছে — শুধু richtext-এর জন্য।
৬.Script (.js)
fc. | কী করে |
|---|---|
submitForm({ form, name, email, phone, message, website }) | Contact / Email signup, ভুল হলে বার্তা, নইলে null |
submitBuiltForm(formId, answers, website) | Online store, Forms-এ বানানো form |
addToCart(productId, quantity) | cart-এ যোগ; header-এর সংখ্যা নিজে বদলায় |
// section = এই copy-র element (প্রতিটা copy-তে একবার চলে) section.querySelectorAll('.card').forEach((card) => { card.addEventListener('click', () => card.classList.toggle('open')); });
Editor preview-তে চলে না — Preview (Publish-এর পাশে) দিয়ে দেখো। Error console-এ Code section "<নাম>"।
৭.Block
| Code section | Code block | |
|---|---|---|
| Page-এ | code:<id> | cb:<id> |
.json | settings + blocks | শুধু settings |
| Script পায় | section | block |
| যোগ করা | Add section, Code sections | Add block, Your code blocks |
কোন section কোন block নেয় — প্রতিটা built-in-এর schema.json-এ accepts:
| Section | Add block-এ আসে |
|---|---|
বেশিরভাগ ("@theme", default) | সব built-in block + তোমার code block |
| Product grid · Featured collection · Collection list · Brand list | Heading, Text, Button, Divider, Space |
আগে থেকে page-এ থাকা block থেকে যায়।
৮.Built-in code customize
Built-in section ──Customize code──▶ "<নাম> (custom)" শুধু তোমার store-এ settings + নিজের block ─────────── থাকে ──────────▶ store data (product, slide…) ──── data.* হয়ে ───▶
| কীভাবে | কোথায় |
|---|---|
| Section-এ right-click / ⋯, Customize code | page-এ |
| Edit code, Theme sections / Theme blocks, Customize | page-এ বসে না |
| ফেরা: ⋯, Use original section / block | copy Edit code-এ থেকে যায় |
২৩টা section আর ১১টা block customize করা যায়।
| Section | data-তে |
|---|---|
| Product grid, Featured collection | data.products |
| Featured product | data.product (+ images, description) |
| Collection list / Brand list | data.collections / data.brands |
| Slideshow | data.slides, data.side |
| Contact details / Form | data.contact / data.form |
Slideshow: মোবাইলে আলাদা banner
প্রতিটি slide-এর নিজের Picture এবং ঐচ্ছিক Picture for phones field আছে। Editor-এ slide যোগ বা বেছে নিয়ে Picture-এ desktop banner দিন, তারপর Picture for phones-এ মোবাইলের আলাদা crop দিন। Phone picture ফাঁকা রাখলে desktop banner-টাই ব্যবহার হবে। 639px বা তার কম screen-এ একই slide-এর mobile image দেখায়; link ও alt text একই থাকে।
Slideshow-এর code customize করলে <picture> pattern-টি রাখুন:
<picture> {{#if mobileImage}}<source media="(max-width: 639px)" srcset="{{mobileImage}}">{{/if}} <img src="{{image}}" alt="{{title}}"> </picture>
প্রতিটি slide-এর জন্য data.slides-এ image, mobileImage, link, ও title আসে। তাই প্রতিটি desktop banner-এর জন্য আলাদা mobile banner দেওয়া যায়। Slideshow-এর আলাদা Side picture setting শুধু পাশাপাশি ছবি দেখানোর layout-এর জন্য—এটি mobile banner নয়।
৯.Draft → Publish → History
লেখো ──Save draft──▶ DRAFT ──Publish code──▶ LIVE │ লিখতে লিখতে preview │ │ আগের version → History (শেষ ২০) │ └──Discard draft──▶ live-এ ফেরা └─ Preview link-এ draft দেখা যায় (script-ও চলে)
| কাজ | কে দেখে |
|---|---|
| লেখা | editor preview |
| Save draft | তুমি + Preview link যার আছে |
| Publish code (যেটা দরকার টিক দাও) | সব shopper, যেসব page-এ আছে |
| History, Restore as draft / Restore & publish | — |
- Page-এর Publish code publish করে না।
- দুজন একই file-এ, *"changed while you were editing"*: Keep mine বা Load theirs।
১০.ভুল code store ভাঙে না
| ভুল | কী হয় |
|---|---|
settings.json ভুল | লাল লেখা; save হয় না |
Template ভাঙা ({{#if}} বন্ধ নেই) | Save হয় না, file + line লাল বারে |
| চলার সময় ভুল | preview: লাল বাক্স · store: আসল built-in (শূন্য থেকে লেখা হলে ফাঁকা) |
| JavaScript error | শুধু ঐ copy থামে; console-এ দেখায় |
Pause custom code (উপরে): সব customized section/block আসলটা দেখায়, কোনো code script চলে না। কিছু মোছে না।
১১.fcomurs built-in বদলালে
তোমার copy নিজে থেকে বদলায় না। নতুন default এলে Update চিহ্ন:
- Compare — default-এ কী বদলেছে · তোমার vs নতুন
- Start from the new default — নতুন file তোমার draft-এ (বাড়তি setting থাকে)
- Preview, Publish code
১২.Header ও footer placeholder
| Header | Footer |
|---|---|
{{logo}} {{store_name}} | {{logo}} {{store_name}} {{about}} |
{{menu}} {{search}} | {{categories}} {{social}} |
{{cart_count}} (নিজে বদলায়) | {{quick_links}} {{info_links}} {{support_links}} {{extra_links}} |
{{phone}} {{email}} | {{phone}} {{email}} {{address}} {{copyright}} {{year}} |
চালু করতে: Edit code, Header-এ Use this code।
১৩.রং ও selector
| CSS variable | কীসের |
|---|---|
var(--primary) | দাম, link, accent |
var(--btn-color) / var(--btn-fg) | বোতাম / তার লেখা |
var(--nav-bg) / var(--nav-fg) | header ও footer / তার লেখা |
var(--background) | page |
| কী ধরবে | Selector |
|---|---|
| একটা section / block | #section-<id> · #block-<id> (right-click, Copy CSS selector) |
| এক ধরনের | [data-section="product-grid"] · [data-block="button"] |
| সব | .fc-section · .fc-heading · [data-code-section] · [data-code-block] |
১৪.অনুমতি
| অনুমতি | কী করা যায় |
|---|---|
| Custom code | লেখা, Save draft, preview, Customize, History |
| Custom code — publish | Publish code, Restore & publish, মোছা, Pause |
Owner-এর দুটোই। Settings, Staff, Page access।
১৫.পুরো উদাহরণ — Trust badges
Click করলে ব্যাখ্যা খোলে এমন badge, সঙ্গে একটা product।
{
"settings": [
{ "key": "heading", "label": "Heading", "kind": "text", "default": "Why shop with us" },
{ "key": "product", "label": "Product to show", "kind": "product", "help": "Optional" },
{ "key": "columns", "label": "Badges per row", "kind": "range", "min": 2, "max": 4, "default": 3 }
],
"blocks": [
{
"type": "badge",
"label": "Badge",
"fields": [
{ "key": "icon", "label": "Icon", "kind": "text", "default": "✓" },
{ "key": "title", "label": "Title", "kind": "text", "default": "Easy returns" },
{ "key": "detail", "label": "Detail (opens on click)", "kind": "textarea" }
]
}
],
"starter": [
{ "type": "badge", "settings": { "title": "Easy returns", "detail": "Change your mind within 7 days." } },
{ "type": "badge", "settings": { "icon": "⚡", "title": "Fast delivery", "detail": "Inside Dhaka in 1–2 days." } },
{ "type": "badge", "settings": { "icon": "↺", "title": "Easy returns", "detail": "Change your mind within 7 days." } }
],
"max_blocks": 8
}<section class="tb"> {{#if settings.heading}}<h2 class="tb-title">{{settings.heading}}</h2>{{/if}} <ul class="tb-list" style="--tb-cols: {{default settings.columns 3}}"> {{#each blocks}} {{#if (eq type "badge")}} <li class="tb-badge"> <button type="button" class="tb-head" aria-expanded="false"> <span class="tb-icon" aria-hidden="true">{{default settings.icon "✓"}}</span> {{settings.title}} </button> {{#if settings.detail}}<p class="tb-detail" hidden>{{settings.detail}}</p>{{/if}} </li> {{/if}} {{/each}} </ul> {{#with settings.product}} <a class="tb-product" href="{{url}}"> <img src="{{image}}" alt="{{title}}" loading="lazy"> <span>{{title}} — {{money price}}</span> </a> {{/with}} </section>
.tb { max-width: 1100px; margin: 0 auto; padding: 40px 20px; } .tb-title { margin: 0 0 20px; font-size: 26px; font-weight: 700; text-align: center; } .tb-list { display: grid; grid-template-columns: repeat(var(--tb-cols), minmax(0, 1fr)); gap: 12px; margin: 0; padding: 0; list-style: none; } @media (max-width: 640px) { .tb-list { grid-template-columns: 1fr; } } .tb-badge { border: 1px solid #e5e5e5; border-radius: 8px; } .tb-head { display: flex; width: 100%; align-items: center; gap: 10px; padding: 14px 16px; border: 0; background: none; font: inherit; font-weight: 600; text-align: left; cursor: pointer; } .tb-icon { color: var(--primary); } .tb-detail { margin: 0; padding: 0 16px 14px 42px; opacity: 0.75; } .tb-product { display: flex; align-items: center; gap: 12px; margin-top: 20px; color: inherit; text-decoration: none; } .tb-product img { width: 64px; height: 64px; object-fit: cover; border-radius: 8px; }
section.querySelectorAll('.tb-head').forEach((head) => { const detail = head.nextElementSibling; if (!detail) return; head.addEventListener('click', () => { const open = head.getAttribute('aria-expanded') === 'true'; head.setAttribute('aria-expanded', String(!open)); detail.hidden = open; }); });
| তারপর | |
|---|---|
| Save draft | লাল বার = ভুল, কোন file-এ |
| Page-এ বসাও | Add section, Code sections, Trust badges, product বাছো |
| Script দেখো | Preview (Publish-এর পাশে) |
| Live | Publish code, টিক, Publish; তারপর page-এর Publish |
| ফেরাও | History, Restore & publish · বা Pause custom code |
Block হিসেবে: Your blocks, + New, Badge; .json-এ শুধু settings (icon, title, detail); script-এ section-এর বদলে block।
১৬.সীমা ও সমাধান
| সীমা | |
|---|---|
| প্রতিটা file | ১,০০,০০০ অক্ষর (.json ২০,০০০) |
| প্রতি store-এ code section / block | ৫০ / ৫০ |
| History | প্রতিটার শেষ ২০টা publish |
| সমস্যা | সমাধান |
|---|---|
| Save করলাম, store-এ বদল নেই | Save draft শুধু draft, Publish code |
| Publish বোতাম নেই | শুধু লেখার অনুমতি — owner-কে বলো |
| Script কাজ করছে না | editor preview-তে চলে না — Preview দেখো; console দেখো |
| CSS অন্য section-এ লাগছে | #section-<id> বা নিজের class দিয়ে শুরু করো |
{{settings.x}} ফাঁকা | .json-এ নেই বা খালি, {{default settings.x "…"}} |
| Add block-এ আমার block নেই | ঐ section নেয় না — Rich text / Custom section-এ দাও |
| Customized section আসলটার মতো দেখাচ্ছে | code pause করা, বা template চলতে গিয়ে ভুল — preview-র লাল বাক্স দেখো |
