Skip to main content

Troubleshooting

Each section below starts with the cause that turns out to be right most of the time.

1. My archives return a 404​

Check the permalinks. Go to Settings → Permalinks and pick anything other than the default. The category, tag and actor archives are all built on pretty permalinks: on the default ?p=123 setting they cannot resolve.

Saving that screen also flushes the rewrite rules, which fixes the same symptom when the rules have gone stale after a plugin change. It is worth doing even if the setting already looks right.

2. The header has no navigation​

The menu exists but is not attached to a location. Go to Appearance → Menus, open the menu you want, and tick the header location under Menu Settings → Display location.

3. My own menu keeps being replaced by Main Menu​

Fixed in KolorTube 1.10.0. Earlier versions put the Main Menu back in the header on every page, whatever menu you had chosen in Appearance → Menus. Update the theme: the menu you pick now stays.

4. A menu entry or a See all link leads to a 404​

The page behind it was deleted. Open WP-Script → Theme Options: a missing Categories, Tags or Actors page shows This page does not exist with a Create it button in the Videos tab, and the Pages tab does the same for the legal pages.

A changed slug is not the cause: the theme redirects (301) the old URL of its pages to the new one. On versions before 1.10.0 the See all links of the category and tag widgets kept the old address, which is fixed.

5. My logo does not show​

KolorTube uses the WordPress site logo, at Appearance → Customize → Site Identity, not a setting of its own. If you were looking for it in the theme's panels, that is why you could not find it.

6. A video shows no player​

Check which of the three source fields you filled in:

  • Video URL for a file you host, an mp4 or webm
  • Video embed code for the iframe a provider hands you
  • Video shortcode for a player plugin

Pasting an iframe into the Video URL field is the usual cause. See Video Information.

7. Hover previews do nothing​

Two things have to line up: the preview has to be switched on in General, and the video needs a Video trailer URL. A video without a trailer simply shows its thumbnail.

The same applies to thumbnail rotation, which needs images in the Thumbnails field.

8. My changes in the Customizer are not applied​

You have not published them. The Customizer keeps changes in a draft until you click Publish, and closing the panel without publishing throws them away.

If a change is published but the site still looks the same, empty your caching plugin and your CDN before looking further.

9. The site still shows placeholder SEO text​

Older versions shipped the SEO descriptions with placeholder latin as their default, which was printed on the homepage and on every archive until the fields were filled in. Updating the theme replaces those defaults with real sentences.

If you had already saved the latin text into a field, the update does not touch it: your saved value wins over the default. Clear the field to fall back to the new text, or write your own, in SEO.

10. Ad zones stay empty​

An empty ad field prints nothing at all, by design: no placeholder, no gap. So an ad zone that looks missing is usually a zone that was never filled in.

Check the right page's section too: the zones are set per page type, and the homepage ones do not apply to video pages. See Advertising.

11. Something else​

If none of this covers it, open a ticket from your account with the URL of the page, what you expected and what you got. A screenshot saves a round trip.