SEO Panel Theme Installation & Upgrade Guide — SEO Panel Documentation

Theme Management

SEO Panel Latest Free

Download the latest stable release and get started in minutes.

Download

Theme Installation Process

Themes must be installed manually by uploading files to the server via FTP/SSH.

Manual Theme Installation Steps

  1. Download Theme
    Download the theme from the official SEO Panel themes repository:
    https://www.seopanel.org/themes/
    Save the theme ZIP file to your local computer.

  2. Extract Theme Archive

# Extract the theme ZIP file  
unzip theme-name.zip  
# This will create a theme folder, e.g., 'odbox'
  1. Upload Theme Files
    Upload the extracted theme folder to the /themes/ directory: Via FTP:
# Copy theme to themes directory  
cp -r odbox /var/www/html/seopanel/themes/  
# Set proper permissions  
chown -R www-data:www-data /var/www/html/seopanel/themes/odbox  
find /var/www/html/seopanel/themes/odbox -type d -exec chmod 755 {} \;  
find /var/www/html/seopanel/themes/odbox -type f -exec chmod 644 {} \;
  1. Verify Theme Files
    Ensure the theme directory structure is correct:
seopanel/  
└── themes/  
    └── odbox/  
        ├── theme.php         # Main theme file  
        ├── style.css         # Theme stylesheet  
        ├── images/           # Theme images  
        ├── js/               # JavaScript files (if any)  
        ├── readme.txt        # Theme documentation  
        └── [other files]

  1. Access Theme Manager
    Go to Admin Panel => Themes Manager
    The new theme should appear in the themes list.

  2. Preview Theme (Optional but Recommended)
    Before activating:

  1. Activate Theme
    When ready to switch themes:
  1. Configure Theme Settings
    After activation:
  1. Test Theme Functionality
    Thoroughly test the new theme:
  1. Clear Browser Cache

Clear server-side cache

rm -rf /var/www/html/seopanel/tmp/cache/* 

Also clear browser cache (Ctrl+Shift+Delete) to see changes.

Theme Upgrade Steps

Critical

Theme Upgrade Process

Themes must be upgraded manually by replacing theme files on the server.

Manual Theme Upgrade Steps

  1. Check Current Version
    Go to Admin Panel => Themes Manager
    Note the current version of your active theme.

  2. Backup Current Theme

# Create timestamped backup of current theme  
cd /var/www/html/seopanel/themes/  
cp -r odbox odbox_backup_$(date +%Y%m%d_%H%M%S)  
# Or via FTP: Download the theme folder
  1. Document Custom Changes
    Create a list of any custom modifications:
  1. Export Customizations
    Save any custom code or settings:
# Save custom CSS  
cp odbox/style.css odbox_custom_styles_$(date +%Y%m%d).css  
# Save custom images  
cp -r odbox/images/custom odbox_custom_images_backup/

  1. Download New Version
    Download the latest theme version from:
    https://www.seopanel.org/themes/

  2. Switch to Default Theme (Recommended)
    Go to Admin Panel => Themes Manager
    Activate the default theme temporarily to avoid issues during upgrade.

  3. Replace Theme Files
    Via FTP:

# Remove old theme (backup already created)  
rm -rf /var/www/html/seopanel/themes/odbox  
# Extract and copy new version  
unzip odbox-new.zip  
cp -r odbox /var/www/html/seopanel/themes/  
# Set proper permissions  
chown -R www-data:www-data /var/www/html/seopanel/themes/odbox  
find /var/www/html/seopanel/themes/odbox -type d -exec chmod 755 {} \;  
find /var/www/html/seopanel/themes/odbox -type f -exec chmod 644 {} \;
  1. Reapply Customizations
    Carefully merge your custom changes:
# Review differences between old and new  
diff -r odbox_backup_* odbox/  
# Manually merge custom changes into new theme  
# DO NOT simply copy old files over new ones!
  1. Run Theme Upgrade (If Required)
    Go to Admin Panel => Themes Manager
  1. Reactivate Theme
  1. Verify Upgrade

Theme Compatibility Check

Before installing or upgrading themes:

  1. Check SEO Panel Version
    View your SEO Panel version in the dashboard.

  2. Review Theme Requirements
    Check the theme’s readme.txt for:

    • Minimum SEO Panel version
    • PHP version requirements
    • Browser compatibility
    • Required features or plugins

  3. Check Browser Support
    Ensure the theme supports:

    • Chrome (latest 2 versions)
    • Firefox (latest 2 versions)
    • Safari (latest 2 versions)
    • Edge (latest 2 versions)
    • Mobile browsers

  4. Test Responsive Design
    Preview theme on various screen sizes:

    • Desktop (1920px, 1366px, 1024px)
    • Tablet (768px, 1024px)
    • Mobile (375px, 414px, 360px)

Theme Customization Best Practices

Child Themes (Advanced)
For extensive customizations, consider creating a child theme: 

seopanel/
└── themes/
    ├── parent-theme/          # Original theme
    └── parent-theme-child/    # Your customizations

Custom CSS
Add custom CSS without modifying theme files: 

/* Create custom.css in theme folder */
/* Add your custom styles here */

.custom-header {
    background-color: #your-color;
}

Version Control
Track theme customizations with Git: 

cd /var/www/html/seopanel/themes/your-theme
git init
git add .
git commit -m "Initial theme customization"

Troubleshooting Theme Issues

Issue: Theme doesn’t appear in Theme Manager

Issue: Theme activation fails

Issue: Broken layout after theme activation

Issue: Theme looks different than preview

Issue: Mobile responsive issues

Issue: Theme performance is slow

Theme Security Best Practices

Security Checklist

Theme Optimization Tips

Performance:

Accessibility:

SEO:

Maintenance:

Theme Resources

Popular SEO Panel Themes:

Custom Theme Development

For developers wanting to create custom themes:

Basic Theme Structure: 

mytheme/
├── theme.php          # Theme configuration  
├── style.css          # Main stylesheet  
├── header.php         # Header template  
├── footer.php         # Footer template  
├── sidebar.php        # Sidebar template  
├── functions.php      # Theme functions  
├── images/            # Theme images  
├── js/                # JavaScript files  
└── readme.txt         # Documentation

Theme Configuration (theme.php): 

<?php  
// Theme Name: My Custom Theme  
// Description: A custom theme for SEO Panel  
// Version: 1.0.0  
// Author: Your Name  
// Requires: SEO Panel 4.x or higher  
?>

Development Best Practices: