Troubleshooting - Sports Leagues Docs

Quick solutions to common issues with AnWP SL Kit. Run through the checklist first, then find your specific problem below.

🎯 Pre-Flight Checklist

Before troubleshooting, verify these essentials:

Requirement	How to Check
WordPress 6.5+	Dashboard > Updates (version in footer)
PHP 7.4+	Dashboard > Site Health > Info > Server
AnWP Sports Leagues Premium active	Dashboard > Plugins (must show “Active”)
AnWP SL Kit active	Dashboard > Plugins (must show “Active”)
Sports data exists	Sports Leagues menu (teams, players, games created)
Featured images set (for Hero Slider)	Posts > All Posts (featured image column)
Browser cache cleared	Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Site cache cleared	Your caching plugin’s admin panel

🚨 Common Errors

“Parent Plugin Not Found” Error

Symptom: Error message on plugin activation or admin notice.

Cause: AnWP Sports Leagues Premium is not installed or activated.

Solution:

1. Install AnWP Sports Leagues Premium first
2. Activate Sports Leagues Premium
3. Then activate AnWP SL Kit
4. Refresh page

“Fatal Error: Class Not Found”

Symptom: White screen or fatal error mentioning AnWP classes.

Cause: Plugin files are corrupted or incomplete.

Solution:

1. Deactivate AnWP SL Kit
2. Delete plugin from server
3. Re-download plugin ZIP
4. Re-upload and activate

JavaScript Console Errors

Symptom: Browser console shows errors (F12 > Console tab).

Error	Solution
Uncaught ReferenceError: Swiper is not defined	Whitelist anwp-swiper.min.js in security plugin settings, or disable JavaScript optimization temporarily
Cannot read property of undefined	Re-save the page/post, then clear browser and site cache

See the official WordPress JavaScript Debugging Guide for detailed instructions.

🧩 Blocks Not Appearing

Blocks Missing from Inserter

Symptom: Can’t find SL Kit Blocks category or individual blocks.

Solutions:

1. Verify Plugin Activation – Dashboard > Plugins – Ensure “AnWP SL Kit” shows “Deactivate” link (not “Activate”)
2. Clear Browser Cache – Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac). Try incognito/private window
3. Check Block Editor Version – Ensure using Gutenberg (block editor), not Classic Editor
4. Disable Conflicting Plugins – Deactivate all other plugins temporarily, then re-activate one-by-one to find conflict
5. Check User Permissions – User must have edit_posts capability
6. Re-register Blocks – Deactivate AnWP SL Kit, activate again, clear cache, refresh editor

Category Shows But Blocks Empty

Symptom: “SL Kit Blocks” category appears but has no blocks inside.

Cause: JavaScript not loading or block registration failed.

Solution:

1. Check browser console for errors (F12)
2. Verify block JS file exists in plugin directory
3. Clear all caches
4. Reinstall plugin

👁️ Preview Issues

Block Doesn’t Preview in Editor

Symptom: Block shows loading spinner or blank in editor.

Cause: Server-side rendering (SSR) issue.

Solutions:

1. Check REST API – Navigate to yoursite.com/wp-json/ – should show JSON data (not error)
2. Verify Nonce – Re-save page (generates new nonce). Check for security plugin blocking REST API
3. Check PHP Errors – Enable WP_DEBUG and check /wp-content/debug.log
4. Increase PHP Limits – Increase max_execution_time to 300 in php.ini

Preview Different from Frontend

Symptom: Block looks different in editor vs. published page.

Explanation: This is normal behavior. The editor shows admin styles for usability, while the frontend shows actual theme styles.

Solution: Always use the Preview button to see true frontend appearance. Don’t rely on editor appearance.

🎠 Slider Problems

Slider Not Sliding

Symptom: Slider appears but doesn’t move (autoplay or manual).

Solutions:

1. Check Autoplay Settings – Block > Style tab > Autoplay: ON, set delay to at least 2 seconds
2. Verify Swiper.js Loaded – View page source (Ctrl+U), search for swiper.min.js
3. Check Navigation – Style tab > Navigation: Set to both, arrows, or dots
4. Increase Slide Count – Slider needs minimum 2 slides. Check Limit setting (Query tab)
5. Enable Observer (if in tabs) – If slider is in tabs/accordions, keep Enable Observer: ON
6. JavaScript Conflicts – Disable other slider plugins temporarily. Check browser console (F12)

Slider Shows One Slide Only

Symptom: Only first slide visible, navigation missing.

Solutions:

1. Query tab > Limit: Increase to 5 or 10
2. Verify posts/games/players exist matching filters – remove filters temporarily to test
3. Hero Slider > Style tab > Loop: ON (requires minimum 2 slides)

Navigation Arrows Not Appearing

Symptom: No arrows visible on slider.

Solutions:

1. Check Navigation Setting – Style tab > Navigation: Change to arrows or both
2. Adjust Arrow Color – Arrows may be invisible (white on white). Style tab > Arrows Color: Set to contrasting color (e.g., #000000)
3. CSS Conflict – Theme may hide arrows. Add custom CSS to force visibility

🎨 CSS Issues

Styles Not Loading

Symptom: Block appears unstyled or broken layout.

Solutions:

1. Verify CSS File – View page source (Ctrl+U), search for anwp-sl-kit. Should find stylesheet link
2. Clear All Caches – Site cache, browser cache (Ctrl+Shift+R), CDN cache, server-side cache (Redis, Memcached)
3. Check File Permissions – CSS file must be readable (permissions: 644)
4. Disable CSS Optimization – If using Autoptimize, WP Rocket, etc., exclude SL Kit CSS from optimization
5. RTL Issues – If using RTL language and styles broken, verify RTL CSS file exists
6. Regenerate CSS – Re-save the page/post (regenerates inline CSS)

Inline CSS Not Appearing

Symptom: Block uses inline CSS (dynamic styles) but not showing.

Solutions:

1. Re-save Page – Edit page > Click Update (refreshes inline CSS generation)
2. Check for PHP Errors – Enable WP_DEBUG and check debug.log
3. Increase Memory Limit – Add define('WP_MEMORY_LIMIT', '256M'); to wp-config.php

📊 Data Not Displaying

“No Games/Players/Staff Found”

Symptom: Block shows empty state message.

Solutions:

1. Verify Data Exists – Sports Leagues > [Games/Players/Staff] – ensure data is created and published
2. Check Filters – Remove all filters (Team ID, Season ID, etc.). If data appears, filters are too restrictive
3. Verify Assignments – Players: Assigned to team AND season? Staff: Assigned to team AND season? Games: Belong to tournament?
4. Check Post Status – Data must be “Published” (not Draft, Pending)

Wrong Data Showing

Symptom: Block shows unexpected content.

Solutions:

1. Add Specific Filters – Use Season ID to limit to specific season, Team ID for specific team. See Data Filtering Guide
2. Check Data in Sports Leagues – Verify player/game belongs to correct team/tournament
3. Clear Cache – Data may be cached from previous configuration

Images Not Showing

Symptom: Player photos, team logos, or featured images missing.

Solutions:

1. Upload Images – Players: Featured Image, Teams: Team Logo, Posts: Set Featured Image
2. Check Image URLs – View page source, find <img> tag, verify src URL is valid (not 404)
3. File Permissions – Check /wp-content/uploads/ permissions (755 for directories, 644 for files)
4. Increase Upload Limits – Edit php.ini: upload_max_filesize = 64M, post_max_size = 64M

⚡ Performance Issues

Page Loads Slowly

Symptom: Pages with SL Kit blocks take 3+ seconds to load.

Cause	Solution
Too many blocks	Limit to 3-5 blocks per page maximum
Large limits	Query tab > Limit: Reduce to 10-20
Unoptimized images	Use image optimization plugin (Smush, EWWW). Max 1920x1080px for sliders
No caching	Install caching plugin (WP Rocket, W3 Total Cache). Enable page and object caching
Slow hosting	Upgrade hosting plan. Use CDN for assets (Cloudflare)
Database queries	Optimize database with plugin (WP-Optimize)

Slider Stutters or Lags

Symptom: Slider animation not smooth.

Solutions:

1. Reduce Transition Speed – Hero Slider > Style tab > Speed: 0.5 seconds (faster)
2. Disable Effects – Hero Slider > Style tab > Ken Burns Effect: OFF (reduces GPU load)
3. Optimize Images – Compress slider images (TinyPNG). Use WebP format
4. Disable Other Animations – Theme parallax, scroll effects may conflict

🆘 Getting Help

Before Contacting Support

Gather this information:

1. System Info – WordPress version, PHP version (Site Health > Info > Server), AnWP Sports Leagues Premium version, AnWP SL Kit version
2. Active Theme & Plugins – Theme name and all active plugins
3. Browser Console Errors – Press F12, click Console tab, screenshot any red errors
4. Screenshots – Block configuration, frontend output, error messages
5. Steps to Reproduce – Exact steps causing the issue, expected vs. actual behavior

Enable Debugging Mode

Add these lines to wp-config.php to see detailed errors:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('SCRIPT_DEBUG', true);

View log at: /wp-content/debug.log

Common Conflict Plugins

These plugins occasionally conflict with SL Kit:

Plugin	Fix
Autoptimize	Exclude AnWP scripts from optimization
WP Rocket	Whitelist AnWP scripts
Wordfence Security	Check firewall rules (may block REST API)
Other Block Plugins	May override block categories
Page Builders	Blocks work in Gutenberg only (not Elementor/Divi editor)

Test for conflicts:

1. Deactivate all other plugins
2. Activate a default WordPress theme (e.g., Twenty Twenty-Five)
3. Test if issue persists
4. Re-activate plugins/theme one-by-one

📝 Known Limitations

These behaviors are expected and not bugs:

Behavior	Explanation
Block appearance differs in editor vs. frontend	Editor uses admin styles. Always preview on frontend
Empty block shows “No Data Found”	No data meets filter criteria. Check filters and Sports Leagues data
Slider requires minimum 2 slides	Swiper.js limitation. Add more slides or use different layout
Responsive controls only on Hero Slider	Other blocks use simpler layouts. Use custom CSS for adjustments
Statistics require configuration	Stats come from Sports Leagues plugin. Configure in Sports Leagues > Settings

✅ Quick Fixes Checklist

Resolves 80% of issues:

• Clear browser cache (Ctrl+Shift+R)
• Clear site cache (caching plugin)
• Verify parent plugin (Sports Leagues Premium) is active
• Check data exists in Sports Leagues
• Remove all filters temporarily
• Re-save the page/post
• Test in different browser
• Deactivate other plugins temporarily
• Check browser console for errors (F12)
• Verify image files uploaded

📚 Related Documentation

• SL Kit Overview
• Demo Import Guide
• Blocks Reference
• Data Filtering
• Contact Support