Init Manga Blog Shortcodes – Complete & Detailed Usage Guide

General Principles

• Manga Identification: All shortcodes support 3 identification methods: id="123" (manga post ID), slug="manga-name" (URL slug), title="Manga Title" (exact title)
• Safe Returns: If manga/data not found, shortcodes return empty HTML or content from empty parameter. Can be overridden via init_manga_empty_html filter.
• Performance: Statistics like views, ratings are cached for 1 hour with key manga_stats_{ID} in group init_manga.
• Validation: style/layout/size use whitelists; columns/limit are limited to prevent layout breaks.
• Accessibility: Semantic HTML, ARIA labels, UIkit compatible.

1. [manga_info] – Manga Card

Displays manga card with complete information: cover image (supports blur + reveal button), title, short description, views, chapter count, 18+ badge, completion mark.

[manga_info id="123"]
[manga_info slug="manga-name" show_all_genres="true"]
[manga_info title="Manga Title" empty="<p>Manga not found</p>"]

Parameters:

• show_all_genres="true" – Display up to 3 genres (default: only 1)
• empty – Replacement HTML when no data available

Technical Notes:

• Change thumbnail size via init_manga_card_thumb_size filter
• Status automatically maps to label + UIkit class
• Age normalization: adult/r18/nsfw → 18+

2. [manga_details] – Detailed Information

Displays information list: alternate title, chapter count (with pluralization), status, author (Author Mode or author_tax taxonomy), translation team, genres.

[manga_details id="123"]
[manga_details slug="manga-name" empty="<div>No data available</div>"]

Parameters:

• empty – Replacement HTML when no data available. Does not support fields/layout.

3. [manga_stats] – Statistics

Displays views, bookmarks, rating (with count), comments in 3 interface styles. Cached for 1 hour.

[manga_stats id="123"]
[manga_stats slug="manga-name" style="cards"]
[manga_stats title="Manga Title" style="badges"]

Parameters:

• style – Display style: inline (default), cards (card layout), badges (badge layout)
• empty – Replacement HTML when no data available

Hook: init_manga_stats_output to customize HTML output (add tooltips, change icons…).

4. [manga_read_button] – Read Button

Creates CTA button leading to manga permalink (does not handle first/latest/continue).

[manga_read_button id="123"]
[manga_read_button slug="manga-name" text="Read Now" style="primary" size="large"]
[manga_read_button title="Manga Title" class="uk-width-1-1 uk-text-center"]

Parameters:

• text – Button label (default: Read %manga_title%)
• style – UIkit style: primary, secondary, danger…
• size – Size: small, large (default: normal)
• class – Additional CSS classes
• empty – Replacement HTML when no data available

5. [manga_list] – Manga List

Creates list from multiple manga by ID or slug. Supports 3 layouts, uses template parts for reusability.

[manga_list ids="123,456,789" layout="grid" columns="3" limit="9"]
[manga_list slugs="manga-a,manga-b" layout="list" limit="10"]
[manga_list ids="1,2,3,4,5" layout="carousel" show_chapters="true" show_stats="true"]

Parameters:

• ids or slugs – Identification list (comma-separated). Choose one identification type.
• layout – Display style: grid, list, carousel
• columns – Column count (1-6, applies to grid only)
• limit – Quantity limit (1-50)
• show_chapters – Display chapter information (if init_manga_get_chapters exists)
• show_stats – Display statistics in item template
• empty – Replacement HTML when no data available

Notes: Optimized query with no_found_rows, enables meta/tax cache. Customize query via init_manga_list_query_args filter.

6. [manga_team] – Translation Team Info

Displays translation team information, retrieved directly from team_id or from manga. Supports enhanced team data (avatar, banner, social links, stats).

[manga_team id="123"]
[manga_team slug="manga-name" style="card" show_social="true" show_stats="true"]
[manga_team team_id="45" style="inline" empty="<span>No translation team</span>"]

Parameters:

• id / slug / title – Source from manga
• team_id – Translation team term ID (direct specification)
• style – Display style: card, badge, inline (default)
• show_social – Display social media links
• show_stats – Display team statistics
• empty – Replacement HTML when no data available

7. [team_manga] – Team’s Manga

Lists manga from a specific translation team with team information header.

[team_manga team_id="45" layout="grid" columns="3" limit="6"]
[team_manga team_slug="team-name" layout="list" limit="10" show_chapters="true"]

Parameters:

• team_id or team_slug – Team identification (one required)
• layout – Display style: grid, list
• columns – Column count (1-6, applies to grid)
• limit – Quantity limit (1-50)
• show_chapters, show_stats – Display additional information
• empty – Replacement HTML when no data available

8. [manga_compare] – Manga Comparison

Detailed comparison of 2 manga by criteria: status, chapter count, rating, views, genres, author. Displays as comparison table with CTA buttons.

[manga_compare ids="123,456"]

Rules:

• Must provide exactly 2 valid IDs. Does not support slugs.
• Invalid IDs or not exactly 2 → UIkit warning.

9. [manga_highlight] – Highlight Block

Creates quote or highlight block for manga. Uses text or falls back to excerpt/content.

