Sites Configuration Overview

The Sites Config page in VpAdmin allows you to manage all your websites in one place. Here, you can add new websites, edit existing site configurations, view site details, and even delete websites. It provides a centralized interface to control and customize your online presence.

Adding a New Site

To add a new website:

1. Click "Add New Site": Click the "+ Add New Site" button. A dialog box will appear.

2. Connect to Git: Click either "Connect GitHub" or "Connect GitLab" to authorize VpAdmin to access your repository.

3. Configure Site Settings: Fill in the required information for your new site, including:

   • Site Name: Enter a descriptive name for your site.
   • Theme: Choose a free theme for your website (e.g., VitePress).
   • Username: Auto filled by system.
   • Repo Address: Auto filled by system.
   • Admin Backend: Select "Yes" or "No" to enable or disable the admin panel.
   • Domain: (Optional) Enter a custom domain, or leave the domain as default if you don't have your own. This URL will be used as the callback domain for OAuth configurations. If you need to add third-party OAuth login to your website, please configure the correct URL for your website. Please refer to the OAuths section for details.

4. Click "Confirm" Save the new site configurations, which will trigger the initial website deployment.

   (See the annotated screenshot below for guidance)

   

Editing a Site Configuration:

1. Click "Edit": Click the edit icon next to the site you want to modify.

2. Modify Settings: In the Edit Site Configuration dialog box, you can reconnect to GitHub or GitLab and adjust the domain setting.

3. Click "Confirm": Click the "Confirm" button to save your changes, or "Cancel" to discard them.

   

Viewing Site Details:

1. Click "Details": Click the details icon to view the details about the site.

   

Deleting a Site:

1. Click "Delete": Click the trash icon next to the site you want to delete.
2. Confirm Deletion: In the confirmation dialog, confirm you want to delete the site configuration.
   • Option to delete the related remote repository and website.

   DANGER

   This will take your online website offline and delete it.

   

Searching for a Site

Use the filter at the top of the site list to search for a specific site.

Paging Sites

Use the paging feature to find a specific site if there are too many sites.

Conclusion

The Sites Config page in VpAdmin gives you full control over your websites, enabling you to quickly add, edit, view, and manage your online presence efficiently.