Mangabooth Webtoons

Requirements

Install the theme

1. Download the Mangabooth Webtoons theme ZIP from your purchase / delivery package.
2. In WordPress go to Appearance → Themes → Add New → Upload Theme and upload the ZIP.
3. Click Activate. After activation you are redirected to Appearance → Webtoons Welcome.
4. If you prefer FTP: unzip and copy the webtoons folder into wp-content/themes/, then activate it from Appearance → Themes.

Install plugins

1. After activating the theme, WordPress shows an admin notice to install required plugins. Or go to Appearance → Install Plugins.
2. Select WP Manga and WP Manga – Shortcodes, choose Install, then activate both.
3. Optionally install Blogger AI Assistant if you want AI writing tools. It is not required for webtoon features.
4. Go to Settings → Permalinks and click Save Changes so manga rewrite rules are flushed.

Install demo content

This is the recommended way to get started. After installing demo content, you can learn the theme and start adding your own series and chapters.

1. Go to Appearance → Webtoons Welcome.
2. Click Install Sample Data to create sample manga posts (20 series), homepage, Front-Page template pages, menus, widgets, theme mods, and configuration.
3. Or click Install Configuration only if you already have manga content and only want pages, menus, widgets, and settings.
4. Visit the site homepage when the installer finishes.

First-time setup checklist

1. Appearance → Customize → Site Identity — upload the site logo. This appears in the header on all pages except the reading header (which has its own logo setting).
2. Appearance → Menus — assign menus to Main Menu, Secondary Menu, Footer Menu, and User Menu.
3. WP Manga → Settings — set the Manga Archive page and User Page (the page with [manga-user-page]).
4. Settings → General — enable Anyone can register if you want the header Login button and sign-up modal.
5. Settings → Reading — set a static homepage if you did not use sample data: Homepage = your Home page, Posts page optional.
6. Create at least one manga series: WP Manga → Add New, add a featured image, genres, chapters, then set Webtoon Settings (release days, header images).

WP Manga (plugin) Settings

Open WP Manga Settings for core manga options.

Widgets Settings

Appearance → Widgets, or Customize → Widgets. Empty widget areas are simply hidden. Full-width vs. contained Top/Bottom sidebars is a Customizer layout option, not a widget setting.

The widget Webtoons: HTML Block outputs a published HTML Block by ID. Use it in any sidebar above. See HTML Blocks.

Theme Customize settings

Appearance → Customize. These options control look and layout. Manga data still comes from WP Manga.

Site identity & logos

Site Identity → Logo — used in the site header. Recommended height about 50px; width is flexible. If no logo is set, the site name is shown as text.

Webtoons – Header → Episode Reading – Header Logo — optional logo for the reading header only.

Appearance → Webtoons Welcome is the first-run hub (docs, demo, support, changelog, sample data). It is not a Customizer panel.

Layout

Section Webtoons – Layout Settings:

• Header Sidebar Fullwidth
• Header Secondary Sidebar Fullwidth
• Bottom Sidebar Fullwidth
• Bottom Secondary Sidebar Fullwidth
• Show Go To Top Button (default on)

Header (series defaults)

Section Webtoons – Header — used when a series has no Background Image of its own:

• Default Manga Detail Background Color (default #000)
• Default Manga Detail Text Color (default #FFF)
• Default Manga Detail Background Image

Archives & listing cards

Section Webtoons – Archives Page. These defaults apply to archives, Front-Page grids, and shortcode listings unless the shortcode overrides them.

Shortcode attributes show_genres, show_chapters, show_views, show_liked, and thumbnail_size override these per instance.

Typography & colors

Section Webtoons – Typography. Color and type values are written as CSS variables on :root. Heading/content fonts are extra controls at the end of the same panel.

Fonts

Colors

Spacing & layout tokens

These sit in the same Customizer section because they map to the remaining CSS variables.

Footer & social

Footer Settings — Footer Logo and Copyright Text. Placeholders: {year}, {site}. Empty copyright uses “© {year} {sitename}. All rights reserved.”

Social Accounts — Facebook, Twitter/X, Instagram, YouTube, LinkedIn, Pinterest, TikTok, Snapchat, Discord. Empty URLs are hidden in the footer.

Social Share — toggles share buttons on series and reading pages: Facebook, X-Twitter, Tumblr, Reddit, Copy Link, RSS. The bookmark heart is not here; it follows WP Manga’s User bookmark option.

Floating banners

Fixed left/right banners beside .main-content. Hidden automatically below 1200px.

1. Preferred: widgets in Appearance → Widgets → Left Floating Banner / Right Floating Banner.
2. Fallback: in case no widgets are added, section Webtoons – Floating Banners — Left / Right Banner HTML (ad units, iframes, scripts). Users with unfiltered_html can store raw HTML; others are limited to post-safe HTML.

Leave both the sidebar and the HTML empty to hide that side.

SEO (Manga)

Section Webtoons – SEO (Manga). Leave a field empty to keep WordPress / plugin defaults. Descriptions are trimmed to 160 characters.

Example single title: %title% - Read Online Free | %sitename%

HTML Blocks

Reusable snippets stored as a private post type. Admin menu: HTML Blocks.

1. Add a new HTML Block. Give it a title; put HTML, blocks, or shortcodes in the editor.
2. Note the numeric ID in the list table (ID column).
3. Embed with [html_block id="123"] anywhere shortcodes work, or add the widget Webtoons: HTML Block to a sidebar and pick the block.

Self-references are blocked so a block cannot recurse infinitely. Only published blocks render. Sample data creates a Footer Block in the Bottom Sidebar.

Shortcodes

Place shortcodes in pages, HTML Blocks, widgets that parse shortcodes, or the “Before Chapters List” editor. Theme shortcodes wrap WP Manga Shortcodes; both plugins must be active.

Theme shortcodes

[webtoons_tab_trending]

Tabbed sliders for Trending (week views), Popular (all-time views), and New (latest). Built on [wp_manga_tabs] + [manga_post_slider].

[webtoons_tab_trending heading="Popular & New Series" tabs="popular,new" viewall="/originals/"]

[webtoons_tab_genres]

One tab per genre slug; each tab is a 6-column [manga_listing]. Required: genres.

[webtoons_tab_genres heading="By Categories" genres="action,drama,romance"]

[webtoons_calendar]

Weekday tabs. Each tab lists series whose Release Schedule includes that day (via [manga_listing_by_day_release]).

[webtoons_calendar heading="Daily" items_per_row="6"]

[manga_listing_by_day_release]

Low-level listing used by the calendar. You can use it alone.

[manga_listing_by_day_release weekday="friday" count="20" items_per_row="5"]

[html_block]

[html_block id="42"]

WP Manga Shortcodes plugin

[manga_listing]

The main series grid. Sample homepage uses it for “Newly Released Originals”, “Completed”, and indie listings.

[manga_listing heading="Completed" count="5" items_per_row="5" orderby="date" status="end"]
[manga_listing heading="Indie" show_genres="1" show_liked="0" count="5" items_per_row="5" thumbnail_size="square"]

[manga_post_slider]

[manga_post_slider post_type="wp-manga" count="10" number="5" orderby="view" time="week" arrows="1" dots="0" rank="1"]

[wp_manga_tabs] + [wp_manga_tabcontent]

Generic tab wrapper. Tab IDs are sanitize_title of the comma-separated tabs labels. Each inner shortcode must set matching tab.

[wp_manga_tabs heading="Picks" tabs="Hot,New" viewall="/manga/" viewall_label="See all"]
  [wp_manga_tabcontent tab="hot"][manga_listing count="6" orderby="views"][/wp_manga_tabcontent]
  [wp_manga_tabcontent tab="new"][manga_listing count="6" orderby="new-manga"][/wp_manga_tabcontent]
[/wp_manga_tabs]

Optional: viewall, viewall_label, viewall_target.

[manga_info]

Series details block (thumbnail, meta, optional chapter list). Defaults to the current post if id is omitted.

[manga_info id="123" chapters="1" title_link="1"]

[manga_chapters]

[manga_chapters id="123" count="10" cols="2"]

[manga_grid]

Fixed 9-item grid. Attributes: orderby, order, genres, tags, ids, chapter_type, author.

[manga_grid genres="action" orderby="views"]

[manga_heading]

Styled heading. Content is the title text.

[manga_heading icon="fa fa-star"]Editor picks[/manga_heading]

[manga_blog]

Blog post cards (standard posts, not manga).

Attributes: count (6), cats, tags, ids, order, orderby, items_per_row (3 or 2).

[manga_blog count="4" items_per_row="2" cats="news"]

[wp-manga-my-bookmarks]

Logged-in user’s bookmarked series. Guests see nothing.

Attributes: style (1 or 2), column (must divide 12; default 3 → 4-column bootstrap).

[wp-manga-my-bookmarks style="1" column="3"]

WP Manga user dashboard

[manga-user-page]

Renders bookmarks, history, account settings, and reader settings. Put it on one page and select that page in WP Manga → Settings → User Page.

[manga-user-page]

Hooks & filters for developers

Add callbacks from a child theme’s functions.php or a small custom plugin. Prefix your functions. Theme text domain: webtoons.

Theme actions

add_action( 'webtoons_after_loop_manga_item', function( $manga_id ) {
    echo '<span class="custom-flag">' . esc_html( get_post_meta( $manga_id, 'my_flag', true ) ) . '</span>';
} );

Theme filters

add_filter( 'webtoons_front_page_query_args', function( $args, $page_id ) {
    $args['posts_per_page'] = 24;
    return $args;
}, 10, 2 );

add_filter( 'webtoons_archive_heading', function() {
    return __( 'Browse series', 'my-child' );
} );

WP Manga / reading hooks used in this theme

These fire from theme templates. They are the usual extension points for chapter lists and reading UI.

add_filter( 'wp_manga_chapter_image_url', function( $url, $host, $link, $post_id, $name ) {
    return 'https://cdn.example.com/' . ltrim( $link, '/' );
}, 10, 5 );

Public query vars

Useful post meta (series)

User meta (authors)

_webtoons_user_social_facebook, _instagram, _x, _youtube, _tiktok — URLs from the profile screen.

Template overrides

Copy any file from wp-content/themes/webtoons/ into a child theme using the same relative path. Manga templates live under wp-manga/ (for example wp-manga/manga-single.php, wp-manga/content/content-archive.php).

Do not edit the parent theme directly if you expect updates. Prefer hooks and Customizer settings when they already cover the change.

Mangabooth Webtoons User Guide · Theme 1.0 · Requires WordPress 6.7+, PHP 8.0+, WP Manga 2.4.2, WP Manga Shortcodes 1.7.1.1.