Common Issues

Installation Issues

Theme Upload Failed

Problem: Cannot upload the theme ZIP file in WordPress admin.

Solutions:

1. Increase Upload Limit — Add to php.ini or .htaccess:

   upload_max_filesize = 128M
   post_max_size = 128M

2. Use FTP Instead — Extract the ZIP and upload the hianime folder directly to /wp-content/themes/ via FTP, then activate in WordPress admin.

3. Ask Your Host — Contact your hosting provider and ask them to increase the upload size limit.

---

White Screen After Activation

Problem: Site shows a blank white screen after activating HiAnime.

The most common cause is a missing or incompatible Ioncube Loader. HiAnime uses Ioncube-encoded files — without the loader, PHP throws a fatal error.

Solutions:

1. Verify Ioncube Loader — Create a phpinfo.php file in your site root:

   <?php phpinfo(); ?>

   Visit yoursite.com/phpinfo.php and search for ionCube. If it's missing, contact your host to enable it. Delete the file immediately after.

2. Check PHP Version — HiAnime requires PHP 8.1, 8.2, or 8.3. Check your version at Tools > Site Health > Info > Server.

3. Enable Debug Mode — Add to wp-config.php:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);

   Then check /wp-content/debug.log for the exact error message.

4. Increase Memory Limit — Add to wp-config.php:

   define('WP_MEMORY_LIMIT', '256M');

---

Theme Styles Not Loading

Problem: The site looks broken with no styling after activation.

Solutions:

1. Clear All Caches — Clear browser cache (Ctrl+Shift+Delete), WordPress cache, and any CDN or server cache.

2. Flush Permalinks — Go to Settings > Permalinks and click Save Changes without changing anything. This rebuilds the rewrite rules.

3. Check File Permissions — Ensure wp-content/themes/hianime/ is readable by the web server (755 for folders, 644 for files).

---

License Issues

License Shows as Inactive

Problem: OtakuThemes > License shows the license as inactive even after activation.

Solutions:

1. Clear all caches — Go to OtakuThemes > Cache and clear the theme cache, then clear your browser cache and any server/CDN cache.

2. Check the domain in the member area — Log in to otakuthemes.com/member, go to Licenses, and verify your domain is listed and marked as active. The domain must match exactly (e.g. yoursite.com vs www.yoursite.com matters).

3. Check cURL — The license check requires the cURL PHP extension. Verify it's enabled at Tools > Site Health > Info > Server.

4. Firewall blocking outbound requests — If your server blocks outbound connections to otakuthemes.com, license verification will fail. Contact your host to allow outbound HTTPS requests.

---

Domain Limit Reached

Problem: Cannot activate on a new domain — limit exceeded.

Solution:

1. Go to otakuthemes.com/member > Licenses
2. Deactivate an old or unused domain
3. Then activate your new domain

---

Content & Import Issues

Demo Import Fails or Stops

Problem: The demo import from OtakuThemes > Demo Import fails or doesn't complete.

Solutions:

1. Increase PHP limits — Add to wp-config.php:

   define('WP_MEMORY_LIMIT', '256M');

   Also ask your host to increase max_execution_time to at least 300 seconds.

2. Deactivate other plugins temporarily — Some plugins conflict with the import. Deactivate all non-essential plugins and try again.

3. Meta Box must be active — The demo import creates anime content with custom fields. Ensure Meta Box is installed and activated before importing.

4. Try again — If it partially imported, it's generally safe to run again.

---

Anime or Episodes Not Appearing

Problem: Published anime or episodes don't appear on the site.

Solutions:

1. Flush permalinks — Go to Settings > Permalinks and click Save Changes. This is required after adding custom post types.

2. Check the Series field on episodes — Each episode must have the Series field set to a parent anime. Without this, the episode won't appear on the anime's episode list.

3. Clear cache — Go to OtakuThemes > Cache and clear the cache.

---

Performance Issues

Slow Page Load

Problem: Pages are loading slowly.

Solutions:

1. Clear and configure cache — Use OtakuThemes > Cache to clear the theme cache. Consider a caching plugin like WP Fastest Cache or LiteSpeed Cache.

2. Use a CDN — Enable the Image CDN feature in OtakuThemes > Features > Page 3 to offload image delivery. For full site CDN, Cloudflare works well.

3. Optimize images — Use WebP format for poster images. WordPress can convert on upload with plugins like ShortPixel or Imagify.

4. Check hosting resources — If you're on shared hosting with high traffic, consider upgrading to VPS or managed WordPress hosting.

---

High Server Load

Problem: Server CPU or memory is consistently maxed out.

Solutions:

1. Enable object caching — Redis or Memcached significantly reduces database queries. Ask your host if Redis is available.

2. Reduce anime per page counts — In OtakuThemes > Content, lower the number of items displayed per page to reduce query load.

3. Upgrade hosting — Shared hosting is not suitable for high-traffic anime sites. At 10,000+ monthly visitors, a VPS is recommended.

---

Getting Help

Before Contacting Support

Provide the following when submitting a support ticket:

1. WordPress version — Dashboard > Updates
2. Theme version — OtakuThemes > About & Support
3. PHP version — Tools > Site Health > Info > Server
4. Ioncube status — Visible in phpinfo() output
5. Active plugins — A list of all active plugins
6. Error messages — Screenshots, browser console errors (F12), or /wp-content/debug.log entries

Submit a Ticket

1. Log in to the OtakuThemes member area
2. Submit a support ticket with all the information above
3. Include your site URL