WordPress拖拽Widget时设置项消失，点击保存才恢复问题排查

Hey there, let's break down this widget problem you're dealing with. Since the issue only pops up with your example theme and vanishes when switching to a default one, the root cause is definitely in your custom theme's code—let's walk through the most likely fixes step by step:

1. Check Your Widget Class's form() Method #

First, take a close look at the PHP code for your custom widgets (the WP_Widget subclass you built). A super common mistake here is adding a check that skips rendering the settings form when the widget is first dragged into the sidebar (before any settings are saved).

For example, if your code looks like this:

public function form( $instance ) {
    if ( empty( $instance ) ) {
        return; // This skips rendering the form for brand-new widgets!
    }
    // Rest of your form rendering code
}

Delete that empty($instance) check. When you first drag a widget into the sidebar, $instance is empty by default—but you still need to render the default form fields so users can see and edit them before saving.

2. Audit Theme Admin JavaScript #

Your theme might have custom JavaScript running on the Widgets page that's messing with the drag-and-drop behavior. Look for files like admin.js, widgets.js, or any scripts enqueued via the admin_enqueue_scripts hook targeting the widgets.php page.

Check for event listeners that trigger when a widget is added, like widget-added or sortstop. A buggy script could be accidentally hiding the widget's inner settings panel:

jQuery(document).on('widget-added', function(event, widget) {
    widget.find('.widget-inside').hide(); // This would hide settings right after dragging!
});

If you find code like this, either remove it entirely or adjust the logic to only hide panels under specific conditions (not for newly added widgets).

3. Inspect Theme Admin CSS #

Another culprit could be custom CSS that's hiding the widget settings panel by default. Flip through your theme's admin stylesheets for rules targeting .widget-inside, .widget-control-form, or elements with the widget-added class.

For example, a rule like this would cause exactly the issue you're seeing:

.widget-added .widget-inside {
    display: none !important;
}

Remove or modify any CSS that's hiding the settings panel unless it's intentionally supposed to be hidden (like for collapsible widgets that toggle on click).

4. Verify Sidebar Registration Code #

Double-check your register_sidebar() code in functions.php to make sure you haven't added any unusual parameters that might break widget rendering. A standard registration should look something like this:

register_sidebar( array(
    'name'          => __( 'Main Sidebar', 'example' ),
    'id'            => 'main-sidebar',
    'description'   => __( 'Widgets for the main sidebar area', 'example' ),
    'before_widget' => '<section id="%1$s" class="widget %2$s">',
    'after_widget'  => '</section>',
    'before_title'  => '<h2 class="widget-title">',
    'after_title'   => '</h2>',
) );

Make sure there are no extra attributes or filters attached to the sidebar that might interfere with how widgets load when dragged.

Final Notes #

Since you already tried disabling custom scripts, focus on the theme's core widget-related PHP, JS, and CSS. Start with the form() method in your widget class—it's the most common source of this exact issue. If you share snippets of your widget code, we can narrow it down even further!

内容的提问来源于stack exchange，提问作者Leomanish97