👑 Administrator Guide

Complete guide to managing your Xiuno BBS forum

Getting Started

Accessing the Admin Panel

Navigate to https://xiuno.wiki/admin/ and login with your administrator credentials.

Admin Dashboard Overview

The admin panel provides access to:

• Dashboard: Site statistics and quick actions
• Forums: Manage forum categories and structure
• Users: User management and permissions
• Groups: User role configuration
• Settings: Site configuration
• Plugins: Plugin management
• Themes: Theme customization
• Moderation: Content moderation tools

Forum Structure Management

Creating Forum Categories

Recommended Forum Structure

📚 Documentation
   ├── 📖 Getting Started
   ├── ⚙️ Configuration
   └── 🔧 Troubleshooting

💾 Downloads
   ├── 📦 Releases
   ├── 🧩 Plugins
   └── 🎨 Themes

💬 Community
   ├── 📢 Announcements
   ├── 💭 General Discussion
   ├── 🐛 Bug Reports
   └── 💡 Feature Requests

🛠️ Development
   ├── 🔌 Plugin Development
   ├── 🎨 Theme Development
   └── 🔗 API & Integration

User Management

User Administration

Navigate to Admin Panel → Users

Common User Operations

User Groups

Navigate to Admin Panel → Groups

Default Groups

Creating Custom Groups

Content Moderation

Thread Management

Navigate to Admin Panel → Moderation → Threads

Moderator Actions

• Pin Thread: Keep thread at top of forum
• Lock Thread: Prevent new replies
• Move Thread: Transfer to different forum
• Merge Threads: Combine duplicate discussions
• Delete Thread: Remove thread and all replies
• Highlight: Add color highlight to important threads

Post Moderation

For individual posts in a thread:

• Edit: Fix typos or formatting
• Delete: Remove spam or inappropriate content
• Soft Delete: Hide from users but keep in database
• Report: Flag for admin review

Site Settings

General Settings

Navigate to Admin Panel → Settings → General

Registration Settings

Navigate to Settings → User Registration

Anti-Spam Options

• Email Verification Require users to verify email before posting
• CAPTCHA Prevent automated registrations
• Admin Approval Manually approve new registrations
• Invite Only Closed registration with invite codes

SEO Settings

// In conf/conf.php
'urlrewrite' => 1,              // Enable friendly URLs
'url_rewrite_suffix' => '.html', // Add .html suffix
'sitename' => 'Xiuno Wiki',     // Meta title
'sitebrief' => 'Open source BBS',  // Meta description
'sitekeywords' => 'forum,wiki,xiuno', // Meta keywords

Plugin Management

Installing Plugins

Managing Plugins

Theme Customization

Changing Themes

Navigate to Admin → Themes

1. Browse available themes
2. Click "Preview" to see demo
3. Click "Activate" to apply theme
4. Clear cache: rm -rf tmp/*

Custom CSS

Add custom styles in Admin → Themes → Custom CSS:

/* Custom purple theme */
:root {
    --primary-color: #667eea;
    --secondary-color: #764ba2;
}

.header {
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
}

.btn-primary {
    background: var(--primary-color);
    border: none;
}

Backup & Maintenance

Automated Backups

Create a backup script: /home/xiuno/backup.sh

#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/home/xiuno/backups"

# Database backup
mysqldump -u xiuno -p'your_password' xiuno > $BACKUP_DIR/db_$DATE.sql

# Files backup
tar -czf $BACKUP_DIR/files_$DATE.tar.gz /home/xiuno/public_html

# Delete old backups (keep 30 days)
find $BACKUP_DIR -name "*.sql" -mtime +30 -delete
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete

echo "Backup completed: $DATE"

Schedule with cron:

# Daily backup at 2 AM
0 2 * * * /home/xiuno/backup.sh >> /home/xiuno/backup.log 2>&1

Maintenance Mode

To enable maintenance mode, create file: tmp/maintenance.lock

touch tmp/maintenance.lock

Visitors will see a maintenance message. Remove file to restore access.

Database Optimization

Run weekly maintenance:

mysql -u xiuno -p
USE xiuno;

OPTIMIZE TABLE bbs_thread;
OPTIMIZE TABLE bbs_post;
OPTIMIZE TABLE bbs_user;
ANALYZE TABLE bbs_thread;
ANALYZE TABLE bbs_post;

Security Best Practices

Restricting Admin Access

Add to .htaccess in admin/ directory:

# Allow only specific IP addresses
Order Deny,Allow
Deny from all
Allow from 123.456.789.0  # Your IP
Allow from 192.168.1.0/24 # Local network

Performance Monitoring

Site Statistics

Check in Admin → Dashboard:

• Total users, threads, posts
• Daily active users
• New registrations
• Database size
• Cache hit ratio

Performance Tips

1. Enable Redis: Significantly faster than MySQL cache
2. Enable Gzip: Reduce bandwidth usage
3. Optimize Images: Compress uploads automatically
4. CDN: Use CloudFlare for static assets
5. Database Indexing: Already optimized automatically