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
For Administrators, Not Developers
This section covers using and managing themes and plugins. If you want to create custom themes or plugins, see For Developers.
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 verified plugins on PteroCA Marketplace
Install plugins via ZIP upload or manual placement
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:
Browse plugins on PteroCA Marketplace
Download plugin ZIP package
Navigate to: Admin Panel → Plugins
Upload plugin ZIP file
Configure plugin settings
Enable the plugin
Discover Extensions on Marketplace
Visit marketplace.pteroca.com to browse:
✅ Security-scanned plugins
✅ Community-reviewed themes
✅ Free and premium extensions
✅ Version-compatible downloads
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