3 * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
4 * Copyright (C) 2002-2012 The Nucleus Group
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 * (see nucleus/documentation/index.html#license for more info)
13 * @license http://nucleuscms.org/license.txt GNU General Public License
14 * @copyright Copyright (C) 2002-2012 The Nucleus Group
15 * @version $Id: index.php 1690 2012-03-08 22:45:08Z ftruscot $
19 include('upgrade.functions.php');
21 // begin if: make sure user is logged in
22 if ( !$member->isLoggedIn() )
24 upgrade_showLogin('index.php');
27 // begin if: make sure user is an admin
28 if ( !$member->isAdmin() )
30 upgrade_error('Only super administrators are allowed to perform upgrades');
36 <h1> Upgrade Nucleus </h1>
39 <p> <strong>Note:</strong> If you just installed Nucleus for the first time and are not upgrading from an earlier version, you will not need these files. </p>
42 <p> Database updates may be required when upgrading from an earlier version of Nucleus. This tool allows you to automate these updates. </p>
45 // calculate current version
46 if ( !upgrade_checkinstall(96) )
50 else if ( !upgrade_checkinstall(100) )
54 else if ( !upgrade_checkinstall(110) )
58 else if ( !upgrade_checkinstall(150) )
62 else if ( !upgrade_checkinstall(200) )
66 else if ( !upgrade_checkinstall(250) )
70 else if ( !upgrade_checkinstall(300) )
74 else if ( !upgrade_checkinstall(310) )
78 else if ( !upgrade_checkinstall(320) )
82 else if ( !upgrade_checkinstall(330) )
86 else if ( !upgrade_checkinstall(340) )
90 else if ( !upgrade_checkinstall(350) )
94 else if ( !upgrade_checkinstall(360) )
98 else if ( !upgrade_checkinstall(400) )
107 if ( $current == 400 )
110 <p class="ok"> No database updates required! The database has already been updated to the latest version of Nucleus. </p>
116 <p class="warning"> <a href="upgrade.php?from=<?php echo $current?>">Click here to upgrade the database to Nucleus v4.0</a>. </p>
122 <p> <strong>Note:</strong> It is strongly recommended that you create a database backup <em>before</em> performing upgrades. </p>
125 <h1> Manual Updates </h1>
126 <p> Some updates need to be performed manually. Instructions are given below (if any). </p>
129 $from = intGetVar('from');
146 upgrade_manual_200();
150 // upgrades from pre-340 version need to be told of recommended .htaccess files for the media and skins folders. these .htaccess files are included in new installs of 340 or higher
151 if ( in_array($from, array(95, 96)) || $from < 340 )
153 upgrade_manual_340();
157 // upgrades from pre-350 version need to be told of deprecation of PHP4 support and two new plugins included with 3.5 and higher
158 if ( in_array($from, array(95, 96)) || $from < 350 )
160 upgrade_manual_350();
164 // upgrades from pre-400 version need to be warned of possible plugin incompatibility in general and specifically where known.
165 // may also need to do some things for db encoding?
166 if ( in_array($from, array(95, 96)) || $from < 400 )
168 upgrade_manual_400();
175 echo '<p class="ok"> No manual changes needed. This must be your lucky day! </p>';
183 * @param int $version
185 function upgrade_todo($version)
187 return upgrade_checkinstall($version) ? "(<span class='ok'>installed</span>)" : "(<span class='warning'>not yet installed</span>)";
192 * Manual update instructions for version 0.96
194 function upgrade_manual_96()
198 $guess = str_replace('/nucleus/', '/media/', $DIR_NUCLEUS);
200 <h2> Changes needed for Nucleus 0.96 </h2>
201 <p> A manual addition needs to be made to <em>config.php</em>, in order to get the media functions to work. Here's what to add: </p>
204 $DIR_MEDIA = '<strong><?php echo i18n;;hsc($guess)?></strong>';
207 <p> Also, it will be necessary to create that directory yourself. If you want to make file upload possible, you should set the permissions of the media/ directory to 777 (see the documentation/tips.html in Nucleus 0.96+ for a quick guide on setting permissions). </p>
210 } // end function upgrade_manual_96()
214 * Manual update instructions for version 2.0 and before
216 function upgrade_manual_200()
220 $guess = str_replace("/nucleus/", "/skins/", $DIR_NUCLEUS);
222 <h2> Changes needed for Nucleus 2.0 </h2>
223 <p> A manual addition needs to be made to <i>config.php</i>, in order to get imported skins to work correctly. Here's what to add: </p>
225 // extra skin files for imported skins
226 $DIR_SKINS = '<strong><?php echo i18n;;hsc($guess)?></strong>';
229 <p> Also, it will be necessary to create this directory yourself. Downloaded skins can then be expanded into that directory and be imported from inside the Nucleus admin area. </p>
231 <h3> RSS 2.0 and RSD skin </h3>
233 <p> When a fresh version of Nucleus 2.0 is installed, an RSS 2.0 (Really Simple Syndication) syndication skin is also installed, as well as an RSD skin (Really Simple Discovery). The files <code>xml-rss2.php</code> and <code>rsd.php</code> are available in the upgrade, however the skin itself needs to be installed manually. After you've uploaded the contents of the <code>upgrade-files</code>, open <code>admin area > nucleus management > skin import</code>. From there, you can install both skins. (Unless you don't want them installed, that is) </p>
236 } // end function upgrade_manual_200()
240 * Manual update instructions for version 3.4 and before
242 function upgrade_manual_340()
246 <h2> Changes needed for Nucleus 3.4 </h2>
247 <p> It is recommended that you apply some restrictions to what you allow the web server to do with files in the <i>media</i> and <i>skins</i> folders. These restrictions are not necessary to the functioning of the software, nor to the security of the software. However, they can be an important help under the security principle of denying any access that is not required. </p>
249 <p> Instructions for applying the restrictions are found in the following two files on your server: </p>
251 <li> <a href="../../extra/media/readme.txt">extra/media/readme.txt</a> </li>
252 <li> <a href="../../extra/skins/readme.txt">extra/skins/readme.txt</a> </li>
256 } // end function upgrade_manual_340()
260 * Manual update instructions for version 3.5 and before
262 function upgrade_manual_350()
266 <h2> Important Notices for Nucleus 3.5 </h2>
269 // Give user warning if they are running old version of PHP
270 if ( phpversion() < '5' )
272 echo '<p> WARNING: You are running NucleusCMS on a older version of PHP that is no longer supported by NucleusCMS. Please upgrade to PHP5! </p>';
276 <p> Two new plugins have been included with version 3.5. You may want to consider installing them from the Plugins page of the admin area. </p>
278 <li> <strong>NP_Text</strong>: Allows you to use internationalized skins to simplify translation. </li>
279 <li> <strong>NP_SecurityEnforcer</strong>: Enforces some security properties like password complexity and maximum failed login attempts. Note that it is disabled by default and must be enabled after installation. </li>
283 } // end function upgrade_manual_350()
287 * Manual update instructions for version 4.0 and before
289 function upgrade_manual_400()
291 global $DIR_NUCLEUS, $manager;
293 <h2> Important Notices for Nucleus 4.0 </h2>
296 // Give user warning if they are running old version of PHP
297 if ( phpversion() < '5' )
299 echo '<p> WARNING: You are running NucleusCMS on a older version of PHP that is no longer supported by NucleusCMS. Please upgrade to PHP5! </p>';
302 // find if any of the known plugin incompatibilities are installed.
303 $pluginsToCheck = array(
304 array("NP_ShowComments","Not installed","1.30"),
305 array("NP_MultiLanguage","Not installed","1.10")
307 foreach ( $pluginsToCheck as $plug )
309 if ( $manager->pluginInstalled($plug[0]) )
311 $plug[1] = $manager->getPlugin($plug[0])->getVersion();
316 <p> Nucleus CMS 4.0 represents a lot of fundamental code changes behind the scenes to make use of PHP5 features, to establish a single multi-byte code base, and to generally improve some of the structure to comply with contempary coding standards.
317 As such, despite the best efforts of the development team to maintain backward compatibility with plugins, there are areas where compatibility could not be maintained due to the nature of the 3rd-party plugin system.
318 The following table shows the list of known plugin incompatibilities, please review it and upgrade your plugins as needed. If you experience compatibility issues with any plugins,
319 please request help at our <a href="http://forum.nucleuscms.org">support forum</a>.</p>
321 <tr><th>Plugin Name</th><th>Installed Version</th><th>4.0-compatible version</th></tr>
323 foreach ( $pluginsToCheck as $plug )
325 echo '<tr><td>'.$plug[0].'</td><td>'.$plug[1].'</td><td>'.$plug[2].'</td></tr>';
331 } // end function upgrade_manual_350()