=== Flipora – PDF Flipbook & 3D PDF Viewer ===
Contributors: charan
Author URI: https://ravulacharan.in
Plugin URI: https://about.ravulacharan.com/flipora/
Tags: flipbook, pdf viewer, 3d flipbook, pdf embed, lead generation
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 4.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn any PDF into a realistic 3D flipbook. A PDF viewer with custom lead forms, reader analytics, read aloud, SEO text and embeds.

== Description ==

**Flipora is a PDF flipbook plugin for WordPress.** It turns a PDF, a set of images or HTML pages into a realistic 3D book that readers can flip on a phone, tablet or computer. Upload your file, choose a look and publish. There is no code to write.

Use it for digital magazines, product catalogs, brochures, annual reports, lookbooks, menus, course books and any PDF you want people to enjoy reading.

= A 3D PDF viewer that is easy to read =

* Realistic page turns with four skins: Studio Light, Studio Dark, Studio Paper and Classic.
* Page slider with a thumbnail preview, contents panel, full-text search and zoom.
* **Read aloud:** the browser reads the pages to the reader and turns them as it goes.
* **Text view:** the current pages as plain text, with larger type.
* **Saved pages and notes:** readers keep their favourite pages in their own browser.
* **Link to any page:** copy a link that opens the book at that page.
* Reading progress, "continue where you left off", keyboard shortcuts, light and dark modes.
* Share to Facebook, X, LinkedIn, WhatsApp and email.
* Works on mobile, with a single-page view and touch gestures.

= Custom lead forms with a simple form builder =

Collect more than an email address. Build the form you need in a few clicks:

* Field types: name, email, phone, short text, long text, number, date, dropdown, single choice, multiple choice and a consent checkbox.
* Drag to reorder, set required fields, make two fields sit side by side, and see a live preview.
* Use one form for the whole site, or a different form for each book.
* Show the form at a chosen page, before a download, or both.
* Leads are listed, searchable and exportable to CSV with one column for each question.
* **Webhook:** send every new lead to Zapier, Make, n8n or your CRM.
* **Branded emails:** an automatic thank-you email to the reader and a new-lead alert to you, with your logo and colours. Optional SMTP and a one-click test.

= Full control for every book =

* Viewer options for each book: skin, accent colour, reading direction (including right to left), page-turn speed, opening page, auto-play, sounds and single-page view.
* Choose which reader tools appear, whether the title shows, and the toolbar shape and size.
* Transparent or custom background, your logo in the viewer and an optional watermark.
* **Call-to-action button** that shows on the pages you choose. Clicks are counted.
* Members-only books, books for chosen user roles and password-protected books.
* Scheduled availability with start and end dates.
* Hide download or print for each book.

= SEO for flipbooks: search engines and AI assistants =

A 3D book is drawn on a canvas that crawlers cannot read. Flipora gives them something they can:

* **Automatic text version** of your PDF under each book, in a collapsed section. Readable by search engines, AI assistants and screen readers.
* Pages behind a lead form stay out of the text version.
* **Structured data** (schema.org Book, Report, DigitalDocument or CreativeWork) with the page count and publisher.
* Page title, meta description, Open Graph and Twitter tags, with a social image made from page one.
* A simple "Search & sharing" checklist in the book editor.
* Works alongside Yoast SEO, Rank Math, All in One SEO, SEOPress and The SEO Framework without duplicate tags.
* Locked and hidden books are marked noindex and left out of your sitemap.

= A searchable PDF library =

Add a bookshelf of your flipbooks to any page with the **Flipora Library** block or the `[flipora-library]` shortcode. Readers can filter by category and search by title.

= Reader analytics =

Views, page turns, reading time, completion rate, downloads, button clicks and a map showing which pages get the most attention.

= Build faster =

