Docs Library Pro

A Beautiful, Fast & Smart Document Library for WordPress

Modern document showcase with real-time search, pagination, pinned documents, dark mode, and rich formatting support.

---

Features

Feature	Description
Supported Formats	PDF, DOC/DOCX, XLS/XLSX, RTF, PPT/PPTX
Color-Coded Icons	SVG icons with distinct colors per format
Live Search	Instant filtering by title, description, or filename (Cyrillic-safe)
Pagination	12 documents per page with smart ellipsis navigation
Pinned Documents	Pin up to 4 documents — always shown first with a ⭐ badge
File Size Display	Human-readable sizes (e.g., 2.4 MB)
Media Library Sync	Uses Title and Caption from WordPress Media
Admin Panel	Full dashboard with tabs: Documents, Upload, Pinned, Settings, Help
Upload & Delete	Upload files via drag-and-drop, delete directly from admin
Dark Mode	Auto-detects dark theme via system preference, body class, or background brightness
Responsive Grid	Looks perfect on mobile, tablet, and desktop
Shortcode & Gutenberg	Use via [docs_library] or native Gutenberg block
Secure & Clean	Strict format whitelist, full escaping, rel="noopener", no inline JS vulnerabilities

---

Installation

1. Download the plugin as .zip
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload docs-library-pro.zip
4. Click Install Now → Activate

Done! Your documents from wp-content/uploads/ are now beautifully displayed.

---

Usage

Shortcode

[docs_library]

With specific formats:

[docs_library formats="pdf,docx,xlsx"]

Gutenberg Block

Search for Docs Library in the block editor and insert it directly.

---

Admin Panel

Navigate to Docs Library in the WordPress sidebar. The panel includes:

Tab	Description
📄 Documents	View all documents with format badge, size, open & delete actions
⬆️ Upload	Drag-and-drop upload with real-time progress bar
⭐ Pinned	Select up to 4 documents to always appear first
⚙️ Settings	Choose visible formats, set section title and description
📋 Help	Shortcode reference and plugin info

---

Pinned Documents

You can mark up to 4 documents as pinned from the ⭐ Закачени tab in the admin panel.

• Pinned documents always appear first in the grid, regardless of alphabetical order
• They are highlighted with an orange ⭐ Препоръчан badge in the top-left corner
• After pinned documents, the rest are sorted alphabetically

---

Dark Mode

The plugin automatically adapts to dark themes:

• Detects system preference (prefers-color-scheme: dark)
• Detects WordPress dark mode body classes (ast-dark-mode, dark-theme, is-dark-theme, etc.)
• Measures the actual background brightness of the page for full compatibility with any theme

---

Allowed Formats

The following formats are supported and can be toggled in Settings:

PDF · DOC · DOCX · XLS · XLSX · RTF · PPT · PPTX

Security note: No matter what is passed via shortcode, formats like TXT, PHP, HTACCESS and all other file types are always blocked by a hardcoded server-side whitelist.

---

Changelog

v2.0.0

• Full admin panel with 5 tabs (Documents, Upload, Pinned, Settings, Help)
• Drag-and-drop file upload with progress bar
• Delete documents directly from admin
• Pinned documents feature (up to 4, always shown first)
• Pagination (12 per page, with ellipsis navigation)
• Dark mode auto-detection via background brightness analysis
• Strict server-side format whitelist (blocks TXT, HTACCESS, etc.)
• Compiled Gutenberg block editor script (no raw JSX)
• Settings: configurable formats, section title and description

v1.0.3

• Initial release
• Shortcode [docs_library]
• Gutenberg block
• Live search with Cyrillic normalization
• Color-coded SVG icons per format
• Responsive grid layout

---

Author

Fedya Serafiev — urocibg.eu
License: GPL v2 or later