Quick Start

Assumes YeCha is installed and the home page opens. Shortest path to a working site — about five minutes.

On this page

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:

OptionMeaning
site.name / site.name_enSite name in Chinese / English (/en/ uses the English name)
site.subtitle / site.subtitle_enTagline
site.descriptionMeta description
site.languages / site.default_langEnabled languages and base language, e.g. ["zh","en"] / zh
site.urlReal hostname (canonical URLs, login sessions)
stats.head / stats.footAnalytics 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:

PluginPurposeSuggestion
polyMultilingual content and AI translationenable for multilingual sites
market/theme, /plugin, /downloads, /market pagesrecommended for a product site
siteCorporate-site modeoptional
forumCommunity forumoptional
home-static / entry-staticBake static home / entry pageshigh-traffic sites
statxTraffic statisticsoptional

Enabling runs the plugin's idempotent migrations/ automatically; disabling only stops registration and keeps the data.

5. Publish the first post

Posts → New:

  1. Enter a title; the slug is generated (editable, letters/digits/hyphens only).
  2. Write excerpt and body in Markdown (tables, ``lang fences, {#anchor}` headings).
  3. Pick categories/tags and upload a cover.
  4. Set status to publish (optionally schedule published_at).
  5. 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

OptionEffect
home.landing1 = themed portal landing page, 0 = post list
home.styletext list / img cards
home.show_circleshow community block
theme.sidebar_modeflow / sticky sidebar
theme.options.latest_nnumber 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