[wp-trac] [WordPress Trac] #63737: Theme update fails, creates duplicate directory after incorrect plugin update attempt

[WordPress Trac]

#63737: Theme update fails, creates duplicate directory after incorrect plugin
update attempt
-------------------------------------------------+-------------------------
 Reporter:  leemon                               |       Owner:  (none)
     Type:  defect (bug)                         |      Status:  new
 Priority:  normal                               |   Milestone:  Awaiting
                                                 |  Review
Component:  Upgrade/Install                      |     Version:  6.8.2
 Severity:  normal                               |  Resolution:
 Keywords:  has-test-info has-screenshots        |     Focuses:
  reporter-feedback close                        |
-------------------------------------------------+-------------------------

Comment (by leemon):

 Given that this issue seems to be resolved by ensuring the theme ZIP file
 has a single root folder named after the theme slug (e.g., `my-theme/`
 containing all theme files), I'm wondering if this is a documented
 requirement for theme ZIP file structure for updates, especially when
 using the admin installer.

 I've looked through some of the Theme Handbook and developer resources,
 but I haven't explicitly found a section that outlines this specific
 packaging requirement for ZIP files to ensure smooth updates, particularly
 in scenarios where a previous, incorrect installation attempt might have
 occurred.

 If this is indeed a standard or best practice, it would be helpful to have
 it clearly documented to prevent similar issues for other theme developers
 and users. Could someone point me to any existing documentation that
 covers this, or consider adding it if it's not currently present?

 Thanks!

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63737#comment:12>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform