Cách khắc phục lỗi: “Không thể cài đặt gói. Chủ đề thiếu biểu định kiểu style.css ”

Bạn đã tải xuống một chủ đề mới tuyệt đẹp cho trang web WordPress của mình và cố gắng tải nó lên bảng điều khiển WordPress. Rất tiếc, chủ đề không thể cài đặt và xuất hiện lỗi sau: “Không thể cài đặt gói. Chủ đề thiếu biểu định kiểu style.css. ”

Trong bài viết này, chúng ta sẽ khám phá lý do gây ra lỗi này và cách giải quyết. Chúng tôi cũng sẽ chỉ cho bạn cách tránh lỗi này trong tương lai thông qua sự hiểu biết vững chắc về những kiến thức cơ bản về cấu trúc tệp WordPress, cũng như bằng cách giúp bạn đảm bảo bạn đang tải lên đúng tệp ngay từ đầu.

Hãy bắt đầu!

Thích xem phiên bản video?

Lỗi “Không thể cài đặt gói” xuất hiện ở đâu?

Lỗi tải lên chủ đề cụ thể này xuất hiện trong bảng điều khiển WordPress trong Giao diện > Chủ đề > Thêm mới > Tải lên chủ đề .

Nó chủ yếu xảy ra ngay sau khi bạn nhấp vào nút Chọn tệp , chọn tệp để tải lên, sau đó nhấp vào nút Cài đặt ngay . Tóm lại, lỗi này chỉ dành riêng cho mô-đun Thêm Chủ đề , vì vậy bạn không nên nhìn thấy nó ở bất kỳ nơi nào khác trên WordPress.

Bản thân văn bản lỗi có nội dung “Không thể cài đặt gói. Chủ đề thiếu biểu định kiểu style.css , ”được đưa vào thông báo trạng thái cài đặt chủ đề, ngay trước khi một thông báo khác cho bạn biết“ Cài đặt chủ đề không thành công ”.

Điều gì Xảy ra Khi Bạn thấy Lỗi “Không thể cài đặt gói”?

Đây là một trong những lần hiếm hoi lỗi trên màn hình máy tính cho bạn biết gần như chính xác điều gì đang xảy ra. Trong dòng thứ hai, nó cho biết: “Chủ đề thiếu biểu định kiểu style.css.”

Tóm lại, bạn đã cố gắng cài đặt một chủ đề WordPress bằng cách tải nó lên bảng điều khiển WordPress của mình. Nó liên quan đến một tệp .zip chứa đầy một thư mục tệp chủ đề phức tạp chứa mã hóa, bảng định kiểu và trách nhiệm quản lý và trình bày trang tổng quan, giao diện frontend và nhiều phần tử WordPress khác của bạn.

Đặc biệt, lỗi này cho thấy rằng biểu định kiểu style.css không nằm trong bộ sưu tập tệp WordPress đó hoặc WordPress gặp khó khăn khi tìm biểu định kiểu vì bạn đã tải tệp lên không chính xác.

Tóm lại, lỗi xảy ra vì nó không thể phát hiện tệp style.css . Nó xảy ra do một trong những lý do sau:

• Tệp style.css bị thiếu trong thư mục gốc của chủ đề do nhà phát triển chủ đề đã mắc lỗi.
• Tệp style.css bị thiếu trong thư mục do bạn đã vô tình xóa nó vào một thời điểm nào đó.
• Tệp style.css thực sự nằm trong thư mục gốc, nhưng bạn chưa tải thư mục đó lên WordPress một cách chính xác. Đôi khi nó xảy ra khi bạn không giải nén tệp trước khi tải lên.
• Bạn đang cố tải lên một tệp không thuộc WordPress — nó có thể không phải là một tệp chủ đề.

Biểu định kiểu style.css là gì?

Thư mục tệp WordPress của bạn chứa nhiều tài liệu và thư mục, bao gồm mã hóa PHP, CSS và HTML.

CSS, hoặc các biểu định kiểu xếp tầng, đề cập đến một ngôn ngữ thiết kế web được sử dụng cùng với PHP và HTML. Lý do chính của CSS là cách điệu các phần tử thiết kế web tĩnh bằng màu sắc, định dạng và phông chữ. Nói một cách đơn giản, CSS làm cho nội dung trang web của bạn trông đẹp mắt.

