MicroBlog-GeneralManager

[English] [简体中文]

A personal microblog manager with preset universal templates for online management of your blog and dynamic generation of static web pages.

📖 View Detailed Help

Features

• Online blog management: Create, edit, copy, and delete blogs through the admin panel
• Static page generation: Support for standalone SPA mode and template-dependent mode
• Template system: Customizable blog templates for generating unified-style pages
• Permission management: Flexible permission control mechanism
• Secure authentication: Token-based user authentication mechanism
• Pure frontend display: Blog homepage is purely static, no backend required

Quick Start

Requirements

• PHP 7.4+ (with SQLite3 extension enabled)
• Web server (Apache, Nginx) or PHP built-in server

Installation

1. Clone the repository

   git clone https://github.com/JularDepick/MicroBlog-GeneralManager.git
   cd MicroBlog-GeneralManager

2. Start local development server

   php -S localhost:11378 -t src/

   Database will be automatically created on first API request.

3. Access the admin panel

   • Admin panel: http://localhost:11378/mgr/
   • Blog homepage: http://localhost:11378/

Usage

1. Configure Admin Account

Edit src/mgr/api/account.php and use pwd.html tool to generate password hash:

1. Visit http://localhost:11378/mgr/pwd.html
2. Enter salt, username, and password
3. Click "Generate Hash"
4. Copy the hash to account.php

2. Login to Admin Panel

1. Open http://localhost:11378/mgr/
2. Enter configured username and password
3. Click "Login"

3. Create Blog

1. Click "New Blog" button
2. Fill in title, topics (optional), select template and generation mode
3. Enter blog content (supports Markdown and HTML)
4. Click "Create"

4. Generate Static Page

1. Click "Generate" button in the blog list
2. Wait for generation to complete
3. Click the ID link to view the generated blog

5. Visit Blog Homepage

Open http://localhost:11378/ to view all generated blogs.

Tech Stack

• Frontend: HTML + CSS + JavaScript (ES6 Modules)
• Backend: PHP
• Database: SQLite3
• Authentication: SHA-512 hashing + Token mechanism

Project Structure

MicroBlog-GeneralManager/
├── src/                          # Source code directory
│   ├── index.html                # Blog homepage
│   ├── main.js                   # Blog homepage logic
│   ├── style.css                 # Blog homepage styles
│   ├── mgr/                      # Admin panel
│   │   ├── index.html            # Admin frontend entry
│   │   ├── main.js               # Admin frontend logic
│   │   ├── style.css             # Admin frontend styles
│   │   ├── pwd.html              # Password hash tool
│   │   ├── blank/                # Blank template files
│   │   │   └── default/          # Default template
│   │   └── api/                  # Admin PHP API
│   │       ├── .config.php       # Site configuration
│   │       ├── account.php       # Account configuration
│   │       ├── sqlite-db/        # SQLite database directory
│   │       └── *.php             # API endpoints
│   ├── pages/                    # Generated blog pages
│   └── temp/                     # Temporary generation directory
├── AGENTS.md                     # Agent development guidelines
├── HELP.md                       # Detailed usage help
├── README_zh-CN.md               # Chinese README
├── README.md                     # English README
├── COPYRIGHT                     # Copyright notice
├── LICENSE                       # License
├── COMMERCIAL.md                 # Commercial license info
└── .gitignore                    # Git ignore config

License

This project is licensed under AGPL-3.0-or-later.

Copyright © 2026 JularDepick, see COPYRIGHT for details.