Selytho Page Flip Creator — User Manual
Version 1.2.0 | copyright © Rob Snow | Rob Art | WordPress Development, 2026
https://robsnow.eu/plugins-wordpress-development/

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONTENTS

  1. Introduction
  2. Installation
  3. Quick Start
  4. The Dashboard
  5. Creating a Flipbook
  6. Flipbook Settings
     6.1  Appearance
     6.2  Controls
     6.3  Info Panel
     6.4  Pro Features
  7. Bookshelf Mode
  8. Embedding — Shortcode Reference
  9. Viewer Settings Panel
  10. Share Panel
  11. Statistics
  12. Global Settings
  13. Licence Activation
  14. Pro Features Reference
  15. Frequently Asked Questions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. INTRODUCTION

Selytho Page Flip Creator turns any PDF into a hardware-accelerated 3D page-turning viewer,
embedded anywhere in WordPress with a single shortcode.

The engine is built on Three.js (WebGL) with PDF.js for client-side PDF
rendering. No server-side image conversion is required — you simply provide a
URL to a publicly accessible PDF file.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2. INSTALLATION

  1. Download the Selytho Page Flip Creator plugin zip file.
  2. In your WordPress admin, go to Plugins > Add New > Upload Plugin.
  3. Choose the zip file and click Install Now.
  4. Click Activate Plugin.
  5. Selytho Page Flip Creator appears in the WordPress admin sidebar.

Alternatively, upload the `selythowp` folder to /wp-content/plugins/ via FTP
and activate from the Plugins screen.

On first activation you are redirected to a getting started screen.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3. QUICK START

  1. Go to Selytho Page Flip Creator → Flipbooks → + Add New.
  2. Paste your PDF URL (or pick from the Media Library).
  3. Adjust settings — the live preview updates instantly.
  4. Click Save Flipbook.
  5. Copy the shortcode from the sidebar and paste it into any page or post.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

4. THE DASHBOARD

The Dashboard (Selytho Page Flip Creator → Dashboard) gives you an overview of all your
flipbooks and a snapshot of view statistics.

  Statistics Overview
    Total Views       — combined view count across all flipbooks
    Flipbooks        — number of flipbooks created
    Avg Read Depth    — how far through the book visitors typically reach
    Most Viewed       — the flipbook with the highest view count

  Your Flipbooks table
    Lists all flipbooks with Name, Author, Pages, Shortcode, Views, Avg Depth,
    and an Edit link. Author and Pages are populated from PDF metadata the first
    time you open and save each flipbook in the editor.

  Quick Actions (sidebar)
    + Create Flipbook — opens the editor for a new flipbook
    View Statistics    — goes to the full Statistics page
    Settings           — opens global default settings

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5. CREATING A FLIPBOOK

Go to Selytho Page Flip Creator → Flipbooks → + Add New (or click Create Flipbook from
the Dashboard sidebar).

  PDF field
    Paste a direct URL to your PDF file, or click Choose PDF to pick from the
    WordPress Media Library. The filename is used as the default flipbook name
    if the name field is empty.

  Flipbook Name
    The name used in the admin and as the default info panel title. Auto-filled
    from the PDF filename on selection.

  Live Preview
    The right column shows a live 3D preview. It updates automatically when you
    change settings. Use it to check appearance before saving.

  Saving
    Click Save Flipbook (bottom of the page or sidebar button). You are
    redirected back to the edit page with a confirmation notice.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

6. FLIPBOOK SETTINGS

