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.
supportbygps@gmail.com, 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 |
| 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. |
Changelog
| Version | Changes |
|---|---|
| 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
supportbygps@gmail.com
Phone
8801821124025
WhatsApp support
+88 01729341345
Website
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.