fcomursDocs

Store Developer Guide

HTML, CSS আর JavaScript দিয়ে fcomurs store সাজাও — editor-এর ভেতরেই। Server, build, deploy কিছু লাগে না।

১.কোথায় কী

Diagram
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 sectionsPublish code
যেকোনো section-এর জন্য blockEdit code, Your blocksPublish code
Built-in section/block বদলানোRight-click, Customize codePublish code
নিজের header / footerEdit code, Header / Footerpage-এর Publish
একটা page-এ একটু CSSCustom code, This pagepage Publish
পুরো store-এর CSS / scriptCustom code, Whole storeSave
Analytics, Pixel, TikTok…Custom code, TrackingSave

টিপস: panel-এর মাঝের কিনারা টেনে চওড়া/সরু করো (double-click = আগের মাপ)।

২.File এক নজরে

FileSectionBlockকোথায় চলে
.htmlHandlebars {{settings.x}}Handlebarsserver + editor preview
.css✓✓browser
.jsপায় section, fcপায় block, fcশুধু store-এ (আর Preview link-এ)
.jsonsettings blocks starter max_blocksশুধু settingssetting panel বানায়

৩.প্রথম section — ৫ ধাপ

  1. Edit code, Your sections, + New, নাম, Enter
  2. .json — merchant কী বদলাতে পারবে
  3. .html — সেগুলো বসাও: {{settings.heading}}
  4. Save draft (Ctrl+S), preview দেখো
  5. Publish code, যোগ করো: Add section, Code sections

৪.settings.json

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
}
kindTemplate-এ আসে
text textarea url color datetimeলেখা
richtextHTML — {{{ }}} দিয়ে ছাপো
imageছবির ঠিকানা
selectবাছা মান (options লাগে)
number rangeসংখ্যা (min max step unit)
checkboxtrue / false
producttitle url image price compareAtPrice inStock id slug
collectionname url image slug products
collectionscollection-এর তালিকা
formform-এর id

আরও: default · help · placeholder। key: অক্ষর দিয়ে শুরু; অক্ষর, সংখ্যা, _।

৫.Template cheat sheet

নামSectionBlock
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}}
Handlebars
<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-এর সংখ্যা নিজে বদলায়
JavaScript
// 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 sectionCode block
Page-এcode:<id>cb:<id>
.jsonsettings + blocksশুধু settings
Script পায়sectionblock
যোগ করাAdd section, Code sectionsAdd block, Your code blocks

কোন section কোন block নেয় — প্রতিটা built-in-এর schema.json-এ accepts:

SectionAdd block-এ আসে
বেশিরভাগ ("@theme", default)সব built-in block + তোমার code block
Product grid · Featured collection · Collection list · Brand listHeading, Text, Button, Divider, Space

আগে থেকে page-এ থাকা block থেকে যায়।

৮.Built-in code customize

Diagram
Built-in section ──Customize code──▶ "<নাম> (custom)"   শুধু তোমার store-এ
   settings + নিজের block ─────────── থাকে ──────────▶
   store data (product, slide…) ──── data.* হয়ে ───▶
কীভাবেকোথায়
Section-এ right-click / ⋯, Customize codepage-এ
Edit code, Theme sections / Theme blocks, Customizepage-এ বসে না
ফেরা: ⋯, Use original section / blockcopy Edit code-এ থেকে যায়

২৩টা section আর ১১টা block customize করা যায়।

Sectiondata-তে
Product grid, Featured collectiondata.products
Featured productdata.product (+ images, description)
Collection list / Brand listdata.collections / data.brands
Slideshowdata.slides, data.side
Contact details / Formdata.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-টি রাখুন:

Handlebars
<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

Diagram
লেখো ──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 চিহ্ন:

  1. Compare — default-এ কী বদলেছে · তোমার vs নতুন
  2. Start from the new default — নতুন file তোমার draft-এ (বাড়তি setting থাকে)
  3. Preview, Publish code
HeaderFooter
{{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 — publishPublish code, Restore & publish, মোছা, Pause

Owner-এর দুটোই। Settings, Staff, Page access।

১৫.পুরো উদাহরণ — Trust badges

Click করলে ব্যাখ্যা খোলে এমন badge, সঙ্গে একটা product।

trust-badges.jsonJSON
{
  "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
}
trust-badges.htmlHandlebars
<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>
trust-badges.cssCSS
.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; }
trust-badges.jsJavaScript
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-এর পাশে)
LivePublish 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-র লাল বাক্স দেখো