Troubleshooting

Solutions to common issues you may encounter with SkunkPages.

Installation Issues

Plugin Won't Upload

Symptom: Error message "The uploaded file exceeds the upload_max_filesize directive"

Cause: PHP upload limit is too small

Solutions:

1. Contact your hosting provider to increase the limit
2. Use FTP installation method instead
3. Use WP-CLI: wp plugin install /path/to/skunkpages.zip

Plugin Won't Activate

Symptom: Activation fails with error message

Common Causes & Solutions:

PHP Version Too Old

• Check: php -v
• Requirement: PHP 7.4 or higher
• Solution: Ask host to upgrade PHP

WordPress Version Too Old

• Check: Dashboard → Updates
• Requirement: WordPress 6.0+
• Solution: Update WordPress

Plugin Conflict

• Deactivate all other plugins
• Activate SkunkPages
• Reactivate plugins one by one to find conflict

Memory Limit Too Low

• Add to wp-config.php: define('WP_MEMORY_LIMIT', '256M');

Activation Success But No Blocks

Symptom: Plugin shows as active but blocks don't appear

Solutions:

1. Hard refresh browser: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
2. Clear WordPress cache (if using caching plugin)
3. Check if WordPress block editor is enabled
4. Verify you're in the post/page editor (not classic editor)

Block Editor Issues

Blocks Don't Appear in Inserter

Symptom: Can't find SkunkPages blocks when searching

Solutions:

1. Search for "Skunk" or "SkunkPages"
2. Verify plugin is activated
3. Clear browser cache
4. Check JavaScript console for errors (F12)
5. Disable other block plugins temporarily

Can't Insert Blocks

Symptom: Blocks show but clicking does nothing

Solutions:

1. Check browser console for JavaScript errors
2. Disable browser extensions (especially ad blockers)
3. Try a different browser
4. Clear WordPress transients
5. Increase PHP memory limit

Block Settings Panel Missing

Symptom: Can't see block customization options

Solutions:

1. Click the gear icon (⚙️) in top right corner
2. Ensure you've selected the block
3. Try switching to Code Editor and back
4. Clear browser cache

Display Issues

Blocks Look Different on Frontend

Symptom: Blocks look correct in editor but wrong on live site

Common Causes:

Theme CSS Conflicts

• Theme styles override block styles
• Solution: Add custom CSS to increase specificity
• Or: Use !important declarations

Caching Issues

• Old styles are cached
• Solution: Clear all caches (browser, plugin, CDN)

Missing Styles

• Styles didn't load
• Check browser console for 404 errors
• Verify file permissions

JavaScript Not Loading

• Interactive blocks won't work
• Check console for errors
• Verify jQuery is loaded

Blocks Not Mobile Responsive

Symptom: Blocks don't adapt to mobile screens

Solutions:

1. Clear all caches
2. Check if theme has responsive issues
3. Verify viewport meta tag in theme header
4. Test on actual device, not just browser resize
5. Check for custom CSS overriding responsive styles

Images Not Displaying

Symptom: Image placeholders or broken images

Solutions:

1. Verify image was uploaded successfully
2. Check file permissions on uploads folder
3. Ensure image URL is correct
4. Try re-uploading the image
5. Check for CDN or security plugin blocking

Performance Issues

Slow Page Load Times

Causes & Solutions:

Large Images

• Compress images before upload
• Use WebP format
• Enable lazy loading
• Use appropriate image sizes

Too Many Animations

• Limit animations to key sections
• Reduce animation complexity
• Consider disabling on mobile

Heavy Fonts

• Use system fonts when possible
• Limit font weights loaded
• Use font-display: swap

No Caching

• Install caching plugin
• Enable browser caching
• Use CDN if available

Block Editor Slow

Symptom: Editor lags when adding/editing blocks

Solutions:

1. Disable auto-save temporarily
2. Reduce number of blocks per page
3. Increase PHP memory limit
4. Disable other plugins while editing
5. Use distraction-free mode

Compatibility Issues

Conflict with Page Builder

Symptom: Errors when using both SkunkPages and another page builder

Solution:

• Use only one page builder per page
• Create separate pages for each builder
• Or choose one builder to use exclusively

Theme Compatibility

Symptom: Blocks don't work with your theme

Solutions:

1. Verify theme supports Gutenberg/Block Editor
2. Update theme to latest version
3. Contact theme developer
4. Try default WordPress theme (Twenty Twenty-Four) to test
5. Consider switching themes

Plugin Conflicts

Common Conflicting Plugins:

• Other page builders (Elementor, Beaver Builder)
• Old visual editors
• CSS/JS optimization plugins (misconfigured)
• Security plugins (too restrictive)

To Identify:

1. Deactivate all other plugins
2. Activate SkunkPages
3. Reactivate plugins one by one
4. Note which plugin causes the issue

Styling Issues

Custom CSS Not Working

Symptom: Custom styles don't apply

Solutions:

1. Verify CSS syntax is correct
2. Check class names for typos
3. Clear all caches
4. Increase CSS specificity
5. Use !important if necessary
6. Ensure CSS is in the right place

Colors Not Changing

Symptom: Color settings don't affect block

Solutions:

1. Clear caches
2. Check if theme is overriding colors
3. Use browser inspector to identify conflicting styles
4. Try inline styles as test
5. Verify color picker is working

Fonts Not Loading

Symptom: Font doesn't change

Solutions:

1. Verify Google Fonts API is accessible
2. Check for font name typos
3. Clear caches
4. Try different font
5. Check browser console for loading errors

Data & Content Issues

Content Not Saving

Symptom: Changes lost when saving page

Solutions:

1. Check PHP max_input_vars (increase to 3000+)
2. Increase PHP post_max_size
3. Disable autosave conflicting plugins
4. Save more frequently (smaller edits)
5. Check error logs

Block Validation Errors

Symptom: "This block contains unexpected or invalid content"

Solutions:

1. Click "Attempt Block Recovery"
2. If that fails, click "Convert to HTML"
3. Or click "Convert to Classic Block"
4. Re-create the block if necessary
5. Report persistent errors to support

Lost Blocks After Update

Symptom: Blocks missing after plugin update

Solutions:

1. Check if blocks were moved to trash
2. Restore from backup
3. Check database for block content
4. Roll back to previous plugin version temporarily
5. Contact support immediately

Getting Help

If you can't resolve your issue:

Before Contacting Support

Gather this information:

• WordPress version
• PHP version
• SkunkPages version
• Active theme name
• List of active plugins
• Browser and version
• Screenshot of issue
• JavaScript console errors
• PHP error logs

Support Channels

Documentation

• Browse full docs: skunkglobal.com/docs/pages

Community Forum

• Search existing threads: community.skunkglobal.com
• Post new question with details

Email Support

• Premium support: support@skunkglobal.com
• Include all troubleshooting info above

GitHub Issues

• Report bugs: github.com/skunkglobal/skunkpages/issues
• Check existing issues first

Prevention Tips

Regular Maintenance

• Keep WordPress updated
• Keep plugins updated
• Keep theme updated
• Regular backups
• Monitor error logs

Best Practices

• Test major updates on staging site
• Use child theme for customizations
• Document custom changes
• Limit plugin count
• Choose quality themes/plugins

Performance Monitoring

• Use caching
• Optimize images
• Monitor page load times
• Regular database optimization
• CDN for assets

Next Steps

• Installation Guide - Reinstall if needed
• Getting Started - Start over fresh
• Customization - Advanced solutions