=== Kitab ===
Contributors: jlil
Tags: Books, Book Management, ISBN, Publishers, Authors
Requires at least: 4.7
Tested up to: 6.6
Stable tag: 1.2.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


Kitab - Books Management System for WordPress

## Description
**Kitab** (Arabic: كِتَاب) is a comprehensive Books Management System plugin for WordPress, designed to create, organize, and display books as a custom post type (CPT). With support for publishers, authors, and detailed book fields, Kitab enables easy cataloging and display of book information.

Kitab enhances WordPress by adding a **Books** custom post type with a range of book-specific custom fields and taxonomies. It allows you to organize books by author, publisher, and other metadata, and provides multiple options for displaying book information in an intuitive and customizable format.

## Features
- **Custom Post Type for Books**: Add books as unique posts with detailed information.
- **Support for Default Posts and Pages**: Use Kitab features with regular WordPress posts and pages if desired.
- **Authors and Publishers Taxonomies**: Easily categorize books by authors and publishers.
- **Detailed Custom Fields**: Track essential book details with dedicated fields, including:
  - **Book Name**
  - **Author**
  - **Pages**
  - **Edition**
  - **ISBN**
  - **Copyright Year**
  - **Copyright Holder**
  - **PDF Download Link**
  - **EPUB Download Link**
  - **Buy Link / Affiliate Link**
- **Book Cover as Thumbnail**: Upload a cover image for each book, displayed as the post thumbnail.
- **Flexible Display Options**: Control how and where book information is shown:
  - Above content
  - Below content
  - Both above and below content
  - Manually via shortcode or template tag
- **Format Options**: Choose how to display book details:
  - **Definition List (dl)**: For a clean, concise list.
  - **Table Format**: For a structured table display of book details.

## Installation
1. Upload the `kitab` folder to `/wp-content/plugins/` in your WordPress installation.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Configure settings in the **Kitab** options menu to customize fields and display options for your books.

## Usage
1. Once activated, go to **Books** in the WordPress admin menu to add and manage your book entries.
2. Organize books using the **Authors** and **Publishers** taxonomies.
3. Configure display options in **Kitab Settings** to determine where book details appear in relation to content.

## Customization
### Custom Fields for Book Details
Kitab provides the following fields for storing and displaying book-specific details:
- **Book Name**
- **Author**
- **Pages**
- **Edition**
- **ISBN**
- **Copyright Year**
- **Copyright Holder**
- **PDF Download**: Link to a downloadable PDF version of the book.
- **EPUB Download**: Link to a downloadable EPUB version of the book.
- **Buy Link or Affiliate Link**: Link to purchase the book or affiliate URL.

### Display Options
Kitab offers various ways to position book details on your website:
- **Above Content**
- **Below Content**
- **Both Above and Below Content**
- **Manual Placement**: Use the Kitab shortcode or template tag for custom placement.

### Display Formats
Kitab provides two formats for book details display:
- **Definition List (dl)**: A straightforward list layout.
- **Table Format**: An organized, grid-style table display.

## Changelog
### 1.2.0
- Added display position options (above, below, both, or manual).
- Added additional fields for comprehensive book metadata.
- Improved thumbnail support for book covers.
- Minor UI enhancements and bug fixes.

### 1.1.0
- Added table format option for displaying book info.
- Introduced Authors and Publishers taxonomies.

### 1.0.0
- Initial release with Books CPT, ISBN and page number fields, and basic display control options.


## Support
For support, issues, or feature requests, contact us via the [Support Forum](https://wordpress.org/support/plugin/kitab) or email support@jlil.net.

## License
This plugin is licensed under the [GPL-2.0 License](https://www.gnu.org/licenses/gpl-2.0.html).

---

## About the Author
Developed by [جليل](https://jlil.net), Kitab is inspired by the need for a structured, intuitive platform for book lovers and libraries on WordPress.

---

### Keywords
Books, Book Management, WordPress Plugin, Custom Post Type, Taxonomies, ISBN, Custom Fields, Publishers, Authors, Affiliate Links, eBook Downloads, Book Covers