SK ePaper Manager

SK ePaper Manager lets you create and display digital ePapers by uploading multiple images or PDF files for each edition.

Visitors can browse all ePapers in an archive view or open single editions to read page by page — with support for zoom, print, download, and shortcode embedding.

Perfect for news portals, daily newspapers, schools, or local publications.

Features

• Custom Post Type for ePapers
• Multi-Edition & Language Taxonomies
• Drag-and-Drop page reordering in Admin
• Dedicated Edition Date picker field
• Shortcodes: [sk_epaper id="123"] and [sk_epaper_archive]
• View Counter & Admin Columns: Track edition views and page count in WP Admin
• Upload multiple images or PDFs per edition
• Built-in archive page for all ePapers
• Single page view for each edition
• Zoom in/out for easier reading
• Print edition directly from the browser
• Download edition
• Modern, responsive layout

Shortcodes

• [sk_epaper id="123"] – Embeds single ePaper reader inside any post or page.
• [sk_epaper_archive count="6" edition="delhi"] – Displays a grid of ePapers with optional edition filtering.

License

This plugin is licensed under the GPLv2 or later.
See https://www.gnu.org/licenses/gpl-2.0.html

1. Upload the plugin to /wp-content/plugins/sk-epaper-manager or install through the Plugins screen.
2. Activate SK ePaper Manager from the Plugins screen.
3. Use the ePapers menu in your dashboard to create and manage ePaper editions.

1. 

   Admin: add or edit an edition - title, publication date, Editions and Languages.

2. 

   Admin: ePaper Details & Pages - drag and drop page order and per-page labels.

3. 

   Frontend: the ePaper archive with search, Edition, Language, month and exact-date filters.

4. 

   Frontend: the ePaper reader - zoom, print and download controls, with the page rail below.

5. 

   Frontend: turning pages in the reader.

6. 

   Frontend: a full edition page end to end, with the page rail and the More Editions row.

7. 

   Admin: City and regional Editions.

8. 

   Admin: Languages for multi-language publications.

9. 

   Admin: Getting Started - a step-by-step guide, shortcode reference and one-click sample content.

10. 

    Admin: Analytics - reader engagement, top editions, live filtering and an edition date range.

11. 

    Admin: Shortcodes & Helper - build and copy shortcodes for any page builder.

12. 

    Admin: Settings - reader controls, performance and lazy loading.

13. 

    Admin: Settings - brand colour, content width, thumbnail position and uninstall behaviour.

2.0.0

Performance
* Pages now load on demand instead of all at once. A 24 page edition no longer pushes every full size image (or every PDF iframe) on first paint.
* Embedded viewers below the fold wait until they are approaching the viewport before loading anything.
* Plugin CSS and JavaScript now load only on pages that actually show an ePaper, instead of on every page of the site.

Reader
* Added a page thumbnail strip below the reader for jumping straight to a page.
* Added an optional PDF.js rendering mode for real zoom and text selection on PDF editions (requires the PDF.js library in assets/vendor/pdfjs/; falls back to the browser embed otherwise).

View counting
* Rewritten to run through a REST beacon with a noscript pixel fallback, so counts keep working behind full page caching, where the old template based counter silently stopped.
* Repeat views from the same visitor now collapse over a 24 hour window and known bots are filtered out. Existing totals are preserved, but the counter will grow more slowly from now on because the numbers are closer to reality.
* Counting no longer writes to the database on every single page view.

Archive
* Added filters on the ePaper archive: search, Edition, Language, month and an exact edition date.
* The date picker only offers days that actually have an edition, and never a future date.
* Search now also matches Edition and Language names and page labels, not just the title and content.
* Editions and Languages on a card are clickable badges that filter the archive.
* Cards show the whole page at A4 proportions and the entire card is one link.

Related editions
* Added a “More Editions” row under the reader, matched first by Edition, then Language, then most recent.