[manga_highlight id="123"]
[manga_highlight slug="manga-name" style="card" text="Great quote here"]
[manga_highlight title="Manga Title" style="banner" chapter="12"]

Parameters:

• style – Display style: quote (default), card, banner
• text – Custom content (will use excerpt if not provided)
• chapter – Display “Chapter N” label
• empty – Replacement HTML when no content/data available

10. [manga_author] – Author

Displays author information with avatar, short bio, and optional social links.

[manga_author id="123"]
[manga_author slug="manga-slug"]
[manga_author author_slug="author-slug" show_social="true"]

Parameters:

• id / slug – Identify the manga to resolve its author
• author_id / author_slug – Directly identify the author
• show_social – Show social links if available (default: false)
• style – Display style: inline, badge, card (default: inline)
• empty – HTML fallback when no data is found

11. [author_manga] – Manga by Author

Lists all manga belonging to a specific author in grid or list layout.

[author_manga author_id="12" layout="grid" columns="3" limit="6"]
[author_manga author_slug="author-slug" layout="list" limit="10" show_stats="true"]

Parameters:

• author_id or author_slug – Required author identifier
• layout – Display style: grid, list
• columns – Number of columns (1–6, grid only)
• limit – Number of manga to display (1–50)
• show_stats – Show basic stats (views, follows, rating)
• empty – HTML fallback when no data is found

12. [manga_publisher] – Manga Publisher Information

Displays detailed information about the Publisher of a manga, either retrieved automatically from the manga post or directly from a specific publisher term. This shortcode inherits the design and logic of [manga_team] and uses the same metabox structure (shared metadata keys with prefix team_*, fallback to publisher_* if not found).

[manga_publisher id="123"]
[manga_publisher slug="manga-slug" style="card" show_social="true" show_stats="true"]
[manga_publisher publisher_id="45" style="inline" empty="<span>No publisher found</span>"]

Parameters:

• id / slug / title – Get publisher from a manga post
• publisher_id – Directly specify a publisher term ID
• style – Display style: card, badge, inline (default: inline)
• show_social – Display social links (Facebook, Discord, etc.)
• show_stats – Display stats (published manga count, members, founded date)
• empty – Custom HTML when no data is found

Technical Notes:

• Banner and avatar are retrieved from team_banner/team_avatar (fallback to publisher_banner/publisher_avatar).
• Social links use team_social_{provider} first, fallback to publisher_social_{provider}.
• New i18n strings: "Published by", "Published by %s", "%d manga published" (text-domain init-manga).

13. [publisher_manga] – Manga by Publisher

Lists all manga titles under a specific publisher, similar to [team_manga], with the same layout flexibility and query optimization.

[publisher_manga publisher_id="45" layout="grid" columns="3" limit="6" show_stats="true"]
[publisher_manga publisher_slug="shueisha" layout="list" limit="10" show_chapters="true"]

Parameters:

• publisher_id or publisher_slug – Identify the publisher (one is required)
• layout – Display layout: grid, list
• columns – Number of columns (1–6, only for grid layout)
• limit – Maximum number of manga (1–50)
• show_chapters – Show recent chapter info (if init_manga_get_chapters exists)
• show_stats – Show basic manga stats (views, rating, follows)
• empty – Custom HTML when no data is available

Hooks:

• init_publisher_manga_query_args – Filter query arguments for [publisher_manga] (e.g., custom ordering or meta filters).

Limits & Validation

• style: inline, cards, badge, badges, card, quote, banner, grid, list, carousel
• layout: grid, list, carousel
• size: small, large (or empty)
• columns: 1–6 (auto-limited); limit: 1–50 (auto-limited)

Performance Cache: Manga statistics (views, rating, chapters…) cached for 1 hour with key manga_stats_{ID}, cache group: init_manga.

Extension Hooks

• init_manga_empty_html – Customize empty HTML for each shortcode
• init_manga_card_thumb_size – Change thumbnail size for [manga_info] and lists
• init_manga_list_query_args – Modify [manga_list] query
• init_team_manga_query_args – Modify [team_manga] query
• init_manga_stats_output – Customize [manga_stats] HTML

Complete Examples

[manga_info slug="one-piece" show_all_genres="true"]
[manga_details slug="one-piece"]
[manga_stats slug="one-piece" style="badges"]
[manga_read_button slug="one-piece" style="primary" size="large"]
[manga_list ids="1,2,3,4,5,6" layout="grid" columns="3" show_stats="true"]
[manga_team slug="one-piece" style="card" show_social="true"]
[team_manga team_id="45" layout="list" limit="5"]
[manga_compare ids="123,456"]
[manga_highlight slug="one-piece" style="banner" text="The adventure to find the legendary treasure!"]

Best Practices

• Efficiency: Use [manga_list] with predefined ID/slug lists instead of complex queries.
• Layout: Choose appropriate layout and column count for your design, UIkit grid compatible.
• User Experience: Always set empty with friendly messages when no data available.
• Consistency: Use the same style across shortcodes on the same page for unified interface.
• i18n: All text supports internationalization with text-domain init-manga and pluralization.