How to uninstall extensions
- 1 Extension Manager terminology
- 2 Uninstall Extensions
Extension Manager terminology
In the context of the TYPO3 extension manager ("EM"), the words "install" and "uninstall" differ from their mainstream meaning. To avoid mixing these terms up with the other EM verbs, here is a clarification:
- Import means "downloading an extension from TER and copying it to typo3conf/ext/".
- Install means "activating the already imported extension inside the extension manager and performing database changes mandated by the extension".
- Uninstall means "deactivating an extension, but leaving it on the disk".
- Delete means "removing extension files permanently from disk".
See also the Delete Extensions for a complete discussion about removing an extension completely from disk and database.
First find out, which other extensions and functions of your Typo3-Installation are dependent of the extension you want to deinstall. Major dependeancies you can find out by checking the Extension Repository. Look for the extension you want to deinstall and the others you have installed. Read for all of them the chapters 'Dependencies' and 'Reverse dependencies'.
Contemplate, whether you made referrals to the extension in any setup, config or other Typoscript-section. Think of the results of deleting them and finally do it.
If you are not sure, or just testing, you might as well deinstall the extension (which is without deleting) and see what happens. This could lead to your backend no longer loading. In that case you can add the extension again by going to the Install Tool and adding it to [EXT][extListArray] again. However, you can always undo it. Be sure not to do it under time pressure.
Uninstall / Deinstall / Remove
There are at least 3 ways to uninstall an extension:
- A - Using the Extension Manager
- B - Using the Install Tool (if the Backend does not work)
- C - Using ftp and an editor to edit LocalConfiguration.php (if neither Backend nor Install Tool work)
Each of them does not delete the extension, but prevents it from being loaded by Typo3 further more. Choose A, B, or C
A - Using the Extension Manager
You get an overview about installed extensions.
On the left side you see an icon, which shows the status of each extension, and what you can do:
- The extension is not installed. (Click once to install)
- The extension is installed and running. (Click once to uninstall)
B - Using the Install Tool
Here look for the entry of the extension you want to disable ('uninstall') and delete its extension_key with the following comma.
In the end, scroll to the end of the page and press 'Write to LocalConfiguration.php'.
C - Using ftp and an editor
For >= 6.2 LTS:
1) Open the file typo3conf/PackageStates.php
2) Search for your ext_key in the array.
... 'ext_key' => [ 'composerName' => '...', 'state' => 'active', 'packagePath' => '.../', 'suggestions' => , ], ...
3) Change 'state' => 'active' to 'state' => 'inactive'
For < 6.2 LTS:
Download from folder typo3conf/ the file LocalConfiguration.php.
Use an utf-8-capable(!) editor and open LocalConfiguration.php.
Search '$TYPO3_CONF_VARS['EXT']['extListArray']' and find the extension key, for example
$TYPO3_CONF_VARS['EXT']['extListArray'] => array( 'css_styled_content', 'tsconfig_help', 'context_help', 'extra_page_cm_options', 'impexp', 'sys_note', 'tstemplate', 'tstemplate_ceditor', 'tstemplate_info', 'tstemplate_objbrowser', 'tstemplate_analyzer', 'func_wizards', 'wizard_crpages', 'wizard_sortpages', 'lowlevel', 'install', 'belog', 'beuser', 'aboutmodules', 'setup', 'taskcenter', 'info_pagetsconfig', 'viewpage', 'rtehtmlarea', 't3skin', 't3editor', 'felogin', 'static_info_tables', 'templavoila', 'indexed_search', 'macina_searchbox', 'tt_news', 'sr_language_menu', 'phpmyadmin', 'sys_action', 'sr_freecap', 'captcha', 'powermail', 'powermail_sendpost', 'wt_dynamictarget', 'rgsmoothgallery', 'rgfolderselector', ),
Delete the entry and one comma.
(You do not need to delete one of the entries from $TYPO3_CONF_VARS['EXT']['extConf'])
Save the file (without utf-8-BOM, if asked) and upload again.
Backup the new LocalConfiguration.php
The file typo3conf/LocalConfiguration.php has been changed. Make a backup of the new version. That's it. If your Typo3 is still running, you are done.
To get more information about the extension, in extension manager click on its title (3rd column).
If you want to purge the extension entirely from your installation and the hard disk, read Delete Extensions.
Page started by DvSchuetz