# SK ePaper Manager

[![WordPress Plugin](https://img.shields.io/badge/WordPress-Plugin-5850ec.svg)](https://wordpress.org/plugins/sk-epaper-manager/)
[![Version](https://img.shields.io/badge/Version-1.2.0-blue.svg)](https://github.com/shrikantgaur/sk-epaper-manager)
[![Tested Up To](https://img.shields.io/badge/WordPress-7.0-green.svg)](https://wordpress.org/plugins/sk-epaper-manager/)
[![PHP Requirement](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://www.gnu.org/licenses/gpl-2.0.html)
[![License](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

**SK ePaper Manager** is a feature-rich, high-performance WordPress plugin that lets you upload, manage, and display digital newspapers, magazines, brochures, or newsletters using **images or PDF files**.

Designed with modern aesthetics, fast AJAX reader engagement analytics, multi-city/language taxonomy management, shortcode builder, and custom brand color themes.

---

## 🚀 Key Features

* 📰 **Custom Post Type (`epaper`):** Dedicated admin management for digital editions.
* ↕️ **Drag-and-Drop Page Sorting:** Reorder pages intuitively in Admin metabox using jQuery UI Sortable.
* 🏙️ **City / Regional Editions & Languages Taxonomies:** Categorize newspapers by city (`epaper_edition`) and language (`epaper_language`).
* 📅 **Publication Date Picker:** Set custom edition publication dates.
* 📊 **AJAX Real-time Analytics Dashboard:** Track total views, published editions, average reads per edition, live search, and paginated rankings without page reloads.
* 🎨 **Brand Color & Viewer Settings:** Customize viewer toolbar controls (Zoom, Print, Download) and frontend primary brand color accent from WP Admin.
* 🧩 **Shortcode Embed Builder:** Embed single readers (`[sk_epaper id="123"]`) or edition grids (`[sk_epaper_archive count="6"]`) into Gutenberg, Elementor, Divi, or theme templates.
* 📑 **PDF & Image Support:** Upload JPG, PNG, WEBP, GIF, or PDF files.
* 🔍 **Interactive Single Reader:** Smooth page slider with Zoom In/Out, Print, and Download functionality.
* ⚡ **WordPress Coding Standards (WPCS 100% Compliant):** Fully sanitized inputs, nonce verification, and escaped output.

---

## 📸 Screenshots Showcase (Original & New Features)

### 🖥️ Original Classic Screenshots
| 1. Admin Installed & Active | 2. Add/Edit ePaper |
| :---: | :---: |
| ![Admin Post List](assets/screenshots/screenshot-1.png) | ![Add Edit ePaper](assets/screenshots/screenshot-2.png) |

| 3. Edit page and add ePapers | 4. Listing ePaper |
| :---: | :---: |
| ![Edit page and add ePapers](assets/screenshots/screenshot-3.png) | ![Listing ePaper](assets/screenshots/screenshot-4.png) |

| 5. Single page | |
| :---: | :---: |
| ![Single page](assets/screenshots/screenshot-5.png) | |

---

### ⚙️ New Feature Screenshots (v1.2.0)
| 6. Add New ePaper (Updated Upload & Date Picker) | 7. City & Regional Editions Taxonomy |
| :---: | :---: |
| ![Add New ePaper Updated](assets/screenshots/screenshot-6.png) | ![City Editions](assets/screenshots/screenshot-7.png) |

| 8. Languages Taxonomy | 9. AJAX Analytics & View Statistics |
| :---: | :---: |
| ![Languages](assets/screenshots/screenshot-8.png) | ![AJAX Analytics](assets/screenshots/screenshot-9.png) |

| 10. Shortcodes & Embed Documentation | 11. Viewer Settings & Color Customization |
| :---: | :---: |
| ![Shortcodes Documentation](assets/screenshots/screenshot-10.png) | ![Viewer Settings](assets/screenshots/screenshot-11.png) |

---

## 🛠️ Installation

1. Upload `sk-epaper-manager` folder to the `/wp-content/plugins/` directory, or install directly via WordPress Admin (**Plugins > Add New**).
2. Activate **SK ePaper Manager**.
3. Access the new **ePapers** menu in your WordPress Admin sidebar.

---

## 🧩 Shortcodes Usage

### 1. Single ePaper Reader
Embeds an interactive ePaper reader for a specific edition:
```shortcode
[sk_epaper id="123"]
```

**PHP Template Code:**
```php
<?php echo do_shortcode( '[sk_epaper id="123"]' ); ?>
```

### 2. ePaper Archive Grid
Displays a responsive grid listing of editions with optional count, city edition, or language filters:
```shortcode
[sk_epaper_archive count="6" edition="chandigarh" language="english"]
```

**PHP Template Code:**
```php
<?php echo do_shortcode( '[sk_epaper_archive count="6" edition="chandigarh"]' ); ?>
```

---

## 🧑‍💻 Developer Customization

Template files can be overridden by copying them from the plugin's `templates` folder into your active theme root:

- `archive-epaper.php` - Custom layout for archive listings (`/epapers/`).
- `single-epaper.php` - Custom layout for single edition reader pages.

---

## 📝 Changelog

### 1.2.0
* **New:** Added Drag-and-Drop page reordering in Admin metabox via jQuery UI Sortable.
* **New:** Added "Editions" (`epaper_edition`) and "Languages" (`epaper_language`) taxonomies.
* **New:** Added custom Publication Date picker field.
* **New:** Added Real-time AJAX Analytics Dashboard with view stats, live search, loading overlay, and pagination.
* **New:** Added Shortcode Embed Documentation page with interactive shortcode generator.
* **New:** Added ePaper Viewer Settings page with control toggles and primary brand color picker.
* **Security & Quality:** 100% WordPress Plugin Check (PCP / WPCS) compliance across all plugin files.

### 1.1.6
* Fixed PDF upload visibility in admin edit screen metabox.
* Fixed frontend JavaScript error when displaying PDF attachments in ePaper viewer.

### 1.1.5
* Added direct file access protection check in template files for enhanced security.
* Updated WordPress version compatibility check ("Tested up to: 7.0").
* Updated PHP requirement to 7.4.

---

## 📄 License

This plugin is open-source software licensed under the [GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html).