Assumes YeCha is installed and the home page opens. Shortest path to a working site — about five minutes.
On this page
- Sign in · Site settings · Theme · Plugins · First post · Home layout · Cache & verify · Next
1. Sign in
Open /admin/ with the installer's admin account. The sidebar has 16 modules (see user guide): dashboard, posts, pages, taxonomies, multilingual, notes, comments, users, attachments, themes, layouts, upgrade, plugins, market, settings, tools.
First moves: change the initial password (Users) and create a full backup (Tools → Backup).
2. Site settings
Fill at least:
| Option | Meaning |
|---|---|
site.name / site.name_en | Site name in Chinese / English (/en/ uses the English name) |
site.subtitle / site.subtitle_en | Tagline |
site.description | Meta description |
site.languages / site.default_lang | Enabled languages and base language, e.g. ["zh","en"] / zh |
site.url | Real hostname (canonical URLs, login sessions) |
stats.head / stats.foot | Analytics slots; empty means zero outbound calls |
Full table: user guide → options.
3. Switch theme
Themes lists everything under themes/ (34 bundled). Click to activate; Theme settings exposes whatever that theme declares in theme.json (settings): accent colour, width, posts per page, latest-post count, sidebar toggle.
Home unchanged after switching? Clear caches and rebuild the baked home page (step 7).
4. Enable plugins
Plugins lists 20 built-in modules. Common picks:
| Plugin | Purpose | Suggestion |
|---|---|---|
poly | Multilingual content and AI translation | enable for multilingual sites |
market | /theme, /plugin, /downloads, /market pages | recommended for a product site |
site | Corporate-site mode | optional |
forum | Community forum | optional |
home-static / entry-static | Bake static home / entry pages | high-traffic sites |
statx | Traffic statistics | optional |
Enabling runs the plugin's idempotent migrations/ automatically; disabling only stops registration and keeps the data.
5. Publish the first post
Posts → New:
- Enter a title; the slug is generated (editable, letters/digits/hyphens only).
- Write excerpt and body in Markdown (tables, ``
lang fences,{#anchor}` headings). - Pick categories/tags and upload a cover.
- Set status to
publish(optionally schedulepublished_at). - Save, then open
/<slug>.html.
Pages work the same way for about/contact/docs pages. Add them to navigation via Nav::defs() or custom nav (see user guide → navigation).
6. Home layout
| Option | Effect |
|---|---|
home.landing | 1 = themed portal landing page, 0 = post list |
home.style | text list / img cards |
home.show_circle | show community block |
theme.sidebar_mode | flow / sticky sidebar |
theme.options.latest_n | number of latest posts |
7. Clear cache and verify
php -r 'chdir("/www/wwwroot/yecha.org"); require "config.inc.php"; require "core/bootstrap.php"; Cache::flush("pages"); Cache::flush("blocks");'
rm -f /www/wwwroot/yecha.org/var/home-static/index.html
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: example.com' https://127.0.0.1/Check: home renders with the new theme; /<slug>.html opens; the new post appears in /sitemap.xml; /feed works; settings save without errors.
Next
- All admin modules → user guide
- Build your own → themes · plugins
- Backup, upgrade, performance → operations