Overview
Personalize your PteroCA installation by managing themes and plugins.
Overview
This section is for administrators who want to customize and extend their PteroCA installation by:
Installing and managing themes
Installing and managing plugins
Configuring theme settings
Configuring plugin settings
Customization Options
Themes
Change the visual appearance of your PteroCA panel:
Configure theme appearance via Admin Panel → Settings → Appearance:
Select active theme
Upload logo and favicon
Customize colors
Configure dark mode
Set MOTD (Message of the Day)
Install and switch between themes:
Browse available themes
Install themes from marketplace
Upload custom themes
Switch active theme
Configure theme-specific settings
Plugins
Extend PteroCA functionality with plugins:
Configure installed plugins via Admin Panel → Settings → Plugins:
Plugin-specific configuration options
Enable/disable plugin features
API keys for plugin integrations
Install and manage plugins:
Browse plugin marketplace
Install plugins
Enable/disable plugins
Configure plugin settings
Update plugins
Uninstall plugins
Getting Started
To customize your theme:
Navigate to: Admin Panel → Settings → Appearance
Upload your logo and favicon
Customize colors to match your brand
Save changes
To install a plugin:
Navigate to: Admin Panel → Plugins
Browse available plugins
Click "Install" on desired plugin
Configure plugin settings
Enable the plugin
Safety and Best Practices
Before installing themes or plugins:
✅ Create a backup of your installation
✅ Verify theme/plugin is from a trusted source
✅ Check compatibility with your PteroCA version
✅ Test on a staging environment first (if available)
Managing plugins:
Only install plugins you trust
Keep plugins updated
Disable unused plugins
Review plugin permissions
Theme customization:
Test theme changes before going live
Keep custom logos and favicons reasonably sized
Ensure color contrast meets accessibility standards
Plugin Permissions
Some plugins require specific permissions to function. After installing a plugin:
New permissions may appear in the permission list
Assign plugin permissions to relevant roles
See Access Control for managing permissions
Troubleshooting
Common issues:
Plugin won't enable: Check error logs and PHP requirements
Theme not applying: Clear cache and refresh browser
Logo not displaying: Check file size and format (PNG, JPG, SVG)
Plugin settings not saving: Verify file permissions
For detailed troubleshooting, see individual pages.
For Developers
Want to create your own themes or plugins?
See For Developers:
Related Documentation
Access Control - Permissions for plugin/theme management
Core Configuration - System settings
For Developers - Creating themes and plugins
Last updated