* Guided Add Book screen with drag-and-drop PDF upload.
* Bulk import: many PDFs become many books, with covers, page counts and text.
* Duplicate books, a Gutenberg block, an Elementor widget and a shortcode generator.
* Embed books on other websites, with an allow-list of sites.

= Privacy =

Analytics are anonymous and counted per book per day, with no cookies and no IP addresses. Leads are stored in your own database and work with WordPress's personal-data export and erase tools. Saved pages and notes stay in the reader's browser.

Privacy Policy: https://about.ravulacharan.com/flipora/legal/privacy/
Terms of Use: https://about.ravulacharan.com/flipora/legal/terms/

== Installation ==

1. In WordPress go to Plugins, Add New, Upload Plugin and choose the `flipora.zip` file. Or upload the `flipora` folder to `/wp-content/plugins/`.
2. Activate **Flipora**. If "3D FlipBook – Lite Edition" or "FlipBook Studio Pro" is active, Flipora switches it off and keeps all books, pages, leads and settings.
3. Go to FlipBooks, Add New Book, and upload your PDF.
4. Publish. Use the book's own page, the Gutenberg block, the Elementor widget or the shortcode shown in the editor.
5. To use lead forms, open FlipBooks, Settings, Emails to set your sender name and address, then send a test email.

== Frequently Asked Questions ==

= How do I embed a PDF as a flipbook in WordPress? =
Create a book under FlipBooks, Add New Book, and upload your PDF. Then add the Flipora block to any page, or paste the shortcode shown in the book editor, such as `[3d-flip-book id="1"][/3d-flip-book]`.

= Is Flipora a PDF viewer or a flipbook maker? =
Both. It shows your PDF in the browser as a 3D book, so readers don't need a PDF app or a download.

= Can search engines read a PDF flipbook? =
Yes. When you add a PDF, Flipora captures its text and shows it in a collapsed "Read the text version" section under the book. Search engines, AI assistants and screen readers can read that text. Flipora also links to the original PDF and adds structured data. No plugin can guarantee a ranking, but this gives your content a fair chance.

= Can AI assistants such as ChatGPT or Gemini find my flipbook? =
They read web pages the same way search engines do, so the text version and structured data help them understand your book. Flipora does not block or submit to any AI service. Your site's robots.txt decides who may crawl it.

= Can I create my own lead form? =
Yes. Open FlipBooks, Settings, Lead form to build a site-wide form, or choose "A custom form for this book" in a book's Lead capture box. You can ask for a phone number only, with no email address.

= Can I require a form before someone downloads the PDF? =
Yes. In the book's Lead capture box, set "When to ask" to "Before downloading the PDF" or "Both". The form is a friendly gate, not a security barrier: someone who finds the PDF's address can still open it. Use a password or members-only book for private files.

= Can I send leads to my CRM? =
Yes. Add a webhook URL under Settings, Lead form. Each new lead is sent as JSON, which works with Zapier, Make, n8n and most CRMs. Use the test button to check it.

= Does the flipbook work on mobile? =
Yes. On phones the viewer takes most of the screen height, shows one page at a time if you choose, and supports touch gestures.

= Which languages does read aloud support? =
Read aloud uses the speech voices in the reader's browser and device, so the choice of languages depends on them. The button is hidden in browsers without speech support.

= Can I make a flipbook private? =
Yes. Use the Access & protection box to set a password, limit the book to logged-in members or chosen roles, or set start and end dates.

= Does it work with right-to-left languages? =
Yes. Choose "Right to left" under Viewer options in the book editor. Pages then turn in the direction used for Arabic, Hebrew and Urdu.

= I upgraded from FlipBook Studio Pro or 3D FlipBook Lite. Are my books safe? =
Yes. Flipora uses the same books, pages, leads and settings, so everything carries over. Books with an old lead form keep that same form.

= Lead emails do not arrive. What should I do? =
Use FlipBooks, Settings, Emails, "Save & send test". If it reports an error or nothing arrives, your host is not delivering WordPress mail. Turn on "Send through SMTP" with your mail provider's details, or use an SMTP plugin. Use a sender address on your own domain for best delivery.

