Mambo 4.5.5 to 4.6.2 Patch Installation Instructions: Below you will find the steps to bring a Mambo 4.5.5 system up to the 4.6.2 version. This will NOT bring prior versions up to date. You should first try to bring prior versions up to the 4.5.5 patch level before applying the 4.6.2 patch. The Mambo 4.5.5 to 4.6.2 upgrade process is a bit more complicated than other recent upgrades since the 4.6 branch is a minor release. 4.6 is called a minor upgrade since not a ton of visual changes have taken place, but in reality the core of Mambo has had a significant rewrite and a number of new features added. 4.6 is an important milestone for the project that lays the ground work for future versions of Mambo. The team has worked hard on this release and has done a lot of work trying to maintain compatibility with existing 3rd party components, modules, mambots while at the same time trying to move the project forward. That being said it is important that you THROUGHLY test all your 3rd party components with 4.6 PRIOR to upgrading your installation. It is possible that some of your extensions have not yet been made compatible with Mambo 4.6+. We did go through an extended release candidate testing period to work on 3rd party compatibility and provide 3rd party developers with lots of time to start preparing their extensions for the new release. We recommend you report any issues you find during testing back to the corresponding 3rd party developers. The Mambo team will assist 3rd developers as best we can with making their extensions compatible with the new branch. Upgrading Steps: 1) Again... test your 3rd party extensions and upgrade AFTER you are confident they are working to your satisfaction. 2) Backup your site (both database & site files) 3) Note: If you never installed the 4.5.5 version of the MOStlyCE (WYSIWYG editor) mambot and/or the MOStlyCE Admin component then you can skip this step. If you have installed the 4.5.5 versions of the MOStlyCE (WYSIWYG editor) mambot and/or the MOStlyCE Admin component you will need to uninstall them as they were ported versions specific to 4.5.5. After uninstalling the mambot change your default editor to TinyMCE or No Editor in your Global Configuration if it is not already set this way. When you finish with the upgrade to 4.6.2 you can install the 4.6 version of MOStlyCE & MOStlyCE Admin from the new Add-On Installer on the Installers menu if you have PHP5 or by downloading the 4.6 versions manually from Sourceforge (http://sourceforge.net/project/showfiles.php?group_id=25577). 4) Take your site offline: Site->Global Configuration->Site Offline (YES). 5) Remove the following files and whole directories: Directories: /includes/patTemplate /help Files: /includes/mamboxml.php /globals.php /administrator/includes/auth.php /administrator/components/com_weblinks/weblinks_item.xml /administrator/components/com_languages/admin.languages.html.php /language/english.xml 6) Run the SQL statements in the file called 455_to_462_upgrade.sql in the upgrades folder via your normal database interface (ie) phpMyAdmin, MySQL commandline, etc. You will need to replace all instances of "#_" with whatever your table prefix is. By default the Mambo table prefix is set at "mos_". Example: #_containers would change to mos_containers if your table prefix was mos_ (that is a single underscore). 7) Upload and/or extract all files inside the patch into the root of your Mambo installation. Let them overwrite the existing files. 8) Open your configuration.php file a) Change $mosConfig_helpurl to be $mosConfig_helpurl = 'http://docs.mambo-foundation.org'; b) Change $mosConfig_locale to be $mosConfig_locale = 'en'; c) Verify that $mosConfig_lang = 'english'; (or change if not) d) Add the following lines: $mosConfig_usecaptcha = '0'; $mosConfig_locale_use_gettext = 0; $mosConfig_locale_debug = 0; 9) If you are not utilizing Search Engine Optimization (SEO) within your site then you may skip this step. If you are currently using SEO within your exisiting 4.5.5 site then you have a bit more work to do/think about. With Mambo 4.6 the SEO/SEF engine was rewritten and thus 4.5.5 style SEF urls will no longer work properly after you upgrade. If you are currently running a 3rd party SEF extension hopefully you have already tested this out with 4.6 as noted in step 1. A number of the 3rd party SEO extensions available were written specifically for the Mambo 4.5 branch and no longer work under Mambo 4.6. So now for what you can/should/and/or/might want to do... * If you wish to continue utilizing 4.5.5 style urls then you can do this by utilizing the new pre-installed Legacy SEF component (com_legacysef). This was included in the patch by default. In the root of your Mambo installation is a file called htaccess.txt.45x (Note: a backup copy can be found in components/com_sef). You need to rename this file to .htaccess. Be careful to get the right file as there is a similar file named htaccess.txt in the same directory for the 4.6 SEF engine. If you were utilizing SEO with your 4.5.5 site then this file is most likely already in place as .htaccess. To be safe just replace it anyway. With those steps taken your site should continue to work as it has in the past. * If you wish to utilize the 4.6 SEO engine then you can simply rename the htaccess.txt file found in the root of your Mambo installation to .htaccess. This will cause you some extra work since older 4.5.5 urls will no longer work. You will need to update any hardcoded links on your site for the new 4.6 style SEF urls. It is also worth noting that back-links to articles on your site with older 4.5.5 style urls will also not work. Of course all of this relies on the fact that you actually have SEO enabled for your site (Global Configuration->SEO Tab->Search Engine Friendly URLs->Yes). 10) Bring your site back online: Site->Global Configuration->Site Offline (NO). 11) Remove the upgrade folder That's it. Patch complete. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Additional Note - The following are new features of 4.6 that are not present in the patch from 4.5.5 or the Mambo Lite version of 4.6: MOStlyCE, MOStlyDBAdmin, mosComment, latest content module, and additional sample templates. They are present in the full version of 4.6.2 and available as installable addons via the new Add-On installer for those with PHP5 and/or as a manual download from Sourceforge (http://sourceforge.net/project/showfiles.php?group_id=25577).