All settings are per-flipbook and override the global defaults set in Settings.

  6.1 APPEARANCE

    Flip Style
      Hard — stiff card-like pages. Suitable for catalogues and magazines.
      Soft — flexible paper pages with a more natural curl. (Pro)

    Flip Speed
      Duration of the page-turn animation in seconds (0.3s – 3.0s).

    Curl Amount
      How much the page curls during a flip (0% = flat, 100% = maximum curl).

    Cover Mode
      Centre — the front cover is centred on load; book opens to a spread.
      Info   — the cover opens immediately into a spread with the info panel.

    Background Colour
      The colour behind the book. Click the swatch to open the colour picker.

    Height
      Viewer height in pixels (300–1200). Width is always derived from the PDF's
      aspect ratio.

    Padding
      Space around the book inside the viewer container.

    Corner Radius
      Rounds the corners of the viewer container (0–40px).

    Drop Shadow
      Adds a subtle shadow beneath the viewer container.

    RTL (Right-to-Left)
      Mirrors the page order for right-to-left documents such as Arabic, Hebrew,
      or Japanese manga. The entire book geometry is mirrored — navigation,
      drag direction, and info panel position all adjust automatically.

  6.2 CONTROLS

    Show Arrows
      Display previous/next arrow buttons on the viewer.

    Interaction Mode
      Click & Drag — both corner clicks and drag-to-flip are active.
      Click only   — only corner clicks trigger page turns.
      Drag only    — only dragging triggers page turns.

    Pan Direction
      Natural — drag right to pan right.
      Reverse — inverted pan direction.

    Download Button
      Show a download button in the controls bar (downloads the PDF).

    Page Numbers
      Display current page / total pages in the controls bar.

  6.3 INFO PANEL

    The info panel slides in from the left (or right in RTL mode) and displays
    PDF metadata for the current book.

    Show/Hide fields
      Toggle which metadata fields are shown: Title, Author, Creation Date,
      Subject, Keywords.

    Hide All
      Hides the info panel button entirely.

    Per-book overrides
      Enter custom values to override what is read from the PDF metadata.
      Enable the override toggle for a book to use your custom values instead.

    Info Logo (Pro)
      Upload a logo image to display at the top of the info panel.

    Colours
      Customise the info panel background, title colour, and body text colour.

  6.4 PRO FEATURES

    See Section 14 — Pro Features Reference.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

7. BOOKSHELF MODE

Bookshelf mode groups multiple PDFs into a single flipbook. Visitors see a
shelf selector at the bottom and can switch between books.

  Enabling
    In the flipbook editor, check Enable Bookshelf Mode. The single PDF field
    is replaced by a shelf book list.

  Adding books
    Click Add Books to pick one or more PDFs from the Media Library. Each book
    appears as a row with a drag handle (for reordering), a label field, and a
    remove button.

  Info panel overrides
    Each book in the shelf gets its own info panel tab. You can set per-book
    title, author, subject, keywords, and date overrides independently.

  Shelf label
    The label shown on the shelf selector button for each book. Defaults to the
    PDF filename.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

8. EMBEDDING — SHORTCODE REFERENCE

  By flipbook ID (recommended)
    [selytho id="123"]

    Uses all settings saved for that flipbook. Replace 123 with your flipbook
    ID (shown in the shortcode column on the Flipbooks list).

  By PDF URL (quick embed, no saved flipbook required)
    [selytho url="https://yoursite.com/uploads/doc.pdf"]

    Uses global default settings.

  Shortcode attributes (override any saved setting inline)

    url="..."         Direct URL to a PDF file
    id="..."          Flipbook post ID
    height="600"      Viewer height in pixels
    style="hard"      Flip style: hard or soft (Pro)
    rtl="true"        Enable right-to-left page order

  Example with overrides
    [selytho id="123" height="800" rtl="true"]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

9. VIEWER SETTINGS PANEL

The settings panel is accessible to visitors via the settings icon in the
controls bar. It allows real-time adjustment of the viewer without reloading.

  Free controls
    Flip Speed    — slider, 0.3s to 3.0s
    Curl Amount   — slider, 0% to 100%
    Interaction   — segmented: Click & Drag / Click / Drag
    Pan Direction — segmented: Natural / Reverse

  Pro controls (visible only when Pro licence is active)
    Auto Flip     — toggle switch; starts/stops automatic page turning
    Controls Position — segmented: Top / Bottom
    Controls Mode     — segmented: Over / Outside

  The panel tracks the page scroll position and stays aligned with the viewer.
  Clicking the backdrop or the × button closes the panel.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

10. SHARE PANEL

The share button (in the controls bar) opens a share overlay with:

  Social sharing
    Facebook, X (Twitter), LinkedIn, Pinterest, BlueSky, Email

  Copy link
    Copies the current page URL to the clipboard. The icon dims briefly on click
    to confirm the action.

  The overlay has a blurred backdrop. Click outside or the × to close.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

11. STATISTICS

