PHP-Nuke: Management and Programming Chris Karakas www.karakas—online.de Claudio Erba www.spaghettibrain.com Chris Karakas www.karakas—online.de Andre Purfield oss.cs—consultants.com Fortunato Matarazzo Chris Karakas www.karakas—online.de PHP-Nuke: Management and Programming by Chris Karakas, Claudio Erba, Chris Karakas, Andre Purfield, Fortunato Matarazzo, and Chris Karakas There has always been the necessity to have a definitive guide on PHP-Nuke. This guide describes the installation and structure of PHP-Nuke and the details of customizing the front end to suit the users’ needs. The architecture of PHP-Nuke, with its modules, blocks, topics and themes is presented in detail, as well as the interplay of PHP and MySQL for the creation of a mighty content management system (CMS).It also delves into more advanced issues, like the programming of PHP-Nuke blocks and modules, security, acceleration, and optimization. Day-to-day operations and miscellaneous topics are also covered. Revision History Revision 2.1 04.08.2005 Revised by: CK Security bugfix and maintainance release. Fixed typos, made some improvements, closed a security hole in the section on How to include a HTML file and its links (thanks to waraxe for this, see http://www.waraxe.us), closed the same security hole in the PHP-Nuke module version of this document, added code for keycaps, applications, acronyms and product names in the CSS and some enhancements in jadetex.cfg. Revision 2.0 16.02.2004 Revised by: CK Added more than 400 pages of additional material. See Credits section for the exact details. Revision 1.2.1 22.08.2003 Revised by: CK Now available as PHP-Nuke module too. Link to the module source in the Formats section. Smaller logo. Revision 1.2 29.05.2003 Revised by: CK New logo, CSS stylesheet, HTML validation, footer icons. Incorporated LDP reviewer’s comments. Created Aknowledgements and Availability of sources sections. Revision 1.1 13.02.2003 Revised by: AP Cleaned up the wording and a few typos. Revision 1.0 09.01.2003 Revised by: CK First complete version. Table of Contents 1. Terms of distribution.............................................................................................................................1 1.1. Disclaimer...................................................................................................................................1 1.2. Formats........................................................................................................................................1 1.3. Licence........................................................................................................................................3 1.4. Availability of sources.................................................................................................................3 1.5. Credits.........................................................................................................................................4 1.5.1. Version 1.0......................................................................................................................5 1.5.2. Versions 1.x....................................................................................................................6 1.5.3. Version 2.0......................................................................................................................7 1.5.4. Version 2.1....................................................................................................................10 1.5.5. General.........................................................................................................................10 1.6. Aknowledgements.....................................................................................................................11 1.7. Conventions...............................................................................................................................14 1.8. The book behind the book.........................................................................................................15 1.8.1. The general idea...........................................................................................................16 1.8.2. Line of attack................................................................................................................16 1.9. How to translate this HOWTO..................................................................................................17 2. Introduction to PHP-Nuke..................................................................................................................19 2.1. Purpose......................................................................................................................................19 2.2. What Is PHP-Nuke....................................................................................................................19 2.3. Short history of PHP-Nuke.......................................................................................................21 2.4. The PHP-Nuke Communities....................................................................................................21 2.5. Why use PHP-Nuke and not static HTML pages......................................................................22 2.6. The PHP-Nuke forks.................................................................................................................23 2.6.1. PHP-Nuke vs. Post-Nuke.............................................................................................23 2.6.2. PHP-Nuke vs. XOOPS.................................................................................................25 2.6.3. XOOPS vs. Post-Nuke..................................................................................................26 3. How to install PHP-Nuke....................................................................................................................27 3.1. Prerequisites..............................................................................................................................27 3.2. Installation process....................................................................................................................28 3.2.1. Download......................................................................................................................28 3.2.2. Upload through FTP.....................................................................................................28 3.2.3. File permissions............................................................................................................31 3.2.4. Database creation..........................................................................................................34 3.3. How to install PHP-Nuke through phpMyAdmin.....................................................................34 3.3.1. What Is PHPMyadmin..................................................................................................34 3.3.2. How to install phpMyAdmin........................................................................................34 3.4. phpMyAdmin: How to administer MySQL via Web................................................................35 3.4.1. phpMyAdmin navigation bar: Structure.......................................................................36 3.4.2. phpMyAdmin navigation bar: SQL..............................................................................37 3.4.3. phpMyAdmin navigation bar: Export...........................................................................39 3.4.4. phpMyAdmin: other commands...................................................................................40 3.4.5. How to install the DB of PHP-Nuke with PHPMyadmin............................................41 3.5. How to install PHP-Nuke using nukesql.php............................................................................43 3.6. How to install PHP-Nuke locally..............................................................................................44 iii 3.6.1. easyPHP........................................................................................................................44 3.6.2. XAMPP........................................................................................................................46 3.6.3. Apache2Triad...............................................................................................................47 3.6.4. Apache, PHP and MySQL on Mandrake Linux...........................................................47 3.6.5. Apache, PHP and MySQL on Red Hat Linux..............................................................49 3.7. The config.php file....................................................................................................................52 3.7.1. More than one PHP-Nuke sites....................................................................................56 3.8. Resources..................................................................................................................................58 3.9. Common installation problems.................................................................................................58 3.9.1. Test scripts....................................................................................................................58 3.9.2. Warning: mysql_fetch_row(): supplied argument is not a valid MySQL result resource 62 3.9.3. Call to undefined function: message_die() in db.php line 88.......................................63