ColorlibHQ / ColorlibHQ/Sparkling

Customizer Not Working

Open
#277 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
PHP
Stars
429
Forks
330
Avg merge
22m
Merged PRs (30d)
1

Description

I'm having an issue when I click on Appearance > Customize where I just get a blank white screen. A related issue happens when I click on Appearance > Widgets - I can get to my sidebar, which is what I want to edit, but whenever I add some text I get a JSON error.

I used Claude to fix the issue and here are the results:

Root cause: inc/welcome-screen/welcome-page-setup.php had a customize_register hook that tried to instantiate two classes — Epsilon_Section_Recommended_Actions and Epsilon_Section_Pro — from the Epsilon Framework. That framework was deliberately removed from Sparkling in v2.6.0, but this one file still referenced its classes. Every time WordPress opened the Customizer, PHP threw a fatal "class not found" error before rendering a single byte, resulting in the blank white screen. The Widgets JSON error was a downstream symptom of the same underlying problem affecting how the block editor communicated with the theme.

The fix: Added class_exists() guards in welcome-page-setup.php so the function returns immediately when those classes aren't present, letting the Customizer load normally. Also earlier in the session: changed your permalink structure from "Plain" to "Day and name" so the REST API pretty URL /wp-json/wp/v2/ works correctly — that was contributing to the Widgets JSON error.

Both Appearance > Customize and Appearance > Widgets are working now.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in inc/welcome-screen/welcome-page-setup.php and inspect the customize_register hook and its references to the Epsilon classes. Reproduce Appearance > Customize and Appearance > Widgets, then verify both load without the blank screen or JSON error after the stale references are handled.

Written by the indexing model from the issue text.

Assessment

Tech stack
php, wordpress
Domain
frontend, web-dev
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.