❓ Admin Frequently Asked Questions (FAQ)
This document covers common questions, causes, and checklist items regarding backup/restore, external media storage integration, and dashboard statistics in the admin page.
🗄️ Q1. An error occurs during backup data import (Restore).
Checklist when an error occurs during restore after choosing a backup file.
💡 Core Checklist
- Corrupted Backup File:
- If the text was not saved properly during download, restore may fail. Open the
.jsonfile in a text editor to verify that it has a valid data format.
- If the text was not saved properly during download, restore may fail. Open the
- Menu Path Mismatch:
- You must use the restore menu that matches your data type. Post data must be restored under the
Data Backup & Restoresection of theContent Backupmenu; image media files must be restored under theMedia Backup & Restoresection of theContent Backupmenu; and complete system data must be restored under theFull System Backup & Restoresection of theSite Settingsmenu.
- You must use the restore menu that matches your data type. Post data must be restored under the
- Database (D1) Binding:
- Verify in the Cloudflare management console that your database (D1) connection binding is properly associated.
📂 Q2. Upload or display errors occur after switching the media storage provider.
Analysis of causes when upload errors occur or images are not displayed after switching the storage provider from default KV to R2, Supabase, or ImageKit.
💡 Core Checklist
- Cloudflare R2:
- Verify if the
IMAGESR2 bucket binding is correctly associated in your project settings (wrangler.json).
- Verify if the
- Supabase Storage:
- Check the accuracy of the entered API endpoint (
supabase_storage_url), Service Role Key (supabase_storage_key), and bucket name (supabase_storage_bucket). The bucket's access control list (ACL) must be set to Public for images to be visible externally.
- Check the accuracy of the entered API endpoint (
- ImageKit.io:
- Check the format of the entered endpoint URL (
imagekit_url_endpoint) and inspect cross-origin resource sharing (CORS) settings.
- Check the format of the entered endpoint URL (
- Upload Size Restrictions:
- High-resolution images may fail to upload due to size limitations per request in the edge server environment. Shrink the original image dimensions before uploading.
📊 Q3. Dashboard analytics charts display only demo data.
Checklist when demo data is displayed instead of actual traffic metrics on the main dashboard.
💡 Core Checklist
- Cause: If the Google Analytics 4 (GA4) API credentials/environment variables are missing or incorrect, placeholder demo data is rendered to prevent dashboard crashes.
- Setup Instructions: Add the following environment variables to the Cloudflare Pages settings and redeploy:
GA4_PROPERTY_ID: Google Analytics Property IDGA4_CLIENT_EMAIL: Google Cloud Service Account EmailGA4_PRIVATE_KEY: Google Service Account Private Key
- Google AdSense: If you wish to integrate the AdSense revenue dashboard, verify that the
ADSENSE_ACCOUNT_IDenvironment variable is correctly set.
0 Comments
Login is required to write comments.