# BD BookShelfHelper

**Contributors:** B.D. Murphy  
**Tags:** books, author, series, pen names, reviews  
**Requires at least:** WordPress 6.0  
**Tested up to:** WordPress 6.4  
**Requires PHP:** 7.4  
**License:** GPL v2 or later  
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html  

Manages book data, series, pen names, short links, reviews, and ratings for the BD Murphy Bookshelf theme.

## Description

BD BookShelfHelper is a WordPress plugin designed to work with the BDMurphy Bookshelf theme. It provides comprehensive management for:

- **Book Management:** Full custom post type for books with multi-language support
- **Series System:** Organize books into series with volume numbers
- **Pen Names:** Support for multiple author pen names
- **Short Links:** Auto-generated short URLs for books (e.g., /ph/ for "Pandemic Hacker")
- **Review Short Links:** Dedicated URLs for reader reviews on each retailer
- **Ratings:** Amazon and Goodreads rating integration
- **SEO:** Auto-generated meta tags and schema.org Book structured data

## Installation

1. Upload the `bd-bookshelfhelper` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure settings under 'BD BookHelper' in the admin sidebar

## Configuration

### Setting Up Books

1. Go to BD BookHelper > Add Book
2. Fill in book details including ASIN/ISBN
3. Add localized content for each supported language
4. Set retailer purchase links
5. Add reviews and ratings

### Pen Names

1. Go to BD BookHelper > Pen Names
2. Add author pen names
3. Assign to books in the book editor

### Series

1. Go to BD BookHelper > Series (taxonomy)
2. Create series with name, slug, and description
3. Assign books to series with volume numbers

### Settings

Configure affiliate codes and integrations under BD BookHelper > Settings.

## Short Links

Books automatically get short URLs based on their title:
- "Pandemic Hacker" → /ph/
- "Deal Hunter" → /dh/

Review short links follow the pattern: `{book-slug}r{site-code}`:
- /phrA = Amazon review
- /phrG = Goodreads review

## Frequently Asked Questions

### Do I need the theme?
Yes, this plugin is designed to work with the BDMurphy Bookshelf theme.

### Can I use without affiliate codes?
Yes, the plugin works without affiliate codes. They are optional.

### What languages are supported?
English, French, Spanish, German, Italian, Portuguese, Russian, Japanese, and Chinese (Simplified).

## Changelog

### 2.0.0
- Initial release with full book management, series, pen names, and integrations