Một ví dụ cơ bản liên quan đến một hình ảnh đơn giản trên trang web của bạn. HTML chỉ tiến xa hơn về kiểu dáng. Tuy nhiên, CSS tăng cường khả năng thiết kế của bạn với các tùy chọn để di chuyển hình ảnh đó đến bất kỳ vị trí nào trên trang, thêm lề, phần đệm, nền và nhiều yếu tố khác để tiếp cận nội dung của bạn một cách trực quan hơn.

Tuy nhiên, bảng tính style.css không hoạt động một mình. Nó tương tác với tất cả các thư mục trong WordPress và thường hoạt động song song với các ngôn ngữ lập trình khác để tạo ra kết quả mong muốn.

Để có hướng dẫn chi tiết, hãy xem bài viết CSS WordPress của chúng tôi.

Biểu định kiểu style.css được cho là ở đâu?

Trang tính style.css là một phần của tất cả các chủ đề WordPress. Vì đây là cách chính mà WordPress kiểm soát thiết kế và bố cục trực quan của trang web của bạn, đó là một tệp bắt buộc.

Điều đó có nghĩa là bất cứ khi nào bạn mua hoặc tải xuống một chủ đề, bạn nên tìm thấy một biểu định kiểu style.css trong các tệp chủ đề.

Lưu ý: Bạn thường phải giải nén gói tệp chủ đề để xem các tệp chủ đề.

Ví dụ: chúng tôi đã tải xuống chủ đề Hello Elementor và mở các tệp chủ đề để hiển thị danh sách các tệp và thư mục, bao gồm cả trang style.css .

Mở trang style.css sẽ hiển thị nội dung của nó, bắt đầu với thông tin cần thiết như tên chủ đề của tác giả. Bạn sẽ nhận thấy rằng nó yêu cầu bạn không thay đổi bất kỳ phần nào của tệp này, vì nhiều chủ đề thích bạn thực hiện sửa đổi CSS trong bảng điều khiển hoặc trong một thư mục tùy chỉnh khác.

Cuộn xuống, biểu định kiểu style.css hiển thị một danh sách dài các đoạn mã CSS, tất cả đều kết hợp với nhau để làm cho chủ đề của bạn trông giống như nó.

Vì vậy, biểu định kiểu style.css được cho là có trong mọi thư mục tệp chủ đề, thường nằm gần các tệp CSS khác và gần các thư mục cho nội dung và mẫu.

Điều gì sẽ xảy ra sau khi bạn thấy lỗi “Không thể cài đặt gói”?

Một thư mục chủ đề không có biểu định kiểu style.css là vô dụng, ít nhất là khi tải nó lên WordPress và tạo ra một chủ đề đầy đủ chức năng.

Không thể tải lên thư mục gốc vì WordPress chặn mọi nỗ lực tải tệp lên mà không có biểu định kiểu style.css . Lý do cho điều này là vì thiếu biểu định kiểu có thể phá vỡ hoặc gây hại cho toàn bộ cơ sở hạ tầng WordPress.

Ngoài ra, bạn nhận được thông báo lỗi: “Không thể cài đặt gói. Chủ đề thiếu biểu định kiểu style.css . ”

Tin tốt là bất kỳ chủ đề nào đã được kích hoạt trước đó trên trang web WordPress của bạn vẫn còn nguyên. Không có hại gì đối với trang web của bạn và bạn không thể tải lên chủ đề mới.

Tuy nhiên, bạn có thể muốn thay thế chủ đề hiện tại, vì vậy điều cần thiết là phải thực hiện các giải pháp sau để hoán đổi chủ đề cũ và cài đặt chủ đề mới.

Làm cách nào để khắc phục Lỗi “Chủ đề thiếu biểu định kiểu style.css”?

Trong phần này, chúng tôi sẽ trình bày hai lý do chính khiến bạn gặp lỗi thiếu biểu định kiểu, cùng với thông tin về cách giải quyết vấn đề.

