# StoryBook CMS — Exact Live UI cPanel Build

This package uses the compiled frontend from the existing StoryBook CMS, not a recreated PHP interface.

## Install

1. Upload and extract the ZIP in cPanel.
2. Create a MySQL database and user with All Privileges.
3. Open `https://your-domain.com/install.php`.
4. Enter the database and first Admin details.
5. Sign in, then delete `install.php`.

The visible CMS keeps the original dashboard, order journey, production editor, cover controls, finance screens, colours, spacing and responsive behaviour. Orders, printing batches and overhead records are synchronized to MySQL.

Version 2.2 fixes large cover-image white screens and keeps **Open book** available after an order is sent to Review, without changing the order back to Production.

Version 2.3 adds Admin-only user management for multiple Production Managers, including account activation and password changes.

Version 2.4 adds a working Logout control and increases story heading/body sizes in preview and PDF. The flat story-text background uses 70% opacity.

Version 3.0 adds durable server-side production books, manual Save plus autosave, reliable file uploads, multiple books/themes under one order, manager assignment and role-safe order visibility. Every story prompt now locks the exact child name, gender and age stage (including teenager proportions), uses the exact story world/mission/companion, and blocks unrelated costumes or props.

Existing installations upgrade automatically when the new files are uploaded. Keep your existing `config.php` and `uploads` folder; the new `production_books` table is created safely on first load.

Version 3.1 restores the intended manager access: Production Managers can work with all orders and books, while Finance, overhead costs and financial reports remain Admin-only. It also keeps Open book available throughout the full journey, puts Show all first, defaults new page text to Bottom, moves image uploads to the top, fixes multi-book switching/saving, and makes wardrobe direction story- and page-specific without blanket costume bans.

Version 3.2 keeps Printing & Production Manager Funds available to Production Managers. Managers can add and view daily printing, packaging, other production costs, money received and fund balance. Admin-only overheads, salaries, marketing costs, monthly profit and financial overview remain protected.

Version 3.3 replaces the shared generic story template with 26 theme-specific bilingual adventures. Every theme now has its own connected sequence of events, obstacles, learning action, climax and ending across all 16 pages. The image prompt is generated from the exact English scene used by that page, with page-specific camera direction, exact name/gender/age-stage identity lock, theme-and-scene wardrobe, recurring-character continuity, bottom text-space planning and strict mismatch exclusions. The dashboard, order journey, production storage, user permissions, costs and existing UI/UX are unchanged.

Version 3.4 keeps the original 26 stories and adds 24 new non-duplicate bilingual stories, bringing the catalog to exactly 50. Each added story has 16 connected pages, its own setting, mission, recurring companion, obstacle sequence, lesson and reward; the existing exact-age, gender, name, wardrobe and page-scene prompt controls remain active. No dashboard, editor, order, finance, user-permission or UI/UX behavior is changed.

Version 3.5 adds a personalized hero-emblem rule to every page and front-cover prompt. Where a superhero suit, chest badge, shield, cape clasp, jersey, helmet, uniform badge, racing suit, mission patch or medal naturally appears, any generic heart/LOVE/fixed-S/franchise-style logo is replaced by the uppercase first letter of the child's name. The initial remains visually consistent across the book and is not forced onto ordinary clothing.

Version 3.6 adds a secure Customer Story Preview Link for each saved book. The public mobile-friendly reader shows only the selected saved book's front cover, pages 1–16 and back cover with Previous/Next navigation; it never exposes prompts, editor tools, order/customer details, prices, finance or management screens. The same link always reflects the latest saved version of that book.

Version 4.0 strengthens page-to-page visual variety in every image prompt and adds a complete public e-commerce storefront. Admins manage products, cover plus up to three product images, title, summary, price, story theme and coupons from `store-admin.php`. Product pages include bilingual 16-page storyline reading, and checkout separates customer/delivery details from character personalization. Dhaka delivery is ৳80, outside Dhaka is ৳150, coupon totals are verified server-side, and successful storefront orders are added to the existing StoryBook CMS order journey.

Version 4.1 makes `index.php` the public Storefront root and moves CMS login/studio to `cms.php`. Store Admin now controls desktop/mobile homepage slides, header logo, WhatsApp and Messenger floating buttons, Facebook Pixel ID, Dataset ID, server-only Conversions API Access Token, Facebook domain verification and website SEO/Open Graph settings. Browser and server Purchase events share the order ID for event deduplication.

Version 4.2 removes the global recurring-companion requirement that could create the same unnecessary female face across many pages. Across all 50 themes, secondary characters now appear only when the exact page scene explicitly names or requires them; otherwise the personalized hero appears alone. Story-required teachers, parents, doctors, guides, teammates, animals, robots and fantasy characters remain available on their relevant pages.