Admin
* Added a Getting Started screen with a step-by-step guide, a shortcode reference and an explanation of how view counts work.
* Added one-click sample content: three demo editions with labelled pages, drawn on your own server, removable in one click.
* Added an edition date range filter to Analytics.
* Added per-page labels, so pages can be named Front Page, City, Sports and so on.
* Settings are laid out in two columns with a sticky save bar.
* Added a Content Width setting so the reader and archive line up with your theme, plus a sk_epaper_content_max_width filter.
* Added a Thumbnail Position setting: below the reader, or a rail on the left or right.

Editor and blocks
* Added “ePaper Viewer” and “ePaper Archive” blocks. Both render through the same code as the shortcodes, and both shortcodes continue to work unchanged.
* ePapers are now exposed through the REST API for blocks and headless use.
* Existing sites keep the classic editor for ePapers. New sites start on the block editor, and either can switch under ePapers > Settings.

Accessibility
* Navigation arrows are real buttons with labels and keyboard focus instead of decorative divs.
* Added a live region for the page counter, visible focus outlines, and reduced motion support.

Admin
* Settings now run through the WordPress Settings API with per field sanitisation.
* Added settings for archive page size, lazy loading, thumbnails, PDF mode, editor choice, and uninstall behaviour.

Housekeeping
* Restructured the plugin into classes under includes/. Every function that existed as a global in 1.2.x is still defined and still hooked under the same name, so existing remove_action() and remove_filter() calls keep working.
* Themes can now override the plugin templates by copying them to yourtheme/sk-epaper/.
* Added uninstall.php. It deletes nothing unless you opt in first, and never touches ePaper posts or uploaded media.
* Completed internationalisation: post type labels, the viewer chrome, and admin JavaScript strings are all translatable, with a Domain Path header.
* Added a batched, resumable data migration so sites with thousands of editions upgrade without timing out.
* Added phpcs configuration and a GitHub Actions workflow covering PHP 7.4/8.1/8.3.

1.2.1

• Fixed: ePaper archive and taxonomy pages loaded every edition in a single query (posts_per_page = -1), which could exhaust memory on sites with many editions. Archives are now paginated through the main query (default 24 per page, configurable in Settings).
• Fixed: Editions with no recorded views were missing from the Analytics table because the query required the views meta key to exist.
• Added: View counter meta is now initialised when an ePaper is published.
• Fixed: Arrow-key navigation affected every viewer on pages with multiple [sk_epaper] shortcodes, and fired while typing in form fields.
• Fixed: “Print All Pages” could silently do nothing or print blank pages; printing now waits for images to finish loading.
• Fixed: Print iframes were left in the DOM after every print.
• Fixed: The meta box save routine now runs only for the ePaper post type, skips revisions, and validates that submitted IDs are real attachments.
• Changed: Deactivation no longer unregisters the post type and taxonomies; it only flushes rewrite rules.
• Housekeeping: Added the SK_EPAPER_VERSION constant for asset versioning.

1.2.0

• Added Drag-and-Drop page reordering in Admin metabox via jQuery UI Sortable.
• Added “Editions” and “Languages” custom taxonomies for multi-city/language management.
• Added custom Edition Date picker meta field.
• Added shortcodes [sk_epaper] and [sk_epaper_archive] for page builder embedding.
• Added View Counter (_sk_epaper_views) and custom columns in Admin post list table.

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

• Fixed direct file access protection in template files to prevent security issues.
• Updated “Tested up to” to 7.0 (current WordPress version).
• Updated PHP requirements to 7.4.

1.1.4

• Fixed Dashicons for zoom and print buttons on frontend.
• Updated template files for WordPress 6.9 compatibility.
• Minor UI improvements.

1.1.3

• Replaced all Font Awesome icons with WordPress Dashicons.
• Fixed minor UI issues for single ePaper template.
• Updated slider arrows to use Dashicons.
• General code and template improvements.

1.1.2

• Added sidebar to single ePaper template
• UI improvements and minor fixes

1.1.1

• Updated plugin header and readme stable tag for WordPress.org compliance
• Added local Font Awesome to replace CDN
• Fixed escaping output issues
• Prefixed global variables in templates
• Other minor code improvements

1.0

• Initial release — custom post type, image upload, archive and single templates.