Cách giải quyết tình huống khi chủ đề của bạn bị thiếu tệp Style.css

Tệp style.css bị thiếu có nghĩa là một trong hai điều: nhà phát triển chủ đề (có thể là bạn) không đưa nó vào thư mục gốc hoặc bạn đã vô tình xóa tệp style.css.

Với tình huống đầu tiên, chúng tôi khuyên bạn nên thực hiện quá trình hành động sau:

1. Liên hệ với nhà phát triển chủ đề và thông báo cho họ về sự cố: Mặc dù khó xảy ra, nhưng bạn có thể tải xuống không tốt hoặc ai đó / điều gì đó từ phía nhà phát triển đã mắc lỗi. Các nhà phát triển chủ đề có uy tín sẽ cung cấp cho bạn phản hồi nhanh chóng với một tệp chủ đề mới. Nếu bạn là nhà phát triển chủ đề, hãy đọc hướng dẫn này về cách tạo chủ đề con, đặc biệt là phần về cách tạo biểu định kiểu.
2. Tìm kiếm chủ đề mới: Đây rất có thể là cách hành động tốt nhất, vì hiếm khi nhà phát triển chủ đề chất lượng bỏ lỡ một trong những phần quan trọng nhất. Có lẽ bạn đã tải xuống một chủ đề từ một nguồn sơ sài hoặc một người mới bắt đầu đang học cách viết mã.

Bạn có thể thêm một trang style.css , nhưng loại đó đã đánh bại mục đích của việc sử dụng một chủ đề được tạo sẵn ngay từ đầu. Đó là chưa kể, một chủ đề được dùng để có một biểu định kiểu, nhưng bây giờ bị thiếu nó, sẽ không hoạt động bình thường.

Cách giải quyết tình huống trong đó WordPress không nhận dạng được trang tính style.css

Đôi khi, WordPress không thể nhận dạng trang style.css trong thư mục chủ đề khi bạn cố gắng tải nó lên bảng điều khiển.

Những lý do cho điều này bao gồm những điều sau:

• Bạn không tải chủ đề lên đúng cách.
• Bạn phải giải nén tệp gốc từ nhà phát triển để hiển thị tệp chủ đề.
• Tệp chủ đề không dành cho WordPress.
• Tệp không phải là một tệp chủ đề mà là một cái gì đó khác.
• Style.css không ở đúng vị trí trong thư mục gốc.

Một số lý do này có vẻ đơn giản, nhưng thường là những lý do hời hợt nhất gây ra các vấn đề khó chịu.

Hãy xem các phần bên dưới để hiểu cách giải quyết những tình huống này dựa trên nguyên nhân gốc rễ.

Tải lên chủ đề đúng cách

Một lý do khiến bạn có thể thấy “Không thể cài đặt gói. Chủ đề bị thiếu biểu định kiểu style.css ”là do quá trình tải lên tệp chủ đề của bạn.

Người dùng mới, hoặc thậm chí là người dùng có kinh nghiệm, có thể vô tình bỏ qua các bước tốt nhất để tải lên tệp chủ đề.

Vui lòng đọc hướng dẫn của chúng tôi về cài đặt chủ đề WordPress để đảm bảo bạn làm theo các bước thích hợp. Bài viết đề cập đến việc tìm kiếm các chủ đề WordPress tốt nhất và các phương pháp cài đặt, như thông qua bảng điều khiển hoặc FTP. Nó cũng hướng dẫn bạn các cách cài đặt chủ đề miễn phí và cao cấp hơi khác nhau.

Xem liệu tệp chủ đề có yêu cầu giải nén không

Nhiều lỗi tải lên chủ đề xảy ra do tệp tải xuống nén. Nó hơi khó hiểu đối với những người coi WordPress chỉ chấp nhận các tệp nén.

Tuy nhiên, một số nhà phát triển chủ đề cung cấp cho bạn tệp nén trong tệp nén và bạn phải giải nén gói ban đầu để tìm tệp tải lên hợp lệ chỉ bao gồm nội dung của chủ đề.

Ví dụ: bạn có thể thấy rằng một nhà phát triển chủ đề đóng gói các tài liệu khác vào bản tải xuống gốc, vì vậy WordPress sẽ xem xét tất cả nội dung này và tự hỏi tệp chủ đề thực sự ở đâu.

