History: Upgrade 2.x to 3.x

Source of version: 34 (current)

^
You should probably be using ((Upgrade))
^



! Upgrade 2.x to 3.x
Minimum ((Requirements|requirements)): PHP 5 and Mysql 4.1
__Be careful - many changes were made in styles, such as switching to a tableless design and revamping how buttons are styled. Many themes that were in the package are no longer supported__ (__[http://themes.tikiwiki.org/tiki-index.php?page=Theme+Issues+when+Updating+to+Tiki3.0|Please read Theme Issues when Updating to Tiki 3.0|shadowbox;title=External site: themes.tikiwiki.org;]__) Plan some time to update your style (see note below) if you are not ready to change it to a bundled one.

{BOX(title=>"SUMMARY: Upgrade in a few simple steps:")}
{FANCYLIST()}Back up all the files and database from your current Tiki installation.
Copy or upload all the files of the newer version onto the files of the older version so any older ones are replaced (ftp with "overwrite if source is newer").
Use your file manager application to find the directory where you have unpacked your Tiki and remove the "lock" file which was created in the db folder.
Go to tiki-install.php and click the "upgrade" button, which will update the database.
Choose a new style 3.x ready for your site, or adapt your old theme style to the new style scheme - see below. 
Check that the features you used to use are still turned on (wiki plugins, among others).
Revise potentially unsafe plugin calls.
Learn the other things that have changed in [tiki3|Tikiwiki 3.0]
{FANCYLIST}{BOX}

!! Step 0. Review release notes
Review ((tw:ReleaseNotes30)).

From version to version, some behavior may change. Some features were not optional before and now are optional, such as wiki structures. You need to turn these on.

!! Step 1. Back up
Read the instructions on how to make a ((Backup)).

!! Step 2. Overwrite


!!! 2.2 Upgrade from 2.latest to 3.x
Get Tiki 3 from here: [http://info.tikiwiki.org/Download]

!! Steps 3 and 4
Upgrade process from 2.x to 3.0 is fairly easy, and it should be self-explanatory. 

If you need further instructions, ask in ((tw:Irc)) or in the tw forums: [http://tikiwiki.org/forums], and please, come back here and upgrade the documentation to make it easier for new users with what you learned.

!! Step 5. Some styles changed
* __If you are upgrading the site from an earlier Tiki release and you have these themes installed already - ''Darkroom, Feb12, TheNews'', and ''Tikinewt'' - you must remove all the old files in their template directories__ (such as ''templates/styles/thenews/tiki.tpl''). These old files are not compatible with Tiki 3. These four themes' template directories should contain only index.php and credits.tpl.
* Other pre-Tiki 3.0 themes are generally incompatible now, so will cause display and function problems. For an immediate fix at the site, switch to one of the new Tiki 3.0 themes.
* If your site uses a customized theme, you will need to make major adjustments. __Themes based on old Tiki themes other than the four listed above will not work correctly in Tiki 3.__ In particular, header.tpl and tiki.tpl have been changed significantly, but there are other changes throughout the template files and stylesheets.  If your left and right columns display below the middle column, this indicates that lite.css properties are missing, so this file needs to be imported (add ''@import "lite/lite.css";'' at the top of your theme stylesheet). This CSS file handles the new tikiwiki tableless layout that is now the default method. In updating your styling, note that in this method, the left and right columns are ''div id="col2"'' and ''div id="col3"'', which are changed from ''td id="leftcolumn"'' and ''td id="rightcolumn"'' in the old default. 
* __Module title__: the module title was in a div before;; now it is in an h3. You may need do add a h3.box-title in your stylesheet in place of div.box-title
* Perhaps the __search module__ and the __tikiwiki logo__ will appear at the top. You may tune this in admin->look, second tab
* The __buttons__ have changed. Add something like ''.button a'' to the stylesheet in place of ''a.linkbut'' and set the margin to 0.
* If you have hard links to ''tiki-file_galleries.php'' you need to change to  ''tiki-list_file_gallery.php''.
* If you want a design with the classic "table" look (full-height borders and backgrounds on side and middle columns, etc.) then see Tiki 3-compatible table-using themes at mods.tikiwiki.org (or themes.tikiwiki.org) such as Kubrick or Andreas08 for use as models, if necessary.

!! Step 6. Check that the features you used to use are still turned on.

More specifically, structures, search, individual plugins, and some other features may have to be activated in the admin panel.

!! Step 7. Revise potentially unsafe plugin calls and approve or reject them
Usage of potentially unsafe wiki plugins has to be validated by users with the new permissions related to approve plugins. This way, any usre can make any attempt to use potentially any plugin, including iframe, dbreport, tag, sql, snarf, regex... which would need to be validated by some trusted users/editors/admins later on in order to aprove or reject them.

A list of plugin calls pending revision can be found at any time here: __tiki-plugins.php__

!! Step 8. Learn about the other changes in Tiki3
You can read and learn about it at this page: ((Tiki3))

-= Related =-
* [http://tikiwiki.org/ReleaseNotes30]
* ((Upgrade))