ShopFlow e-commerce theme documentation
A fast, mobile-first WooCommerce theme with a customizable homepage, quick-order product cards, an installable mobile app experience and social login. This guide takes you from upload to a finished store.
What you get
Everything below is controlled from Appearance → Customize. No code is needed.
Homepage builder
Four hero layouts including video, editable features strip, category grid with Show more, and five promo banner slots.
Quick order cards
Order from the product card or product page without opening the cart. Buy now and pre-order buttons included.
App-like mobile
Bottom navigation bar, installable PWA, and an install pop-up that hides itself inside the installed app.
Account & login
Register form, tabbed login, Google and Facebook sign-in.
Brand control
Solid, gradient or glossy brand fill. Colors can be picked from your logo. Light and dark mode.
Bilingual
English and Bengali switcher with automatic theme translations.
Requirements
Check these with your hosting provider before installing.
| Item | Minimum | Recommended |
|---|---|---|
| WordPress | 6.0 | 6.8 |
| PHP | 7.4 | 8.1 or newer |
| WooCommerce | Active plugin | Latest release |
| HTTPS | Needed for PWA install, Google and Facebook login | Valid SSL certificate |
| PHP memory limit | 128 MB | 256 MB |
Installation
Upload the theme zip file, then activate it. Use the zip named shopflow-ecommerce.zip, not the folder inside it.
- Install and activate WooCommerce from Plugins → Add New.
- Go to Appearance → Themes → Add New → Upload Theme.
- Choose
shopflow-ecommerce.zipand press Install Now. - Press Activate. You will be asked for your license (next section).
- Unzip the file on your computer. You get one folder named
shopflow-ecommerce. - Upload that folder to
/wp-content/themes/. - Open Appearance → Themes and activate ShopFlow.
License activation
ShopFlow needs an active license. Without one the storefront shows a maintenance page to visitors, while the admin area stays open for you.
- After activation you land on the license screen. If you do not, open Appearance → Theme License.
- Enter your license key and the email used for purchase, then press Activate.
- When the status turns to Active the storefront opens again and demo import unlocks.
portal.getproservices.net. The server must be able to make outgoing HTTPS requests.Import demo content
Loads 39 sample products in 10 categories, pages, menus and the default contact details so you can edit instead of starting empty. The product pictures are original illustrations bundled with the theme.
- Activate your license first.
- Open Appearance → Demo Content and press Import.
- Wait until the progress bar finishes. Do not close the tab.
[email protected], 8801821124025 and Dhaka, Bangladesh. Replace them in Customize → ShopFlow Contact.Demo templates
Apply a complete homepage layout and style in one click from Appearance → Demo Content → Demo Templates. A template changes the look only. Your products, pages, menus, logo and contact details are not touched, and you can fine-tune everything in the Customizer afterwards.
| Template | Hero | Homepage style | Colors |
|---|---|---|---|
| Classic Blue | Full-width banner slider | Classic | Blue, navy footer |
| Modern Blue Cards | Slider + 2 category cards | Classic | Blue, navy footer |
| Smart Store Orange | Slider + 2 category cards | Smart Store | Orange gradient, navy footer |
| Premium Dark Gold | Dark banner slider | Premium Dark | Black and gold, with search bar and All Categories bar |
| Premium Light Gold | Light banner slider | Premium Light | Cream and gold, with search bar and All Categories bar |
| Outdoor Camo Green | Dark banner + highlights + Trending row | Premium Dark | Olive and khaki, round badge logo, scrolling pattern band |
| Outdoor Camo Light | Light banner + highlights + Trending row | Premium Light | Olive and khaki on cream, round badge logo, scrolling pattern band |
| Fresh Green Mega Menu | Category menu + slider | Classic | Green gradient, dark mode switch on |
| Glossy Violet Split | Text beside artwork | Classic | Glossy violet, brand-colored top bar |
- Install the demo content first so the pages show real products and categories.
- Press Preview to see a template on your own site. A bar at the bottom shows Apply this template and Exit preview. Nothing is saved while you preview, and only administrators see the preview.
- Press Apply template on the one you like. The active template shows an Active label.
- Open your homepage. Change anything you want in Appearance → Customize.
WooCommerce setup
Run the WooCommerce wizard first, then create the standard pages.
- Set your currency, shipping and payment methods in WooCommerce → Settings.
- Make sure Shop, Cart, Checkout and My Account pages exist under WooCommerce → Settings → Advanced.
- Set Settings → Reading → Your homepage displays → A static page and choose the demo Home page. ShopFlow draws the homepage from
front-page.php. - Set permalinks to Post name in Settings → Permalinks.
Customizer map
Open Appearance → Customize. All theme options sit in panels that start with “ShopFlow”.
| Panel | What it controls |
|---|---|
| ShopFlow Colors | Brand fill (solid, gradient, glossy), colors from logo, gradient angle, accent, second color, text color |
| ShopFlow Layout | Site width, light/dark toggle, dark mode logo |
| ShopFlow Header | Top bar visibility and message |
| ShopFlow Language | English / বাংলা switcher, position, default language |
| ShopFlow Homepage (panel) | Sections & Titles, Hero Layout & Banners, Hero Slides, Features Strip, Category Tiles, Promo Banners, Extra Promo Sections, Customer Reviews |
| ShopFlow Product Cards | Quick order, Buy now text, pre-order |
| ShopFlow Mobile Bottom Bar | Bottom navigation slots |
| ShopFlow Footer | Footer background and text colors, footer text, “Download Mobile App” column, PWA icon, install pop-up options |
| ShopFlow Checkout | “Create an account” (Register) on My Account |
| ShopFlow Social Login | Google and Facebook sign-in |
| ShopFlow Category Pages | Category archive options |
| ShopFlow Social Links | Social media icons |
| ShopFlow Contact Page | Email, phone, address, map |
Header & top bar
Logo, search, account, cart and optional language and theme switches.
- Logo: Site Identity → Logo. If none is set, the bundled ShopFlow logo shows.
- Dark mode logo: upload a light-colored version in ShopFlow Layout → Logo for dark mode. It replaces the normal logo when a visitor switches to dark mode.
- Top bar: toggle it under ShopFlow Header. The message defaults to “Free shipping on orders over $50”.
- Brand fill on the top bar: enable “Use the brand fill for the top bar and the newsletter band” under ShopFlow Colors.
- 1Top bar message and menu
- 2Logo
- 3Search
- 4Language, theme, account, cart
Homepage style
Choose how the homepage is arranged in ShopFlow Homepage → Sections & Titles → Homepage style.
Classic
The original order: hero, features strip, categories, featured products, promos.
Premium Dark
A dark gold look for the whole site: a search bar that is always visible, a menu bar with an All Categories dropdown, your menu links and a Special Deals button, then category tiles under the banner. Edit the search placeholder and button texts in ShopFlow Header. Use dark banner images or the video hero for the best result.
Smart Store
Hero banner, large colored category cards, featured products, promo banners, a “why choose us” icon strip, reviews, then the newsletter band.
Every section keeps its own on/off switch and text fields, so you can still hide or rename anything.
Hero banner
Pick one of five layouts in ShopFlow Homepage → Hero Layout & Banners.
Full-width banner images
Large banner slides with heading, text and button.
Sidebar menu + banner slider
Category list on the left from the Hero Sidebar Menu, slider on the right.
Classic: text beside artwork
Text on one side, artwork on the other.
Banner slider + category cards on the right
The slider with 1 to 4 category cards beside it. Choose the categories by slug (for example electronics, beauty-health), the number of cards and the column width. Card pictures come from each category thumbnail.
Video banner (play video)
A banner that plays your video.
Video banner
- Set Hero layout to Video banner (play video).
- Upload an MP4, or paste a YouTube / Vimeo / MP4 link.
- Add a poster image.
- Choose how it plays: poster with a Play button (plays on click), or plays by itself, muted and looping, like a moving background.
- Heading, text and overlay use the banner settings in the same section.
Features strip
The row of short promises under the hero (shipping, payment, returns, support). Edit icon, title and text for each item.
Open ShopFlow Homepage → Features Strip.
Categories grid
Shows product categories as tiles. Choose how many appear first and let visitors reveal the rest.
- Columns: tiles per row on desktop.
- Show first: how many tiles are visible at start.
- Show more button: when the category count is higher than “Show first”, a button reveals the others without reloading the page.
- Category images come from Products → Categories → Thumbnail.
- 1Reveals the remaining categories
Extra promo banner sections
Add banner rows between homepage sections. Each row has its own images, links and number of columns.
Positions available:
| Position | Appears |
|---|---|
| After categories | Directly below the category grid |
| After featured products | Below the featured products row |
| After promos | Below the standard promo cards |
| After deals | Below the deals section |
| Before newsletter | Just above the newsletter band |
For each section: switch it on, add up to the allowed number of banners (image, link, alt text) and choose 1, 2 or 3 columns. Empty banners are skipped.
Product cards
Compact cards with a framed “Quick order” area under the price.
Card options sit under ShopFlow Product Cards: the Buy now button text, pre-order for out-of-stock items, and the pre-order button text.
Quick order & Buy now
On a single product page the Quick order frame sits below Add to cart and Buy now. A customer enters name, phone and address and places the order on the spot.
- 1Quick order frame, same style as the product card
Category banners
Give each product category its own banner image on its archive page.
- Go to Products → Categories and edit a category.
- Find Category banner, press Select image and pick a wide image (about 1600×400).
- Optional: add a banner link. Press Update.
Categories without a banner show the default shop heading.
My Account & registration
The account page shows Login and Register side by side on desktop and as tabs on mobile.
Registration is switched on by the theme through ShopFlow Checkout → Show “Create an account” on My Account. The WooCommerce setting is overridden for you.
PWA & install pop-up
Visitors can add your store to their home screen as an app. ShopFlow serves the web app manifest and service worker for you.
Setup
- Make sure the site runs on HTTPS.
- Open ShopFlow Footer and tick Installable web app (PWA). Set the app text.
- Upload a square 512×512 PNG app icon, or keep the bundled one.
- Tick Show an “Install our app” pop-up and choose its position (header, footer or center), delay, and how many days to wait after it is closed.
When the pop-up shows
- The browser supports installing and the app is not installed yet.
- Never inside the installed app (standalone mode).
- After a visitor closes it, it waits the number of days you set before showing again.
- Optional: show it only on phones and tablets.
- On iPhone the pop-up explains the Share → Add to Home Screen steps.
SMTP mail setup
Send order emails, password resets and contact form messages through your own mail server. Open Appearance → SMTP Mail.
- Press a quick-fill button (Gmail, Outlook, SendGrid, Mailgun or Brevo), or type your host and port.
- Choose encryption: TLS with port 587, or SSL with port 465.
- Enter the username and password. For Gmail or Microsoft with 2-step verification, create an App Password.
- Set From email to an address on the same account or domain, tick Enable and save.
- Enter your address under Send a test email and press Send test. If it fails, the server conversation is shown.
WhatsApp chat button
Tick Show a floating WhatsApp chat button in ShopFlow Header, enter the number with the country code (for example 8801821124025) and set the button text. On phones it becomes a round icon above the bottom bar.
Language switcher
Enable under ShopFlow Language. Theme texts are translated automatically. For text you typed yourself, write both languages in the same field, separated by ||:
Free shipping over $50 || ৫০ ডলারের উপরে ফ্রি ডেলিভারি
Place the switcher in the header, top bar, or both. First-time visitors can start in English, Bengali or the WordPress site language.
Dark mode
Tick Show a light/dark toggle in the header under ShopFlow Layout. The visitor’s choice is remembered in their browser.
Troubleshooting
| Problem | Fix |
|---|---|
| Site shows a locked / maintenance page | License is missing or expired. Log in at /wp-admin and activate it. |
| “Critical error” after an update | A file upload was cut off. Re-upload the whole theme folder, then check wp-content/debug.log. |
| Old design after update | Clear the cache plugin and CDN, then hard-refresh the browser. |
| Install pop-up never appears | Needs HTTPS and a supported browser. It hides after a visitor dismisses it, and inside the installed app. |
| Google or Facebook says “redirect_uri mismatch” | The redirect address in the provider console must match the Customizer value exactly, including https://. |
| Facebook login works only for you | The Meta app is still in Development mode. Switch it to Live. |
| No Register form on My Account | Enable it under ShopFlow Account, then clear caches. |
| Hero video does not autoplay on phones | Use “plays by itself” mode with an MP4, and set a poster image. Some phones in low-power mode block autoplay; the “Play button” mode always works. |
| Demo import button disabled | License not active yet. |
Checkout style, card colours and sub-menus
One-page order form checkout
The checkout shows a product row with a quantity stepper, name, address and phone fields, delivery zone cards (for example Inside Dhaka and Outside Dhaka) and an order summary with a large confirm button. Open Customize → ShopFlow Checkout to change the button text, the note under it and the three info lines, add or hide an optional customer note field (its text is saved as the order note and shown on the order page), or choose Standard to go back to the normal WooCommerce layout. For the delivery zone cards add two flat-rate shipping methods in WooCommerce → Settings → Shipping. This works with the classic checkout shortcode.
Product card colours
Customize → Product Card Colors sets the card background, product name, price, old price, rating stars, sale badge, button text, icon colours and the Buy now, WhatsApp and Messenger buttons. Leave a colour empty to keep the default.
Promo banner colours
Customize → Homepage → Promo Banner Colors sets the large banner background, heading, text, badge, button, and the image tile label, shade and arrow icon.
Newsletter colours
Customize → Homepage → Newsletter Colors sets the background, heading, text, button and email field colours. Slider arrow colours are at the end of Product Card Colors.
bKash, Nagad, Rocket and Upay
Go to WooCommerce → Settings → Payments, open the method, tick Enable and enter your account number (it only shows at checkout once a number is set). Customers send the money themselves, To show the provider logo, upload it to Media (use the official logo from the provider) and paste its URL in the Logo image URL field; otherwise a coloured name badge is shown. Customers then type the number they paid from and the transaction ID. The order is set to On hold and the details appear on the order page and in an order note. After you check the payment in your wallet app, change the order to Processing or Completed. This is a manual check, not an automatic payment API.
Floating chat: WhatsApp and Messenger
In Customize → Header tick Show floating chat buttons, then enter the WhatsApp number (with country code) and the Messenger page username or m.me link. If left empty, the numbers from Product Cards → Quick order are used. Both buttons appear as a stack in the bottom corner (icons only on phones, above the bottom menu); untick show WhatsApp or show Messenger to use just one. To hide the Quick order row in product cards but keep it on the product page, untick Show a Quick order row in product cards and keep Also show the Quick order row on the product page ticked (Customize → Product Cards).
Thank you page
After an order the customer sees an animated success header (“Thank you, Rahim!”), four summary cards (order number, date, total, payment), a What happens next list, buttons for Continue shopping, Track your order and Call us, and tidy order details with product images and the delivery address. It works on phones too. Edit the heading ({name} becomes the first name), message, steps (one per line, written as Title | text), the Call us button and a bottom note in Customize → Thank You Page, or untick the first option to return to the plain WooCommerce page. Payment instructions (bKash, Nagad, bank transfer) appear in their own card below.
Logo size and top bar customer service
Resize the logos in Customize → Header → Header logo height (desktop and phone) and Customize → Footer → Footer logo height; the width follows automatically. In Customize → Header tick Top bar: show a customer service link to show an icon with text and a number, for example “Customer Service 01XXXXXXXXX”. Choose the icon, edit the text, and set the number (it uses your Contact phone if left empty). Clicking calls the number, or opens the link you enter, such as a Contact page or WhatsApp. The top bar must be switched on. On phones only the icon and number are shown.
Homepage product showcase
Go to Customize → Homepage → Product Showcase Sections. For each of the three showcases tick show this section, type a title, then choose what to show: the products of one category, hand-picked products (type product IDs or SKUs separated by commas, the order is kept), or a ready-made list (on sale, newest, best selling, top rated). Set the number of products, the columns (2-5) and where it appears: after the categories, Featured Products, the promo banners, Hot Deals, or before the newsletter. The View All link goes to the category automatically, or to a link you enter. A showcase with nothing to show is skipped.
Print invoice
Open any order in WooCommerce and click Print invoice (also available as an Invoice button in the orders list). The invoice opens in a new tab; click Print / Save as PDF. Upload your letterhead in Customize → Invoice → Letterhead: it is printed across the full width of the A4 page (about 2480 x 400 px works well), with an optional footer image. The table shows product images (switchable), price, quantity and totals, then Subtotal, Discount, Shipping fee, Total, Advance paid and Due, with a PAID or DUE stamp. Type the advance amount in the Advance payment received field on the order screen and save; if it is empty, orders that already have a payment date count as fully paid. Title, number prefix, note, terms and signature label are editable in the same Customize section.
Order tracking
A Track Order page is created automatically the first time you open the WordPress admin (shortcode [shopflow_track_order]). Add it to your menu under Appearance → Menus. Customers enter their order number and the phone number used when ordering and see a timeline: Order placed, Confirmed, On the way, Delivered. The step moves on when you set the order to Processing, add courier details, or mark it Completed. On every order edit screen fill Tracking details (courier, tracking code, optional link) and save to show them to the customer. The order received page gets a Track your order button. Lookups are limited to a few attempts per visitor every 10 minutes. Switch the feature off in Customize → Order Tracking.
Template slideshow
On the Demo Templates screen click Watch slideshow of all templates. An animated walkthrough plays through every template (banner, category cards, product row) in its own colours, advancing every 5 seconds. Use the arrows, dots or keyboard arrow keys to move, the pause button to stop, and Preview on my site or Apply template on any slide.
Variation style: boxes or drop-down
In Customize → Product cards → Product variations style choose Boxes (customers click M, L, XL...) or the classic Drop-down list. To mix both, keep Boxes and list the options that should stay a drop-down in Always use a drop-down for these options (for example Country). Box and text colours can be changed there too. Unavailable combinations are greyed out and a second click on a chosen box clears it.
Colour swatches
When a variation attribute is a colour, Boxes mode shows a round colour circle instead of a text box. Common colour names (Red, Navy Blue, Olive, Forest Green and many more) are recognised automatically — nothing to set up. For an exact shade, go to Products → Attributes → [your colour attribute] → Configure terms, edit a term and pick its Swatch colour; that always wins over the automatic guess. A term with no recognisable colour name and no swatch colour set just stays a text box.
Product card buttons
In Customize → Product cards you can change the text of Add to cart, Select options, Buy now and Pre-order, and hide the Add to cart / Select options button or the Buy now button. If one is hidden the other fills the row.
Banner image fit
The same Banner image fit option exists for category page banners (Customize → Category pages). In Customize → Hero layout → Banner image fit choose Automatic (the whole banner is shown and the height follows the picture, nothing is cropped) or Fill (fixed height, image cropped). For the cleanest slider use the same size for every banner.
Automatic WebP images
Every JPG or PNG you upload (Media Library, product images, demo images) is converted to WebP and the original is not kept. Open Tools → Image Optimizer to set the quality and maximum width, switch it off, or convert images that are already in your Media Library (take a backup first). Your server needs GD or Imagick with WebP support; the page tells you if it is missing. GIF and SVG files are left alone. For images uploaded earlier, use Convert existing images on the same page (progress bar, converted count and space saved are shown; skipped images can be retried), or tick images in Media → Library (list view) and choose the bulk action Convert to WebP. The Media Library also shows a shortcut notice while JPG/PNG images remain.
Sub-category menus
Menu items with children (and the Premium Dark All Categories list) now open sub-menus to the side of their parent with an arrow marker, and flip to the left near the screen edge.
Changelog
| Version | Changes |
|---|---|
| 1.55.0 | New: colour swatches for product variations — automatic for common colour names, or set your own per term. |
| 1.54.0 | Fix: WooCommerce's "Products per row" setting now actually changes the shop/catalog grid column count. |
| 1.53.0 | New: "Premium Light Gold" and "Outdoor Camo Light" demo templates, plus a Premium Light homepage style option. |
| 1.52.0 | Fix: "Use the brand fill for the top bar and the newsletter band" now actually applies on Premium Dark Gold and Outdoor Camo Green. |
| 1.51.0 | Fix: Logo alignment Center/Right now works on the Premium skin; action icons are compact circles again. |
| 1.50.0 | Fix: category banner "Automatic" fit no longer crops wide images. |
| 1.49.0 | Fix: Accent Color now actually applies on Premium Dark Gold and Outdoor Camo Green. |
| 1.48.0 | Updated Outdoor Camo Green demo template: Brushstroke hero, Trending Products row. |
| 1.47.0 | New Logo alignment option: Left, Center or Right. |
| 1.46.0 | Scalloped notch behind the round badge logo. |
| 1.45.0 | Header logo hover effect. |
| 1.44.0 | New: enable/disable the fixed Thank You page URL. |
| 1.43.0 | Fix: one-page checkout no longer stamps the store's own state onto orders. |
| 1.42.0 | Invoice: full state/country + Ship to address. |
| 1.41.0 | New "Outdoor Camo Green" demo template + round emblem/badge logo option. |
| 1.40.0 | New Cart style option: side drawer cart. |
| 1.39.0 | Removed the built-in Facebook Pixel setup. |
| 1.38.0 | Variation box border color + distinct selected-box color. |
| 1.37.0 | Fix: banner auto-fit (no crop) now also works in the sidebar and cards hero layouts. |
| 1.36.0 | Fixed Thank You page URL for Pixel/Ads tools. |
| 1.35.0 | Facebook Pixel Test Event Code field. |
| 1.34.0 | Built-in Facebook Pixel: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase. |
| 1.33.0 | Self-service temporary support access with auto-expiry. |
| 1.32.0 | Update notices and one-click theme updater. |
| 1.31.0 | Signed, domain-bound license verification; security review. |
| 1.30.0 | Category card image fix; floating WhatsApp + Messenger chat. |
| 1.29.0 | Styled, responsive thank you page. |
| 1.28.0 | Logo size options; top bar customer service link. |
| 1.27.0 | Homepage product showcase sections. |
| 1.26.0 | Print invoice with letterhead, product images, shipping, advance and due. |
| 1.25.0 | Order tracking page. |
| 1.24.0 | Bulk image optimizer: progress, savings, Media Library bulk action. |
| 1.23.0 | Automatic image fit for category banners. |
| 1.22.0 | Template slideshow in the Demo Templates gallery. |
| 1.21.0 | Variation boxes or drop-down for product options. |
| 1.20.0 | Rename/hide Add to cart and Select options in product cards. |
| 1.19.0 | Automatic banner image fit; automatic WebP conversion of images. |
| 1.18.0 | Optional customer note field on the checkout. |
| 1.17.1 | Payment method logos. |
| 1.17.0 | bKash, Nagad, Rocket and Upay payment methods. |
| 1.16.1 | Sub-category fix in All Categories; colours for card slider arrows, promo text and newsletter. |
| 1.16.1 | One-page order form checkout, product card and promo banner colour options, sub-category fly-out menus. |
| 1.15.1 | Preview button for demo templates. |
| 1.15.0 | 39 demo products in 10 categories and six one-click demo templates. |
| 1.14.2 | All Categories menu closes properly. |
| 1.14.0 | Premium Dark homepage style with visible search bar and category menu bar. |
| 1.13.0 | New hero layout: banner slider with category cards on the right. |
| 1.12.0 | Footer: business text under the logo, Get in Touch column, developer credit removed from the footer. |
| 1.11.0 | Smart Store homepage style, SMTP mail setup, WhatsApp chat button. |
| 1.10.1 | Documentation link in the developer credit pop-up. |
| 1.10.0 | Separate logo for dark mode. |
| 1.9.9 | Footer color options and a tidier mobile footer. |
| 1.9.8 | Added this documentation. |
| 1.9.7 | Hero video banner layout. |
| 1.9.6 | Developer credit with website and WhatsApp support pop-up. |
| 1.9.5 | Redesigned My Account login and register layout. |
| 1.9.4 | Editable features strip. |
| 1.9.3 | Google and Facebook social login. |
| 1.9.2 | My Account register form. |
| 1.9.1 | Extra promo banner sections. |
| 1.9.0 | License lock: no license, no storefront. |
| 1.8.x | More homepage categories with Show more, per-category banners, install pop-up, mobile bottom bar, PWA download block, quick order restyle, bundled logo and default contact info, parse-error fixes. |
Support
When you write to support, include your WordPress and PHP version, theme version and a screenshot of the problem.
Google & Facebook login
Add the sign-in buttons under ShopFlow Social Login. You need app credentials from each provider.