Mặc dù hầu hết các nhà phát triển chủ đề có uy tín đều biết điều này gây nhầm lẫn, nhưng chúng tôi đã gặp phải trường hợp hiếm hoi khi bạn phải giải nén bản tải xuống chủ đề đầu tiên để xem những thứ như hướng dẫn sử dụng và nội dung khác.

Ngoài việc tải lên tệp chủ đề sai cách ở điểm trước, đây là vấn đề đầu tiên bạn nên khắc phục sự cố trước khi xem xét các phương pháp khác, vì đây là một cách khắc phục dễ dàng và vẫn hơi quen thuộc đối với các nhà phát triển chủ đề để thực hiện việc này. Điều này cũng chỉ xảy ra khi bạn mua chủ đề từ nhà phát triển bên thứ ba, xem như cách Thư viện chủ đề WordPress.org hạn chế các tệp chủ đề được đóng gói kỳ lạ.

Vì vậy, giả sử bạn tải lên tệp nén từ nhà phát triển bên thứ ba, chỉ để nhận thấy rằng bạn nhận được thông báo lỗi: “Không thể cài đặt gói. Chủ đề thiếu biểu định kiểu style.css . ”

Có một cơ hội tốt là tất cả những gì bạn phải làm là giải nén tệp gốc do nhà phát triển chủ đề cung cấp để giải nén một tệp ZIP khác bên trong nó.

Để giải quyết vấn đề, hãy chuyển đến tệp bạn đã tải xuống ban đầu từ nhà phát triển chủ đề.

Nó rất có thể là một tệp ZIP, có ý nghĩa khi tải lên WordPress dưới dạng chủ đề, nhưng nó có thể chứa các tệp nội dung bổ sung làm lộn xộn thư mục và khiến WordPress khó xác định các tệp chủ đề.

Do đó, hãy mở hoặc giải nén tệp để giải nén bất cứ thứ gì bên trong nó. Nó thường được thực hiện bằng cách nhấp chuột phải và chọn tiện ích giải nén hoặc lưu trữ ưa thích của bạn.

Bây giờ, hãy mở tệp đã giải nén để hiển thị nội dung của nó. Như bạn có thể thấy trong ví dụ này, các nhà phát triển chủ đề đã bao gồm tệp readme.txt và một thư mục nội dung khác trong thư mục gốc của tệp tải xuống chủ đề. Họ cũng có tệp chủ đề thực, được nén trong lĩnh vực này. Đó là tệp chủ đề thực tế bạn cần tải lên WordPress.

Quay lại Giao diện > Chủ đề > Thêm mới > Tải lên chủ đề để chọn một tệp từ máy tính của bạn. Sau đó, hãy đảm bảo rằng bạn chọn tệp chủ đề nén này mà không có bất kỳ tính năng bổ sung nào (như tài liệu ReadMe trong ví dụ này).

Hãy nhớ rằng bạn có thể hoàn thành quá trình khắc phục sự cố này và thấy rằng chủ đề được đóng gói lạ lùng không phải là vấn đề. Nếu bạn không thấy tệp chủ đề nén trong gói chủ đề gốc từ nhà phát triển của mình, hãy xem xét các mẹo khắc phục sự cố khác bên dưới.

Tìm hiểu nếu tệp chủ đề dành cho WordPress

Nhiều chủ đề trang web tồn tại trực tuyến. Không có gì lạ khi bạn thấy một thiết kế chủ đề mà bạn yêu thích, chỉ để mua nó và phát hiện ra nó không thực sự dành cho WordPress. Ví dụ: thị trường ThemeForest bán các mẫu trang web cho các hệ thống quản lý nội dung và trình xây dựng trang web khác nhau, bao gồm Drupal, Joomla, Webflow và Shopify.

Mỗi nền tảng đều có cấu trúc tệp gốc cho các chủ đề, vì vậy WordPress sẽ từ chối mọi nỗ lực tải lên một chủ đề dành cho hệ thống khác như Bigcommerce hoặc Magento.

