Why Is My Wordpress Theme Not Uploading

For the nigh part, I think WordPress is a pretty solid platform. Of course, nosotros complicate things when we elevate third-party elements into information technology for the sake of improving performance or security, calculation new blueprint features, or opening up greater functionality. But the payoff is generally worth it. Without those integrations, you'd have to do much more transmission coding and that only doesn't isn't the most effective way to build a website these days.

That said, in that location are times when issues ascend when you try using WordPress plugins and themes on your website. Every bit I've talked near earlier, in that location are WordPress plugin conflicts that occur upon initial installation or during updates. Only there are other ways in which they can cause bug for you lot before you even get them on the site.

Below, I'm going to break down the 7 reasons why a WordPress plugin or theme won't install on a website and some ways to go around these errors.

7 Reasons Why Your WordPress Plugin or Theme Won't Install

The nice thing about these kinds of WordPress errors is that they're easy to place. Usually, there's an error message that accompanies each failure to load, so there isn't as much troubleshooting with something like this as in that location are with other WordPress errors. It'southward but more than annoying than anything else.

So, here are the near mutual reasons why your WordPress plugin or theme won't install and what to do about them:

• Uploading the Wrong File Format
• Missing Files
• Syntax Fault
• Uploading the Wrong Zip File
• Exceeding the Memory Limit
• Exceeding the File Size Limit
• Miscellaneous Errors

1. Uploading the Incorrect File Format

Typically, y'all'll encounter an installation mistake during the transmission upload of a theme or plugin through the Add together New / Upload option in WordPress (as opposed to directly installing from the WordPress repository):

Install your new WordPress plugins here.

When you encounter the following "bad format" message, information technology ways that you lot have not uploaded the native files provided to you past the theme or plugin developer.

This is what the "bad format" error looks like.

The only plugin or theme files that should ever be uploaded to WordPress are aught files.

Before y'all get in touch with the plugin or theme developer, verify that yous didn't receive the right file from them. If this came from your client, they may have unzipped the folder and given you what they thought was the correct file from inside. If it didn't come up from the client and you really don't have the right folders, go in affect with the developer.

2. Missing Files

Now, let's say you did try and upload a aught file into WordPress, just you saw this error message instead:

This is what the "missing files" error looks like.

This means that the files contained inside the folder are not what WordPress was expecting.

Unzip the folder and review the contents. Is this even the right goose egg? Does it incorporate all the files you would look a plugin or theme to have? Yous tin cantankerous-check the contents of the binder confronting WordPress's recommendations for files that should exist included in the bundle:

• A WordPress plugin packet.
• A WordPress theme bundle.

If you've detected whatever missing files, accomplish out to the programmer for assistance.

3. Syntax Error

When you purchase a WordPress plugin or theme from a reputable developer, you shouldn't take to worry about this kind of error occurring.

However, let's say your client was trying to cut corners and salve money, and so they institute some plugin or theme online that looked promising. Y'all effort to install it in WordPress and you receive a syntax error. It'll usually say something about "parse mistake" and "syntax error".

All this ways is that there's something wrong in the lawmaking. This error can actually come up if you erroneously try to edit a theme or plugin once it'due south installed on your website. However, if you're seeing it during installation, then the error lies with the developer.

If yous desire to review the lawmaking of the plugin or theme on your own, yous might be able to detect and repair the error yourself. Before you lot dig in, check into any other reported issues with the plugin or theme if at that place'due south a support system attached to information technology (through WordPress or a market place).

