Ultimate · Document Theme User Manual
🎯 Theme Overview
Theme Introduction
Jizhi·Doc Theme is a professional-grade document theme designed for Z-BlogPHP, especially suitable for scenarios like technical documentation, knowledge bases, and product manuals. The theme adopts a modern design language, offering rich customization options and an excellent user experience.
Applicable Scenarios
| Scenario Type | Applicability | Configuration Focus |
|---|---|---|
| Technical Documentation | ⭐⭐⭐⭐⭐ | Multi-level categories, infinite scroll loading, sorting system |
| Knowledge Base | ⭐⭐⭐⭐⭐ | Search optimization, category navigation, related content |
| Product Manual | ⭐⭐⭐⭐ | Clear directory structure, responsive layout |
| Personal Blog | ⭐⭐⭐⭐ | Donation system, personalized settings |
| Enterprise Website | ⭐⭐⭐ | SEO optimization, brand display |
🚀 Installation and Configuration
Installation Steps
Download Theme: Get the theme from the official application center
Activate Theme: Z-Blog Backend → Theme Management → Activate Jizhi·Doc Theme
Basic Configuration: Refer to this manual for configuration
Configuration Process Recommendation
Basic Settings → SEO Optimization → Homepage Modules → Article System → Advertisement Settings → Other Features
⚙️ Detailed Explanation of Basic Settings
Logo and Brand Settings
Image Logo Configuration
Enable Image Logo: On Logo URL: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/logo.svg Dark Mode Logo: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/nlogo.svg
Text Logo Configuration
Enable Image Logo: Off Logo Icon: fas fa-book-open Logo Text: DOCSTHEME
Icon Usage Guide
The theme includes Font Awesome 6.7.2 icon library:
| Icon Category | Common Icons | Class Name | Applicable Scenarios |
|---|---|---|---|
| Document Related | Book | fas fa-book | Document Center |
| File Related | File | fas fa-file-alt | Article Pages |
| Navigation Related | Home | fas fa-home | Main Navigation |
| Search Related | Search | fas fa-search | Search Function |
| User Related | User | fas fa-user | User Center |
Avatar System Configuration
QQ Avatar + Random Avatar: On Use First Letter of Random Avatar Filename: On Gravatar Avatar: On
Avatar Display Priority:
QQ Avatar (Email matching QQ number)
Gravatar Avatar (Email registration)
Random Avatar (First letter of username)
System Default Avatar
Time Display Settings
| Setting Item | Option | Display Effect | Recommended Scenario |
|---|---|---|---|
| List Time Setting | YYYY-MM-DD | 2024-01-15 | Formal documents |
| List Time Setting | YYYY-MM-DD HH:MM:SS | 2024-01-15 14:30:25 | News and information |
| List Time Setting | XXX ago | 3 days ago | Blog and social media |
| Article Time Setting | Same as above options | Same as above effect | Article pages |
Pagination Method Configuration
| Mode | Configuration Value | User Experience | Applicable Scenarios |
|---|---|---|---|
| Default Pagination | 0 | Traditional and clear | Less content |
| Manual Load | 1 | Modern and controllable | Most websites |
| Automatic Load | 2 | Smooth and seamless | Content feed |
Article Timeliness Reminder
Recommended Days: >90
Reminder Content: |
This article was last updated {daysDiff} days ago. Please note if the content is still valid.💰 Appreciation and Interaction System
Basic Configuration
Enable Appreciation Button: On Appreciation Text: Appreciate Enable Likes: On Display Related Articles: On
Payment QR Code Settings
WeChat Payment QR Code: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/weipayimg.svg Alipay Payment QR Code: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/alipayimg.svg QQ Payment QR Code: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/qqpayimg.svg
📚 Article System Configuration
Left Navigation Settings
Call Method Selection
| Method | Configuration Value | Applicable Scenarios | Features |
|---|---|---|---|
| Previous and Next N Articles in Current Article | 0 | Tutorial content | Linear reading |
| Fixed N Articles in Category | 1 | Category display | Content recommendation |
| Multi-level Categories | 3 | Document and knowledge base | Complete structure |
Sorting Rule Configuration
Sort Field: Post Time Sort Direction: Ascending Include Subcategories: On Include Top Categories: On Maximum Articles: 99 Multi-level Default Folded: On Drag to Adjust Width: On Directory Icon: On Infinite Scroll Loading: On
Global Article Sorting System
Sort Field Options
| Field | Configuration Value | Applicable Scenarios | Effect |
|---|---|---|---|
| Post Time | log_PostTime | General sorting | Posting order |
| Update Time | log_UpdateTime | Wiki documents | Update order |
| Comment Count | log_CommNums | Community content | Popularity sorting |
| View Count | log_ViewNums | Hot content | Traffic sorting |
| Article ID | log_ID | Special needs | ID order |
| Author ID | log_AuthorID | Multi-author site | Author grouping |
Sort Direction
Descending: Newest content first (DESC)
Ascending: Oldest content first (ASC)
Category-Level Sorting Settings
Each category can have its sorting rules set independently, overriding global settings.
🏠 Homepage Module Configuration
Search Area Configuration
Main Title: "Your Website Main Title" Description: "Describe the website's features and value in a paragraph" Preset Keywords: "Keyword1|Keyword2|Keyword3"
Featured Area Configuration
Module Configuration Parameters Table:
| Parameter | Input Instructions | Example Value |
|---|---|---|
| Enable Module | Controls module display | On |
| Title | Module title text | Latest Announcements |
| Icon | Font Awesome class name | fas fa-bell |
| Link | Click to jump link (optional) | /news |
| Data Source | Content source | Single Category |
| Call Category | Specify category | News and Information |
| Include Subcategories | Whether to include subcategories | On |
| Sorting Rule | Sort direction | Descending |
| Number of Calls | Number of articles to display | 6 |
Category Area Configuration
- Enable: On Icon: fas fa-code Data Source: Category Data Call Category: Technical Documentation Title: Development Documentation Description: Collection of technical documents and tutorials Link: /category/tech
Recommended Reading Area
Icon: fas fa-paperclip Area Title: Recommended Reading Number of Calls: 8
🌐 SEO Optimization Configuration
Basic SEO Settings
Theme SEO Settings: On Site Title: Main Title - Subtitle Keywords: Core Keyword1,Core Keyword2,Core Keyword3 Site Description: Description text within 150 characters, including keywords
Page Title Template
Drag and Drop Sorting Instructions
Drag and drop to adjust the order of title components
Separators will be automatically added between components
Title Configuration for Each Page Type
| Page Type | Recommended Format | Variable Support |
|---|---|---|
| Article Page | Article Title - Category Title - Site Title | |
| Category Page | Category Title - Site Title | |
| Tag Page | Tag Name - Site Title | |
| Page | Page Title - Site Title |
Advanced SEO Features
Feature Switch Table
| Feature | Configuration | Function | Recommended |
|---|---|---|---|
| Other SEO | On | Article-level SEO settings | ✅ |
| Title Separator | - | Title separator symbol | ✅ |
| Automatic Tag Page Description | On | Auto-generate descriptions | ✅ |
| Automatic Category Page Description | On | Auto-generate descriptions | ✅ |
| Image SEO | On | Image alt/title | ✅ |
| Image Lightbox | On | Enlarge images on click | ✅ |
| Search Pretty URLs | On | Optimize search URLs | ✅ |
| Time Factor | On | Baidu time factor | ✅ |
| OG Tags | On | Social media optimization | ✅ |
| Google Structured Data | On | Structured data | ✅ |
Lightbox Control Options
Thumbnail: Display image navigation
Fullscreen: Support fullscreen viewing
Zoom: Support image zooming
Rotate and Mirror: Rotate and mirror operations
📢 Advertisement System Configuration
Ad Slot Location Details
| Ad Slot | Location Description | Best Ad Type | Size Recommendation |
|---|---|---|---|
| Homepage Ad Slot A | Between Search and Featured modules | Brand Banner | |
| Homepage Ad Slot B | Between Featured and Category modules | Product Promotion | |
| Homepage Ad Slot C | Between Category and Recommended modules | Content Recommendation | |
| List Top Ad Slot | Top of list pages | Category Related | |
| List Bottom Ad Slot | Bottom of list pages | Related Recommendations | |
| List Random Ad Slot | Randomly within article lists | Native Ads | Adaptive |
| Ad Slot Above Article | Below article title | Content Related | |
| Ad Slot Below Article | Below article content | Call to Action |
Ad Code Examples
Banner Ad Code
Ad Slot: Set ad code in backend
🎥 Video Function Configuration
Basic Video Settings
Enable Video Playback: On M3U8 Support: On Maximum Video Width: 420px Player Logo: http://yourdomain.com/zb_users/theme/Jz52_docs/style/images/videologo.png
Video Embedding Methods
Local Video Embedding:
Publish an article and upload or enter the video file address
Online Video Embedding:
Publish an article and enter the video website embed code
⚡ Other Function Configuration
Theme Night Mode Settings
Default Night Mode: Off Scheduled Night Mode Activation: 22:00-06:00
Wide and Narrow Screen Switching
Default Wide Screen: On Maximum Wide Screen Width (Homepage, List Pages): 1400px Maximum Wide Screen Width (Article Page): 100%
Width Unit Support:
px: Fixed pixels (1200px)
vw: Viewport width (80vw)
%: Percentage (90%)
Customization Features
Custom CSS: | /* Custom style code */ Header Additional Code:
🛠️ Practical Tools and Tips
Built-in Icon Usage
The theme includes the free version of Font Awesome 6.7.2. For complete class names, refer to: Font Awesome Icon Library
Browser Icon Settings
Prepare a 32x32 pixel favicon.ico file
Generate using online tools: Transparent ICO Generator
Upload to the website's root directory
It will be automatically recognized and displayed
Navigation Menu Settings
Desktop Navigation Icons
Enable the "Link Module Management" plugin
Module Management → Navigation Bar → Edit
Enter the Font Awesome class name in the "Icon" field
Submit and save
Mobile Navigation Settings
Enable the "Link Module Management" plugin
Module Management → Doc Theme Mobile Menu
Configure menu items and submit
💡 Reference Configuration Practices
Scenario-Based Configuration Solutions
Technical Documentation Website
Basic Settings: Pagination Setting: Manual Load Time Display: XXX ago Left Navigation: Multi-level Categories Sorting: Post Time Ascending Homepage Modules: Search Area: Technical Documentation Search Featured Area: Latest Updates + Popular Tutorials Category Area: Complete Technical Categories
News and Information Website
Basic Settings: Pagination Setting: Automatic Load Time Display: YYYY-MM-DD HH:MM:SS Left Navigation: Fixed N Articles in Category Sorting: Post Time Descending Homepage Modules: Search Area: News Search Featured Area: Headline News + Hot Topics
Personal Knowledge Base
Basic Settings: Pagination Setting: Default Pagination Time Display: XXX ago Left Navigation: Multi-level Categories + Infinite Scroll Loading Appreciation System: On
SEO Optimization Strategy
New Website Configuration
Site Title: Brand Name - Brand Slogan Keywords: Core business keywords Site Description: 150-character description highlighting unique features Enable basic SEO features
Established Website Configuration
Enable all advanced SEO features Set default OG image Configure structured data Enable time factor
Advertising Placement Strategy
Traffic Distribution Strategy
| Page Type | Number of Ad Slots | Ad Type |
|---|---|---|
| Homepage | 1-2 | Brand Banner, Product Promotion |
| List Pages | 1-2 | Category Related, Native Ads |
| Article Pages | 1-2 | Content Related, Call to Action |
User Experience Optimization
Control ad quantity on important pages
Use native ads to enhance experience
Avoid pop-up ads
⚠️ Important Notes
Performance Optimization Suggestions
| Configuration Item | Suggestion | Reason |
|---|---|---|
| Include Subcategory Data | Turn off when categories are many | Reduce database queries |
| Generate Thumbnails | Enable as needed | Affects performance with a large number of articles |
| Number of Calls | Set reasonably | Avoid slow loading |
| Automatic Load | Use with caution for large amounts of content | May affect performance |
Compatibility Notes
| Feature | Requirement | Description |
|---|---|---|
| Infinite Scroll Loading | JavaScript support | Supported by modern browsers |
| Image Lightbox | Image SEO enabled | Dependency |
| Comment IP Geolocation | qqwry.dat file | Needs to be downloaded to the root directory |
Security Reminders
Header Additional Code: Do not insert untrusted code
Custom CSS: Avoid layout conflicts
Clear Configuration: Always back up before operating
🔧 Troubleshooting Guide
Common Problem Resolution
| Problem Phenomenon | Possible Cause | Solution |
|---|---|---|
| Configuration not taking effect | Browser cache | Clear cache and force refresh |
| Abnormal display | CSS conflict | Check custom CSS |
| Functionality abnormal | Dependencies not enabled | Confirm feature enabled status |
| Images not displaying | Incorrect path | Check if image URL is correct |
Problem Diagnosis Steps
Check if the configuration was saved successfully
Test by clearing browser cache
Check browser console for errors
Check file permission settings
Review system error logs
Obtaining Technical Support
If you encounter unsolvable issues, please provide:
Order Number
Theme Version Number
Z-BlogPHP Version Number
Detailed problem description
Error screenshots or logs
Steps to reproduce
Article link: https://docs.zbp.cool/lldocs/49.html
Helpful?
2025-10-20 09:04:36