PanelAlpha Documentation
Back Home
Live Demo Get Started

Client Area Functionality

Documentation

    # Client Area Functionality

    • Issues Logging into WP-Admin
    • Unauthorized or Not Authorized Message in Client Area
    • Visitors and Bandwidth Not Calculated
    • Instance Details Are Outdated or Out of Sync
    • Instance Preview Not Available
    • Domain Does Not Point to the Instance
    • Custom Logo Image

    # Issues Logging into WP-Admin

    Problem: The following error appears when trying to log into WP-Admin:

    Warning: The package could not be installed. 'No valid plugins were found.' Plugin update failed.
    Warning: The '/home//.panelalpha/.../controlpanel-sso.zip' plugin could not be found.
    

    Solution: This error occurs when the Control Panel Connection must-use plugin is missing or corrupted. Run the following command on the PanelAlpha server:

    docker compose -f /opt/panelalpha/app/docker-compose.yml exec api php artisan connectors:build
    

    The SyncWordPressData job will automatically reinstall the must-use plugin during its next daily run. To force immediate installation, manually trigger the synchronization or wait for the scheduled job.

    # Unauthorized or Not Authorized Message in Client Area

    Problem: Users see an Unauthorized or Not authorized message in the Client Area.

    Solution: Check the plan configuration under Plan → Other → Disable privileges for the affected plan. If this option is enabled, disable it and test access again.

    # Visitors and Bandwidth Not Calculated

    Problem: The number of website visitors and bandwidth is not calculated or displayed in the instance details.

    Solution: When using PanelAlpha Engine, visitor and bandwidth data will not display unless you configure the Matomo or Google Analytics integrations.

    # Instance Details Are Outdated or Out of Sync

    Problem: Instance details do not reflect the actual state of the WordPress installation.

    Solution: Run the synchronization command on your PanelAlpha server to refresh instance details:

    docker compose -f /opt/panelalpha/app/docker-compose.yml exec -T api php artisan applications:sync-installation-details {id?}
    

    Parameters:

    • {id?} (optional): Specific instance ID to sync. If omitted, all instances will be synchronized.

    # Instance Preview Not Available

    Problem: The website preview in the "My Instances" section shows "Preview not available."

    Solution: Enable and configure the Google PageSpeed Insights integration. For more information, see the Google PageSpeed Insights documentation.

    # Domain Does Not Point to the Instance

    Problem: The domain does not point to the server after instance creation.

    Solution:

    1. Check if a "DNS propagation is in progress" message appears in the Client Area.
    2. Click the message for instructions on properly mapping your domain to the server.

    # Custom Logo Image

    Problem: The logo appears pixelated. What are the standard dimensions for the logo?

    Solution: The recommended dimensions for the PanelAlpha logo are 271x60 pixels. To prevent pixelation, use an .svg file, which scales without losing quality.