If at that place aren't any, your safest bet might exist to have your customer go a new plugin or theme. If you don't trust the developer to lawmaking the backend well, this event could keep coming up with each new update (and you don't want to deal with that).

4. Uploading the Incorrect Zip File

This error is one you're probably going to encounter with larger, multipurpose themes. You received a nada file from your customer and, past all intents and purposes, it looks to be in skillful shape. Withal, let's say you become to add the new theme:

Install your new WordPress theme here.

Then you lot see this error:

This is what the stylesheet error looks like.

In actuality, the stylesheet is not missing. You probably just downloaded the wrong version of the theme file.

Some developers offer up different cipher packages for their themes, specially if they're including plugins and child themes inside them. Here's an example of how Uncode includes various download options on Themeforest:

Various file downloads are available when you buy a premium theme.

While it'due south essential to have that full file with all the documentation, licenses, plugins, and alternate themes, that file cannot be uploaded into WordPress because it looks like this:

Every bit y'all can come across, the contents of this cypher file wasn't going to get me very far in WordPress.

WordPress tin can unzip the acme-level zip file, but it won't be able to go through and unzip everything else contained within the folder. If you want to get your theme in there, then yous need to upload the proper zip file.

five. Exceeding the Retention Limit

I touched on this mistake recently when I talked about the server issues that bear on WordPress. Basically, this happens when your web hosting PHP memory limit is besides low to process the installation.

The fault will say something like, "Fatal error: Immune memory size of _______ bytes exhausted…" If you run into this retention error, it's piece of cake to fix.

Log into the control console of your site and open up your preferred file editor: FTP or file managing director. In the root directory, you'll discover your wp-config.php file. Click on the edit push button and add the following line of code:

define( 'WP_MEMORY_LIMIT', '256M' );

Since the default retentivity limit is commonly 64M, this volition significantly increment it and help you lot get your new theme or plugin installed without event.

6. Exceeding the File Size Limit

Memory isn't the only affair that can be pushed to its limit when uploading a new WordPress plugin or theme. You may besides discover that the allowable file size is exceeded. When this occurs, you'll come across a message similar to this:

"The uploaded file exceeds the upload_max_filesize directive in php.ini"

To fix this maximum upload limit, you'll demand to practise and so through the control console. Access your directory using either FTP or a file director. One time yous're in there, locate the wp-admin folder.

Do you see a php.ini file? If not, y'all're going to have to create one.

Once y'all have the php.ini file open up, wait for a section that mentions "filesize". If it exists, yous'll want to overwrite information technology with the following lawmaking. If it doesn't, so enter the following lines of code into the file:

upload_max_filesize = 1000M
post_max_size = 2000M
memory_limit = 3000M
file_uploads = On
max_execution_time = 180

This will give y'all some more leeway in how large your WordPress theme and plugin files can be. If you're still experiencing problems with this error, read through Jenni McKinnon'southward guide on how to increment the maximum upload limit.

7. Miscellaneous Errors

I'm including this final hodgepodge error type because y'all never know what types of external conflicts might become in the style of you lot being able to install a plugin or theme. In my example, it was an old disharmonize between an SSL certificate and CDN I had on my site.

In a nutshell, hither's what happened:

1. I bought a new WordPress theme.
2. I installed the WordPress theme and activated it.
3. When I uploaded the theme, I received a bunch of error letters about how some of the plugins wouldn't install. I initially disregarded the message because I didn't think I was going to utilise almost of the plugins anyway.
4. As it turns out, before I could customize or utilise my theme, I had to activate a required plugin from the developer… which would not install. The message beneath is what I saw.

This was the SSL certificate fault I saw.

I've had an SSL document on my website for over a year and had experienced problems with it in the past. Specifically, it conflicted with the CDN. To resolve the conflict, I asked my web host to get rid of the CDN. Every bit far equally I knew, the issue was stock-still. (Funny enough, the CDN ended up beingness the problem hither.)

Anyhow, after working in conjunction with my web hosting company and the theme developer, nosotros were able to sort out that the fault could be bypassed by uploading the plugin files directly into WordPress. I had assumed that an inability to install through the theme upload would hateful an inability to install through the normal process. However, the workaround took and I was able to get the plugin installed on my site.

I guess this is my roundabout fashion of saying that if yous run into an error during the installation of a WordPress plugin or theme, it doesn't resemble numbers 1 through 6 above, and you've tried manually uploading, go to the perceived source of the trouble. They should be able to provide you lot with insights into the problem and spare you the desperation of trying to figure information technology out on your own.

Wrapping Up

So, is there a mode to avoid these in the future? Well, using reputable themes and plugins from WordPress developers is a adept place to start. Familiarizing yourself with what theme and plugin files should comprise is another good thing to accept under your belt.

All in all, I retrieve this is probably one of the easier kinds of errors you might finish upwardly having to deal with in WordPress. That said, errors are a nuisance you oft can't afford to deal with when they popular up mid-workflow, so make sure you're well-versed in what the nigh common errors are and how to get about fixing them.

Tags:

johnsonthishe1957.blogspot.com

Source: https://wpmudev.com/blog/7-reasons-why-your-wordpress-plugins-or-themes-wont-install/

Share this post