{"id":22272717,"url":"https://github.com/sykhangdha/mangareader-wp","last_synced_at":"2025-06-13T04:37:40.886Z","repository":{"id":44001188,"uuid":"440645648","full_name":"sykhangdha/mangareader-wp","owner":"sykhangdha","description":"A simple manga reader theme for wordpress ","archived":false,"fork":false,"pushed_at":"2025-05-15T06:29:25.000Z","size":6976,"stargazers_count":19,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-15T07:29:48.457Z","etag":null,"topics":["manga-wordpress-theme","manga-wp-theme","mangareader","mangareader-wordpress-theme","mangareader-wordpress-theme-free","mangastarter-wordpress-theme","mangastarter-wp","theme","wordpress","wp-manga-plugin","wp-mangareader-plugin"],"latest_commit_sha":null,"homepage":"http://skymanga.42web.io/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sykhangdha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-21T20:44:26.000Z","updated_at":"2025-05-15T06:29:28.000Z","dependencies_parsed_at":"2023-01-24T03:01:35.430Z","dependency_job_id":"977a9b06-3182-4167-a7a9-629d34d9d127","html_url":"https://github.com/sykhangdha/mangareader-wp","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/sykhangdha/mangareader-wp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sykhangdha%2Fmangareader-wp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sykhangdha%2Fmangareader-wp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sykhangdha%2Fmangareader-wp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sykhangdha%2Fmangareader-wp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sykhangdha","download_url":"https://codeload.github.com/sykhangdha/mangareader-wp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sykhangdha%2Fmangareader-wp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259582762,"owners_count":22880084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["manga-wordpress-theme","manga-wp-theme","mangareader","mangareader-wordpress-theme","mangareader-wordpress-theme-free","mangastarter-wordpress-theme","mangastarter-wp","theme","wordpress","wp-manga-plugin","wp-mangareader-plugin"],"created_at":"2024-12-03T13:08:11.139Z","updated_at":"2025-06-13T04:37:40.864Z","avatar_url":"https://github.com/sykhangdha.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎉 MangaStarter Rewritten [Initial Release] 🎉\n\n**1.0 - Initial Release: 5/15/2025(Uses new retro theme)**  \n[📥 Release Notes + Download](https://github.com/sykhangdha/mangareader-wp/releases/tag/v1)\n\n[👀 Live Demo](http://skymanga.42web.io/)\n\nWelcome to *MangaStarter Rewritten*, a custom manga viewer theme using Windows 11(fluent) design elements!\n\n*Note: Please clear cache for site if there are issues with website not showing the new updates!\n\n## Added Changes(viewable in the live demo)\n- Add chapter list to sidebar for manga viewer\n- Switched method for scrolling\n- Improve sidebar view and manga page(currently shows chapter list twice when going back to chapter list)\n- Admin settings improvement\n- Improve image loading for slow servers\n- Theming system(Site is currently using 'Manga95' theme by me that follows design elements from Windows95/Chicago95(linux theme)\n\n---\n\n## 🚀 Getting Started\n\n### ✨ What’s This Theme About?\n*MangaStarter Rewritten* is designed to bring your manga collection to wordpress.\n### 📋 Installation Steps\n1. **Upload the Theme**  \n   - Drop the `manga-reader-theme` folder into `wp-content/themes/`.  OR upload theme through wordpress\n2. **Set Up Your Manga Folder**  \n   - Create a `manga/` folder in your WordPress root (`/manga/`).  \n   - Add manga folders (e.g., `manga/manga-name-1/`) with a `cover.jpg` and chapter subfolders with images.  \n3. **Activate It**  \n   - Head to `Appearance \u003e Themes` in your WordPress dashboard and activate \"Manga Reader Theme\".  \n4. **Fix URL Rules**  \n   - Go to `Settings \u003e Permalinks` and click \"Save Changes\".  \n5. **Dive In**  \n   - Visit `yoursite.com/manga/manga-name` to check out your first manga!  \n\n---\n\n## 🌟 Key Features\n\n### 📖 Manga Page with Cover \u0026 Chapter List\n- **What You Get**: See a manga’s cover (if you add one) and browse chapters without page reloads.  \n- **How It Works**:  \n  - Just go to `yoursite.com/manga/manga-name`—the theme handles it automatically with URL magic.  \n  - Grabs the cover from `manga/manga-name/cover.jpg`.  \n  - Loads chapters via AJAX (`manga_reader_get_chapters`) from files (`manga/manga-name/*`) or the database (`manga_chapter` post type).  \n\n\n### ⚡ AJAX-Powered Chapter \u0026 Image Loading\n- **What You Get**: Chapters and images pop up quickly using AJAX.  \n- **How It Works**:  \n  - `script.js` calls `manga_reader_get_chapters` for the chapter list.  \n  - Click a chapter, and `manga_reader_get_images` fetches the pics from folders (`manga/manga-name/chapter-name/*.jpg`) or the database.  \n- **What it does**: Keeps your server happy by loading only what’s needed and speeds up navigation.  \n\n### 🗂️ Custom Post Type for Chapters\n- **What You Get**: Store chapters in the WordPress database alongside file-based ones.  \n- **How It Works**:  \n  - Add chapters through the admin panel or code.  \n  - Each chapter saves the manga name (`manga_name` meta), images (`chapter_images` meta), and URLs (`chapter_image_urls` meta).  \n- **What it does**: Manage chapters without touching files and use WordPress’s built-in tools.  \n\n### 🛠️ Admin Interface for Management\n- **What You Get**: A \"Manga Reader\" section in your WordPress admin to control everything.  \n- **Features**:  \n  - **➕ Add Manga Folder**: Create new `manga/` folders.  \n  - **🎨 Edit Manga Cover**: Upload or remove covers.  \n  - **🔍 Scan Manga Folders**: List all manga and covers.  \n  - **📝 Add/Edit Chapters**: Add or tweak chapters with images/URLs.  \n- **How it Works**: The `manga_reader_settings_page` offers forms, powered by AJAX endpoints like `manga_reader_add_manga_folder`.  \n- **What it does**: Central hub for admins, no file editing needed.  \n\n### 🎨 Customizable Color Scheme\n- **What You Get**: Tweak colors to match your style via the WordPress Customizer.  \n- **Options**: Accent color (links, buttons), background, header, menu, glass panel tint, footer, and body text.  \n- **How it Works**: `manga_reader_customize_register` adds a \"Color Settings\" section, with live CSS updates from `manga_reader_dynamic_styles`.  \n- **What it does**: Personalize without coding, see changes instantly.  \n\n### 📢 Site Announcement\n- **What You Get**: Share updates or notes with a custom announcement.  \n- **How it Works**: Set a title and text in \"Site Settings\" in the admin panel—it shows up on the frontend.  \n- **What it does**: Keep readers informed with ease.  \n\n### 🔄 Update Site Button (Cache Clearing)\n- **What You Get**: An optional button to clear CSS/JS cache for users.  \n- **How it Works**: Enable it in \"Site Settings\"—it refreshes the homepage via `manga_reader_clear_cache`.  \n- **What it does**: Ensures everyone sees the latest updates.  \n\n### 🔗 Shortcode for Manga Viewer (Optional)\n- **What You Get**: Embed a manga viewer with `[display_manga name=\"manga-name\"]`—optional since `yoursite.com/manga/manga-name` works automatically.  \n- **How it Works**: `manga_reader_display_manga` builds the viewer; use the shortcode for custom spots like posts.  \n- **What it does**: Flexibility to show manga anywhere on your site.  \n\n---\n\n## 📂 Folder Structure\n\nThis theme uses a `manga/` folder in your WordPress root and the theme directory to keep things organized.\n\n```\n/\n├── manga/\n│   ├── manga-name-1/\n│   │   ├── cover.jpg           # Manga cover pic 🎨\n│   │   ├── chapter-1/          # Chapter folder 📁\n│   │   │   ├── page1.jpg       # Chapter images 🖼️\n│   │   │   ├── page2.jpg\n│   │   │   └── ...\n│   │   ├── chapter-2/\n│   │   └── ...\n│   ├── manga-name-2/\n│   └── ...\n└── wp-content/\n    └── themes/\n        └── manga-reader-theme/\n            ├── admin-script.js   # Admin JavaScript ⚙️\n            ├── admin-style.css   # Admin CSS 🎨\n            ├── functions.php     # Theme logic \u0026 hooks 🛠️\n            ├── index.php         # Homepage template 🏠\n            ├── manga-page.php    # Manga page template 📖\n            ├── script.js         # Frontend JavaScript 🚀\n            ├── style.css         # Main styles 🎨\n            └── style-manga.css   # Manga-specific styles 📜\n```\n\n### 📍 Key Spots\n- **`manga/`**: Holds your manga files (covers and chapters) in the root.  \n- **`manga-reader-theme/`**: The theme folder with:  \n  - **`functions.php`**: Where the setup, AJAX, and admin magic happens.  \n  - **`manga-page.php`**: Template for `yoursite.com/manga/manga-name`.  \n  - **`script.js`**: Powers frontend AJAX calls.  \n  - **`style-manga.css`**: Styles just for manga pages.  \n\n---\n\n## 🎮 Usage\n\n### 🌐 Accessing Manga Pages\n- Hit `yoursite.com/manga/manga-name` to view a manga—no shortcode needed!  \n\n### 📝 Embedding Manga (Optional)\n- Add `[display_manga name=\"manga-name\"]` to a page or post (e.g., `[display_manga name=\"cant-believe\"]`) for a custom viewer.  \n\n### ➕ Adding Manga\n- Use `Manga Reader \u003e Manga Management` in the admin panel to create folders and upload covers.  \n- Or, manually add folders to `manga/` with the right setup.  \n\n### 📚 Adding Chapters\n- Add chapters via the admin panel with images or URLs.  \n- Or, drop them into `manga/manga-name/chapter-name/` on the file system.  \n\n### 🎨 Customizing\n- Go to `Appearance \u003e Customize \u003e Color Settings` to tweak colors.  \n- Use `Manga Reader \u003e Site Settings` to enable the \"Update Site\" button or set an announcement.  \n\n---\n\n## 🛠️ Development Notes\n- **🔗 URL Rewriting**: Uses `add_rewrite_rule` to map `manga/manga-name` to `manga-page.php`.  \n- **⚡ AJAX**: Dynamic loading runs through `functions.php` endpoints.  \n- **✂️ Normalization**: Manga names get cleaned (spaces to hyphens, lowercase, no special chars) like \"Can't Believe\" to `cant-believe`.  \n- **🔄 Cache Busting**: `manga_reader_get_asset_version` keeps assets fresh.  \n\n---\n\n## 🤝 Contributing\n1. Fork this repo.  \n2. Create a branch (`git checkout -b feature/your-feature`).  \n3. Make your changes.  \n4. Commit (`git commit -m 'Add your feature'`).  \n5. Push (`git push origin feature/your-feature`).  \n6. Open a pull request!  \n\n---\n\n## 🙌 Acknowledgments\n- Built with WordPress and jQuery.  \n- Shoutout to [O.M.V](https://rsm23.github.io/O.M.V-V2/) and MangaDex for inspiration.  \n- Made because I wanted a simple manga viewer\n\n---\n\n## 🕒 Old Version (No Longer Supported)\n**Install Guide**: [Click Here](https://skyha.rf.gd/mangastarter-install-guide/)  \n**Download**: [MangaStarter-Revival-HotFix2 (6.03.24)](https://github.com/sykhangdha/mangareader-wp/releases/download/HotFix2/mangastart-Rebuilt-Hotfix2.zip)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsykhangdha%2Fmangareader-wp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsykhangdha%2Fmangareader-wp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsykhangdha%2Fmangareader-wp/lists"}