Selytho Page Flip Creator records a view each time a flipbook is loaded in a visitor's
browser. Views are deduplicated per visitor per flipbook within a 2-hour window
using a session cookie.

  Tracked per view
    Flipbook ID, pages seen, total pages, timestamp.

  Dashboard overview (Selytho Page Flip Creator → Dashboard)
    Total Views, Flipbooks count, Avg Read Depth, Most Viewed.

  Statistics page (Selytho Page Flip Creator → Statistics)
    All-time totals card — Total Views, Avg Pages Flipped, Avg Read Depth,
    Flipbooks with Views.

    Per-Flipbook Breakdown table — Views with inline bar chart, Avg Pages,
    Avg Read Depth with colour-coded progress bar (green ≥70%, orange ≥40%,
    red below), Last Viewed date, Edit link.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

12. GLOBAL SETTINGS

Selytho Page Flip Creator → Settings sets defaults that apply to all flipbooks unless
overridden per flipbook.

  Flip Style          Hard or Soft (Pro)
  Background Colour   Default viewer background
  Height              Default viewer height in pixels
  Download Button     Show/hide by default
  Page Numbers        Show/hide by default
  RTL                 Default page order
  Auto Flip           Enable by default (Pro)
  Auto Flip Delay     Seconds between automatic page turns (Pro)
  Zoom                Enable zoom by default (Pro)
  Fullscreen          Enable fullscreen button by default (Pro)
  Thumbnails          Enable thumbnail strip by default (Pro)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

13. LICENCE ACTIVATION

Selytho Page Flip Creator Pro is available from Rob Art | WordPress Development via
Lemon Squeezy. Your licence key is in your order confirmation email.

  Activating
    Go to Selytho Page Flip Creator → Settings → Licence.
    Enter your licence key and click Verify & Activate.
    Pro features are unlocked immediately on success.

  Deactivating
    Click View Details next to your active licence, then Deactivate Licence.
    This frees the licence for use on another site.

  One licence key is valid for one live WordPress installation.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

14. PRO FEATURES REFERENCE

  Soft flip style
    Flexible page curl with a more natural paper feel. Set Flip Style to Soft
    in the flipbook editor or global Settings.

  Auto-flip
    The viewer automatically turns pages at a set interval. Configure the delay
    (2–30 seconds) in the flipbook editor or global Settings. The visitor can
    toggle auto-flip from the Viewer Settings panel.

  Zoom
    Scroll wheel, pinch-to-zoom (touch), and +/- buttons. A 1:1 reset button
    is included. Zoom is clamped to sensible limits.

  Pan
    Alt/Cmd + drag, or scrolling when zoomed in, pans the view. Clamped to
    book extents.

  Fullscreen
    A fullscreen button in the controls bar expands the viewer to fill the
    browser window.

  Thumbnail strip
    A panel showing thumbnail previews of all pages. Click any thumbnail to
    jump directly to that page. Opens and closes with a spring animation.

  Page-turn sound effects
    A subtle paper sound plays on each page turn. Choose from available sound
    files in the flipbook editor.

  Controls position and mode
    Position — Top or Bottom of the viewer.
    Mode     — Over (overlaid on the viewer) or Outside (below/above the viewer,
               expanding the container height).
    Distance — Gap between the viewer and outside controls (px).

  Hide credit line
    Removes the "Created by Selytho Page Flip Creator" credit from the info panel footer.

  Info panel logo
    Upload a custom logo image to display at the top of the info panel.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

15. FREQUENTLY ASKED QUESTIONS

  Does it require server-side processing?
    No. PDF rendering is entirely client-side via PDF.js.

  Will it work with any PDF?
    Yes, as long as the PDF is publicly accessible. PDFs with restrictive CORS
    headers may fail — host the file on the same domain or configure CORS.

  Does it work on mobile?
    Yes. Touch drag-to-flip is supported on mobile and tablet.

  Can I embed multiple flipbooks on one page?
    Yes. Each shortcode creates an independent viewer instance.

  Will it slow my site down?
    Scripts and styles only load on pages where the shortcode is present.
    All assets are served from your own server — no external CDN requests.

  The PDF won't load — what should I check?
    - Confirm the PDF URL is correct and publicly accessible in a browser.
    - Check the browser console for CORS errors.
    - Ensure the PDF is not password-protected.

  How do Author and Pages populate in the dashboard table?
    They are read from PDF metadata by PDF.js when you open the flipbook in
    the editor. Open the flipbook edit page, wait for the preview to load,
    then save — the values are stored as post meta and appear in the dashboard.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support and documentation: https://robsnow.eu/plugins-wordpress-development/
WordPress.org support forum: https://wordpress.org/support/plugin/selytho-page-flip-creator/

copyright © Rob Snow | Rob Art | WordPress Development, 2026. All rights reserved.
