FAQ

How to open lightbox flipbook from a button or image?

1. Assign a custom CSS class and remove default thumbnail via shortcode parameters

[real3dflipbook id="1" thumb="" class="book1"]

or with

Edit Flipbook > Lightbox > CSS class

and

Edit Flipbook > Lightbox > Hide thumbnail > Enabled

2. Add the flipbook shortcode to the page

3. Add the same CSS class to your button or image that should open the lightbox

1. Add shortcode to page, set unique deep linking prefix for the book via shortcode

[real3dflipbook id="1" thumb="" deeplinkingprefix="book1_"]

2. Add a link to page, set href attribute to the same deep linking prefix and add a page number at the end

<a href="#book1_1">Open book></a>

How to move flipbooks to another server?

You can easily move your flipbooks to another server. You need to:

1. move all assets (images, pdf-s) to new server

2. export flipbooks to JSON

3. edit JSON - replace all paths to pages and pdf-s in json with new paths

4. on new server import from the edited JSON

Unable to save flipbook settings/unable to add new flipbook

Increase max_input_vars in your php.ini from default 1000 to higher value, for example 3000 and restart server. If you don’t find max_input_vars in your php.ini file then add it like this

max_input_vars=3000

save and restart server. Make sure that max_input_vars in not commented out with semicolon at the beginning of the line like this

;max_input_vars=3000

Plugin installation failed

You uploaded the zip that is not valid WordPress plugin (wrong zip file).

Installable plugin file real3d-flipbook.zip is inside the main zip that you downloaded from Codecanyon.

You can also download only installable WordPress plugin from Codecanyon.

PDF Flipbook is loading slow

Optimize PDF

Typically, PDFs with a smaller file size will be rendered faster and it depends on how big a single page is. The amount of pages does not affect the performance. It's essential that you optimize your documents for the web. See Optimize a PDF from Adobe's website for more information. There are more improvement techniques that we can suggest:

  1. Avoid using high resolution images -- 150 dpi resolution for scanned images shall be enough for screens, especially for low powered devices;

  2. Try to use JPEG encoding for color images/photos in RGB colorspace when possible;

  3. Avoid using expensive compositions/effects such as transitions/masking -- flatten transparency;

  4. Avoid using PDF generators (or don't create content) that produce ineffective PDF output (e.g. LibreOffice creates a lots of tiny images for vector elements/pictures it does not understand);

  5. If there is such a setting, use web-optimized PDF output / linearization;

  6. Fix or don't produce corrupted PDFs that do not conform to the PDF32000 specification.

Range requests for partial PDF download

Make sure your server supports range requests. That is required so PDF pages can be rendered before entire PDF is downloaded.

PDF Tools Addon

Advanced optimization for PDF Flipbooks is available with PDF Tools Addon

JPG Flipbook is loading slow

Use optimized JPG or WebP images, they should be 200 - 300 kb in size and maximum 2000 - 3000 px in height.

CORS error - loading PDF or images from another domain (cross domain request)

By default PDF and images needs to be on the same domain.

For loading PDF or images form another server, the server that hosts the PDF files must be configured to allow CORS. This involves adding the correct headers to the server's responses. Specifically, the server must include the Access-Control-Allow-Origin header in its response for the PDF files.

Apache:

In your .htaccess or server configuration file, add:

<IfModule mod_headers.c>
  Header set Access-Control-Allow-Origin "*"
</IfModule>

This allows any domain to load the PDF files. Replace * with a specific domain if you want to restrict access.

Nginx:

In your Nginx configuration file, add:

location /path_to_your_pdf_files/ {
    add_header 'Access-Control-Allow-Origin' '*';
}

Again, replace * with a specific domain if needed.

Flipbook is not working

Please check your browser console for errors. In most cases the problem is that flipbook has no PDF/images specified, or is trying to load PDF/images from another domain. If you see CORS error, please see how to enable CORS for PDF

There might also be other javascript errors on the page, coming from another plugin. Try to disable other plugins to see if another plugin is causing the problem.

How to update the plugin to latest version?

When updating to new version, your current flipbooks will remain saved.

Step 1. Re-download the plugin zip file from your Codecanyon downloads page

Step 2. Deactivate and delete the current version

Step 3. Install and activate the new version

How to optimize flipbook for mobile?

There are couple of ways to increase performance and stability on mobile devices.

Reduce page resolution

If you have PDF flipbook, you can reduce page resolution for mobile with

Mobile > PDF page size (full) > 1500

Change view mode

Use different flipbook view mode for mobile (3d or swipe) instead of default webgl

Mobile > View Mode > 3d

Use PDF Tools Addon

With this addon you can optimize flipbook by converting it to images and JSON that will be saved on the server, which will increase flipbook performance and stability.

Last updated