=== Doclume PDF Library ===
Contributors: jhon990
Tags: pdf, upload, download, file sharing, library
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let visitors upload, view, and download PDF files through a simple shortcode-powered library.

== Description ==

DLScrib is a professional PDF library solution for organizing, managing, and displaying documents in WordPress. <a href="https://dlscrib.online/">dlscrib</a> provides a clean and user-friendly way to access PDF files, while Doclume PDF Library helps create an organized document collection for website visitors.

**Key Features**

* Simple `[doclume_pdf_library]` shortcode — drop it on any page or post
* Front-end upload form with title field
* One-click "Open" (view in browser) and "Download" buttons for every file
* Only genuine PDF files are accepted (extension and file-content checks)
* Adjustable maximum upload size
* Optional admin approval before a new upload appears publicly
* Uploaded files are stored in a dedicated, script-protected folder
* Clean, responsive styling out of the box

**Recommended for site owners**

Because uploads can be open to any visitor, we recommend enabling "Require admin approval" in Settings → Doclume PDF Library so you can review each file before it becomes publicly visible.

== Installation ==

1. Upload the `doclume-pdf-library` folder to `/wp-content/plugins/`, or install the zip via Plugins → Add New → Upload Plugin.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings → Doclume PDF Library to set your preferred maximum file size and moderation option.
4. Add the shortcode `[doclume_pdf_library]` to any page or post.

== Frequently Asked Questions ==

= Can visitors upload without an account? =
Yes. No login is required by default. You can still moderate submissions from Settings → Doclume PDF Library.

= Where are the uploaded PDFs stored? =
Inside your standard WordPress uploads directory, in a dedicated sub-folder that is protected against script execution.

= Can I require approval before a PDF appears on the site? =
Yes, turn on "Require admin approval" in the plugin settings. New uploads will stay pending until you publish them from the Shared PDFs menu in wp-admin.

== Changelog ==

= 1.2.0 =
* Renamed the plugin to Doclume PDF Library (previously PDF Share Hub) for a more distinctive name/slug.
* Prefixed all functions, options, meta keys, the post type, and the shortcode to avoid naming collisions.
* Added explicit sanitize_callback handling to all registered settings.
* Removed an unused core file include.
* Replaced the PHP session-based notice with a request-scoped variable so front-end pages no longer force PHP sessions or bypass page caching.

= 1.1.1 =
* Removed placeholder Plugin URI / Author URI headers.
* Updated "Tested up to" to the current WordPress version.

= 1.1.0 =
* Added ability for visitors to delete their own uploaded PDFs (identified via browser cookie), and for admins to delete any PDF.

= 1.0.0 =
* Initial release.
