Files
Bookshelf/bd-bookshelf-plugin/readme.txt
bdm 38cdebd0c6 Track Bookshelf WordPress theme, plugins and specs
Initial import of the bdmurphy Bookshelf work: the bd-bookshelf theme,
bd-bookshelf-plugin, bd-bookshelfhelper and bd-simpleemail plugins, plus
the specification documents, mockups and release archives.
2026-09-28 06:24:25 -07:00

78 lines
2.6 KiB
Plaintext

=== BD Bookshelf ===
Contributors: bdmurphy
Requires at least: 6.0
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Copyright 2026 B.D. Murphy
Book management plugin for authors with ISBN tracking, retail links, and rating synchronization.
== Description ==
BD Bookshelf is a comprehensive book management plugin designed for authors. It provides:
* **Book Management** - Custom database tables for efficient book storage
* **ISBN Tracking** - Support for 4 ISBN formats (eBook, Paperback, Hard Cover, Audio)
* **Retail Links** - Automatic link generation from ISBNs for Amazon, B&N, Apple Books, Google Play, and Kobo
* **Rating Synchronization** - Automated syncing of ratings from Amazon and Goodreads via web scraping
* **Shortcodes** - Display retail grids and ratings anywhere on your site
* **Series Management** - Organize books into series with ordering
* **Author Management** - Support for up to 3 authors per book
* **SEO Metadata** - Custom meta tags and Open Graph data for books
* **GDPR Compliance** - Cookie consent banner for affiliate tracking
* **Click Analytics** - Track clicks on custom redirect shortcodes
* **Data Migration** - Import existing books from WordPress posts or CSV files
== Installation ==
1. Upload the `bd-bookshelf` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to the 'Books' menu to start adding books
4. Configure affiliate codes in Settings > Books > Settings
== Frequently Asked Questions ==
= How do I add a new book? =
Go to Books > Add New Book. Fill in the title, description, ISBNs, and other details. Retail links are automatically generated when you enter ISBNs.
= How do I display retail links? =
Use the shortcodes `[sell_ebook]`, `[sell_pb]`, `[sell_hc]`, or `[sell_audio]` with the book ID:
`[sell_ebook id="123"]`
= How do I display ratings? =
Use the `[rating]` shortcode:
`[rating title="My Book" format="both"]`
= How often are ratings synced? =
Ratings are automatically synced every 12 hours. You can also trigger a manual sync from the Rating Sync page.
== Changelog ==
= 0.1.0 =
* Initial release
* Book management with custom database tables
* ISBN tracking for 4 formats
* Automatic retail link generation
* Rating synchronization from Amazon and Goodreads
* Shortcode suite for retail grids and ratings
* Series and author management
* SEO metadata
* GDPR compliance
* Click analytics
* Data migration tools
== Upgrade Notice ==
= 0.1.0 =
Initial release of BD Bookshelf plugin.