Hãy nhớ rằng bạn có thể thấy lỗi “Chủ đề thiếu biểu định kiểu style.css” trong trường hợp như thế này. Rốt cuộc, một thư mục chủ đề từ Shopify hoặc Drupal có thể có trang style.css của nó nằm ở một nơi khác. Tuy nhiên, bạn cũng có thể gặp một lỗi khác.

Để khắc phục sự cố này, tất cả những gì bạn phải làm là xóa tệp chủ đề không tương thích và chọn một tệp mới.

Trong tương lai, hãy xem xét kỹ tất cả các trang sản phẩm chủ đề để đảm bảo chúng dành cho WordPress chứ không phải trang nào khác. Ví dụ: hầu hết ThemeForest — và các trang sản phẩm chủ đề cao cấp khác — hiển thị nền tảng chứa chủ đề nhiều lần trên trang. Nhìn vào danh mục, tiêu đề và hình ảnh trên trang.

Hầu hết người bán chủ đề cũng bao gồm một khu vực với loại phần mềm hoặc phiên bản cho chủ đề đó. Một lần nữa, hãy nhìn để thấy rằng WordPress là phần mềm chính được liệt kê.

Hoặc bạn có thể sử dụng tất cả các thư viện WordPress như Thư mục chủ đề WordPress.org.

Nếu bạn gặp khó khăn khi tìm kiếm bất kỳ thông tin nào về chủ đề trực tuyến, hãy xem thư mục chủ đề để xem nó như thế nào. Mặc dù mọi thư mục chủ đề WordPress đều có các cấu hình và tệp tin khác nhau, nhưng bạn có thể biết nếu đó thực tế là một chủ đề WordPress bằng cách tìm kiếm một số tệp cụ thể.

Tất cả các chủ đề WordPress đều có trang style.css trong thư mục gốc. Bạn cũng sẽ thấy các thư mục như tài sản và các thư mục tiềm năng cho các mẫu. Tìm kiếm các tệp như index.php , footer.php và sidebar.php . Đôi khi bạn nhìn thấy những thứ này trong các chủ đề cho các nền tảng khác, nhưng chúng thường được đặt các tên khác nhau hoặc nằm ở những nơi khác.

Tìm hiểu xem đó có phải là tệp chủ đề không

Bạn có thể tải nhiều loại thư mục nén lên WordPress, đôi khi khiến bạn khó xem đó có phải là tệp chủ đề hay không. Nhìn bề ngoài, tệp plugin trông không khác gì tệp chủ đề.

Bạn có thể nói điều tương tự đối với tệp nhập trang web từ một trang WordPress khác hoặc các nền tảng như Tumblr hoặc Blogger. Bạn cũng có thể nhận thấy rằng bạn đang cố tải lên sản phẩm WooCommerce hoặc tệp WXR để nhập các mục như bài đăng và trang. Danh sách vẫn tiếp tục, nhưng ý tưởng là không có tệp nào trong số này giống với tệp chủ đề WordPress.

Do đó, điều quan trọng là phải kiểm tra kỹ những gì bạn đang tải lên ngay từ đầu. Có thể nhấp vào một loại tệp trên máy tính của bạn có tên tương tự hoặc bạn gặp khó khăn khi phân biệt giữa tệp plugin gần đây bạn đã tải xuống và tệp chủ đề bạn cũng tải xuống cùng thời điểm.

Cách chính để tránh điều này là duy trì tổ chức và tập trung khi bạn lưu và tải lên các tệp WordPress. Đảm bảo rằng bạn giữ các tệp chủ đề ở những vị trí dễ nhớ và biết tên của các tệp khi chúng được tải xuống máy tính của bạn.

Một cách khác để phân biệt giữa các tệp chủ đề và các tệp hướng WordPress khác là biết cấu trúc tệp trông như thế nào cho mỗi tệp.

Chúng tôi khuyên bạn nên đọc hướng dẫn của chúng tôi về các tệp WordPress và sử dụng chúng, đặc biệt là phần Thư mục Chủ đề WordPress. Bằng cách này, bạn xây dựng kiến thức của mình về cấu trúc thư mục WordPress và xác định chức năng của tệp khi bạn nhìn thấy nội dung của nó.

