📚 MangaDex API WordPress Plugin

A WordPress plugin integrating MangaDex API to crawl, sync, and display manga content directly inside WordPress.
Features include reader with comments, user engagement tools (bookmarks, ratings, history), and membership integration for manga community sites.
🚧 Project status: Beta — actively maintained with demo at mymanga.fwh.is.

---

✨ Features

• 🔗 Integration with MangaDex API
  Crawl and sync manga list, chapters, genres, themes, and formats.

• 💬 Comment system (custom)

  • Per-chapter comment threads (3-level nesting)
  • Profanity & toxicity filter (Regex + Perspective API)
  • User/Admin comment deletion
  • Lazy loading & auto-scroll
  • Pruning of fully-deleted threads

• ⭐ User Features

  • Reading history (per user or guest token, auto-expire after 14 days)
  • Bookmarks
  • Ratings
  • Viewer statistics

• 🎭 User Management

  • Google Social Login integration (via Nextend Social Login)
  • Custom avatar handler

• 🏆 Ranking & Discovery

  • Top manga (followed, rating, etc.)
  • Featured, latest, search & filter shortcodes
  • Mega-menu dropdown for genres, themes, formats

• 🔒 Membership Integration

  • VIP membership promo box ([vip_membership_promo])
  • Compatible with Paid Member Subscriptions

---

📂 Shortcodes

• [mangadex_reader] → Manga reader with comments
• [mangadex_detail] → Manga detail page
• [mangadex_home] → Homepage list
• [mangadex_latest] → Latest manga
• [mangadex_featured] → Featured manga
• [manga_search_filter] → Search + filter UI
• [vip_membership_promo] → VIP upgrade promo box

---

🗄️ Database Schema

The plugin automatically creates custom tables:

• wp_manga_list – Manga info
• wp_manga_chapter – Chapters
• wp_manga_genre, wp_manga_genre_map – Genre system
• wp_manga_comments – Comments (nested with parent_id)
• wp_manga_read_history – Reading history (user/guest)
• wp_manga_bookmarks – Bookmarks
• wp_manga_users – Synced Google users
• (Extra: rating, viewer, top ranking tables)

---

🚀 Installation

1. Clone or download this repository.
2. Copy the mangadex-api/ folder into your WordPress wp-content/plugins/ directory.
3. Activate MangaDex API from WordPress admin.
4. Configure settings (API key, cron, etc.) if required.

---

📖 Suggested “Usage Guide” Section for README

🔧 Usage Guide

After activating the plugin in WordPress, you can add manga content and features to your site using shortcodes.

1. Add Shortcodes to Pages

• Go to WordPress Admin → Pages → Add New (or edit an existing page).
• Insert one of the following shortcodes into the page content:

Shortcode	Description
[mangadex_home]	Homepage manga list
[mangadex_featured]	Featured manga list
[mangadex_latest]	Latest manga releases
[manga_top_chart]	Manga ranking chart
[manga_search_filter]	Search + filter UI
[mangadex_reader]	Manga reader (auto when clicking chapter link)
[mangadex_detail]	Manga detail page (auto when clicking manga link)
[manga_read_history]	User’s reading history
[manga_read_history_mini]	Compact reading history widget
[vip_membership_promo]	VIP upgrade promo box (links to Paid Member Subscriptions plugin)

👉 Example: Create a page “Featured Manga” and paste [mangadex_featured].

2. Customize Theme Integration

• For homepage: go to Appearance → Customize and add the shortcode [mangadex_home] or [mangadex_featured] into a widget/HTML block.
• For membership promo: insert [vip_membership_promo] inside a page or post to display upgrade banner.

3. Settings

• The plugin currently has no dedicated settings page. All customization is done through shortcodes and WordPress built-in editor.

4. Demo

• A live demo of this plugin is available at: mymanga.fwh.is (Note: Demo is experimental, some features may be incomplete.)

---

⚠️ Disclaimer

This plugin fetches metadata only from MangaDex.
It does not host or distribute copyrighted manga images.
Use responsibly and comply with MangaDex terms of service.

---

📜 License

GPL v2 or later.
Feel free to fork, modify, and contribute.