3 * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
4 * Copyright (C) 2002-2009 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-2009 The Nucleus Group
15 * @version $Id: index.php 1624 2012-01-09 11:36:20Z sakamocchi $
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 v3.6</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();
166 echo '<p class="ok"> No manual changes needed. This must be your lucky day! </p>';
174 * @param int $version
176 function upgrade_todo($version)
178 return upgrade_checkinstall($version) ? "(<span class='ok'>installed</span>)" : "(<span class='warning'>not yet installed</span>)";
183 * Manual update instructions for version 0.96
185 function upgrade_manual_96()
189 $guess = str_replace('/nucleus/', '/media/', $DIR_NUCLEUS);
191 <h2> Changes needed for Nucleus 0.96 </h2>
192 <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>
195 $DIR_MEDIA = '<strong><?php echo i18n;;hsc($guess)?></strong>';
198 <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>
201 } // end function upgrade_manual_96()
205 * Manual update instructions for version 2.0 and before
207 function upgrade_manual_200()
211 $guess = str_replace("/nucleus/", "/skins/", $DIR_NUCLEUS);
213 <h2> Changes needed for Nucleus 2.0 </h2>
214 <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>
216 // extra skin files for imported skins
217 $DIR_SKINS = '<strong><?php echo i18n;;hsc($guess)?></strong>';
220 <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>
222 <h3> RSS 2.0 and RSD skin </h3>
224 <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>
227 } // end function upgrade_manual_200()
231 * Manual update instructions for version 3.4 and before
233 function upgrade_manual_340()
237 <h2> Changes needed for Nucleus 3.4 </h2>
238 <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>
240 <p> Instructions for applying the restrictions are found in the following two files on your server: </p>
242 <li> <a href="../../extra/media/readme.txt">extra/media/readme.txt</a> </li>
243 <li> <a href="../../extra/skins/readme.txt">extra/skins/readme.txt</a> </li>
247 } // end function upgrade_manual_340()
251 * Manual update instructions for version 3.5 and before
253 function upgrade_manual_350()
257 <h2> Important Notices for Nucleus 3.5 </h2>
260 // Give user warning if they are running old version of PHP
261 if ( phpversion() < '5' )
263 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>';
267 <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>
269 <li> <strong>NP_Text</strong>: Allows you to use internationalized skins to simplify translation. </li>
270 <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>
274 } // end function upgrade_manual_350()