= Where can I find the full guide or get help? =
The user manual is at https://about.ravulacharan.com/flipora/manual/. For help, email contact@ravulacharan.com or use https://ravulacharan.com/contact/.

== Screenshots ==

1. A PDF as a 3D flipbook, with the page slider and reader tools.
2. The guided book editor with viewer options.
3. The lead form builder with live preview.
4. A custom lead form in the viewer.
5. The Leads screen with answers and CSV export.
6. Search & sharing settings for search engines and AI assistants.
7. Reader analytics on the dashboard.
8. The searchable flipbook library.

== External services ==

Flipora works without any outside account. It connects to other services only in these cases:

* **Your webhook:** if you enter a webhook URL, each new lead (book name, name, email and form answers) is sent to that URL. You choose the service, and its terms apply.
* **Your SMTP server:** if you turn on SMTP, emails are sent through the server you enter.
* **Share buttons:** when a reader presses a share button, a new window opens on that network (Facebook, X, LinkedIn or WhatsApp) with the page address. Nothing is sent before the button is pressed.
* **Google Analytics:** if you turn this option on and your site already loads Google Analytics, reader events are passed to it.

== Third-party libraries ==

Flipora includes three.js (MIT), PDF.js (Apache 2.0), CMap resources supplied with PDF.js (BSD 3-Clause), React and React DOM (MIT), html2canvas (MIT), Font Awesome 4.7 (font: SIL OFL 1.1, CSS: MIT) and Color Picker by Stefan Petre (MIT and GPL). These licences are compatible with the GPL. Details: https://about.ravulacharan.com/flipora/legal/licences/

== Changelog ==

= 4.0.0 =
* New: lead form builder with 11 field types, live preview, a site-wide form and per-book forms.
* New: ask for details before a download, as well as at a chosen page.
* New: webhook for new leads, and form answers in the Leads screen, CSV, emails and privacy export.
* New: viewer options for each book (skin, accent, direction, speed, opening page, auto-play, sounds, single page).
* New: call-to-action button with page range and click counts.
* New reader tools: page slider with preview, read aloud, text view, saved pages with notes, link to a page.
* New: SEO tools, including automatic text version, structured data, social tags and image, noindex control, sitemap handling and compatibility with popular SEO plugins.
* New: searchable library, with a block and the `[flipora-library]` shortcode.
* New: viewer layout settings for the title and for toolbar shape and size.
* Improved: much taller viewer on phones, and the "Powered by" email line is now off by default.
* Improved: settings are grouped into simple tabs.

= 3.0.0 =
* New name and brand: Flipora, by Charan (ravulacharan.in), with a new icon.
* New: branded thank-you email to readers, branded new-lead alerts, editable sender details, email design settings and live preview.
* New: optional SMTP delivery and "Save & send test email" with a clear result.
* New: editable loading message.
* Upgrades from FlipBook Studio Pro and 3D FlipBook Lite keep every book, lead and setting.

= 2.5.1 =
* Clear explanation instead of a "fatal error" when an earlier edition is activated alongside.

= 2.5.0 =
* Elementor widget, lead capture, password-protected books, scheduled availability, embeds, bulk import.

= 2.0.0 – 2.4.0 =
* Studio skins, analytics, access control, Gutenberg block, redesigned admin and book editor, transparent backgrounds, duplicate books.

== Upgrade Notice ==

= 4.0.0 =
Adds a lead form builder, reader tools, per-book viewer options and SEO tools. Your books, leads and settings are kept.

== Credits ==

Flipora is developed by Charan: https://ravulacharan.in

The 3D page-turning engine and original book editor come from "3D FlipBook" by iberezansky (https://3dflipbook.net/), licensed GPLv2 or later. Flipora is distributed under the same licence.
