Skip to content

installation.mdx

Latest commit

 

History

History
103 lines (82 loc) · 3.4 KB

installation.mdx

File metadata and controls

103 lines (82 loc) · 3.4 KB
title Installation
description Install and activate the Aegis theme on your WordPress site

Prerequisites

Before installing Aegis, ensure your environment meets these requirements:

  • WordPress 6.6 or higher
  • PHP 7.4 or higher
  • A modern web browser
Some features may require the latest WordPress version or the [Gutenberg plugin](https://wordpress.org/plugins/gutenberg/) for full functionality.

Installation Methods

Download the latest release from [GitHub Releases](https://github.com/aegiswp/theme/releases). Navigate to **Appearance → Themes → Add New → Upload Theme** in your WordPress admin. Select the downloaded `.zip` file and click **Install Now**, then **Activate**. Download the theme from [GitHub](https://github.com/aegiswp/theme/releases) and extract the `.zip` file. Upload the extracted `aegis` folder to `/wp-content/themes/` on your server. Go to **Appearance → Themes** and activate Aegis. ```bash composer require aegiswp/theme ``` ```bash wp theme install /path/to/aegis.zip --activate ```

Verify Installation

After activation, confirm Aegis is running correctly:

  1. Visit your site's frontend — you should see the default Aegis layout.
  2. Navigate to Appearance → Editor to access the Site Editor.
  3. Check Appearance → Editor → Patterns to browse the included patterns.
Aegis is now installed and ready to use. Visit the [Site Editor guide](/core/site-editor) to start customizing your site.

Updating Aegis

Aegis includes a built-in theme updater that checks for new releases on GitHub. When an update is available:

  1. You'll see a notification in Appearance → Themes
  2. Click Update Now to install the latest version
Always backup your site before updating. If you've made customizations through the Site Editor, your customizations are stored in the database and will persist through updates.

Child Theme

For custom code modifications, use the official Aegis Child Theme rather than editing the parent theme directly. This ensures your customizations survive theme updates.

# Clone the child theme
git clone https://github.com/aegiswp/theme-child.git

# Upload to /wp-content/themes/aegis-child/
# Activate via Appearance → Themes

See the Child Themes guide for detailed instructions.

Troubleshooting

Issue Solution
White screen after activation Ensure PHP 7.4+ and WordPress 6.6+ are installed
Patterns not appearing Clear any caching plugins and check Appearance → Editor → Patterns
Styles not loading Verify the theme folder is named aegis (not aegis-main or similar)
Update not showing The updater requires the repo config in functions.php — do not remove it