Blog Settings – Admin User Guide (UI-Driven)

The Blog Settings module allows administrators to configure behavior, performance, SEO, content display, and features of the blog from a single, well-organized interface.

All changes are database-driven, cached, and applied instantly across the website.

Page Overview

When you open Admin → Blog → Settings, you will see:

1. Page Header

• Title: Blog Settings

• Description: Configure blog module settings and behavior

• Global Actions (Top-Right):

  • Clear Cache
  • Sync from Config

These actions affect all blog settings, not just the current category.

Important Info Banner

At the top of the page:

About Blog Settings
Blog settings are stored in the database and automatically synced with the config file.
Changes take effect immediately and are cached for optimal performance.
Use Clear Cache after making changes to ensure they are applied everywhere.

What this means for admins

• You don’t need to deploy or edit config files
• Settings are safe for shared hosting
• Cache ensures fast performance

Layout Structure

The settings screen is divided into two main sections:

Left Sidebar – Settings Categories

Right Panel – Settings Form

Settings Categories (Sidebar Navigation)

The left sidebar lists all available categories with icons for quick recognition:

Active Category

• Highlighted visually
• Loaded instantly on click
• URL updates with ?category=xyz

Empty Category State

If no settings exist for a category, you’ll see:

No Settings Found
Click Sync from Config to initialize settings.

When to use Sync from Config

• First-time setup
• After developers add new settings in code
• If settings were deleted accidentally

Settings Form (Right Panel)

Each category opens a dedicated settings form.

Header Section

Displays:

• Category name
• Short description
• Reset to Defaults button

⚠ Reset requires confirmation and affects only the active category.

Field Types & How to Use Them

1. Boolean (Toggle Switch)

Used for enable/disable options.

• Example: Blog Enabled, Comments Enabled
• Default label: Enable
• Saves true / false safely

✔ Automatically handles unchecked state

2. Select Dropdown

Used when predefined values exist.

• Example: Search Driver
• Options are dynamically loaded
• Only valid values can be saved

3. Number Fields

Used for limits, TTL, thresholds.

• Minimum value enforced (>= 0)

• Auto step:

  • 0.1 for thresholds
  • 1 for counts

Examples:

• Cache TTL
• Spam Threshold
• Posts Per Page

4. Text & Textarea Fields

Used for:

• Titles
• Descriptions
• URLs
• RSS content

Textarea is used for longer content automatically.

5. Image Upload Fields (Advanced)

Used for:

• Featured images
• Default blog images
• Visual content settings

What admins can do:

• Upload image (JPEG, PNG, GIF, WebP)
• Preview image instantly
• Replace image
• Remove image

Behind the scenes:

• Max size: 10MB
• Auto optimization
• Auto WebP conversion
• Thumbnail generation
• Stored as relative path only

✔ Fully CDN & cache friendly
✔ No full URLs stored in DB

Image Preview Behavior

• Hover image → Remove button appears
• Removing image does NOT save immediately
• You must click Save Settings

Action Buttons (Bottom)

Cancel

• Takes you back to Blog Posts list
• Discards unsaved changes

Save Settings

• Validates all fields
• Casts values by type
• Syncs settings to config
• Clears Laravel cache
• Applies changes instantly

💡 A confirmation message appears after saving.

Global Actions Explained

Clear Cache

Clears:

• Blog settings cache
• Laravel application cache
• Laravel config cache

Use when:

• Changes don’t reflect immediately
• Performance issues appear
• Debugging settings behavior

Sync from Config

Imports default settings from system configuration.

Safe for:

• Shared hosting
• Production use

Does NOT overwrite existing values unless missing.

Reset to Defaults (Category-Only)

• Resets only the active category
• Uses built-in default values
• Logs the reset action
• Clears cache automatically

⚠ Cannot be undone

After reset:

• Page auto-reloads to ensure fresh data

Notifications & Alerts

• Success, warning, and error messages
• Auto-dismiss after 5 seconds
• Upload actions show toast notifications

Examples:

• “Settings updated successfully”
• “Image uploaded and optimized”
• “Cache cleared successfully”

Performance & Safety Notes

✔ All settings are cached
✔ DB-driven, no file permissions needed
✔ Config sync handled automatically
✔ Shared-hosting friendly
✔ Full error logging enabled

Best Practices for Admins

✅ Change one category at a time
✅ Clear cache after major updates
✅ Use reset carefully
✅ Optimize image sizes before upload
✅ Test SEO & RSS after changes

Summary

The Blog Settings module provides:

• Fine-grained control
• Modern UI with previews
• High performance caching
• Safe shared-hosting compatibility
• Developer & admin friendly workflow

This system ensures your blog remains fast, flexible, and scalable without touching code.