Đối với trường hợp này, vui lòng mở tệp bạn đang cố tải lên và đảm bảo rằng tệp đó trông giống như tệp chủ đề.

Giả sử chúng tôi có hai tệp và chúng tôi không nhớ tên cụ thể của chủ đề. Bạn có thể gặp khó khăn khi quyết định cái nào trong hai cái bạn nên tải lên WordPress. Chúng tôi biết rằng một trong số chúng là tệp plugin và tệp còn lại là tệp chủ đề. Bắt đầu bằng cách giải nén cả hai để xem những gì bên trong.

Mở từng tệp riêng biệt để phân tích nội dung.

Tệp này có các thư mục như phần bổ trợ, phần tử, khối và lớp. Nó không bao gồm các thư mục và tệp chủ đề tiêu chuẩn. Mặc dù tất cả các tệp plugin trông hơi khác một chút, nhưng có thể nói điều này giống một plugin hơn là một chủ đề.

Tệp khác tiết lộ một bộ sưu tập rộng rãi các thư mục và tệp PHP. Tệp style.css có trong đó, cùng với các chủ đề cần thiết như footer.php , header.php và sidebar.php . Nó cũng tương đối phổ biến để xem các thư mục cho CSS, Phông chữ và các phần Mẫu trong một tệp chủ đề.

Do đó, đây là tệp chủ đề mà chúng tôi đang tìm kiếm và tệp còn lại dành cho một plugin. Trong tương lai, hãy theo dõi các thuộc tính cổ điển của tệp chủ đề để đảm bảo bạn tải lên các tệp phù hợp.

Đảm bảo rằng tệp style.css ở đúng vị trí

Cho dù do chính bạn hay nhà phát triển thực hiện, tệp style.css có thể bị thiếu ở đúng vị trí.

Không quan trọng tại sao điều này xảy ra, chỉ là WordPress đang tìm kiếm tệp style.css trong thư mục gốc và nó không thể tìm thấy nó.

Để khắc phục sự cố này, hãy kiểm tra thư mục gốc của chủ đề và tìm tệp style.css .

Chúng tôi có thư mục gốc cho chủ đề TwentyTwenty đang mở và có vẻ như không có dấu hiệu của biểu định kiểu style.css . Có thể bạn vô tình kéo nó vào một trong các thư mục khác trong khi sắp xếp, vì vậy bạn nên dành ít nhất vài giây để nhấp vào các thư mục để xem nó có ở trong đó hay không.

Hóa ra chúng tôi đã chuyển nó vào thư mục Mẫu . WordPress có thể gặp sự cố khi nhận dạng trang style.css nếu nó không nằm trong thư mục gốc, vì vậy hãy di chuyển nó trở lại thư mục gốc nơi nó thuộc về.

Bản tóm tắt

Lỗi biểu định kiểu style.css bị thiếu bắt nguồn từ tệp chủ đề bị lỗi và nó chỉ xuất hiện khi bạn cố gắng tải lên tệp trong phần Thêm chủ đề của WordPress.

Các lý do hàng đầu để xem thông báo bao gồm:

• Tệp style.css bị thiếu do nhà phát triển không đưa nó vào thư mục.
• Tệp style.css bị thiếu do bạn đã vô tình xóa hoặc chuyển tệp sang nơi khác.
• Bạn đang tải tệp chủ đề lên không đúng cách.
• Bạn phải giải nén tệp để hiển thị tệp chủ đề thực tế trong gói ban đầu do nhà phát triển cung cấp cho bạn.
• Tệp chủ đề không dành cho WordPress mà là các nền tảng khác như Shopify, Joomla hoặc Drupal.
• Tệp không phải là tệp chủ đề. Đó là một cái gì đó khác, chẳng hạn như một tệp plugin hoặc thậm chí một tài liệu ngẫu nhiên hoặc tệp ZIP từ máy tính của bạn.

Sử dụng hướng dẫn này để giải quyết sự cố tệp chủ đề của bạn và vui lòng liên hệ với bộ phận hỗ trợ khách hàng của Kinsta nếu bạn tiếp tục gặp sự cố.