Skip to content

CMS Content Engine & Backup Management Guide

Comprehensive guide to managing dynamic content, publications, media uploads, single-file JSON backups, and Raw JSON Overrides in TidyFactor-Go.

1. The CMS Content Engine

TidyFactor-Go includes a full-featured Content Engine module (/content) for managing blog posts, research publications, technical documentation, and news articles.

┌─────────────────────────────────────────────────────────┐
│              Content Engine Architecture                │
└───────────────────────────┬─────────────────────────────┘
                            │
       ┌────────────────────┼────────────────────┐
       ▼                    ▼                    ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Articles &  │     │ Categories & │     │  Media &     │
│ Publications │     │  Content     │     │ Zero-Dep     │
│ (Markdown)   │     │  Taxonomies  │     │ Toolbar      │
└──────────────┘     └──────────────┘     └──────────────┘

Key Capabilities

  • Bilingual Markdown Editor: Supports live markdown preview with zero third-party rendering bloat (MarkdownRenderer.tsx).
  • Dynamic Taxonomies: Categorize articles by Categories, Content Types, and Tags.
  • Mobile Card View: Responsive layout in Admin (ContentManagerSection.tsx) that seamlessly adapts between desktop data tables and touch-friendly mobile card stacks.
  • Subfolder Deep Link Resolution: Action links generate dynamically resolved paths (resolveApiUrl('content/${slug}')) for one-click previews in subfolder hostings.

2. Backup & Recovery System

TidyFactor-Go features an integrated Backup & Recovery system accessible under Admin Dashboard \(\rightarrow\) Backup Manager.

[!NOTE] All CMS site content, page configurations, pricing options, SEO metadata, AND dynamic Content Engine publications are packaged into a single unified JSON backup file.

Backup File Lifecycle & Safety

  1. Manual Backup Generation: Single-click export producing sanitized, timestamped files (e.g., brandname-20260802-141100.json).
  2. Pre-Restore Safety Snapshot: Before any restore operation overwrites the database, an automatic safety backup (site-pre-restore-{timestamp}.json) is saved automatically to prevent accidental data loss.
  3. Automated Backup Rotation: Every content save operation triggers an automated snapshot prune routine, retaining up to 10 maximum backups (BACKUP_MAX_COUNT = 10) to optimize server storage.

3. Raw JSON Override & Core Integrity

Located under Admin Dashboard \(\rightarrow\) Advanced Settings \(\rightarrow\) Raw JSON Editor.

[!CAUTION] The Raw JSON Override tool allows administrators to directly inspect, edit, export, or import the raw site JSON payload. Deleting or hiding this component is strictly prohibited by project operational rules.

Client-Side Validation Rules

When applying a raw JSON payload directly, the system validates: - Presence of all 11 required core database keys: version, updatedAt, home, about, solutions, caseStudies, pricing, contact, seo, header, footer. - Version constraint: version === 1. - UTF-8 string encoding and valid JSON formatting.

4. Media Library & Upload Management

  • Supported Formats: JPEG, PNG, WebP, SVG (Sanitized via enshrined/svg-sanitize), GIF, ICO.
  • Upload Directory: Configured dynamically in Config.php / SQLite config table (UPLOAD_DIR).
  • Unsplash Integration: Built-in Unsplash search integration via cURL proxy endpoint (GET /api/admin/unsplash/search).
  • Image ALT Text: Built-in accessibility and SEO ALT text descriptions bound to media items.