How to uninstall extensions
Contents |
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.
Uninstall Extensions
Check Dependencies
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][extList] 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 localconf.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
Open the Extension Manager ('Ext Manager'). From the menu choose 'Install 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)
Next to the extension you want to deinstall click on 
. After some seconds the icon changes to 
.
B - Using the Install Tool
In the menu click on 'All Configuration'.
Scroll down to section 'EXT:'
Scroll further down to entry 'extlist'
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 localconf.php'.
C - Using ftp and an editor to edit localconf.php
Download from folder typo3conf/ the file localconf.php.
Use an utf-8-capable (!) editor and open localconf.php.
Look for the line starting '$TYPO3_CONF_VARS['EXT']['extList']' and find the extension key, for example
$TYPO3_CONF_VARS['EXT']['extList'] = '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,doc_indexed_search,indexed_search,macina_searchbox,tt_news,sr_language_menu,phpmyadmin,metatags,rgtabs,kj_recycler,api_macmade,dropdown_sitemap,sys_action,syslanguage_flags,cron_accessiblemenus,gov_accesskey,db_ttv,date2cal,ve_guestbook,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 starting $TYPO3_CONF_VARS['EXT']['extConf'])
Save the file (without utf-8-BOM, if asked) and upload again.
Backup the new localconf.php
The file typo3conf/localconf.php has been changed. Make a backup of the new version. That's it. If your Typo3 is still running, you are done.
Some notes
To get more information about the extension, in extension manager click on its title (3rd column).
In order to install the extension again, you may just click on and follow the instructions (save changes).
If you want to purge the extension entirely from your installation and the hard disk, read Delete Extensions.
---
Page started by DvSchuetz
