It looks like you're new here. If you want to get involved, click one of these buttons!
There are several reasons why installing a new plugin/addon/theme can fail. I don't think there is a comprehensive overview of what an admin can do when problems arise...
Note: in some older plugins the main plugin file might be named
default.php. That is perfectly okay and no reason for any worries.
When you download a plugin you have to unzip it and move its content to the
The file structure afterwards must read:
When you end up with
/plugins/somePluginsName-1.0.0/somePluginsName/class.somepluginsname.plugin.php you have done something wrong and you will never be able to enable the plugin.
Addons must be unzipped to the
/applications folder. Check if you can find
If there is one more folder or one folder less in that structure, you've messed something up.
All files must be directly unzipped to the
/themes folder and all themes have an
about.php file in their root folder. So you can check if you have unzipped it correct if the path to the new theme looks like that
Note: upper-/lower case is important!
If you unzip what you have downloaded, the folder name will in almost all cases already match, so this paragraph is only useful for trouble shooting.
Open the plugin/the about.php file. Depending on what you look at, one of the first lines of code would look like that
$PluginInfo['somePluginName'] = array(
$ApplicationInfo['someAddonName'] = array(
$ThemeInfo['someThemeName'] = array(
The key of the array (the "someName" part) is how you would have to name the folder. If it is all lower case, your folder must be all lower case, if it is all mixed case, the folder must reflect that, too.
Uploading a plugin/addon/theme doesn't change your forum. You have to enable it first in the dashboard.
Enabling a plugin/addon/theme ("extension") throws an error. There are some things you could solve by yourself, but normally you are lost:
Although an extension has been uploaded to the correct path, it might not be included in the list of available plugins/addons/themes in the dashboard. The reason is, that the info in the header of an extension is cached. The only thing you have to do is to invalidate the cache so that it is renewed and the new extension will be included in the list.
But invalidating that cache isn't always easy.
/cachefolder. There should be a file called
addon.phpwhich caches information about plugins and addons and a
theme-index.phpfile which holds information about the available themes. Delete the file you need (or even both if you are unsure) and refresh the plugins/addons/themes list
If something unpredictable is going on, your extension still might not be included in the list. There is one thing you can do, but it could temporarily create an error message in your forum, for a few seconds only and it is not said that there really would be an error message, but at least it could happen. Nevertheless the process itself isn't dangerous.
$Configuration['EnabledPlugins']['somePluginsName'] = false;. If you find that line, you simply have been too dumb to see the plugin in the list. Go and open the list again. The plugin is contained in the list. You just have to search harder.
falseto true and quickly(!) do the next steps.
Check "2. Target Folders Name"