=== Clicksmith - PDF Viewer ===
Contributors: clicksmith
Tags: pdf, embed, viewer, shortcode, clicksmith, wordpress plugins
Requires at least: 5.8
Tested up to: 6.8.2
Requires PHP: 7.4
Stable tag: 1.1.16
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed PDFs with a simple shortcode. No ads or upsells. Set width/height and optional download link. Free.

== Description ==

A lightweight PDF embed plugin by Clicksmith. No upsells. Includes:
- Shortcode: `[pdf_viewer id="123" width="100%" height="800px"]`
- Or by URL: `[pdf_viewer url="https://example.com/file.pdf" height="700px"]`
- Admin page to generate shortcodes and copy to clipboard
- Media Library integration for quick selection

**Plugin help & documentation:**  
Visit [Clicksmith – PDF Viewer Docs](https://clicksmith.net/wordpress-plugins/clicksmith-pdf-viewer/?utm_source=wporg&utm_medium=readme&utm_campaign=plugin_docs) for setup instructions and support.

**About Clicksmith:**  
We build custom WordPress plugins and automations. Learn more at [Clicksmith.net](https://clicksmith.net/wordpress-plugins/?utm_source=wporg&utm_medium=readme&utm_campaign=plugin_about).

== Installation ==
1. Upload the `clicksmith-pdf-viewer` folder to `/wp-content/plugins/` or install via **Plugins → Add New**.
2. Activate the plugin.
3. Go to **PDF Embeds → Add New** to upload a PDF, set dimensions, and copy the shortcode.
4. Paste the shortcode into any post, page, or widget.

== Frequently Asked Questions ==

= Can I hide the download link? =
Yes. Use `download="false"` in the shortcode.

= Can I start on a specific page? =
Yes. Add `page="3"` to the shortcode.

= Does it work with any PDF URL? =
Yes, but for best results use PDFs hosted in your Media Library.

= Where can I get help or report issues? =
See the docs and contact form at  
[https://clicksmith.net/wordpress-plugins/clicksmith-pdf-viewer/](https://clicksmith.net/wordpress-plugins/clicksmith-pdf-viewer/?utm_source=wporg&utm_medium=faq&utm_campaign=plugin_docs)

== Screenshots ==
1. Admin generator and shortcode list  
2. Frontend PDF embed

== Changelog ==

= 1.1.16 =
* Switch to **Dashicons** (`dashicons-media-document`) for the admin menu icon to eliminate path/caching issues with custom images.
* Readme updates. No front-end functional changes.

= 1.1.12 – 1.1.15 =
* Admin menu icon reliability improvements and cross-browser sizing fixes.
* Updated fallback message copy and documentation links.

= 1.1.9 =
* Updated fallback message text to “If your browser can’t display this PDF” for clarity.

= 1.1.8 =
* Removed credit sentence from readme (“Powered by Clicksmith”). No code changes.

= 1.1.7 =
* Added links to official documentation and support page on Clicksmith.net.

== Upgrade Notice ==
= 1.1.16 =
Uses WordPress Dashicons for the admin menu icon (more reliable across installs). Safe to update.