Troubleshooting
Common Issues

Common Issues & Solutions

Below is a diagnosis and troubleshooting guide for the most common questions and configuration challenges when setting up and using AlonePro.

1. AlonePro Blocks Missing from the Block Inserter

  • Symptom: You search for "Salado" or "AlonePro" in the block inserter, but no custom blocks appear.
  • Root Cause: Nextora is currently set as the active theme instead of AlonePro.
  • Solution:
    1. Navigate to Appearance → Themes.
    2. Locate AlonePro and click Activate.
    3. Reopen the Site Editor or page editor. The 8 custom blocks will now appear under the Design category.

2. "License Activation Required" Modal on Cloud Template Import

  • Symptom: When clicking "Import" on a template inside the Nextora Cloud Templates catalog, a modal prevents import and asks for license activation.
  • Root Cause: The selected template belongs to the premium AlonePro catalog and your site does not have an active Freemius license.
  • Solution:
    1. Go to Appearance → AlonePro License.
    2. Enter your valid license key or connect your Freemius purchase account.
    3. Click Activate License.
    4. Return to Nextora Addon → Templates and re-attempt the import. (Note: Parent Nextora templates can be imported freely without a license).

3. Style Variations Not Showing in Site Editor

  • Symptom: When opening the Styles sidebar and clicking "Browse styles", only the default theme appears.
  • Root Cause: Stale editor cache or browser cache after updating files.
  • Solution:
    1. Perform a hard refresh in your browser (Ctrl + Shift + R on Windows/Linux or Cmd + Shift + R on macOS).
    2. If the issue persists, temporarily switch to another theme in Appearance → Themes and reactivate AlonePro to trigger a cache refresh.

4. Scroll Animations Not Playing

  • Symptom: Blocks with animation-* utility classes appear static and do not animate into view.
  • Root Causes:
    • Operating System Setting: Your OS has Reduced Motion enabled (prefers-reduced-motion: reduce). AlonePro intentionally disables all entrance animations for users who have this accessibility preference active.
    • Script Loading Error: Check your browser's Developer Tools Console (F12) for any JavaScript errors blocking main.js.

5. Interactive Globe Block Not Rendering (Blank Canvas)

  • Symptom: The 3D WebGL Globe appears as an empty white or transparent space.
  • Root Causes:
    • WebGL Disabled: Your browser or operating system has hardware acceleration or WebGL disabled.
    • Strict Content Security Policy (CSP): Security plugins or hosting headers are blocking <canvas> context execution.
  • Solution:
    • Test the page in a modern browser with hardware acceleration enabled.
    • If using a security plugin, ensure WebGL canvas scripts are whitelisted.

6. PHP Memory or Execution Time Errors During Imports

  • Symptom: A Fatal error: Allowed memory size of ... bytes exhausted or Maximum execution time of 30 seconds exceeded appears during theme setup or template imports.
  • Solution:
    • Increase your WordPress memory limit by adding the following lines to wp-config.php: 
      define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
    • Or increase limits in your server's php.ini: 
      memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
Color Token SystemChangelog