=== EasyEMBED - Embed PDFs, Docs, Word, Excel, Powerpoint, Slides, & More ===
Contributors: easyembed
Tags: embed, pdf, google docs, document, shortcode
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed PDFs, Google Docs, Sheets, Slides, Word, Excel, and PowerPoint files on your WordPress site with a simple shortcode.

== Description ==

EasyEmbed lets you embed documents directly into your WordPress posts and pages using a simple shortcode. Supported document types include PDFs, Google Docs, Google Sheets, Google Slides, Word documents, Excel spreadsheets, and PowerPoint presentations.

= Features =

* Embed PDFs, Google Docs, Google Sheets, Google Slides, Word, Excel, and PowerPoint files
* Simple `[easyembed]` shortcode with flexible attributes
* Zoom controls for spreadsheet embeds
* Fullscreen support
* Light and dark theme options
* Responsive design that works on all devices
* Optional download button for embedded documents

== External Services ==

This plugin connects to external services in two situations:

= 1. EasyEmbed Dashboard (easyembed.io) =

When you configure a Dashboard URL in the plugin settings and use the `id` attribute in a shortcode, the plugin connects to the EasyEmbed service at [easyembed.io](https://easyembed.io).

**What data is sent and when:**

* The embed ID and your API key are sent to retrieve the document URL and display settings each time a shortcode is rendered on a page.
* The embed's public ID is sent to record a view count each time a visitor loads a page with a managed embed.
* Your API key is sent to retrieve your list of embeds in the WordPress admin panel.

No data is sent to easyembed.io when using direct URL embeds (the `url` attribute), or when no Dashboard URL is configured in the plugin settings.

* [EasyEmbed Terms of Service](https://easyembed.io/terms)
* [EasyEmbed Privacy Policy](https://easyembed.io/privacy)

= 2. Microsoft Office Online Viewer (view.officeapps.live.com) =

When embedding Word (.doc, .docx), Excel (.xls, .xlsx), or PowerPoint (.ppt, .pptx) files using a direct URL, the plugin constructs an iframe pointing to Microsoft's free Office Online viewer service.

**What data is sent and when:**

* The publicly accessible URL of the document file is passed as a query parameter to `view.officeapps.live.com` in the iframe `src` attribute, each time a visitor loads a page with that embed. The document URL is sent to Microsoft's servers so their viewer can fetch and display the file.

This service is provided by Microsoft. No personal user data is sent — only the document URL.

* [Microsoft Terms of Service](https://www.microsoft.com/en-us/servicesagreement)
* [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)

== Installation ==

1. Upload the `easyembed` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **EasyEmbed > Settings** in your WordPress admin to configure the plugin.
4. (Optional) Enter your EasyEmbed Dashboard URL to use managed embeds with analytics.

== Frequently Asked Questions ==

= How do I embed a document? =

Use the `[easyembed]` shortcode in any post or page. You can embed by direct URL:

`[easyembed url="https://example.com/document.pdf"]`

Or by embed ID from your EasyEmbed dashboard:

`[easyembed id="1"]`

= What document types are supported? =

EasyEmbed supports PDFs, Google Docs, Google Sheets, Google Slides, Microsoft Word (.doc, .docx), Excel (.xls, .xlsx), and PowerPoint (.ppt, .pptx) files.

= Can I customize the embed dimensions? =

Yes. Use the `width` and `height` attributes:

`[easyembed url="https://example.com/doc.pdf" width="100%" height="800px"]`

= Do I need an EasyEmbed account? =

No. You can use direct URLs without an account. An EasyEmbed account at [easyembed.io](https://easyembed.io) is only needed if you want to manage embeds from a central dashboard and track views.

= Is my data sent to an external service? =

Only when using managed embeds (the `id` attribute with a configured Dashboard URL) or when embedding Word/Excel/PowerPoint files via direct URL (which uses Microsoft Office Online). See the External Services section above for full details.

== Screenshots ==

1. Embedding a Google Doc using the shortcode.
2. Plugin settings page in the WordPress admin.
3. Embed with zoom controls for spreadsheets.

== Changelog ==

= 1.0.2 =
* Minor updates and improvements.

= 1.0.0 =
* Initial release.
* Support for PDF, Google Docs, Google Sheets, Google Slides, Word, Excel, and PowerPoint embeds.
* Managed embed support via EasyEmbed dashboard.
* Zoom controls for spreadsheet embeds.
* Light and dark theme support.
* Fullscreen mode.
* View tracking for managed embeds.