Skip to content
mcorucu docs
Epiktetos Theme1.0.0
1.0.02 min read

Troubleshooting

Common setup and runtime issues for Epiktetos.

Use this page to check common configuration issues before debugging code.

Header menu is missing

Confirm a menu is assigned to Primary Navigation.

  1. Go to Appearance > Menus.
  2. Create or choose a menu.
  3. Assign it to Primary Navigation.
  4. Save and reload the front end.

Assign a menu to Footer Navigation. The footer renderer uses the theme footer output, so also confirm Appearance > Epiktetos > Footer settings are saved.

Saved articles route does not load

The reader feature registers a saved route. Refresh permalinks:

  1. Go to Settings > Permalinks.
  2. Save changes without changing the structure.
  3. Reload /saved/.

Search returns no results

Check that:

  • Posts are published.
  • The search query has at least two characters.
  • The REST API is available.
  • No security plugin blocks /wp-json/epiktetos/v1/search.

Homepage looks empty

Publish posts with categories, featured images, and excerpts. Then review Appearance > Epiktetos > Editorial and category ordering.

Dark mode flashes on load

The header class prints no-FOUC CSS in wp_head. If a child theme or optimization plugin moves or strips head output, test with optimization disabled.

Translation strings are missing

The theme loads the epiktetos text domain, but no bundled .pot file was found in version 1.0.0. Generate a translation template before creating language files.

Related articles

InstallationInstall and activate Epiktetos from a theme ZIP or local theme folder.Quick StartConfigure the minimum settings needed for a working Epiktetos site.FAQFrequently asked technical questions about Epiktetos.