=== NinjaWeb Widgets - PDF Card ===
Contributors: ninjawebuk
Tags: elementor, pdf, widget, documents, download
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display PDFs in Elementor as styled cards using the first page as a preview image.

== Description ==

NinjaWeb Widgets - PDF Card adds a custom Elementor widget that displays a PDF as a styled card.

Instead of showing a plain text link, the widget uses the PDF's first page preview image when WordPress can generate one, then adds a title and button to open the file.

Perfect for newsletters, brochures, reports, guides, forms, and other downloadable documents.

== Features ==

* Custom Elementor PDF Card widget
* Displays the first page of a PDF as a preview image when available
* Select PDFs directly from the WordPress Media Library
* Optional custom title
* Customisable button text
* Open PDF in new tab option
* Styling controls for colours, typography, spacing, border radius, and image height
* Responsive and lightweight

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/ninjaweb-widgets-pdf-card/` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Make sure Elementor is installed and active.
4. Edit a page with Elementor and search for "PDF Card".
5. Add the widget to your page, select a PDF, and customise the styling.

== Frequently Asked Questions ==

= Why is my PDF preview not showing? =

PDF preview generation relies on your server configuration. In many hosting environments this requires the Imagick PHP extension and, in some cases, Ghostscript.

= Will the plugin still work without previews? =

Yes. If a preview image is not available, the widget shows a fallback placeholder instead.

= Does this work with Elementor Free? =

Yes. The widget works with Elementor Free and Elementor Pro.

== Changelog ==

= 1.3.0 =
* Renamed the main plugin file to match the plugin slug
* Corrected the contributor username
* Included the widget class file in the final plugin package
* Improved Elementor loading checks
* Kept styling controls for the PDF card widget

= 1.3.1 =
* Removed invalid Plugin URI header while keeping Author URI.

= 1.3.2 =
* Minor readme update and plugin directory maintenance.

= 1.3.3 =
* Added capability to upload multiple PDF's and display them in one Widget.

