=== LayoutGlut - PDF, Doc, Excel, Image and more File preview for WooCommerce ===
Contributors: appglut
Tags: woocommerce, file preview, pdf viewer, document viewer, downloadable products
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 7.0
Stable tag: 3.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show customers a preview of your PDF, Word, Excel, PowerPoint, image, video and audio files on product, shop and archive pages.

== Description ==

Selling ebooks, templates, worksheets, spreadsheets, sheet music or courses? LayoutGlut adds a preview of your files to WooCommerce products, so customers can look inside before they buy.

[youtube https://www.youtube.com/watch?v=D7MIbXhqSDo]

**Where previews show**

* Product page: choose a Page design — the whole product page (gallery with images and files, price, buy box, file list and description) laid out as one design, then fine-tune colors, fonts and layout in the Page Builder. Block themes too: LayoutGlut replaces the theme's WooCommerce templates (product, shop, archives, search) and keeps the theme header and footer
* Shop, category, tag and search pages: a "Preview" button (button, icon or link) on each product card that opens a popup
* Anywhere: the `[layoutglut_preview]` shortcode
* Classic and block themes

**What can be previewed**

* PDF, Word (DOC, DOCX, ODT, RTF), Excel (XLS, XLSX, ODS, CSV), PowerPoint (PPT, PPTX, ODP) and text files — Word (DOCX) and Excel (XLSX, CSV) in the browser; the rest through the Google Docs viewer
* Images, video and audio — with the built-in viewer

**Per product**

A "File Preview" box on the product edit screen: pick the product's downloadable files, a file from the media library (for example a free sample) or a link; label, order and switch each one on or off; show or hide previews for one product.

**Admin**

* Preview Files: every product with previews, file types, what is not shown and why, quick on / off switches
* Global Settings: page design, popup or inline viewer, button style and text, colors, custom CSS
* Page Builder: customize the chosen page design with a live preview
* Tools: system status, export / import, reset, delete all

**Good to know**

The Google Docs viewer has to download the file from your site, so documents only preview on a site that is reachable from the internet, and only for files with a public URL (not files in the protected WooCommerce downloads folder — upload a sample to the media library instead). Images, video and audio work everywhere.

**LayoutGlut Pro** renders PDF (PDF.js), Word (DOCX) and Excel (XLSX, XLS, ODS, CSV) on your own site through signed, expiring links, works on local and private sites and with protected files, and adds preview limits for non-buyers with a buy box, watermarks, copy protection, buyer and role access rules, previews in My Account › Downloads and preview analytics.

== External services ==

This plugin uses the **Google Docs Viewer** (docs.google.com) to show PDF, Word, Excel, PowerPoint and text files in the free version.

* What is sent: when a visitor opens such a preview, their browser loads `https://docs.google.com/gview` with the public URL of that preview file. Google then downloads the file from your site to display it. The visitor's browser connects to Google, so Google receives the visitor's IP address and browser details.
* When: only when a visitor opens a preview of one of those file types. Nothing is sent on page load, and nothing is sent for images, video or audio, which are shown by the browser directly.
* Files in the protected WooCommerce downloads folder are never sent.
* Google Terms of Service: https://policies.google.com/terms — Privacy Policy: https://policies.google.com/privacy

== Installation ==

1. Upload the `layoutglut` folder to `/wp-content/plugins/` and activate it (WooCommerce must be active).
2. Edit a product and add files in the **File Preview — LayoutGlut** box.
3. Pick a page design in **LayoutGlut › Global Settings › Product Page**, and fine-tune it in the **Page Builder** tab.

== Frequently Asked Questions ==

= The PDF / Word preview stays blank =

The Google Docs viewer cannot reach local sites (localhost, .local, .test) or files behind a login. Check LayoutGlut › Tools › System status. Use a public sample file, or LayoutGlut Pro for on-site rendering.

= Can customers download the file from the preview? =

Files in the WooCommerce protected folder are never given out by the free plugin. Media library files you add as samples are public files, like any media file.

= Does it work with my theme? =

Previews are added with standard WooCommerce hooks and blocks. If your theme prints its own product cards, the shop button attaches to the add to cart button; the shortcode works anywhere.

== Screenshots ==

1. The File Preview tab on a product page: customers pick a file and see it right on the page.
2. A Preview button on shop and archive product cards.
3. The preview popup with all of a product's files.
4. Preview Files: every product with previews, its file types and on / off switches.
5. Global Settings: the page design and how previews open.
6. The File Preview box on the product edit screen.
7. Tools: system status, export / import and reset.
8. LayoutGlut Pro: the PDF.js viewer with a 3-page limit and a buy box.
9. LayoutGlut Pro: an Excel workbook with its colors, merged cells and number formats.
10. LayoutGlut Pro: secure links, copy protection and watermark settings.

== Upgrade Notice ==

= 3.3.0 =
Block themes now use LayoutGlut templates for the product, shop, archive and search pages (theme header and footer are kept). Untick them in Global Settings › Advanced › Block themes to keep the theme templates.

= 3.2.0 =
The product page is now set by the Page design only: the old "Position" setting (tab, below add to cart, above / below tabs) is removed. Choose a page design in Global Settings › Product Page.

= 3.1.2 =
The admin screens now use the LayoutGlut pink accent color. No action needed.

= 3.1.1 =
New logo and admin menu icon matching the plugin icon. No action needed.

= 3.1.0 =
Adds the Page Builder with ready-made preview page designs and in-browser Word / Excel viewing. No action needed.

= 3.0.1 =
Small improvements and new screenshots, icon and banner. No action needed.

= 3.0.0 =
LayoutGlut is now a file preview plugin. The product, shop and archive page layouts of version 1.x are removed; your theme's WooCommerce templates are used again.

== Changelog ==

= 3.3.0 =
* Block themes: the product page, shop page, category / tag / attribute archives and product search results can use LayoutGlut templates instead of the theme's WooCommerce block templates. The theme header and footer stay; the Page designs, Page Builder and shop / archive card designs now work on block themes.
* New setting: Global Settings › Advanced › Block themes, to choose which pages use LayoutGlut templates.
* Block themes: WooCommerce product page scripts (tabs, variations, gallery zoom, slider and lightbox) are loaded on pages that use the LayoutGlut template.
* New filters: layoutglut_block_template_content and layoutglut_block_template_gallery_support.

= 3.2.0 =
* The Position setting is removed from Product Page settings: the product page is laid out by the chosen Page design (classic themes); block themes show the file gallery in place of the product image.
* Product Page settings simplified: no separate Design heading, tab title, tab order or gallery options.
* Readme and help texts updated for page designs and the Page Builder.

= 3.1.2 =
* Admin screens use the new pink accent color to match the LayoutGlut logo.

= 3.1.1 =
* New LayoutGlut logo in the admin header and menu, matching the WordPress.org plugin icon.

= 3.1.0 =
* New Page Builder with ready-made preview page designs (5 in the free plugin, 20 with Pro) and a template picker.
* Word (DOCX) and Excel files can be previewed in the browser using the bundled Mammoth and SheetJS libraries.
* Improved free-version file preview and File Preview box on products.
* Extension API refinements for LayoutGlut Pro and add-ons.

= 3.0.1 =
* New plugin icon, banner and screenshots.
* The Save settings button is easier to read in the admin header.
* Readme wording improvements.

= 3.0.0 =
* Rebuilt as a WooCommerce file preview plugin.
* Product tab / section, shop and archive buttons, popup and inline viewer, shortcode.
* File Preview box on products; Preview Files, Global Settings and Tools screens.
* Extension API for LayoutGlut Pro and add-ons (see EXTENDING.md).
