Documentation

Everything you need to install, configure, update and maintain a WP Atölye theme — written for both first-time WordPress users and developers. No filler, no upsells.

Installing a theme

Every WP Atölye theme is a standard WordPress theme distributed as a single tested ZIP archive. You don't need FTP, a build step or any command line — installation happens entirely inside the WordPress admin.

  1. Sign in to your free account and open your dashboard. Find the theme you want and download its latest .zip package.
  2. In WordPress, go to Appearance → Themes → Add New → Upload Theme, choose the ZIP you downloaded, and click Install Now.
  3. When the upload finishes, click Activate. The theme is now live on your site.

Do not unzip the archive before uploading — WordPress expects the original ZIP. The package contains a self-contained theme folder, roughly like this:

atolyeblog/
├── style.css          # theme header + version
├── theme.json         # global styles (v3)
├── functions.php      # setup, enqueues, supports
├── index.php          # main template
├── templates/         # block templates (FSE)
├── parts/             # header, footer, sidebar
├── assets/
│   ├── css/           # compiled Tailwind output
│   └── js/            # TypeScript-built interactions
├── screenshot.png     # 1200×900 preview
├── README.md          # quick start
├── CHANGELOG.md       # version history
└── LICENSE            # GPL-2.0-or-later

Tip: If the upload fails with a file-size error, your host limits upload_max_filesize. Either raise the limit in php.ini, or ask your host to allow uploads up to about 25 MB. Our packages are small, but media-heavy starter content can be larger.

First-time setup

After activating, spend a few minutes on the basics so your site looks like the live demo:

  • Menus. Go to Appearance → Editor → Navigation (or Menus on classic setups) and assign your primary menu to the header location.
  • Homepage. Under Settings → Reading, choose whether your front page shows your latest posts or a static page. Each theme ships with a demo layout you can duplicate.
  • Widgets & sidebars. Open Appearance → Editor → Patterns or the widget areas to place search, recent posts, an author box and ad-safe zones where the demo shows them.
  • Site identity. Set your site title, logo and accent color in Appearance → Editor → Styles. The theme reads colors from theme.json, so brand changes stay consistent everywhere.

Table of contents

Content-focused themes such as AtolyeBlog include an automatic table of contents for long articles. It is generated from the headings in your post — no shortcode required.

  • The TOC scans h2 and h3 elements in the post body and builds anchor links.
  • On desktop it can render as a sticky side rail; on mobile it collapses into a compact inline box at the top of the article.
  • You can disable it per post with the "Hide table of contents" toggle in the post sidebar, or globally in the theme's reading options.

This very documentation page uses the same pattern: the list on the left links to each h2 by its id.

Updating a theme

We ship versioned releases with a readable changelog. Updating is the same flow as installing:

  1. Download the newer ZIP from your dashboard whenever a new version is published.
  2. In WordPress, go to Appearance → Themes → Add New → Upload Theme and upload the new ZIP. WordPress will detect the existing theme and offer to Replace current with uploaded.
  3. Confirm the replacement. The theme files are updated in place.

Your settings are preserved. Customizer values, menus, widgets and theme.json style overrides live in the database, not in the theme files, so they survive an update. Only the template and asset files are replaced. If you edited theme files directly, use a child theme so your changes aren't overwritten.

Quality & QA checklist

No theme goes public until it passes our Quality Gate. Every release you download has cleared this checklist:

  • Fully responsive from 320px to large desktops
  • Accessible navigation with keyboard and screen-reader support
  • Properly escaped output (no unescaped dynamic data)
  • Sanitized and validated theme options
  • Translation-ready with a bundled text domain
  • A real screenshot.png that matches the live demo
  • A README with quick-start instructions
  • A maintained CHANGELOG for every version
  • A LICENSE file (GPL-2.0-or-later)
  • A clean pass on the official Theme Check plugin

Support scope

We'd rather be honest about boundaries than promise everything. Here's what support covers — and what it doesn't.

What we help with

  • Installation and activation problems with the official ZIP.
  • Bugs in the theme itself, reproduced on a default WordPress install.
  • Questions about documented features and theme options.
  • Compatibility issues within our stated WordPress 6.6+ and PHP 8.3 targets.

What's out of scope

  • Custom development, design changes or one-off feature requests.
  • Third-party plugin conflicts we can't reproduce on a clean site.
  • Server, hosting and DNS configuration.
  • Modifications you made directly to theme files (use a child theme).

Read the full support policy before reaching out, and please include your WordPress version, PHP version, theme version and steps to reproduce.

FAQ

No. Upload the new ZIP through Add New → Upload Theme and choose Replace current with uploaded. WordPress swaps the files in place and keeps your settings, menus and content untouched.

Use a child theme for any custom PHP, templates or CSS. Edits made directly to the parent theme are overwritten when you update. Most styling can be done in Appearance → Editor → Styles without touching code at all.

Each theme ships with block patterns that match the live demo so you can rebuild the same layout quickly. We don't bulk-import placeholder posts and images into your database — that keeps your site clean and avoids licensing issues with demo media.

WordPress 6.6 or newer and PHP 8.3 or newer. Themes use theme.json v3 and block templates, so an up-to-date WordPress is important. Older versions are not tested or supported.

Ready to install your first theme?

Create a free account, download a tested ZIP and follow the steps above. Demos, docs and changelogs stay public the whole way.