goukiandCursor
debead72a5
Let admin and editor open /admin in a new tab from the public header and profile, so they can jump to the backend without leaving the site. Co-authored-by: Cursor <cursoragent@cursor.com>
88 lines
4.9 KiB
Markdown
88 lines
4.9 KiB
Markdown
# LaraLog Features
|
|
|
|
Modern blog migrated from SaBlog-X: Filament admin, themes, plugins, sablog import, S3 attachments, Workerman AI queue.
|
|
|
|
## Local development
|
|
|
|
- Site: http://laralog.test
|
|
- Admin: http://laralog.test/admin
|
|
- Account: `admin@laralog.test` / `password`
|
|
- Database: MySQL `laralog` (Herd, root / empty password)
|
|
- Remote: `git@gitea.neatcn.com:gouki/laralog.git`
|
|
|
|
See `README.md` and `docs/` for install, import, plugins, and themes.
|
|
|
|
## Post editor layout
|
|
|
|
- Create/edit post uses **left 2 : right 1** on PC at every breakpoint (not only `lg`).
|
|
- Left: title, full-width slug, category + format + status on one row (single-choice buttons), cover thumbnail (not full-width), then a tall body editor.
|
|
- Right group 1: published at, sticky level (none / light / strong / headline), comment status, excerpt, keywords.
|
|
- Right group 2: read password; membership plugin adds members-only + price here.
|
|
- Plugins must inject via `PostForm::appendToSidebar()` / `appendToAccessSection()` so they do not break the 2:1 grid.
|
|
|
|
## Sticky levels
|
|
|
|
- `sticky_level`: 0 none, 1 light, 2 strong, 3 headline. Headline always stays first on home, category, tag, and search lists.
|
|
- Saving a post keeps `is_sticky` in sync (`true` when level > 0) so older themes still work.
|
|
- List badges show the Chinese label, not a generic “sticky”.
|
|
|
|
## Post preview
|
|
|
|
- Edit page and post table have **预览**, opening `/show-{id}.shtml` in a new tab.
|
|
- Filament v5 actions are `Filament\Actions\Action`. The comments relation manager on the edit page must boot in tests, because a stale `Tables\Actions\Action` import only fails when that Livewire table renders.
|
|
- Guests still get 404 for drafts. Admin and editor can open unpublished posts and see a preview banner.
|
|
|
|
## Frontend admin shortcut
|
|
|
|
- After login, admin and editor see **管理** in the site header. It opens `/admin` in a new tab.
|
|
- Regular members do not see it. The profile page has the same link for staff.
|
|
|
|
## Admin chrome
|
|
|
|
- Top-right badge shows the current app environment (`local` / `prod` / others).
|
|
- Top-right **网站** opens the public site in a new tab; **写文章** jumps to `/admin/posts/create`.
|
|
- Sidebar **管理** includes **页面缓存** (view URLs, hit rate, flush) and **语言** (current locale + available packs). Article translations are not built yet; the language page says so.
|
|
- Sidebar nav is compacted (Filament default `gap-y-7` / `py-8` is too tall for this site).
|
|
|
|
## Hello World plugin
|
|
|
|
- Enabling a plugin now runs that plugin's `database/migrations` automatically.
|
|
- Plugin boot / hook failures are isolated so one plugin cannot take down the whole admin.
|
|
- `/hello-world` stays available even if `hello_world_logs` is missing.
|
|
|
|
## Frontend feeds
|
|
|
|
- Header/footer **RSS / Sitemap / llms.txt** open in a new tab (`target="_blank"`).
|
|
- `/llms.txt` is a core route (not a static file). Each request lists current published public posts so new articles show up immediately.
|
|
- Full text for agents: `/posts/{slug}.md`. Password / members-only posts are omitted.
|
|
- These machine-readable paths are excluded from page cache.
|
|
|
|
## Homepage list / full mode
|
|
|
|
- Same switch as old SaBlog: **浏览模式: 标准 | 列表**.
|
|
- `list` = title + excerpt cards. `full` = full rendered body on the home / category / tag / search lists.
|
|
- Query `?view=list` or `?view=full` wins, then cookie `ll_home_view`, then setting `home_view_mode`.
|
|
- Page cache key includes the view mode so the two layouts are not mixed.
|
|
|
|
## Pagination and imported HTML
|
|
|
|
- Public pagers use `onEachSide(1)` plus a compact `6 / 316` chip (old SaBlog `.p_bar` look), and the main column is CSS grid `minmax(0, 1fr)` so page chips stay in the content column.
|
|
- `SablogHtmlNormalizer` strips leftover ` `, turns SyntaxHighlighter `codeText` / `dp-*` lists into `<pre><code>`, and wraps stacked docker/shell `<div>` lines.
|
|
- Render path always normalizes, so already-imported posts look right without rewriting the database. Persist with `php artisan sablog:fix-content --all`.
|
|
- Code blocks wrap / scroll inside the column instead of stretching the page.
|
|
|
|
## Theme ads / inject
|
|
|
|
- All list and post views include `content_top` / `content_bottom` (and post body) stacks. Saving **主题注入** flushes page cache.
|
|
- Theme variables (old stylevars) render automatically: `ad_header` → header, leftover HTML vars such as `huangjinlian` → footer.
|
|
- `sablog:import` now copies the old `stylevars` table into `theme_vars_{theme}`.
|
|
- Do not add a third half-finished skin. Tighten `sablog` to match the old site; a new theme is a later, complete job.
|
|
|
|
## Media library (xpier)
|
|
|
|
- Package: `xpier/filament-media-library` (admin Media Library + MediaPicker).
|
|
- **Markdown body must store `` or `[name](media:ID)`**, never a CDN/object-storage URL. HTML uses `[media=ID]`.
|
|
- Insert flow: pick a file → **Insert into body**. Cover uses `cover_media_id`.
|
|
- Legacy sablog `[attach=ID]` / `{{attach:ID}}` still render from Spatie media.
|
|
- Details: `docs/media.md`.
|