Installation

Prerequisites

Before installing WyvernPress, ensure your WordPress site meets these requirements:

• WordPress: Version 6.0 or higher
• PHP: Version 8.1 or higher
• MySQL: Version 5.7 or higher (or MariaDB 10.3+)
• HTTPS: Recommended for production sites
• Memory: At least 128MB PHP memory limit (256MB recommended)

Installation Methods

Method 1: Install from WordPress.org (Recommended)

This is the easiest way to install WyvernPress and ensures you receive automatic updates.

1. Log in to WordPress Admin

   • Navigate to your WordPress admin dashboard
   • URL: https://yoursite.com/wp-admin

2. Access the Plugin Installer

   • Go to Plugins → Add New Plugin
   • You’ll see the WordPress plugin directory

3. Search for WyvernPress

   • In the search box (top right), type “WyvernPress”
   • The WyvernPress plugin should appear in the results

4. Install the Plugin

   • Click the Install Now button next to WyvernPress
   • WordPress will download and install the plugin automatically
   • Wait for the installation to complete (usually 5-10 seconds)

5. Activate WyvernPress

   • Once installed, the button changes to Activate
   • Click Activate to enable WyvernPress on your site
   • You’ll see a success message confirming activation

Method 2: Manual Upload

If you have the WyvernPress ZIP file or need to install on a site without direct WordPress.org access:

1. Download the Plugin

   • Download the WyvernPress ZIP file from WordPress.org or your purchase location
   • Save it to your computer (e.g., wyvernpress-core.zip)

2. Upload via WordPress Admin

   • Go to Plugins → Add New Plugin
   • Click the Upload Plugin button at the top
   • Click Choose File and select the ZIP file
   • Click Install Now

3. Activate the Plugin

   • After upload completes, click Activate Plugin
   • WordPress will redirect you to the Plugins page

Method 3: FTP/SFTP Upload

For advanced users or when WordPress upload limits are restrictive:

1. Extract the ZIP File

   • Unzip wyvernpress-core.zip on your local computer
   • You should see a folder named wyvernpress-core

2. Connect via FTP/SFTP

   • Use an FTP client (FileZilla, Cyberduck, etc.)
   • Connect to your web server using your FTP credentials
   • Navigate to /wp-content/plugins/

3. Upload the Plugin Folder

   • Upload the entire wyvernpress-core folder to /wp-content/plugins/
   • Ensure all files are transferred successfully

4. Activate via WordPress Admin

   • Go to Plugins → Installed Plugins
   • Find “WyvernPress” in the list
   • Click Activate

Initial Setup

After activation, WyvernPress needs minimal configuration to get started:

Step 1: Verify Installation

1. Go to Settings → WyvernPress in your WordPress admin
2. You should see the WyvernPress settings page
3. Verify the plugin version number is displayed

Step 2: Configure API Settings (Optional)

For basic CSS styling using the Pattern Library, no API configuration is needed. For advanced AI-powered styling:

1. Navigate to Settings → WyvernPress → AI Settings
2. Choose your AI provider:
   • Pattern Library Only (Free, default): Uses built-in patterns only
   • OpenRouter Integration (Paid): Enables AI-powered complex styling

Setting Up OpenRouter (Optional)

If you want AI-powered styling beyond the pattern library:

1. Create an account at OpenRouter.ai
2. Generate an API key from your OpenRouter dashboard
3. Copy the API key (starts with sk-or-v1-)
4. In WyvernPress settings, paste your API key
5. Select your preferred AI model (Claude 3.5 Sonnet recommended)
6. Click Save Settings

Note

Pattern Library is Free: 60% of styling requests are handled by the built-in Pattern Library without any API calls. You can use WyvernPress effectively without any AI service costs.

Step 3: Test the Installation

1. Create or edit any post or page
2. Add or select any Gutenberg block
3. Look for the WyvernPress icon in the block toolbar or sidebar
4. Click to open the WyvernPress styling panel

If you see the WyvernPress panel, installation is successful!

Troubleshooting

Plugin Won’t Activate

Problem: Error message when trying to activate WyvernPress.

Solutions:

• Verify PHP version is 8.1 or higher (check with your hosting provider)
• Ensure WordPress is version 6.0 or higher
• Deactivate conflicting plugins (especially other CSS or block editor plugins)
• Check error logs: Tools → Site Health → Info → Error Log

WyvernPress Panel Not Showing

Problem: Can’t find WyvernPress in the block editor.

Solutions:

• Refresh your browser (Ctrl+F5 or Cmd+Shift+R)
• Clear WordPress cache if using a caching plugin
• Ensure JavaScript is enabled in your browser
• Check browser console for errors (F12 → Console tab)

API Key Invalid Error

Problem: “Invalid API key” error when using AI styling.

Solutions:

• Verify the API key is copied correctly (no extra spaces)
• Ensure the key starts with sk-or-v1-
• Check your OpenRouter account has available credits
• Try regenerating the API key in OpenRouter dashboard

Memory Limit Errors

Problem: “Allowed memory size exhausted” errors.

Solutions:

• Increase PHP memory limit in wp-config.php:

  define('WP_MEMORY_LIMIT', '256M');

• Contact your hosting provider to increase the memory limit
• Deactivate unused plugins to free up memory

Updating WyvernPress

Automatic Updates (Recommended)

WordPress will notify you when updates are available:

1. Go to Dashboard → Updates
2. Find WyvernPress in the plugins list
3. Click Update Now
4. WordPress will update the plugin automatically

Manual Update

1. Deactivate WyvernPress (but don’t delete it)
2. Download the latest version from WordPress.org
3. Delete the old plugin folder via FTP or File Manager
4. Upload the new version using any installation method above
5. Reactivate the plugin

Backup First: Always backup your site before updating plugins. Use a backup plugin like UpdraftPlus or contact your hosting provider.

Uninstalling WyvernPress

If you need to remove WyvernPress:

Safe Uninstall (Preserves Data)

1. Go to Plugins → Installed Plugins
2. Find WyvernPress
3. Click Deactivate
4. Plugin remains installed but inactive

Complete Removal

1. Deactivate WyvernPress first
2. Click Delete next to the plugin name
3. WordPress will remove all plugin files
4. Your applied CSS styles will remain in your content (they’re part of your posts/pages)

Note

CSS Styles Persist: Any CSS you’ve applied to blocks will remain in your content even after uninstalling WyvernPress. The styles are saved as block attributes, not dependent on the plugin.

Next Steps

Now that WyvernPress is installed, you’re ready to start styling!

• Quick Start: Style your first block in 2 minutes →
• Basic Usage: Learn pattern library and AI styling →
• Pattern Library: Browse available CSS patterns →

Getting Help

Need assistance?

• Documentation: Browse our complete documentation
• Support Forum: Visit the WordPress.org support forum
• Premium Support: Email [email protected] (Premium tier only)