Installation
Install and activate Epiktetos from a theme ZIP or local theme folder.
Install Epiktetos like a standard WordPress theme. The package should contain the epiktetos theme directory with style.css, functions.php, theme.json, templates/, parts/, inc/, and assets/.
The current release package is available as a self-hosted ZIP:
https://mcorucu.com/uploads/Epiktetos-v1.2.0.zip
Install from WordPress admin
- Open WordPress admin.
- Go to Appearance > Themes.
- Select Add New Theme.
- Select Upload Theme.
- Upload the Epiktetos ZIP file.
- Select Install Now.
- Activate the theme.
After activation, Epiktetos registers theme supports, menu locations, shortcodes, admin screens, the first-run setup wizard, and the saved-articles rewrite route.
Install from the filesystem
For local development, place the extracted theme directory at:
wp-content/themes/epiktetos/
Then activate Epiktetos from Appearance > Themes.
Activation behavior
On activation, the theme:
- Registers the Primary Navigation and Footer Navigation menu locations.
- Seeds default primary and footer menus only when those locations are empty.
- Shows a setup wizard notice in the admin area.
- Makes Appearance > Epiktetos available for theme-specific settings.
- Makes bundled Sample Content available from Appearance > Epiktetos > Sample Content.
First-run wizard
The setup wizard is optional and runs inside WordPress admin. It uses the standard WordPress Media Library for logo and Site Icon selection, stores attachment IDs in hidden fields, and keeps previews in sync before saving.
The wizard can configure:
- Site identity basics.
- Logo and Site Icon assets.
- Navigation defaults.
- Homepage and Sample Content setup choices.
Sample Content
Version 1.2.0 includes local Sample Content inside the theme package. It can create posts, pages, menus, taxonomies, comments, theme options, featured images, and page-driven homepage setup data without downloading remote assets or installing plugins.
Go to Appearance > Epiktetos > Sample Content and use the creation tool. The importer is intended for clean installs and review environments; review existing content before running it on a live editorial site.
Permalink refresh
The theme includes a /saved/ reader route. If that route does not load after activation, visit Settings > Permalinks and save once to refresh rewrite rules.
Verify the installation
After activation, check:
- Appearance > Themes shows Epiktetos as the active theme.
- Appearance > Editor opens the block theme editor.
- Appearance > Menus shows Primary Navigation and Footer Navigation locations.
- Appearance > Epiktetos opens the theme settings area.
- The setup wizard logo and Site Icon buttons open the Media Library.
- Sample Content can be created from the Epiktetos admin screen when needed.
- The front page loads without PHP errors.