=== 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.13
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/?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.13 =
* Fix: Corrected icon path resolution when plugin is installed under alternate folder names.  
* Enhancement: Added graceful Dashicons fallback and admin notice to display expected icon path.  
* Internal: Updated CSS and tested under WordPress 6.8.2.

= 1.1.12 =
* Fix: Admin menu icon now uses a 20×20 PNG with cross-browser CSS constraints (Chrome/Windows & Safari/macOS).  
* No functional changes.

= 1.1.11 =
* Fix: Admin menu icon now uses a 20×20 PNG with cross-browser CSS constraints (Chrome/Windows & Safari/macOS).  
* No functional changes.

= 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.

= 1.1.6 =
* Default `toolbar` set to false; removed optional title above iframe on frontend output.

= 1.1.5 =
* Show credit only in admin; removed credit from frontend embeds.

= 1.1.4 =
* Removed “Powered by Clicksmith” from all admin/dashboard views.

= 1.1.3 =
* Resolved PHPCS warnings; sanitized POST values.

= 1.1.2 =
* Hardened sanitization for toolbar/download POST values.

= 1.1.1 =
* Marked as tested up to WP 6.8; added /languages/ placeholder.

= 1.1.0 =
* Added Gutenberg block UI for inserting shortcodes; custom 20×20 admin menu icon.

= 1.0.0 =
* Initial release: Clicksmith-branded PDF viewer with shortcode generator.

== Upgrade Notice ==
= 1.1.13 =
Fixes for icon path resolution and adds fallback support. Safe to update.