PHP-Nuke: Management and Programming

]> PHP-Nuke: Management and Programming Chris Karakas www.karakas—online.de Claudio Erba www.spaghettibrain.com Conversion from LyX to DocBook SGML, Index, document generation, PHP-Nuke module, see Credits Chris Karakas www.karakas—online.de Translation from italian (v.1.0) and translation project coordination, see Credits Andre Purfield oss.cs—consultants.com Translation from italian (v.1.0), see Credits Fortunato Matarazzo Translation from italian (v.1.0), see Credits Chris Karakas www.karakas—online.de PHP-Nuke programming management tutorial PHP MySQL Linux structure news content management system CMS UNIX nuke modules blocks topics themes architecture howto guide content download book installation permissions error sessions security caching optimization javascript googletap backup flash ]]> ]]> ]]> ]]> Figure ]]> ]]> ]]> ]]> Figure 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. 2.1 04.08.2005 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. 2.0 16.02.2004 CK Added more than 400 pages of additional material. See Credits section for the exact details. 1.2.1 22.08.2003 CK Now available as PHP-Nuke module too. Link to the module source in the Formats section. Smaller logo. 1.2 29.05.2003 CK New logo, CSS stylesheet, HTML validation, footer icons. Incorporated LDP reviewer's comments. Created Aknowledgements and Availability of sources sections. 1.1 13.02.2003 AP Cleaned up the wording and a few typos. 1.0 09.01.2003 CK First complete version. Terms of distributionDisclaimerNo liability for the contents of this documents can be accepted. Use the concepts,concepts examples and other content at your own risk. As this is a new edition of this document, there may be errors and inaccuracies, that may of course be damaging to your system.system Proceed with caution, and although this is highly unlikely, the author does not take any responsibility for that.All copyrights are held by their respective owners, unless specifically noted otherwise. Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark.Naming of particular products or brands should not be seen as endorsements. Formats Include the <application>PHP-Nuke</application> HOWTO as a module in your <application>PHP-Nuke</application> site! You can include the PHP-Nuke HOWTO in your PHP-Nuke site as a module using either the method of or the method of ! To use the method of , download the PHP-Nuke module version of the PHP-Nuke HOWTO and install it according to the instruction in the accompanying INSTALL file. To use the method of , just make a module with an index.php file exactly as in the example shown there. It will show the starting page of the PHP-HOWTO in an iframe () and you will be able to navigate its pages without installing anything locally. You have Chris' explicit permission for this. ]]> ]]> ]]> ]]> Inline graphic This document is available in the following formats:formatsHTML (HyperText Markup Language), many HTML files (one for every section), for viewing with any browserHTML (HyperText Markup Language), one big HTML filePHP-Nuke ModuleTXT (ASCII Text)RTF (Rich Text Format)PDF (Portable Document Format)PS.GZ (Compressed Postscript)SGML (Standard Generalized Markup Language), (with the Appendix)LYX (LaTeX frontend LyX), (with the Appendix) RTF: Page numbers In order to get correct page numbers in Microsoft Word, type the following after opening the document: CTRL END CTRL A F9 In Word Viewer 97, you must instead do: CTRL END ALT V N ALT V P See The OpenJade RTF backend for more details. IMPORTANT: Downloads for offline reading! If you want to download the HTML or RTF formats for offline reading, you will need to download the images as well - PNG for HTML and BMP for RTF, including the callouts! To save you the hassle, I have compiled the following zipped tar archives for offline reading: TAR.GZ (Compressed TAR Archive), many HTML files with images TAR.GZ (Compressed TAR Archive), one big HTML file with images TAR.GZ (Compressed TAR Archive), SGML file with images TAR.GZ (Compressed TAR Archive), RTF file with imagesA tarball containing all the above formats,formats including images, is also available: TAR.GZ (Compressed TAR Archive), All files LicenceCopyright ©copy version 1.0 2002 by Claudio Erba. Copyright ©copy version 2.0 2004 by Chris Karakas and Claudio Erba. Copyright ©copy version 2.1 2005 by Chris Karakas and Claudio Erba. Permission is granted to copy,copy distribute and/or modify this document under the terms of the GNU Free Documentation License,GNU Free Documentation License Version 1.2 or any later version published by the Free Software Foundation;Free Software Foundation with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license can be found in , as well as at the GNU Free Documentation License.Original version 1.0 by Claudio Erba, webmaster of spaghettibrain, PHP-Nuke italian Mirror, 2002. Second, revised and expanded, version 2.0 2004 by Chris Karakas and Claudio Erba (see for details). Corrected 2.1 version 2005 by Chris Karakas and Claudio Erba (see Revision History for details).This book, in all its versions (also those modified from third parties in italian, english or whichever other language), for will of the authors, may be reproduced also integrally without violating any law in asmuch as this book is released under the GNU Free Documentation License, see .This book:May be modified partially or integrally creating manuals for companies, agencies or persons who deal with formatting, changing either the diagramdiagram or the contents or the pagination.paginationMay be distributed either in its original or in modified form, or either in electronic or in paper format from either field periodicals or not, Internet sites and whichever other medium.May be used as internal manual by companies, public or private agencies, or universities .May be used distributed by universities as a hand-out.hand-outMay even be resold without having to recognize any type of royalty to the authors on the condition that the purchasers be granted the freedom of making even integral copies, redistribute or resell them. Availability of sourcesSee for the modifiable sources of this document. These are the official versions. We (the authors, translators and current maintainers) plan to continue work on this document and add new chapters and enhancements.enhancements If you want to see the version we are currently working on (the “bleeding edge” version), check PHP-Nuke: Management and Programming from time to time.The modifiable sources of Claudio's text (in italian), the images and example files are available in sxi format (OpenOffice Impress)Openoffice is an office suite completely free which you can download from OpenOffice. on Downloads Area PHPNuke BOOK - LIBRO on spaghettibrain. CreditsThis section documents the efforts that have been invested into this document by its authors, contributors and the community.community We tried hard to give credit where credit is due. However, this does not mean that we used only the sources mentioned explicitly here, in this section. Numerous other sources of information have been used, mainly Forums, such as:PHP-Nuke Forum of Chris Karakas.spaghettibrain of Claudio Erba.nukeforumsnukecopsWhenever a source has been used, we have included a link to it. Thus, depending on the context,context you should interpret the links in this document not only as a source of further information on a subject,subject but also as Credit and a “Thank you” for the idea, the explanation,explanation the discussion or the piece of code it offers. If you feel we have ovelooked something, please feel free to contact us.We do not offer a Bibliography,Bibliography as strict academic criteria would require, but this may change in the future, as Chris is working on a solution to the Bibliography problem in the context of LyX and SGML. How to enter hundreds of references in LyX If you look in the following , and especially , you will notice the exceptionally large number of cross-references that had to be entered. Although a single cross-reference is inserted very easily in LyX (just choose Insert->Cross-reference from the menu, then choose the label of the reference you want), it becomes a real pain if you have to enter hundreds of them, as in our case. Chris' solution to this was to write a script that reads a LyX file and outputs another LyX file that contains references to all labels of the first one. It was easier to copy the references from the file thus created, paste them in (which deals with version 2.0), then delete references to parts that already existed in version 1.0, than try to insert references to all new parts of version 2.0 by using the menu. You can read about Chris' script in Mass insertion of cross-references in LyX. Version 1.0This book started in version 1.0 as a document in italian language, written by Claudio Erba. It contained: , consisting of , , , and . This was Chapter 1 of version 1.0., consisting of , , , , and . This was Chapter 2 of version 1.0., consisting of , a section on AvantGO,AvantGO now removed, and . This was Chapter 3 of version 1.0., consisting of and . This was Chapter 4 of version 1.0. consisting of , , , , , , , and . This was Chapter 5 of version 1.0., consisting of , , , and . This was Chapter 6 of version 1.0., consisting of , , and . This was Chapter 7 of version 1.0., consisting of , , , . This was Chapter 8 of version 1.0., consisting of , , , and . This was Chapter 9 of version 1.0., consisting of , and . This was Chapter 10 of version 1.0., consisting of , , , , , and . This was Chapter 11 of version 1.0.Version 1.0 came with the following figures:, , , , , , , , , a screenshot of the News articles that has been removed, , , , , , , , , , , , , .Version 1.0 contained no tables.tablesAndre Purfield of Open Source Solutions started the translation project (see the PHP-Nuke book translation thread at nukeforums) and coordinated the work of the translators.translators Fortunato Matarazzo made the transaltion of the version 1.0 Chapters 7, 8 and 9 (see above). Chris Karakas translated the rest. Andre imported Fortunato's part into LyX,LyX remade many of the screenshots and also made corrections to the english text of the whole document. Chris imported his part in LyX,LyX formatted the whole document, created the Index and processed the LyX file through his scripts (see , for details) to render all the versions and files available from .Chris also made PNG,PNG PDF (encapsulated PDF), EPS (encapsulated Postscript) and BMP versions of all figures. The PDF and EPS versions are included in the PDF and PS versions of the document respectively. The PNG and BMP versions are used by the HTML and RTF versions of the document respectively and are supplied separately in the images folder. Versions 1.xIn the 1.x versions, various improvements have been made on the document, as can be seen in the Revision History in the front page:Version 1.1: Andre Purfield of Open Source Solutions cleaned up the wording and a few typos.Version 1.2: Chris Karakas made various improvements:Added a new logo.logoAdded a CSS stylesheet for DocBook.Took care of HTML validation (all HTML pages now are validated as conforming to the HTML 4.01 Transitional standardall, that is, except those that contain callouts, see HTML validation.).Added footer icons that have the following property: if you click on them, they validate,date depending on the icon, either the HTML code or the CSS code of the page being currently viewed.Added translation links in the header and footer:footer in the header of each page, you will find links to Google's automatic translation of that page into 5 languages - french,french german, italian, portuguese and spanish. In the footer of each page, on the other hand, you will find links to Alta Vista's automatic “BabelfishBabelfish” translation of that page into 8 languages: chinese, german, japanese, korean,korean french,french italian, portuguese and spanish.Incorporated LDP reviewer's comments.comments Created and .Version 1.2.1: Chris created the PHP-Nuke HOWTO module for PHP-Nuke, a module that integrates this HOWTO into your PHP-Nuke site (you could install this module too, tip, tip!). Chris added a link to it in the Formats section () and made a smaller logo.logoDue to Chris' efforts, starting from version 1.2 this document is an official HOWTO of the Linux Documentation Project. Also, starting from PHP-Nuke version 6.7 FINAL,FINAL this document is included in the docs folder of the standard PHP-Nuke package, as the official PHP-Nuke guide.guideIn all 1.x versions after 1.0, the original italian text has undergone no changes other than those related to translation. But behind the scenes, Chris and Claudio were working fervently for the next version 2.0, which was going to bring dramatic improvements, as you can read in . ]]> ]]> ]]> ]]> Inline graphic Version 2.0In version 2.0, Chris Karakas added the following Chapters and Sections:SectionsIn : , , , , , , , , and .In : , , and .In : , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , and , , and .In : , , , .In : and .The whole : , , , , , , , , , , , , , , , , , , , , , , , , , and .The whole : and .The whole : , , , , , , , (FIXME:FIXME Well, this may not be finished by the time version 2.0 is released, but the will to write it was certainly there! :-) ).The whole : .The whole : , , and .In : , , , , , , , , , , , , , , , , , , , , , and .The whole : and .The whole : , and .The whole : , , , , , , , , , , , , and .The whole : , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , and .The whole : and .In : , , , , , , , , , , .In : , , , , , , , , , , , , , , The whole : .In : , , , , , , , , , , , (some changes), , and .The whole : , , , , , , , , , , , and .The whole : , , , , , , , , , , , , , , , and .In : , , , and .The whole : , , , , , , , , , , , , , , , , and .In version 2.0, Claudio Erba added the following Chapters and Sections:SectionsIn : , , , , , , , , and .In : The introductory text () and .In : A lot of additions and improvements in the whole chapter: , , .In : A lot of additions and improvements in the whole chapter: , (which was added in this version) and .In : Some changes in and .In : , , , , , , and .In : , , , , , , , , and . Note As you can see, almost all labels of version 1.0 have been preserved in version 2.0 too. More specifically, all labels that give rise to HTML files have been preserved in the LyX file. That's no coincidence: Cool labels don't change! Chris translated Claudio's additions from italian and inserted some additions and many cross-references.cross-references On the other hand, some of Claudio's information has found its way in the sections added by Chris.Chris We have added the GNU Free Documentation Licence in the .The following figures have been added in version 2.0:Chris added: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , and .Claudio added: , , , , , , , , , , , , , , , , , , , , , , , , and .Again, as in version 1.0, Chris made PNG,PNG PDF (encapsulated PDF), EPS (encapsulated Postscript) and BMP versions of all figures to be used in the various formats of the document. The following tables have been added in version 2.0:Chris added: , , , , , , , and .Chris wrote all new material of version 2.0 in LyX,LyX formatted the whole document, created the Index (semi-automatically this time, through some of his sed and awk scripts, as described in Document processing with LyX and SGML) and processed the LyX file through his scripts (see , for details) to render all the versions and files available from . Version 2.1In version 2.1, Chris Karakas added the following Chapters and Sections:SectionsIn : how to include two files side-by-side in a module. GeneralSome quotes have been taken from the installation files of phpnuke.org, as well as from the MySQL manual.In we use material taken from A Brief Introduction to Regular Expressions.The sections on mod_rewrite:rewrite , , , and have been taken from the Apache Documentation of mod_rewrite. and part of were taken from a post of Paul S. Owen,Owen Development Team Leader of phpBB, in http://www.phpbb.com/phpBB/viewtopic.php?t=69493, as well as in http://www.phpbb.com/kb/article.php?article_id=54 and are included here with permission.permission is taken from W3C's working draft CSS3 Paged Media Module, version of Dec. 18th 2003 and is Copyright ©copy 2003 W3C (MIT, ERCIM, Keio), All Rights Reserved. Used with permission according to W3C document licence.The examples for admonition in the Conventions Section () were taken from the Section on admonitions of the DocBook Guide of the Debian Newbiedoc Project.The CSS file for DocBook that is used in this document , ck-style.css, uses QBullets in links. See Explain CSS on how to do this. Thanks to Matterform Media for providing QBullets for free. If you plan to use them on your website,website please observe the QBullets usage terms. The CSS also got important elements from the Newbiedoc CSS file for DocBook and Mark Pilgrim's influential dive into Accessibility. The CSS font size controlling code and its explanation are taken from Using relative font sizes. AknowledgementsClaudio said in the first version (1.x) of this document: The following people contribute, directly or indirectly to this projectproject and their help is hereby kindly aknowledged:Francisco Burzi with all the introductory scripts, found in the files of installation of PHP-NukeVasco Clergy and his daughter Valentina of Lug Rieti for the translationsations of the modules of the handbookMicaela Bechini,Bechini for the daily translations of phpnuke.org from English.EnglishThe communities of Splatt.it, Nukeitalia.com, PHPnuke.it (and its Mailing List), Postnuke.it, envolution.it, xoops.it and obviously the 1500 registered users of spaghettibrain.Aemmenet,Aemmenet in the person of Mark Atzori that has granted us free use of the server on which spaghettibrain is accommodated.Roberto Scano of IWA Italy and Patrizia Bertini of Webaccessibile.org for the contributions on usability,usability accessibility and W3C validation.validationMarcello Tansini of webmasterpoint.org for the support given to the project in terms of visibility.visibilityAndrea Birgahi, the best PHP-Nuke Theme Maker of the world for the diagramdiagram of spaghettibrain, for the logo of the book and a lot more.My girl Sara for all...My mother Lella, my sister Cora, my dog Grey and the newly arrived babybaby dog Maya.

This book I dedicate it to my Pap� Antonio. Hello P�.P�.

For this second version (2.x), Claudio wishes to thank:Francisco Burzi, the daddy of PHPNuke,PHPNuke who has chosen this book as the official PHP-Nuke handbook!The translator and the manager team of the PHP-Nuke HOWTO:HOWTO Chris Karakas, Andre Purfield, Fortunato Matarrazzo.MatarrazzoUmberto Zaccarini of WMG Italia.Euro Gala of Eticoweb, for the operative and ethical support.Florence University,University because after reading my book they called me to give a course of CMS at Multimedia Master; in particular D.ssa Barbara Iraci, Dott. Diego Mencarelli and Dott. Del Bimbo. Thanks to every master student, too.My team, the Crew Spaghetti, Andrea Biraghi, Federico Campoli,Campoli Fabio Pirovano, Claudio Demarinis and the casual externals Alex Zollia, Micaela Bechini,Bechini VirtualDarkness.VirtualDarknessMichel "Ziobudda" Morelli, Fabio Farnesi (programmiamo.net), Giovanni Tummarello (wup.it), Roberto Scano (IWA Italia), Anna Bruno (fullpress.it), Alessandro Del Rosso and the De Andreis brothers (punto-informatico.it), for the mediatic space they give me every time.My mother Lella, my sister Cora, my dogs Maia and Grey.My Sara for everything.Chris wishes to thank:Francisco Burzi, for writing PHP-Nuke and publishing it under the GNU General Public License.Claudio Erba for bringing the ball in rolling.Andre Purfield for starting this wonderful project in the PHP-Nuke book translation thread at nukeforums.com.nukeforums.comAll software developers, whose software is used in the preparation of this document (see ): LyX,TeX,LaTeX,pdfTeX,hyperref,openjade,pdfjadetex,thumbpdf,DocBook DSSSL stylesheets,collateindex,sgmltools,HTML tidy,HTML split,sed,runsed,awk,dvips,and all the standard software used in a GNU/Linux system.systemnukeforums for providing a Forum for the initial stages of this project (see the PHP-Nuke book translation thread), as well as all its numerous readers for their questions and answers - who have influenced many solutions presented in this document. Special thanks go to its most active membersmembersHumpa, Chatserv, Chris-au, for all the useful advice. I've learned a lot from you!Paul S. Owen for his contribution in on session management.managementMark Pilgrim for writing Dive into Accessibility and publishing it under the GNU Free Documentation License.All authors of documentation used in various places (see ):PHP-Nuke,PHP manual,MySQL manual,A Brief Introduction to Regular Expressions,Apache Documentation of mod_rewrite,CSS3 Paged Media Module,Debian Newbiedoc Project.Matterform Media for providing QBullets for free.Didi for .Martin Kaspar for inspirating discussions on PHP-Nuke documentation.documentationAll visitors of the Karakas Online PHP-Nuke Forum for their kind remarks and suggestions for the improvement of the document, especially: nikits72, Last, but not least, Gloomy for all the moral support during the hard times.The translators would like to thank the Linux Documentation Project (TLDP) and its reviewers, especially Tabatha Marshall and Greg Ferguson for their comments and efforts to make this document available from TLDP's plattformplattform to a wider audience. Conventionsadmonitions Admonitions are little pictures used to emphasize something of importance to the reader. The four types used are: Note Using a hammer to put together your computer is bad. Tip Do not hit your thumb with the hammer, it hurts! Important Watch where you're swinging that hammer! Caution Hitting your thumb with a hammer may lead to an unwanted trip to the hospital! Warning Do not, under any circumstances, admit that you hit your own thumb with a hammer. The ridicule you will face is astounding! Access keys Access keys enable navigation through the document, without relying on a mouse. The following keys have been given special meaning in this document:P Previous page.N Next page.H Home of the document (Table of Contents).U Up (takes you one level up the section hierarchy).If you also happen to be reading the document from its original location, then the following access keys can also be used:S Start (takes you to the author's start page).T The current (“This”) page, without the Sitemenu on the left.M The current page in a frameset, where the left frame contains a Menu. To use the access keys, you have to simultaneously press a modifier key, which may vary from browser to browser. For example in NN6+/Mozilla, the modifier key is ALT, so you have to use ALT N to go to the next page, and ALT P to come back. In other browsers such as IE6, the access keys just give focus to the associated link, so the sequence becomes ALT N Enter . Try it, you'll like it! ]]> ]]> ]]> ]]> Inline graphic The book behind the bookDo you want to create professionally formatted documents? Tired of always having to change the font settings, to insert or delete pagebreaks,pagebreaks to format your text for printing,printing monitor, or web view? Do you find yourself spending hours of your life into formatting issues that you wish you never had to be conftonted with? Did you, during your editing efforts, ever get the uncomforting feeling that you are inventing the wheel for th 39th time? Well, in fact you are! You can use the power of Open Source tools like LyX and sgmltools to create the documents you've dreamed of, while, as a nice side effect, concentrating on what deserves most of your attention: Content,Content not Formatting! In Document processing with LyX and SGML, Chris Karakas describes a method by which all you have to do is to write your document in LyX, then run the .lyx file through a script that will produce the SGMLSGML source and, from it, the HTML,HTML TXT, RTF, PDF and PS formatted documents (as in ), complete with table of contents, embedded pictures, fonts, thumbnailsthumbnails (for PDF) and other goodies - just as in the document you are reading right now!That is, to learn how to produce a book like this one, you have to read the book behind the book. ]]> ]]> ]]> ]]> Inline graphic The general idea When writing LyX documents, formatting should be the last thing on your mind. Concentrate on writing a clear and c oncise document. The sgml parser will take care of the formatting.We've all heard of WYSIWYG.WYSIWYG LyX is WYGIWYM.WYGIWYM WYGIWYM stands for "What You Get Is What You Mean". This means if you mean for text to represent source code you assign it a source code environment (Lyxese for style), and it formats the way you meant it to. You needn't worry about formatting during the writing of your document. If you don't like the way it looks upon finishing and printing it out, you can change the way styles map to formatting, and those styles will consistently change throughout the document. Line of attack The method described in Document processing with LyX and SGML follows a line of attack defined by the following:We put everything in a shell script. We don't want to bother about anything else. We want to ponder comfortably upon the meaning of life while drinking some coffee or tea, watching our computer do the work for us - personally, a very rewarding experience :-)We use sed to correct LyX' SGML output. The more we are able to correct, the more SGML features we get out of our plain vanilla LyX.LyXWe use the sgmltools package which hides a lot of details from the end user, giving nonetheless all the power of the involved tools.The current version of the lyxtox script make less use of sgmltools, due to the need of processing intermediate results for the integration of Mathematics, Bibliography etc. The originally used calls to sgmltools are nonetheless included in the comments of that script to demonstrate alternative ways of achieving the same result.We will adapt the DocBook DSSSL stylesheets to our personal needs and taste.taste.The end product shall be a directory ready to upload to our web server with all files, links, images and formats necessary.So you got appetite and want to delve into the gory details? Read the book behind this book: Document processing with LyX and SGML! ]]> ]]> ]]> ]]> Inline graphic How to translate this HOWTOThe PHP-Nuke HOWTO started also as a translation.translation You can read how it all started in PHP-Nuke book translation thread at nukeforums.com.nukeforums.comThe best way to do the translation would be to install the LyX. Chris still uses an old version (1.2.0) of it, but you could try the newest one and we will see if his document processing scripts still work. ]]> ]]> ]]> ]]> Inline graphic The process is the following (see, for example, Greek Translation of Php-Nuke HOWTO and New language translation howto): EnumerateYou take the LyX version of the book from the Formats section (), you do the translation in LyX,LyX then send it to Chris Karakas (chris at karakas-online dot de). EnumerateChris will use his scripts () to export the LyX document to SGML,SGML correct the SGML that comes out of LyX, then produce all other formats,formats as in ).The advantage of this method is that you only need to translate the words,words leaving everything else (like "environments", SGML tags etc.) untouched. This way paragraphs, admonitions (see ), callouts (those small numbers in circles that you see in some code examples, as in ), code environments etc., all remain intact - and you don't need to recreate them.We are in search of available volunteers to translate this book in as many languages as possible. In the case you are interested in translating this book, write to chris at karakas-online dot de, or PHP-Nuke HOWTO. Be prepared for months of hard work, as this is 500 pages of printed material! Introduction to PHP-NukePurposeThere has always been the necessity to have a definitive guide on PHP-Nuke. Due to time constraints,constraints nobody has ever had the will to carry out this operation.operationNot any more! With this book, PHP-Nuke now posesses the most comprehensive guide on the subject,subject suitable for newbies and advanced users alike! What Is PHP-NukePHP-Nuke is free software, released under the GNU License.It is a CMS (Content Managment System) that integrates in its inside all the instruments that are used to create, in a broad sense, an informationinformation portal (). Given the immense number of present functions in the installation and in an even greater quantity of modules developed from third parties, the systemsystem is also adept to the management ofIntranet business,business e-commerce systems, corporate portals , public agencies, news agencies, online companies, information sites,e-learning systems and so on...

phpnuke.org, the official <application>PHP-Nuke</application> site. ]]> ]]> ]]> ]]> phpnuke.org, the official PHP-Nuke site. phpnuke.org, the official PHP-Nuke site. PHP-Nuke utilizes as hinge of its own structure the duo PHP+ MySQL, very often being accompanied by the Apache web server.server Many modules have integrated many other languages, such as Javascript,Javascript Java,Java Flash and also even systems that serve, through the portal, sounds and films in streaming mode (Online Radio,Radio TV Online, Images, Files...). From version 6.x onwards, the compatibility has been extended to include other databases as well, in order to extend the user base even more vastly. PHP-Nuke is developed with a particular eye to the suggestions of the W3C, in its origin,origin the code is in fact W3C compliant and one has validated both the code and the style sheets.style sheets It is then up to the user who intends to create a portal to adhere to these standards during the modification of the graphics or the intrinsic characteristics of the system.systemThe personalisation either of the graphical, or of the programming part has only a single limit, the fantasy and capability of the programmer and web designer.designerThe presence of many PHP-Nuke sites similar to each other is due mainly to the lack of time of those who created them or the fear that the phase of personalisation is too difficult on a technical level. In fact, it suffices to let oneself be inspired by the available themes,themes in order to realize how easy it is to sew a new dress to one's portal.portalFrancisco Burzi,Burzi father and mother of PHP-Nuke, describes his creation as follows:

PHP-Nuke is a Web Portal System, storytelling software, News system,system online community or whatever you want to call it. The goal of PHP-Nuke is to have an automated web site to distribute newsnews and articles with users system.system Each user can submit comments to discuss the articles, just similar to Slashdot and many others. Main features include: web based admin,admin surveys, top page, access stats page with counter,counter user customizable box, themes manager for registered users, friendly administration GUI with graphic topic manager,manager option to edit or delete stories, option to delete comments, moderation system,system Referers page to know who link us, sections manager,manager customizable HTML blocks, user and authors edit, an integrated Banners Ads system,system search engine, backend/headlines generation (RSS/RDF format), and many, many more friendly functions.PHP-Nuke is written 100% in PHP and requires Apache Web server,server PHP and a SQL (MySQL, mSQL, PostgreSQL, ODBC, ODBC_Adabas,ODBC_Adabas Sybase or Interbase). Support for 25 languages, Yahoo like search engine,engine Comments option in Polls, lot of themes, Ephemerids manager, File Manager, Headlines, downloaddownload manager, faq manager, advanced blocks systems, reviews system, newsletter,newsletter categorized articles, multilanguage content management and a lot more.

Short history of PHP-NukeFrancisco Burzi,Burzi describes the history of PHP-Nuke as follows:

PHP-Nuke is a free software, released under the GNU GPL License, version 2.0. PHP-Nuke is the result of many years administrating a news site called Linux Preview. First, around August 1998, I wrote my own code in Perl called NUKE and used it for about 1 year, then my site grew big, so I needed a more powerfull system and decided to use Slash,Slash the same used in the Slashdot site. It's good, but you realy need to know Perl to modify it, need too many modules,modules need to load a damn daemon that sucks all your CPU power. My Pentium III just appeared to be a 386 each minute the daemon made its work.Well, then I discovered Thatware,Thatware a good project to have a news site under PHP.PHP I learned PHP in less than a week and began modifying it. There are too many mods to mention, it was practicaly a rewrite.rewrite I added some cool stuff, deleted some others and after more than 380 hourshours of hard work in 3 weeks! PHP-Nuke was born.On August 17, 2000 I sold LinuxPreview.Previeworg to LinuxAlianza.com and now I have all the time to dedicate to the development of PHP-Nuke.From January 2001 to January 2002, PHP-Nuke has been financially supported by MandrakeSoft, the folks that made Mandrake Linux.Linux This gave me and PHP-Nuke a lot of oxygen and made possible a lot of stuff.Now, I'm alone with this killer project.project There is a lot of help from the people that use and develop modules and themes.themes Now, phpnuke.org is a big site with a lot of users and helpful information for any user around the world. There are also strong users community sites in almost any language you can imagine. Just go to phpnuke.org and enjoy this great community!

The <application>PHP-Nuke</application> CommunitiesA careful look is due to the true value of PHP-Nuke, that is the communitiescommunities that you will find all around. Thanks to the voluntary job of these persons, of these sites, PHP-Nuke has become a well-known system and it is always thanks to them that PHP-Nuke is a multilanguage system that supports more than 25 languages. Even the modules have been created mostly from developers in external communities and have, in second round, been included in new distributions of PHP-Nuke. There are communities out there who are solely devoted to the creation of new graphical themes of PHP-Nuke, to technical support, file mirroring as well as a real lot of multilingual communities that take care of their members informing them in their local language, thus creating new personal ties and more focused projects. Nukeforums.com: Technical support to PHP-Nuke.Nukecops: Official PHP-Nuke development team.Karakas-Online PHP-Nuke Forum: Chris' PHP-Nuke Forum.ForumNukedownloads.com: File mirror for downloads.adsnukeresources.com: Downloadsadsnukefixes.com: Fixes for PHP-Nuke bugs.bugsnukesecurity.com: PHP-Nuke security.securitySomara.com: Themes and graphics.graphicsNukethemes.com: Themes and graphics.graphicsEcomjunk.com: Addons and modules.modulesNukeaddn.com: Addons and modules.modulesCommunities in Italian language: Spaghettibrain.comClaudiodemarinis.itPHPnuke.itSplatt.itNukeitalia.comThanks to the work of these portals and single persons we have more than 500 different modules and blocks that may be used to personalize our portal,portal in areas varying from the weather () to e-commerce (), from gallery () to chat realized in flash and videogames in Java,Java all included in the layout of PHP-Nuke. Why use <application>PHP-Nuke</application> and not static HTML pagesBecause managing large sites with only static HTML pages is dangerous for your health.Because through the dynamic pages, users can interact (Forum,Forum chat)Because through the dynamic pages we can offer value added services (restricted areas, various services based on user classification.classification..) Because the information is more easily catalogued.Because with a few PHP pages we recall a lot of information.informationBecause keeping the contents up-to-date does not demand particular technical expertise and can be managed by anyone (by Davis Batistes).It is the simplest way to to pull over a complete portal,portal thanks to its open source engine,engine it allows anyone to implement new modules or to modify and to personalize existing modules.modules (by Micione,Micione www.vizzani.net)It is very intuitive and easy to learn (by Anonymous)It is easy to modify by those who intend to personalize the program (By Arus)It is easy to use by the lesser experts among us. The <application>PHP-Nuke</application> forksThere are several CMS systems, which are PHPNuke forks;forks among the most famous, we can mention Post-Nuke, Envolution, MyPHPNuke and Xoops.PHP-Nuke vs. Post-NukePost-Nuke is another Content Management System (CMS) similar to PHP-Nuke. Whilst PostNuke is a fork of PHP-Nuke, the entire core of the product has been replaced, with the aim of making it more secure and stable, and able to work in high-volume environments with ease.Some of the highlights of PostNuke are, according to its developers (in Post-Nuke Modules):Customisation of all aspects of the website's appearance through themes,themes including CSS support.The ability to specify items as being suitable for either a single or all languages.The best guarantee of displaying your webpages on all browsers due to HTMLHTML 4.01 transitional compliance.complianceA standard API and extensive documentation to allow for easy creation of extended functionality through modules and blocks.The merits of Post-Nuke, as compared to those of PHP-Nuke, have been subject of controversial discussion among fans of both CMSs. We cannot give an objective opinion, since we are biased towards PHP-Nuke. ]]> ]]> ]]> ]]> Inline graphic However, we will try to give you an idea: Even its critics will agree that, for a portal whose purpose is to make information publicly accessible,accessible PHP-Nuke is a very good solution. In comparison to Post-Nuke,Post-Nuke most people will also find that PHP-Nuke has many more modules available. However, some will argue that most of them seem geared toward the average end user and not a business or corporate environment.On the plus side, PostNuke has a very detailed strict user permissions system allowing you to limit access to every module and area of your site to a general group or a specific user. The permissions system allows you to create groups and users with special permissions. You can add a user to one or many of these groups to give a variety of complex permissions easily. This is handy if you need moderators, sub admins, and other people helping manage a commercial site and wish to limit admin access. This may make PostNuke more appealing to a professional site - but see the Your Account Tweak module (), the Approve Membership module ( ), the eCommerce modules () or the Project Management WorkBoard module () before you draw premature conclusions. ]]> ]]> ]]> ]]> Inline graphic Here are some PostNuke modules that are popular among business end users:Xanthia Theme EngineContentExpess Content managementStatic Content ManagementPostCalendarFormExpress Forms GeneratorpnAddressBook (Palm Style)LDAPNukeOWLPNphpBB2However, PostNuke seems to be caught prisoner of its own development impetus:impetus it changed so fast, so often, and made code break backward compatibilitycompatibility in newer versions so often, that it became difficult even for seasoned webmasters to follow it. Lack of compatibility even between adjacent versions and rumours on its development being suspended, has robbed the nerve of quite a few people, who then turned back to PHP-Nuke for its great community,community support, continuing, smooth development and vast collection of modules.modules The following quote,quote taken from History of PHP-Nuke and Post-Nuke, reflects this situation:

I spent a month trying to customize Post-Nuke for a client, and then I gave up. It was too hard and the support was non-existent. Although you'll find many people in the community who want to help you, you'll find no one who has experience with the particular version you've got.

Is Post-Nuke more secure than PHP-Nuke? The security argument is often heard in favour of Post-Nuke. However, a commited cracker will probably not encounter considerably more difficulties in cracking Post-Nuke, than PHP-Nuke, as the following testimonial, taken from the discussion in History of PHP-Nuke and Post-Nuke, illustrates:

I have a fair few associates who are still hackers, and they can crack into any Post-Nuke site in 20 seconds flat - I've timed them - and they've had full - note: FULL access to the administration section when they have. The fastest I've seen them hack the least secure PHP-Nuke over the past year, is 30 seconds approx. (32 seconds to be precise). That doesn't sound like PHP-Nuke is less secure to me. The latest version of PHP-Nuke (6.5) prior to it's RC1 with the new security procedures in it, it took them 5 minutes to hack into it.

Of course, 5 minutes will not make you sleep any more quiet than with Post-Nuke,Post-Nuke but the Web is a dangerous place by construction and and the point is of relative, not absolute nature.nature PHP-Nuke has improved its security even more since then. For more details on PHP-Nuke security,security we refer you to , where we will talk about PHP-Nuke's past security vulnerabilities,vulnerabilities its new security procedures and what you can do to enhance its security even further.We cannot go into more details on PostNuke, since they would easily fill another book. Perhaps the best test is to visit the homepages of both projects, PHP-Nuke and PostNuke - and decide for yourself which one you like best. ]]> ]]> ]]> ]]> Inline graphic PHP-Nuke vs. XOOPSXOOPS is a dynamic OO (Object Oriented) based open source portal script written in PHP.PHP According to its developers, XOOPS is the “ideal tool for developing small to large dynamic community websites, intra-company portals,portals corporate portals,portals weblogs and much more” (see About XOOPS). The developers also tell the following about their goals:

The goal of the XOOPS team is to create a Content Management System (CMS) for users and developers that installs out of the box offering unparalleled ease of use, support and management.management The XOOPS CMS will be extendable by the use of modules installable through a unified admin interface.interface The ultimate goal of the XOOPS team is to take the best features of current CMS's and roll them into an Open Source CMS that's easy to use, extendable and unparalleled in the Free/Open Source Community.

XOOPS is (see XOOPS Features List):Database-driven: XOOPS uses relational databases (currently MySQL) to store data required for running a web-based content management system (compare with ).Fully Modularized: Modules can be installed/uninstalled/ativated/deactivatedactivated with a click using the XOOPS module administration system (compare with ).Personalization: Registered users can edit their profiles, select site themes,themes upload custom avatars,avatars and much more (compare with )!User Management: The ability to search for users by various criteria,criteria send email and private messages to users through a template-based messaging system (compare with ).Supported World-wide:World-wide The XOOPS community has more than dozen official support sites around the world for support of non-English speaking users (compare with ).Multi-byte Language Support: Fully supports multi-byte languages, including Japanese,Japanese Simplified and Traditional Chinese, Korean, etc (compare with ).Versatile Group Permissions System: Powerful and user-friendly permissionspermissions system which enables administrators to set permissions by group (compare with ).Theme-based skinnable interface: XOOPS is driven by a powerful theme system.system Both admins and users can change the look of the entire web site with just a click of a mouse. There are also over 60 themes available for download (compare with )!The OO (Object Oriented) approach of XOOPS to Web Content Management is innovative, but also controversial. Franzisco Burzi writes in History of PHP-Nuke and Post-Nuke:

About saying that OOP (Object Oriented Programming) is a good stuff and makes stuff more stable, modular, or whatever else you want... False. OOP is good for very big projects, which is not the case of PHP-Nuke (I mean VERY BIG projects) with a lot of reusable code. BUT... any good PHP programmer knows that the use (or worse, the intense use) of objects/classes in a PHP script isn't good. PHP is not efficient managing objects/classes. At least it's less efficient than managing custom user created functions. Any decent PHP 4 book will say this to you: If you can manage to have your software working without using OOP,OOP there isn't any reason to use objects, because of performance issues.

XOOPS vs. Post-NukeWe cannot go into the details of a comparison between XOOPS and Post-Nuke,Post-Nuke as this would be rather off-topic here. For a discussion of XOOPS vs. Post-Nuke,Post-Nuke see XOOPS vs. Post-Nuke. There, among lists of pros and contras, you will read this:

I'm an architect. My teacher always told me that there are no "bad tools". There are only "bad craftsmen". Find your own way to work - it's not a race, not a competition, you don't need to have the better machine to win. The best sites won't flash with decorations, tons of blocks and gifs. They are made with the same basic tools, CLEAR AND WISE IDEA, and lots of custom made details. Innovate - not imitate. ]]> ]]> ]]> ]]> Inline graphic

How to install PHP-NukeThe screenshots regarding the installation procedure,procedure contrary to those of the other chapters, refer to the Windows platform. This is so in an effort to reduce the number of misunderstandings and ulteriorulterior help requests from the Windows community.community (Judging from the feedback we receive, the Linux and FreeBSD communitycommunity seem to be more able to deal with installation problems in this respect). For the installation of PHP+ MySQL+ Apache, PHPMyAdmin etc. refer to where you will find notes and links to useful tools in order to emulateemulate PHP-Nuke on your client.These instructions are valid for all PHP-Nuke versions from 6.0 onwards.PrerequisitesIn the INSTALL file of PHP-Nuke, we read the following about its requirements:requirements

In order to setup PHP-Nuke the folowing prerequisits are necessary.Linux, installed and working properly.Apache Web Server.PHP version 4.1.x or better (mod_php) Apache module.moduleMySQL database server...The above doesn't mean it will not work with other configurations,configurations OS's, DB's, etc, but we only provide INSTALL instructions for the above configuration.configuration In fact PHP-Nuke works under Windows (all), FreeBSD, OS/2, MacOS,MacOS etc.

PHP 4.1.0 or later needed! From the INSTALL file, we see that you must have at least PHP 4.1.0 to use PHP-Nuke 6.5 and later. This is an important piece of information that you should ckeck before proceeding. See Warning: Invalid argument supplied for foreach(). You see, it is always a good idea to read the INSTALL file that comes with a software package. ]]> ]]> ]]> ]]> Inline graphic To see the PHP version you are running and do also a small test on your configuration,configuration you can run the test.php file as described in . PHP-Nuke and databases other than MySQL From PHP-Nuke version 5.3, Francisco added a new SQL abstraction layer. It enables PHP-Nuke to support databases other than MySQL, like mSQL, PostgreSQL, PostgreSQL_local, ODBC, ODBC_Adabas, Sybase and Interbase. For the Microsoft Internet Informaion Server (IIS), some tests we have done were positive, some others indicated that a special configuration was needed. Installation processDownloadWell... there is little to say here, it suffices to go to a site that holds the files and download them. There is only a small remark to make: if you use Windows and download a version comprised of a file with the ending tar.gz, do not worry, your Winzip supports it without problems. Once downloaded, extract it and “throw” all its contents in a folder you created for this purpose and you call “Nuke6Nuke6” or whatever ( sites from which you can download PHP-Nuke are: phpnuke.org, www.spaghettibrain.com etc.). Upload through FTPWell, now what remains is just to upload the files to the interior of our main server directory that resides on our provider.provider Attention! It is highly recommended, prior to any installation steps, to verify that your provider supports PHP and MySQL. Your ISP has already given you:An FTP user and password:password you need these for the file transfers.A database user and password, as well as the name of the database serverserver to connect to: you need them to connect your applications (like PHP-Nuke) to the database and to be able to access the administration panel of phpMyAdminAdmin ().For FTP in the Windows plattform,plattform we recommend using the WS_FTP application.application It is free for personal use and you can download it from download.downloadcom by entering the search key “ws_ftpws_ftp”. For the Linux plattform instead, we recommend GFTP (free for all and preinstallpreinstalled in all distributions), which can be run from the command line by simply typing “gftpgftp”.

WS_FTP: General connection parameters. ]]> ]]> ]]> ]]> WS_FTP: General connection parameters. WS_FTP: General connection parameters. The use of an FTP program is very simple - we will follow the procedureprocedure through 4 screens that enable us to:Connect ()Transfer files ()Set up the permissions (see also )(Eventually) edit the uploaded files shows the WS_FTP General Connection Parameters screen.screen Entering the right values in the fields of that screen will enable you to conncet to the server where you want to upload the files. Attention! If you are installing PHP-Nuke locally, it is not necessary to use FTP! In this case, it suffices to copy the files into the right directory. In case you are working under Linux, it may be necessary to set the right file permissions. See on how to do this.

WS_FTP: Main screen with local and remote windows. ]]> ]]> ]]> ]]> WS_FTP: Main screen with local and remote windows. WS_FTP: Main screen with local and remote windows. Once connected, the next operation is to upload the files on the remote server.server With WS_FTP,WS_FTP as well as woth the majority of the other FTP clients, the window that contains the local files is located to the left, while the remote files are displayed in a window to the right (). You have to position your cursor on the directory that contains the files to be uploaded to the left and the directory tha has to receive them on the remote host to the right. You can do this through the graphical interface of WS_FTP.WS_FTPAs you can see in , there are also some function buttons there: the two arrows are used to upload / download files to / from the server,server the other two buttons that are functionally important are “MkDir”, which creates a new directory, and “RefreshRefresh”, which updates the view of data contained in a window.Don't upload all extracted files. After extraction,extraction you will find a structure similar to the one depicted in .

<application>PHP-Nuke</application> 6.0 file structure ]]> ]]> ]]> ]]> PHP-Nuke 6.0 file structure PHP-Nuke 6.0 file structure You don't need to upload all the files from the folder, in the main directory of your web presence you will only need to upload the contents of the html folder (so just do a doubleclick on the html folder and upload everything that is inside it). But in order to populate the database with the PHP-Nuke tables,tables you will also need to upload the sql folder too. After the database creation (see ), you should delete this folder though - for security reasons.An operation that may be useful in cases of emergency is “EditEdit”, which is accessible from the context menu after a right click with the mouse on the desired file. “EditEdit” will allow a direct modification of the file, without the intermediate step of downloading it to your computer. File permissions Important This process only really applies if your PHP-Nuke will be installed on a Linux/Unix server, if instead you will install it on Windows operating systems you don't have to do anything. Permissions: Each file or directorydirectories are just special files in Linux has 3 groups of permissions associated with it: one set of Read, Write or Execute permissions for the owner (also called “user” in this context), a group and "others" respectively. The owner in our case should be the user name of your web server.server The group is a user group the web server is a member of. And “others” are just “the rest”. File permissions are usually grouped together in groups of three, like this: (rwx)(rwx)(rwx). The first group are the user permissions, the second one the group permissionspermissions and the third one the permissions for “others”. A good mnemonic for this grouping is UGO (User,User Group, Others). Inside each permissions group, a certain permission may or may not be present. Thus, the user (owner) of the file will usually have read and write permissionspermissions (and execute permission too, if the file is executable), but the group permissions may only allow read access and “others” may not be allowed to access the file at all, neither for reading, nor for writing or execution.If you imagine that the existence of a permission is denoted by a 1, while its absence by a 0, then you end up with a representation like (111)(111)(111), where all permissions are present for all, or (000)(000)(000), where they are absent for all. Of course, any other combination is possible, for example (111)(110)100), which denotes read, write and execute permissions for the user (all 1s are present in the first grouping: (111)), read and write permissions for the group (only the first and second 1s are there in the second grouping (110)) and read permission for others (since only the first 1 is there, while the rest are 0s in the third grouping (100)).Writing down a sequence of nine 0s and 1s is not very practical, so one came with the idea to interprete each one of the three groupings as a binary number. A (111) would thus mean a 7, a (110) a 6, a (100) a 4. Taken together, the sequence (111)(110)100) of the example above would be represented by the number 764.764 That's compact and widely used.Unfortunately, it is also very cryptic,cryptic since most people didn't have much exposure to the binary number system at school, not to mention everyday life. How is one going to understand instructions like “set file permissions to 644644” then?Luckily, there exists an easy mnemonic for this: “4,2,1”, that is the first 1 counts as a 4, the second as a 2 and the third one as 1 - a 0 is always a 0, by the way, even in the binary system. ]]> ]]> ]]> ]]> Inline graphic Whenever you see a 1 in the first position of a permissions triple, you add a 4, whenever you see one in the second, you add a 2 and if you see it in the third, you add 1. You do this for UGO, that is for User,User Group and Others and you end up with a three digit number that represents the permissions of the file.Most of the time, however, you will be busy deciphering permissions,permissions rather than formulating them yourself in this cryptic manner. So how do you go about interpreting a permissions representation like 764764 that was given to you in a document like the PHP-Nuke HOWTO? For this, you will need to develop a “feeling” of how each of the three numbers (7, 6 and 4 in this example) can be written a a unique sum of 4s, 2s and 1s. For example 7 is 4+2+1, 6 is 4+2 and 4 is just 4. A 4 in the sum represents a 1 in the leftmost position. If a 4 is not present in the sum, the leftmost position is a 0. A 2 in the sum reperesents a 1 in the middle position - if there is no 2 in the sum, you just write a 0 there. Finally, a 1 in the sum represents a 1 in the rightmost position, while if there is no 1 in the sum, you write a 0 there.Now if you remember that the leftmost 1 or 0 in a pattern like (111) denotesnotes a read permission or the absence or it, a 1 or a 0 in the middle position denotesnotes a write permission or its absence and a 1 or 0 in the leftmost position denotesnotes an execute permission or its absence, then you can take a permissions represenation like 764 above, see that 7=4+2+1 and realize that it means (111), see that 6=4+2 (or 4+2+0, if you like) and realize that it means (110), finally see that 4=4 (or 4+0+0) and realize that it stands for (100), and you can see that 764 is equivalent to (111)(110)(100), meaning read, write and execute permissions for the user (owner), read and write permissions for the group and only read permissions for others. Easy after all, isn't it? ]]> ]]> ]]> ]]> Inline graphic For more information on permissions,permissions see:Setting Unix Permissions For Web PagesAn Introduction to Unix PermissionsUnderstanding UNIX permissions and chmodTutorial: UNIX PermissionsSetting up permissions on files serves the purpose of having them execute only certain operations (write, execute etc.) when called. Setting them up correctly is important for PHP-Nuke to operate in its full functionality.functionality The right permissions for PHP-Nuke are the following (for the base permissions,permissions see in the context of security): Files: 644644Directories:Directories 755Only directories that require upload access (like the forum's avatar folder, if you allow avatar upload) should be set to 777 and files that get datadata written to them by the program should be set to 666.666 With WS_FTP you must select the files or folders on which you want to impose the permissionpermissions and, with the right mouse key,key to select the option “chmod (UNIX)” (see ).

WS_FTP context menu on right mouse click: chmod (UNIX) ]]> ]]> ]]> ]]> WS_FTP context menu on right mouse click: chmod (UNIX) WS_FTP context menu on right mouse click: chmod (UNIX) The window “Remote file permissionspermissions” will appear (see ). To change the permissions on a directory as required to 755,755 for example, check the boxes as shown in and press “OK”.

WS_FTP Remote file permissions window ]]> ]]> ]]> ]]> WS_FTP Remote file permissions window WS_FTP Remote file permissions window This procedure will cost you some time, but it is very important to carry out. Moreover, you will have to do it every time you insert a new file or modulemodule to your PHP-Nuke. Database creationCreate a database that will contain the PHP-Nuke tables.tables The name of the database should be the same name as the one you entered in config.configphp (see ):To populate the database,base you have to run the nuke.sql file “through” mysql. Change to the sql directory and do from the command line:where dbhost,dbhost dbuname and dbname are the database host, database username and database name, exactly as entered in config.php.config.php Just as you import nuke.sql,nuke.sql you can import any other MySQL dump file (see also ). How to install <application>PHP-Nuke</application> through phpMyAdminTo be able to create a database,base you must be able to administer it. A perfect instrument for doing this via a browser is phpMyAdmin.AdminWhat Is PHPMyadminPHPMyAdmin is a visual system for the management of a MySQL database (see ). It is written in PHP and serves to display the contents of the databases on the server (or client) on which MySQL is installed. Through this interface you can create new databases,databases modify existing ones and modify the contents of single fields. How to install phpMyAdminLocal installation under Windows is very simple: you only need to extractextract the files from the archive you downloaded from the official phpBB site and point your browser to the address http://localhost/phpmyadmin. You will then see a screen as in .

PHPMyAdmin start screen. ]]> ]]> ]]> ]]> PHPMyAdmin start screen. PHPMyAdmin start screen. If you are working locally, don't worry about any warnings you might get. In case you have to install phpMyAdmin on your server,server e.g. when your ISP does not offer a preinstalled administration panel for the database,base you must configure the config.inc.php file that comes with it:Supposing that your data are:IP of the database server:server 156.123.22.34User: PippoPippoPassword: TopolinoTopolinoDatabase name: MinnieMinniethen the necessary entries in config.configinc.php look like this:In the config.configinc.php you will find more configuration parameters that are repeated. They serve to manage DBs in various hosts with the same interface.interface phpMyAdmin: How to administer MySQL via WebOnce you have opened your phpMyAdmin (to do this, if you are working locally, you would have to open http://localhost/phpmyadmin with your browser), you will get a screen that offers you the possibilities of Select a database through a drop-down list.Create a new databasebaseas in .

phpMyAdmin: Select database. ]]> ]]> ]]> ]]> phpMyAdmin: Select database. phpMyAdmin: Select database. Once you have chosen the desired operation,operation you arrive at the administration interface of your phpMyAdmin.Admin Newer versions contain a navigation bar, located at the top (), offering the following options: Structure: See the database structure.structureSQL:SQL Execute SQL operations (e.g. load an existing database).Export: Make a backup of the database.baseSearch: Search for data.dataQuery:Query Display the structure of an SQL query (useful for programmers).Drop: Delete a database (be careful!). As far as we are concerned here, we only need to explain the first 3 items:phpMyAdmin navigation bar: Structure“Structure” presents a list of the available tables in the database,base with the follwing accompanying options:Browse:Browse shows the content of the table.Select: is used to make SQL queries to the table.Insert: is used to insert new data into the table.Properties: displays the structure of the table, ie. its fields, their type, length etc.Drop: deletes the table (be careful!).Empty: empties the content of the table, but does not delete the table itself, it leaves it empty (be careful again!).The most frequently asked questions in this context are:How do I delete a single record of the table? Select the table, click on “BrowseBrowse” and select “Delete” for the record in question.If the password is stored encrypted with MD5, how do I change it? Select the table, click on “BrowseBrowse”, then on “EditEdit” and enter, in clear text, the desired password.password Select from the drop-down “Function” menu besides the field the desired function,function in our case “MD5MD5” (see ). See also .

phpMyAdmin: field functions. ]]> ]]> ]]> ]]> phpMyAdmin: field functions. phpMyAdmin: field functions. phpMyAdmin navigation bar: SQL“SQLSQL” serves the purpose of “loading” whole datasets or already existing databases with one action. The datasets (or the database) are presumed to be already available in a MySQL “dump file”. This is a text file containing all the necessary SQL queries that must be sent to the database server,server in order for the datasets or database to be created. An example of such a dump file is the nuke.sql file that comes with PHP-Nuke and contains all the database instructions for the tables to be created during installation (see ).The use of this function is very simple: just search your system for the dump file you want to load,load by hitting the “BrowseBrowse” button (). MySQL dump files usually come with the “.sql” ending, but “.sql.php”, “.txt” or even “.php” are also in use. Whether the file is a MySQL dump file or not, can only be told by inspection: open it with a decent text editor (see ) and if the first lines look like i.e. if it contains CREATE and/or INSERT SQL statements,statements then it is a dump file (see also ).This function is useful when you want to create whole databases and fill them with data in one step, but it is also very useful when you want to add data to an existing database.base However, this does not mean that it will always succeed: especially if the dump files are very large, this operation my exceed the PHP CPU limit (usually set to 30 sec. by the ISPs). (see, for example, )

phpMyAdmin: SQL function. ]]> ]]> ]]> ]]> phpMyAdmin: SQL function. phpMyAdmin: SQL function. Beware of long .sql files! You can of course use phpMyAdmin to comfortably import any MySQL dump file, i.e. from a previous backup of an existing installation with thousands of forums posts. In this case, the import may take longer than the limit on the execution time of PHP scripts that most ISPs set (usually 30 sec.). You will end up with a half-filled database! In this case, either cut the file up into smaller chucks and use phpMyAdmin to load the smaller files, or insert the text piecewise for execution in the text area field of phpMyAdmin that is there for this purpose, or, as a last resort, do it from the command line, as shown in . See also how to import a '.sql' (>3M) file to mysql database with phpmyadmin?, Importing .sql files into an existing database in phpmyadmin. phpMyAdmin navigation bar: Export

phpMyAdmin: database dump. ]]> ]]> ]]> ]]> phpMyAdmin: database dump. phpMyAdmin: database dump. The “Export” function is useful for obtaining backups of our database (we recall that this is also possible to do from the administration panel of PHP-Nuke, see ). The management console we get for this function is quite detailed ():In the central area, we have a list of the database tables,tables while to the right we have the backup options:Structure only: backs up the structure of the database (tables,tables their fields and their properties), but not the data it contains (i.e. the tables are left empty).Structure and data:data will save not only the structure, as above, but the data in the tables as well.Data only: will save only the data,data but not the structure.XML: saves the database in an XML format.formatThe options that appear in the lower part of the screen have to do with the extra features the created backup file should have:Add 'Drop Table': Prepends an instruction to destroy any existing table with that name to the instructions that create that table. For example, if we already have a table “nuke_authorsnuke_authors” in our database,base this option will take care of removing it, before it loads the structure and/or data for a table with the same name. Otherwise, attempting to import a file that contains structure and/or datadata for nuke_authors will result in an error, since the table will already exist. You should check this option if you are reinstalling PHP-Nuke over a previous unsuccessful instalation and you think you might already have some tablestables there.Save as file: will save the backup as a file (which will be compressed accordingly, with either ZIP or GZIP,GZIP if the “zippedzipped” or “gzippedzipped” boxes are checked - other versions of phpMyAdmin may only offer a “bzipzip” compression).If we don't select any table from the table list, phpMyAdmin will deduce that we want to save all tables.tables In case you want to select only some of them, just click on the ones you want with the left mouse button, keeping the CTRL button pressed.To export a database from the command-line,command-line without the use of the graphical tool of phpMyAdmin,Admin you just do: dbdump.sql ]]>where dbuser,dbuser dbhost and dbname are the database user, host and name respectively, exactly as entered in config.configphp (). phpMyAdmin: other commandsYet another couple of instructions: In order to see the structure of a table, you only need to click on the one that is marked in the left bar and you will see all its fields and modification options appear in the central part ().

phpMyAdmin: table forum_topics. ]]> ]]> ]]> ]]> phpMyAdmin: table forum_topics. phpMyAdmin: table forum_topics. ATTENTION! The DROP command eliminates all the contents of the DB, the table or the single field, use it with caution. To learn more about the possibilities that phpMyAdmin offers you in administering your databases,databases see Doing More With phpMyAdmin (Part 1) and Doing More With phpMyAdmin (Part 2). The first part explains how to obtain the software, install and configure it for secure access,access and use it for tasks such as managing multiple servers, manipulating user privileges,privileges viewing reports on server activity, and exporting MySQL records into different formats.formats The second part explains the more advanced aspects of the application,application including using it for transformations,ations maintaining a history of all the SQL queries executed in the phpMyAdmin session,session defining relations between tables to create JOINs automatically, creating E-R diagrams in PDF format,format and bookmarking important queries for future reference. How to install the DB of <application>PHP-Nuke</application> with PHPMyadminCreate a database that will contain the PHP-Nuke tables (see ). The name of the database should be the same name as the one you entered in config.configphp (see ).

phpMyAdmin: Create database. ]]> ]]> ]]> ]]> phpMyAdmin: Create database. phpMyAdmin: Create database. To populate the database,base you have to import the nuke.sql file, exactly as we showed in for general database dump files. Clicking on the left bar, depending on the database you selected, you will see a list menu coming up, showing the structure of the database (and, on the same time, the central page will show the enlarged structure of the database), with a series of options, all of them in the bottom of the page (see ). It is these options we are interested in when installing PHP-Nuke.

phpMyAdmin: table structure and selection. ]]> ]]> ]]> ]]> phpMyAdmin: table structure and selection. phpMyAdmin: table structure and selection. What you have to do now, is to click on “browse” and go search for the .sql file that contains the instructions that build the structure of the PHP-Nuke database (see ). Once found, it suffices to click on “Go” and the database will be installed. Of course, if there are errors, they will be reported at the end of the installation procedure.procedure And of course, the same holds for the message “operation succeeded”. Don't delete the whole database on the ISP! If you have bought some hosting space on your ISP's servers, you may not be able to create databases at your will, but be constrained to use only the one that your ISP created for you. In this case, you can create, delete and modify its tables and their contents, but not the database itself! Don't drop the whole database, as you may not be allowed to recreate it!

phpMyAdmin: SQL query. ]]> ]]> ]]> ]]> phpMyAdmin: SQL query. phpMyAdmin: SQL query. You can verify that the tables were populated with data by browsing their contents () - click on the small icons besides their names in the left frame for this (if you click on their names, you will only see their structure).

phpMyAdmin: table data. ]]> ]]> ]]> ]]> phpMyAdmin: table data. phpMyAdmin: table data. Other options of PHPMyAdmin that are not relative to the installationinstallation of PHP-Nuke, but still useful for the administration of the database,base can be found in . How to install <application>PHP-Nuke</application> using nukesql.phpIf fiddling with the database from the MySQL command line does not make you feel comfortable, you can use one of the Web Installers for PHP-Nuke available for your version, in the form of the nukesql.php script. This file will install all required database tables for a fresh installationinstallation of PHP-Nuke. It works a follows:Simply enter your database login information in config.configphp (see ), upload all PHP-Nuke files (), then upload this file to PHP-Nuke's root directory and point your browser to it (e.g. http://yoursite.com/nukesql.php).nukesql.php proceeds in an interactive way to populate the database tablestables and test your settings in config.php.config.phpSome of its features:featuresChecks that you are not using the default $sitekey ().Lists existing database tables if any.Installs tables on a empty database.baseReplaces existing tables with new ones.Creates duplicate tables for a second nuke site using one database by using a different prefix in config.configphp (see also ).Will help you troubleshoot installation by testing connection to the MySQLMySQL server and selection of database (see also ). How to install <application>PHP-Nuke</application> locallyA PHP-Nuke installation on your own computer will give you the opportunity to test the whole spectrum of functionalities offered, as if you were online and your system were hosted in your ISP.ISP But in order to start working on PHP-Nuke locally, you must have a web server installed on your box. In this section we will cover the necessary steps towards a working PHP-Nuke environment (Apache + PHP + MySQL ) under Windows and Linux.LinuxFor Windows,Windows there are various packages you can choose from - they will install Apache, PHP and even MySQL for you and will provide a ready-to-useready-to-use environment for the installation of PHP-Nuke. Among them, there are easyPHP (), XAMPP () and Apache2Triad ().easyPHPAfter the download of easyPHP (version 1.6 or later), istallation is really easy: just click the setupsetup icon to start it. You will be asked a few questions in the processes and that's all. The first screen is a welcome message and you only have to click on “next” (“suivant”). You will then be presented with screens like licence etc. and you can continue clicking on “next” (“suivant”), until you reach the screen that asks you where you want to install easyPHPeasyPHP (), in which case you just choose the right path (if you have doubts about the right path, you can leave it to the default just as well).

easyPHP: Installation screen. ]]> ]]> ]]> ]]> easyPHP: Installation screen. easyPHP: Installation screen. Continue clicking on “suivant” until the end of the installation,installation when you have to click on “terminer” to end it. easyPHP is now installed.But where should you install PHP-Nuke in a system with easyPHP installed? Suppose you installed easyPHP in a folder like c:\easyphp.easyphp Open that folder and you will find various subdirectories.subdirectories The one that is important is www. It is under the www folder that the local copy of Apache will expect the files to process - and it is exactly there where you should install PHP-NukeI in the c:\easyphpeasyphp\www folder.We must still explain a couple of elements of easyPHP's functioning. Once you start the easyPHP application,application you will find an icon in the bottom bar, to the right of your screen,screen that resembles an “e” with a small red point (). If the red point is lighting, the server is active, if it is dimmed out, the server is shut down.

easyPHP icon in the bottom bar. ]]> ]]> ]]> ]]> easyPHP icon in the bottom bar. easyPHP icon in the bottom bar. To administrate easyPHP,easyPHP you only have to click on that black “e”. A right click with the mouse will offer a menu with all commands available for the server administration,administration a double click with the left mouse button will instead offer an information screen.screenHow to check a successful installationTo make sure that Apache and PHP have been installed correctly on our system,system we will use the phpinfo() function of PHP,PHP which asks the server to give information about the PHP configuration.configuration If we get a screen like the one of , then everything is working correctly.

phpinfo: <acronym>PHP</acronym> screen for a <productname>Windows</productname> system. ]]> ]]> ]]> ]]> phpinfo: PHP screen for a Windows system. phpinfo: PHP screen for a Windows system. To construct a file that uses the phpinfo() function,function you can either use the text.php script of , or, even more simply, create a text file (with a decent text editor, see also ) that contains only the line ]]>Save the file under the name, say, info.infophp and move it to the www folder of the easyPHP directory (we talked about it above). Then enter the URLURLin the address bar of your browser and you should get (among other information) the screen of . XAMPPXAMPP is an easy to install Apache distribution containing MySQL,MySQL PHP and Perl. XAMPP is really very easy to install and to use - just download,download extract and start.The distribution for Linux system (tested for SuSE, RedHat,RedHat Mandrake and Debian) contains: Apache, MySQL, PHP & PEAR,PEAR Perl, ProFTPD, phpMyAdmin, OpenSSL, GD, Freetype2, libjpeg, libpng, gdbm, zlib,zlib expat, Sablotron, libxml, Ming, Webalizer, pdf class, ncurses, mod_perl,mod_perl FreeTDS, gettext, mcrypt,mcrypt mhash, Turck MMCache, SQLite and IMAP C-Client.The distribution for Windows 98, NT, 2000 and XP contains: Apache, MySQL,MySQL PHP + PEAR, Perl, mod_php,mod_php mod_perl, mod_ssl, OpenSSL, phpMyAdmin, Webalizer, Mercury Mail Transport System for Win32 and NetWare Systems v3.32, JpGraph,JpGraph FileZilla FTP Server, mcrypt, Turck MMCache, SQLite, and WEB-DAV + mod_auth_mysmod_auth_mysql. The versions of the programs included in the latest version for WindowsWindows are:Apache 2.0.48 MySQL 4.0.16PHP 4.3.4 Openssl 0.9.7cSQLite 2.8.6 mod_php 4.3.4 + mod_perl 1.99_10 + mod_ssl 2.0.48To install XAMPP you only need to download and extract XAMPP,XAMPP that's all. There are no changes to the Windows registry and it's not necessary to edit any configuration files. It couldn't be easier!To check that XAMPP is working some sample programs are included, there is a small CD collection program (written in PHP using MySQL) and a small guest book software (written in Perl) and several other utilities.If you decide that XAMPP isn't needed any more just delete the XAMPP directory and it's completely removed from your system.system On the press: Call for donations On December 19, 2003, someone applied to the German Patent and Trademark Office for the rights to the "XAMPP" name. This person was not one of the XAMPP developers, but someone totally unknown to them. The trademark application is a danger for the project's future, since the applicant could - if no legal measures are taken - forbid that the XAMPP developers use that name for their software or do business taking advantage of the name's popularity. The XAMPP developers call on the project's website for donations to help counter this threat with legal means. Whether you are a new XAMPP user, a friend of Apache Friends, or just someone who would like to help, please take the time and make a donation to the XAMPP project. Apache2TriadApache2Triad offers the following goodies,goodies according to the Description:

Apache 2.0.47 , MySQL 4.0.13 , OpenSSL 0.9.7b PHP 4.3.3 , Perl 5.8.0 , Tcl 8.4.2 , PythonPython 2.2.2 plus PHP-Nuke 6.8 , PHPmyadmin 2.5.2 , AWStats 5.7 plus Stunnel 4.04 , SSLCertSSLCert 1.0 plus Xmail 1.1.6 and SlimFTPd 3.13 plus UebiMiau 2.7.2 and PHPXmail 0.33 all configured and easy to install and easy to customize as it has the cleanest layout and structure there is and is updated for every new release of the software it contains plus The Apache2triad Control Pannel suite of tools plus Full documentations plus Unparalelled Installer.

The homepage of the program is Apache2Triad. Apache2Triad is not free for commercial usage: if your company wants to use Apache2Triad you must purchase it for 15$, which is certainly worth the money if you only think at the frustration it saves you by installing all the above packages for you. Apache, <acronym>PHP</acronym> and MySQL on <productname>Mandrake</productname> LinuxWe will describe how to get a functioning, local installation of the Apache-PHP-MySQL trio on a Linux system - we chose Mandrake Linux for this purpose, but the process is similar with other distributions. We will use visual tools for our purposes, making the assumption that, whoever is capable of compiling the binaries from the source code himself, will not need our guidance.

RPMdrake: selecting the Apache package(s) for installation. ]]> ]]> ]]> ]]> RPMdrake: selecting the Apache package(s) for installation. RPMdrake: selecting the Apache package(s) for installation. The most simple thing to do to get Apache,Apache PHP and MySQL installed under Linux,Linux is to install the appropriate packages from the CD. For this, we will use the software application tool called RPMdrake;RPMdrake upon execution, it will ask for the root password;password after we enter it, we will be presented a screen that asks us what we want to install. We enter “ApacheApache” in the aproppriate field and in the sequence we choose the main ApacheApache package (). RPMdrake will ask us if we also want to install the packages of the “dependenciesdependencies” (i.e. packages which the main package we selected depends on). It is important to answer with “yes” here.We then click on “install” and we are asked to insert the CD (or the CDs) containing the RPM packages.packages Once Apache has been installed, we open the Mandrake Control Center and click on “Start” for the httpd service ().

<productname>Mandrake</productname> Control Center. ]]> ]]> ]]> ]]> Mandrake Control Center. Mandrake Control Center. The last control step is to open our browser and instruct it to open http://localhost/. If the browser's response is Apache's Welcome Page, we are done.We have to repeat the above operations in the same identical way for the PHP and MySQL packages.packages In order to make the MySQL database service available, we have again to go to Mandrake Control Center and click on “Start” for the mysql service - PHP does not need this step, it is available immediately after installation.installationBut where is the folder for the HTML files and our PHP-Nuke? It turns out that this is under /var/www/html and we should use phpMyAdmin () to give this folder the permissions of 777 (for more on file permissions,permissions see ). This way all users will be able to add, modify and delete files there, not only root.rootTo verify that everything has gone well, we use the info.infophp file of . If we get a screen similar to that of , then everything is fine. Apache, <acronym>PHP</acronym> and MySQL on Red Hat LinuxFor some obscure reason, Red Hat 8.0 does not connect the PHP package to that of MySQL and we have to resort to some tricks to make them work together. Thus, for Red Hat, you have to proceed as follows:If Apache,Apache PHP and MySQL are not already installed, install the appropriate packages.packages For Red Hat 8.0, choose the “Packages” menu entry as shown in . Once you have entered the system (as root), you can choose the three necessary pieces (Apache,Apache PHP and MySQL):Apache is found under “Web Server”.PHP is found under “Web Server”.MySQL is found under “SQL database Server”.To see what is contained in each section, click on the “Details” link ().

Red Hat: Package Sections. ]]> ]]> ]]> ]]> Red Hat: Package Sections. Red Hat: Package Sections. After the selection of packages,packages you must click on “Updatedate” and Red Hat will go on to install them, after it has checked their dependencies.dependencies Now, Apache,Apache PHP and MySQL are installed, but unfortunately, we are not yet done: we must ensure that PHP will talk to MySQL.MySQL To this end, we must do 2 things:EnumerateEdit the php.ini file, so that PHP supports also files that start with “<?” - and not only those that start with “<?php”.EnumerateInstall the mysql.so file.We recall that, in order to edit a system file, we must be root.root We can nevertheless do our edits without logging out first, if we do the following:Open a terminal window (System -> Terminal)Login as root (command “su”, then enter the password)Start our preferred text editor (see ). The editor will start with root privileges,privileges so you can edit the php.ini file, usually located under /etc, and set the short_open_tag parameterparameter to ON: tags are recognized. ]]>For your local experiments, it is comfortable to also set safe_mode to OFF and register_globals to ON (but see for the security related point of view on this).Save everything and you are done with operation 1 above.Operation 2 is simple: just copy the mysql.so file brutally into /usr/lib/php4/. You should do this with root permissions.permissionsThe only thing that remains now, is to restart the services.services We can do this from the command-line of a terminal window and also through a graphical tool. For the novice user, we will describe the graphical way - again, an advanced user will know how to do this from the command-line (see GNU/Linux Command-Line Tools Summary for a compact summary of command-line tools in Linux).

Red Hat: Service Configuration Panel. ]]> ]]> ]]> ]]> Red Hat: Service Configuration Panel. Red Hat: Service Configuration Panel. The activation or restart of the service we are interested in takes place by selecting the appropriate entry for that service in the Service Configuration Panel (httpd is the service for Apache,Apache while mysqld is the service for MySQL), then click on “activateactivate” or “restartrestart” respectively ().Note that in order for our changes in PHP to take effect, we will have to restart Apache.ApacheNow you can connect to your server by pointing your browser to http://localhost or to http://127.1270.0.1. Apache and the hosts file If the Apache service does not start, it may be because it cannot resolve "localhost" correctly. This name for the local computer is given the IP address 127.0.0.1 in the hosts file (usually under /etc). You can try to change in /etc/hosts to: The folder that is expected to hold the HTML files is again /var/www/html. Note that, again, in order for the normal user to be able to modify the HTML files, you will have to change the permissions of that folder to 777777 (see ). It is also comfortable to create a link to that folder on the client's desktop, so that he does not have to click his way through the path each time. The config.php fileThe last thing that remains to do before starting with the management of your site, is to configure the file config.configphp This is important because it sets up a connection between the PHP files of PHP-Nuke and the MySQLMySQL database that manages it. Important: Use a decent text editor! Do NOT use Notepad or Wordpad to edit the config.php file! These "text" editors don't deserve this name - they introduce extra invisible characters in the file, causing spurious errors with the PHP interpreter. Everything will look O.K., but you will spend many hours trying to find out why your PHP tells you there is an error there. Recommended text editors are UltraEdit (excellent, but not freeware), Crimson Editor , WinSyntax (both good for PHP and Freeware, Crimson Editor has some feature more than WinSyntax) and HTMLkit (free for personal use). Various text editors and their functionalities for PHP are discussed in this decent text editor thread. You need to enter a database username and a password in the config.configphp file. This user must have administration rights on the PHP-Nuke MySQL databasebase (whose name you also entered in the config.configphp file). You configure this user to have administration rights on the PHP-Nuke databasebase by either phpMyAdmin,Admin or from the command line: Please note This is the database user account, on whose behalf everything is done from the database point of view. That is, no matter which user is doing something in PHP-Nuke, when he presses [Enter], the command will be forwarded to the database client, who will connect to the database server with that username and password you entered in the config.php. If that username and password were wrong, or that user did not have "all privileges" on the PHP-Nuke database (the database whose name you entered in the config.php), then the client will not be able to connect and you will get an error (one of these exactly-speaking but nothing-communicating "...was not a valid resource" errors ). Let's have a closer look at the configuration process. Compared to the 5.6 version, the config.configphp file has undergone a radical diet, leaving it with only a few lines. The rest has been moved to the nuke_config table (). This has created problems with the Splatt Forum (), which also used a table with that name. When you open the file “config.phpconfig.php” you will see the following near the top: $dbhost = "localhost"; $dbuname = "root"; $dbpass = ""; $dbname = "nuke"; $prefix = "nuke"; $user_prefix = "nuke"; $dbtype = "MySQL"; $sitekey = "SdFk*fa28367-dm56w69.3a2fDS+e9"; In place of "localhost" you will have to put the host/server that the database is installed on. If this is your own computer, the "localhost" is O.K., otherwise you will have to ask your ISP. In place of "root" you must put the username of the database user that PHP-Nuke will have to use in order to connect to the database and execute the necessary database operations. This user must have been grented all privileges to the PHP-Nuke database as discussed above. You will have to insert the password of the database user here. In place of "nuke" you will have to insert the name of your database here. I recommend this to be left to its default value, "nuke", is the prefix that goes in front of the name of every database table. This is the prefix that goes in front of the name of every database user table. The idea here is that you can have one prefix, i.e. one PHP-Nuke database, but many user prefixes, i.e. different user tables for different sites. The user tables will have a different user_prefix in their names, but the rest of the tables will still use prefix, thus sharing the same nuke database among different user bases from different sites. Leave this to "MySQL", if you have a MySQL database (which will be true in most situations). This is case sensitive, so "mysql" or "Mysql" will not do, it has to be exactly "MySQL". You should change this key to be a unique key that identifies your site. Ideally, no two sites should have the same key.The site key is used to create the random number for the security image () in the Your Account module and the administration section and is an important but often overlooked security feature of PHP-Nuke. See also for software that can help you create a truly random site key. Let's do an example:Host DB: 212.110.12.297 User DB: Pippo Password DB: Topolino Database Name: Orazio Operating System Used: Linux (what else!!! :-) )The file config.configphp should then look like: Attention! This is case sensitive! Remember to use The Capital Letters!!! On Linux systems, if you write a user name or a password without taking care of letter case, the system will not allow you to log in. You must distinguish between the database user (and password), which you enter in the config.php file, and the administrator "God"God account. The database user is only known to the database.base The administrator "God"God account (there are also other administrator levels), on the other side, is created by PHP-Nuke automatically for you. This account, as well as the users accounts, exist only in the PHP-Nuke database,base not in the MySQL server's configuration. How is this PHP-Nuke administrator created? If you go to the "Home" link of PHP-Nuke., you will then see a message telling you the following - just do what it tells you:

Welcome to PHP-Nuke!Congratulations! You have now a web portal installed!. You can edit or change this message from the Administration page. For security reasons the best idea is to create the Super User right NOW by clicking HERE

Click on that link and it will create the PHP-Nuke administrator account for you. A superuser is NOT a registered User A superuser is an administrator with all admin powers. One should call it superadmin, because everyone gets confused at first. It is fine (and normal) to have a superuser admin and a registered user that have the same name. Be careful with side effects when you are logged in as both, see Login Block on Left doesn't go away. We are done, the only thing that remains to do is to enter the administrationadministration section (www.yoursite.com/admin.adminphp). The very first time you will log in using “GodGod” as username and “Password” as password.password I recommend you to change these as soon as possible. Immediately after that, you should take some security measures, see .The config.configphp file also defines two arrays, the $AllowableHTML and $CensorList array. As its name says, $AllowableHTML is an associative array containing entries for all HTML tags that are to be allowed on your site:1, ]]>1, ]]>2, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>2, ]]>1, ]]>2, ]]>2, ]]>2, ]]>2, ]]>2, ]]>2, ]]>1, ]]>1, ]]>1); ]]>The meaning of "1" and "2" is whether the tag accepts attributes or not. For example, if you want the tag to NOT accept attributes (i.e. you accept but you don't accept ) the you put "1", otherwise (i.e., if attributes like "align" etc. are accepted) you put "2". That this is indeed so, can be seen from the check_html() function of mainfile.php (see also ):"; ]]>"; ]]>"; ]]>The code checks if the associated value to the given tag ($tag) in the $AllowableHTML array is “1” or empty. If this is the case,case the value of $tag is only “<$tag>”. Otherwise a set of replacements takes place on the attribute list:The delQuotes() function deletes duplicate space and adds escaped quotesquotes around each attribute value.The ereg_replace() function replaces the ampersand (&) with its HTML entityentity “&”.If the tag is not in the $AllowableHTML array, the line in the code above shows that it is replaced by the empty string, i.e. it is not echoed at all. Thus, if there is an HTML tag that you are missing, you should enter it in the $AllowableHTML array and take care to enter correctly a “1” or a “2” according to your needs. See for example Smilies in news.The $CensorList array contains a list of words that you don't want to see in texts of articles on your site. More than one <application>PHP-Nuke</application> sitesThe variables in the config.configphp file allow for quite some flexibility when it comes to installing more than one PHP-Nuke sites that have to be related in one or the other way:Different <application>PHP-Nuke</application> sites from the same databaseIf you have two (or more) PHP-Nuke sites, located in different Web URLs (or different local directories), that you want to operate from the same database,base you have some handwork to do, but it is not difficult. From the point of view of the database server,server what differentiates one PHP-Nuke site from another, is the name of the table(s) used. In PHP-Nuke, all tables come with a prefix:prefix the users table uses the $user_prefix prefix from the config.configphp file(), while all other tables use $prefix.prefix Thus, you don't need a second database to operate a second PHP-Nuke site. A different database helps keep the installations separate by providing a kind of “container” to put each installation's tables in, but apart from this, there is nothing special to it. To use only one database for two PHP-Nuke installations,ations proceed as follows:Use separate $prefix and $user_prefix values in each site's config.php,config.php e.g. in config.configphp for site 1 and in config.configphp for site 2. All other values should stay identical in the config.configphp files of both sites.Edit the nuke.sql file (located under the sql directory of the PHP-Nuke package) for each site. Change every occurence of “nuke_” to “nuke1_” for site 1 and to “nuke2_” for site 2, then proceed with the installation as described in . If you use nukesql.php () for the installation,installation see the tip at the end of this section. Different <application>PHP-Nuke</application> sites with the same user baseThere are situations that you might want to share users among your PHP-Nuke sites. For example, if you have a site about cars and another one about car insurance,insurance your users will probably be interested in both. But requiring them to enter two different logins and passwords is not going to make them happy - that's where $user_prefix comes into play.The idea behind a separate prefix for the users table in PHP-Nuke is to enable you to keep all other tables separate, but use the same users table across different PHP-Nuke installations.ations By using a different $prefix for each site, but the same $user_prefix for both, your users will require only one login and password - and will be recognized by the second site, while logged in in the first one and vice versa.To use the same user base in two separate PHP-Nuke sites, proceed as follows:Use the same database as descibed in .Use separate $prefix values, but the same $user_prefix for both config.phpconfig.php files, e.g. in config.configphp for site 1 and in config.configphp for site 2. All other values should stay identical in the config.configphp files of both sites.Edit the nuke.sql file (located under the sql directory of the PHP-Nuke package) for each site. Change every occurence of “nuke_” to “nuke1_” for site 1 and to “nuke2_” for site 2, except the ones for the nuke_users table, which you should change to “nuke-commonnuke-common”. The full name of the users table should thus be “nuke-common_usersnuke-common_users” in both nuke.sql files. Then proceed with the installation as described in . Using nukesql.php If you use nukesql.php () for the installation, you should change the prefixes as above and point your browser to each instance of nukesql.php (one for each installation, located in the respective PHP-Nuke root directory). It will then create the tables with the right prefixes for you. ResourcesClaudio says: if you are looking for PHP-Nuke hosting,hosting Spaghettibrain.com has custom offers for you... give us a visit! Spaghettibrain.com is the italian support site for PHP-Nuke, there you will find modules,modules security patches, support forums and a lot more. Come for a tour soon.Other specialized PHP-Nuke hosters:hostersNukezoneRaven Web Hosting Common installation problemsSome of the most common installation problems of PHP-Nuke are discussed in the following subsections. In identifying the most common sources of problems and frustration,frustration we hope to eliminate a good portion of the Help! posts in the various forums of the community.community Feel free to post your own favourite to Chris' PHP-Nuke Forumfor inclusion in the next version of this HOWTO.HOWTOTest scriptsBefore you start the ambitious undertaking of debugging your PHP-Nuke installation, you should download and run some tools that may shorten the search path and save you some headaches:headachestest.testphpConnectTest.php andanalyze.analyzephptest.phptest.testphp is a “quick'n dirty” script to help you find out if you could connect to the database and how your PHP configuration looks like. Put the following lines in a file, name it test.testphp, upload it in the same directory where you have your config.configphp and tell your browser to open it (see Warning: Invalid argument supplied for foreach()): ]]>If everything is right, you will only see the PHP info.info Otherwise, you will see a descriptive message of the error first (in the first line) and also the PHP info.info You can use the output to determine various parameters of your PHP configuration, like version numbers, libraries,libraries paths and variables. Whenever you ask yourself if you have feature X enabled, remember to run this small script and search its output for a string that describes the feature. You will most probably find the answer there. Conversely, if you don't find the answer in the output of test.testphp (i.e. the output of the phpinfo() function), you will probably not find it easily. ConnectTest.phpThe ConnectTest.php script from Humpa is a more elaborate test script that you can help with database connectionconnection problems. Download and save it with a .php ending (it comes with a .txt ending to preventevent the web server from interpreting the PHP code in it). You should put the ConnectTest.php file in the PHP-Nuke root directory, i.e. in the same directory where also config.configphp is located. Then you just tell your browser to open it.The Connection Test Script was unable to connect ]]>One or more of these variables are wrong in ]]> \$dbhost=\"$dbhost\", ]]>$dbuname\", and/or \$dbpass=\"*hidden*\" ]]>
"; ]]>Now, please don't say that you are using the ]]>"; ]]>"; ]]>mysql_connect
"; ]]>"; ]]> ]]>"); ]]> ]]>

"; ]]>If everything looks good, but you ]]> ]]>

"; ]]>Connection Test Script connected to your MySQL server ]]>"; ]]>\$dbuname = \"$dbuname\";
\$dbtype = \"$dbtype\"; ]]>\$prefix = \"$prefix\";
\$user_prefix = \"$user_prefix\";
"; ]]>Connection to your database \" ]]>$dbname\" was also successful.
"; ]]>$tablename ]]> ($numFields $fields / $numRows $rows)\n
"; ]]>But, you need to set ]]> \$dbtype = \"MySQL\"; "; ]]> in your config.php!!!!!!!!
"; ]]>There are $i tables in your \" ]]>$dbname\" database
"; ]]>"; ]]>You don't seem to have all the ]]>Get the "; ]]>Web Installer for your version of ]]>
"; ]]>These are the admin names (aid) in your nuke_authors ]]>$admin_names
"; ]]>Now check this list of tables with your nuke.sql file:

$stufftoprint"; ]]>Your database \"$dbname\" did not exist, ]]>"; ]]>"; ]]>"; ]]>However, the \"$dbname\" database does not exist. ]]> ]]> (in your config.php) ]]>If you have not created the database yet, then "; ]]>"; ]]>Then, get the appropriate ]]>"; ]]>"; ]]> ]]> analyze.phpThe analyze.php script from Paul Laudanski (a.k.a. Zhen-Xjell) is the most elaborate from all the three script presented here. Rename the file to "analyze.analyzephp", transfer it to the same place that your config.configphp file is found and call it from your browser. For a preview of what it reports, run analyze.php for the nukecops site. The code has been successfully tested for Nuke versions 6.5B6, 6.5B5,6.5B5 6.0, 5.6.
analyze.php: MySQL connection transcript. ]]> ]]> ]]> ]]> analyze.php: MySQL connection transcript. analyze.php: MySQL connection transcript.
The script not only tests your MySQL database connection (see ), but also displays information on:config.configphp settingsSMTP (mail server) settingssettingsGD (graphics) library settingssettingsDatabasesModulesModulesBlocksBlocksNoticesRanksRanksAdministrators and Moderatorsphp,ini settingssettingsSecurity codeRecursive file listing along with resource permissionspermissions
analyze.php: MySQL security warning. ]]> ]]> ]]> ]]> analyze.php: MySQL security warning. analyze.php: MySQL security warning.
It also checks for MySQL (see ) and PHP (see ) vulnerabilities and reports them to you if they need to be patched. Warning: mysql_fetch_row(): supplied argument is not a valid MySQL result resourceYou get thisThis is a very general error. Most of the time it just means that you could not connect to the databasebase (for whatever reason) and thus the result set you tried to fetch was not a “valid MySQL result resource”. You should try first to get a more descriptive error message. For this purpose, you must edit the "case" lines in the sql_layer.layerphp file.Example:This is the "case" that starts at line 286 in the nuke 6.5 sql_layer.layerphp (for the line 286 error), at line 300 in the nuke 6.0 sql_layer.layerphp (for the line 301 error message) - or line 285 in nuke 5.6 (for the line 286 error message):Edit it like this: Please note: This will NOT fix your problem. But it will give a more descriptive message as to what the error cause is. See Warning: mysql fetch row: supplied argument is not a valid MySQL result resource and submit news problem. Call to undefined function: message_die() in db.php line 88This is the most “popular” error. It basically means that it couldn't connect to the database.base You may get this error even if you did everything right, depending on the version you are using. The reasons are multiple:Are you sure you downloaded *all* the files? Maybe some file is missing. Perhaps you wanted to save some bandwidth and omitted some crucial file or directory, or subdirectory.subdirectoryYou didn't enter "MySQL"MySQL as the dbtype in config.php (see ). It must be exactly with a Capital M, a small y, and capital S, Q and L.The code tries to select the database,base but the database is not there. Create the database and populate it with tables (see ).You have some error in the config.configphp file (see ). Double check that the username and password are correct. Don't forget, the " and ; are important. And DON'T remove the $ in front of the variables! If you used an editoreditor like Notepad, Wordpad,Wordpad or some editor that you are not 100% sure that works correctly, delete the config.configphp file, get a fresh copy and edit it with a decent text editor (see ). Error: Failed opening 'language/lang-.php' for inclusionYou either didn't install the language files lang-xxx.php (like language/lang-english.php), or you cannot connect to the database,base so that the value of the default language could not be set and is empty (and that's why you get an error about lang-.php,lang-.php instead of lang-english.php, or lang-french.frenchphp etc.). Try the small test script (see Call to undefined function: message die in db.php line 88): ]]>(see also ), oryour include path information is missing some paths (like ".", the current directory), see . Fatal error: Failed opening required 'includes/sql_layer.php' Your web server could not open includes/sql_layer.layerphp. There are many reasons for this (Fatal error: Failed opening required includes/sql layer.php): The file is really not there, something went wrong with the installationinstallation - reinstall (see ).The file is there but the web server does not have the right to open it - check permissions (see ).There is a .htaccess file somewhere in the directory hierarchy that denies access to you. There is something wrong with the include path of the PHP interpreter (see ).You might see more information on the cause of your problem if you have access to the web server access and error logs. Sorry, such file doesn't exist...Whenever you try to access a module (or simply your site), you ge the error (see, for example: Humpa Chess Install and http://www.karakas-online.de/forum/viewtopic.php?t=348):Of course, following a classic attitude to error handling, it doesn't tell you which file does not exist... ]]> ]]> ]]> ]]> Inline graphic We thus have to search the code to see what is happening: The errorcomes from mainfile.php.mainfile.php There are exactly three occurences of it in the code. In all three the pattern is the same (see Sorry, such file doesn't exist...):EnumerateFirst it is tested if you are a normal user, an administrator,administrator if the module is active etc., depending on the circumstances.EnumerateThen, a test is made on the existence of $modpath. Upon its failure,failure you get the error above:$modpath, in turn, is the path to the module in question. As you can see in the code snippet yourself, it depends on the value of $name, which is the name of the module,module and $file, which is...well, for this you have to scroll up to the start of mainfile.php.mainfile.php There, we readwhich in plain english says "if the variable $file is NOT set, set it to 'index'".Putting all the puzzle pieces together, we arrive to the conclusion that the fileis not there.There are various things you should check and all have to do with trying to find out why your web server cannot find the index file of the modulemodule you are trying to access:accessIs the index.indexphp file really there in the modules/YourModule folder?Did you set up the permissions (, ) correctly? Does your web server have read access to that folder and file?Is there a (hidden) .htaccess file () somewhere in your document tree that prevents the web browser from accessing that file?Did you install all files? You have to dive in the docs of that module to see if you are missing anything.Check ifreturns an error. Substitute YourModule with the name of the module that is giving you the headaches.headachesIf this is a module you downloaded and installed yourself (as opposed to a preinstalled one, see ): Did you really follow the instructions? Did you download the right file? Did you extract it in the modules folder?Did you see the module in the list of modules and did you activate it ( and )?
Modules administration panel. ]]> ]]> ]]> ]]> Modules administration panel. Modules administration panel.
Warning: setlocale(): Passing locale category name as string is deprecatedAll of a sudden, you get tons of warnings like this one:The problem comes suddenly after your ISP has upgraded to a newer version of PHP (without telling you, of course! ]]> ]]> ]]> ]]> Inline graphic To fix this, remove the quotes that are around "LC_TIME"LC_TIME in the line/file mentioned in the error message displayed (see Warning: setlocale(): Passing locale category name as string is deprecated and News article: Warning: setlocale(): Passing locale category name as string is deprecated.). Attention: repetitious error! You may get this error again and again. You will have to do the above change in *all* occurences of the LC_something constants! I once counted 17 of them, scattered all around the PHP-Nuke files... Security code is not showing up
Security code in the User Login screen. ]]> ]]> ]]> ]]> Security code in the User Login screen. Security code in the User Login screen.
You just installed PHP-Nuke for the first time, created a super user, and you can't log in because the security code graphic (see ) is coming up as a dead image. ]]> ]]> ]]> ]]> Inline graphic This is a frequent error, but it seems that the reasons (and cures) may be multiple (see Security code graphic not showing up, security image stopped working):You changed something in the language files and put comments - remove the comments.commentsYou (or your ISP) don't have the GD library loaded. To find out if you have the GD library loaded, run a test script like test.testphp (see ), ConnectTest.php (see ) or analyze.analyzephp (see ). The first two display the output of the PHP phpinfo() function directly ( ), analyze.analyzephp will display an only slightly different information box on GD (). If you are on Windows 2000, read how to install GD on a Win2K box.The gfx function in admin.adminphp is not always working fine. You could try to put it in a separate file and change the call from admin.phpadmin.php to the new file. See Humpa's posting in Admin Security login jpeg not showing for an example.Activate (or reactivate) the Your Account module.module If your Admin's security code works, but the others don't (showing an read X mark for others), then you may want to set the Your Account module as viewable by all visitors (see PhpNuke 6.5 Security Code Problem).
phpinfo(): GD library information. ]]> ]]> ]]> ]]> phpinfo(): GD library information. phpinfo(): GD library information.
For more thoughts on this problem, read Humpa's PHP-Nuke FAQ on the security code. If you want to use a PNG or GIF image for the security code, consult the solution in Using a png or gif for security code image. If you want to display the security code as text, rather than an image, see security code in plain text format - but then there is no point to it (the idea is to display an image that makes automatic number recognition difficult to robots), then you can disable it just as well.
analyze.php: GD library information. ]]> ]]> ]]> ]]> analyze.php: GD library information. analyze.php: GD library information.
How to bypass the security codeAnother approach could be to bypass the security code altogether. This is probably the only option you have (unless you are willing to display it as plain text - see the links at the end of this section for this), if your ISP refuses to load the GD library:library without GD, no security code image - without security code image, you cannot enter anything in the securitysecurity code field, and you get an “Access denied” error. Here is how you disable the security code:Find the 7 occurences of:For the Admin login,login there is one in the admin.php, and one in the auth.php. For Users, there will be five in the modules/Your_Account/index.indexphp (and there might be one in the block-Login.php,block-Login.php and/or one in the block-User_Info.php, if they are modified). Replace all of the occurances with this:Follow the above instruction exactly. Be careful not to introduce syntax errors! Changes like the last one (bypassing the security code) require extreme caution on your part. All too big is the risk of introducing new errors, while trying to correct old ones! If you get an error, it does't mean the solution ceased to work for you. Check for syntax errors that you might have introduced with your editing. Most probably, you will find something. ]]> ]]> ]]> ]]> Inline graphic See syntax error, security images removed for a real world example. If you have one of the later versions of PHP-Nuke, you can try a trick: edit the config.configphp file and if you find a line there, like this one:and change it to (see How to disable the security code): Warning: Invalid argument supplied for foreach() in mainfile.phpYou get errors and warnings like:You must have at least PHP v. 4.1.0 to run PHP-Nuke 6.5 and later. See and Warning: Invalid argument supplied for foreach(). Include path is wrongIf the include path happens to be wrong (you can see your include path in the output of test.testphp, see ), you could try the following: Suppose your nuke files are in /usr/local/httpd/htdocs/nuke/html (just an example ). Suppose that this is the directory that containsthe includes directory beneath it. Then create a .htaccess file () that contains the line (no equal signs, just copy it in the .htaccess file). In most cases the include path will be correctly configured. In the few ones that it's not, the most probable cause of errors will be a missing “current directory” (a missing dot in the include path).If you have access to the php.ini file, you can do the same there. Find the line where include_path is defined and add the dot in the list, e.g.:include_path = “.:/usr/local/httpd/htdocs/nuke/html/includesincludes”See also Warning: main(/db/db.php): failed to open stream and Fatal error: Failed opening required 'includes/sql_layer.php". Users don't receive any confirmation mailsThis is not a PHP-Nuke error. PHP-Nuke uses PHP's mail() function and this, in turn, uses the mail serverserver that is found on the web server.server If that mail server is configured incorrectly, you will get problems with mail. The best way to solve them is to talk to your ISP and try to find out which configuration is used for your case.case We have seen cases of ISPs that would configure the mail server to deliver mail only to local domains,domains thus making communication between PHP-Nuke and users of other domains impossible (see E-mail problems, my nuke only sends mail to my domain).Now, what do you do after you have fixed your mail server?server Those e-mails with the activation links have already been sent once, and since they never reached their destinations.ations.. You are losing users because you cannot resend them! If you ever needed to resend an activation email, or just wanted to delete one that was awaiting activation,activation then you will appreciate the Resend module. It will help you manage the temp_users table.If you want users to be registered directly, without confirmation mails, see . If you want to disable registration,registration see . If you want to approve every user who applied for registration,registration you can use the Approve Membership module (see and Authorize accounts). Login loop
User Login screen. ]]> ]]> ]]> ]]> User Login screen. User Login screen.
You login without problems, but whenever you try to access a function or links of the PHP-Nuke site, you are returned to the login screen and are asked to enter your user name and password again - a very annoying procedure!The first thing you should check, is if you have cookies enabled in your browser. PHP-Nuke uses cookies to store authentication information on your computer (in the cookies file, see also ), in order to be able to recognize you on your next page request (remember, HTTP is a stateless protocol,protocol meaning that, whenever the web server serves you a page you requested, it forgets about it, so the next page request is seen as being completely unrelated to the previous one). Thus, you must have cookies enabled to use PHP-Nuke.If enabling cookies does not make the problem disappear, it might be a permissions problem (see ), in which case you should contact the administrator of the site. 3rd party cookies If you are experimenting with frames, you will find out that the cookie will be set fine, as long as the frame and the parent page are on the same site. If the frame is a different site than the parent, then you will have to allow 3rd party cookies (a lower security setting), see Why do users have to put security to "low" to be able to log. You have an error in your SQL syntax near '-------------When you try to create the database tables with the nuke.sql file (see ), you get an error:This is because your nuke.sql file came with nice, useless long lines containing dashes,dashes like these ones:Just use a decent text editor (see ) and delete that long line, or put a # in front of it. If that doesn't help, put a # in front of every line that starts with a dash, making it a comment. SQL accepts “--” as the string that starts a comment, but it seems that MySQL does not like the rest of the dashes (after the first two ones) as a comment. Error: Couldn't update private forum permissions
Administration panel: Forums. ]]> ]]> ]]> ]]> Administration panel: Forums. Administration panel: Forums.
You get the following error everytime you try to make a particular user (or a site administrator) a moderator in PHP-Nuke 6.5-7.0:7.0This is a bug modules/Forums/admin/admin_ug_auth.php - the INSERT statement is missing a string value in the VALUES clause.clause Try this admin_ug_auth.php instead. See Couldn't update private forum permissions and Site Admin & Moderator for more details. Invalid session in forums
Administration panel: Forums. ]]> ]]> ]]> ]]> Administration panel: Forums. Administration panel: Forums.
You installed the PHP-Nuke Forum (which is the phpBB forum starting v.6.56.5 of PHP-Nuke, see ), but now, when you try to access it you get the error: Solution: In the forum configuration,configuration go to the Cookies section and change the name of the cookie file from "phpbb2mysql " to something more original or unique, like "phpbb2mysql2"phpbb2mysql2 . You also need to have the right cookie domain,domain i.e. if you have installed the forum under http://yoursite.com/nuke/html, the cookie domain should be http://yoursite.com/nuke/html too. “What is this session id anyway?”, you may ask. This is quite a technical matter and is covered in detail in . You cannot create the administrator account
Administration panel: Edit Admins. ]]> ]]> ]]> ]]> Administration panel: Edit Admins. Administration panel: Edit Admins.
Everything looks fine with your newly created PHP-Nuke site, then you are told by the system that there is no administrator yet and you should create one:You do what you are told and create that Super User,User but the next time you get the same message. It seems that you cannot create the administrator account!The message that asks you to create the Super User is the _NOADMINYET message whose translation you can find in the various language files (see ) in the admin/language folder. For example, in admin/language/lang-english.php,lang-english.php we read:define("_NOADMINYET"_NOADMINYET,"There are no Administrators Accounts yet, proceeed to create the Super User:User");The _NOADMINYET message is output in admin.php:admin.phpsql_numrows($db->sql_query("SELECT * FROM ".$prefix."_authors")); ]]>"._NOADMINYET."

" ]]>From the code we see that it is echoed only if $the_first is 0, meaning no entries in the $prefix_authors table. Thus, for some reason, the nuke_authors table (assuming your $prefix is "nuke" in config.configphp), is not filled. You can do the following (see I cant make my Admin acount work):You should check the entries in nuke_authors.nuke_authors You can do this either from the MySQL prompt withor with the "browse" function of phpMyAdmin ().If your Super Admin is there, then it is weird... ]]> ]]> ]]> ]]> Inline graphic If the Super Admin is not there, then you can't write to the database.base To check this possibility, find the function create_first() in admin.php.admin.php There, you will see two lines with a call to sql_query.query They are both identical:sql_query($sql); ]]>Insert the line:after each one. This will echo a more descriptive error message (see ) and may lead you to the solution. But, as experience shows (see I cant make my Admin acount work), you most probably have set the wrong values in your config.php (). ]]> ]]> ]]> ]]> Inline graphic This is a known issue and a solution is presented in . You lost the administrator password, or deleted the admin account
Administration panel: Edit Admins. ]]> ]]> ]]> ]]> Administration panel: Edit Admins. Administration panel: Edit Admins.
You did a Very Big Mistake - you erased your PHP-Nuke Super Admin! Now you cannot do anything on your website! Your powers are those of a normal member... ]]> ]]> ]]> ]]> Inline graphic How do you get your Admin back? You can try one of the following two solutions (see I deleted my Super Admin. How do I get him back?):EnumerateYou can use phpMyAdmin (or a similar DB administration package, see ) and look in (the technical term on the link is “browse”) the nuke_authors table. You can take two approaches:EnumerateSee if your admin is still there, and you can set a new password (you'll have to choose “MD5MD5” from the dropdown menu on the pass field, see ). If your admin is not there, then just add a new row to the table and put in the missing info.info EnumerateOr you can just delete the line with the administrator name and point your browser to the admin.adminphp file - you will then be prompted to enter a new admin name and password.password You may enter whatever new values you like there, but you should not create a user with the same name, even if prompted to.EnumerateUsing phpMyAdmin (or directly in MySQL), go to the nuke_authors table and make your password dc647eb65e6711e155375218212b3964 - that will make it Password, then just login and change it. Here we make use of the fact that the MD5 hash of the word “Password” is dc647eb65e6711e155375218212b3964.
phpMyAdmin: field functions. ]]> ]]> ]]> ]]> phpMyAdmin: field functions. phpMyAdmin: field functions.
How to compute the MD5 hash of an arbitrary password using only <acronym>PHP</acronym> and your browser If you are curious about the MD5 hash of a certain password, but do not have easy access to a function that computes it, you can make use of the fact that the PHP interpreter of your web server can compute is for you. Substitute XXXX for the password whose MD5 hash you want to compute in the following script: ]]> and upload it somewhere on your web server. Then point your browser to it and you should see the answer. You can use it to change the password field of the nuke_authors table directly in MySQL. See Admin Password - i've lost it, Password help for discussions. You get garbage in some parts of the pageIf some parts of your page looks like containing garbage,garbage it may be due to a compressed output from the server.server You could try to disable compression by just commenting the line (see I cant make my Admin acount work):or setting $do_gzip_compress to FALSE:in mainfile.php.mainfile.php The part that controls compression in mainfile.php is:= '4.0.4pl1' && strstr($HTTP_USER_AGENT,'compatible')) { ]]> '4.0') { ]]>You might even have to comment it completely (see PhpNuke wont show in IE or Opera). Compressed output in forums
Gzip compression in the Admin Panel of the Forums module. ]]> ]]> ]]> ]]> Gzip compression in the Admin Panel of the Forums module. Gzip compression in the Admin Panel of the Forums module.
You seem to be getting a compressed output in the forums. You are either seeing garbage, or you can see it in IE, but not in Mozilla.Mozilla When you press “RefreshRefresh”, Mozilla reacts like you want to download something that is “encryptedencrypted” or compressed.All this is a sign that you may be compressing the page twice. If, for example, your Apache has been already configured to send compressed output (with mod_gzip, or some other technique for Web Content Compression), then you should disable gzip compression in the forums administrationadministration panel (from “General Admin,Admin Configuration”, as in ).See also Cannot see forum in Mozilla and see in IE. Warning: Cannot add header information...in forumsYou get errors of the form:when vieweing the forums. There are two solutions (see Warning: Cannot add header information...in forums):EnumerateNear the start of mainfile.php find:= '4.0.4pl1' && strstr(Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1),'compatible')) { ]]> '4.0') { ]]>and change it to:= '4.0.4pl1') ]]> '4.0') { ]]>Add the following line to a .htaccess file (see ) placed in your root PHP-Nuke directory:or if you have access to php.ini,php.ini set:See also Warning: Cannot modify header information on Forums and Cannot modify header information. To learn more about PHP output buffering,buffering see Output Buffering with PHP and PHP Output Buffering tutorial. In Windows, you get an empty pageYou installed Apache, PHP and MySQL in Windows. It seems to work, but when you try to run PHP-Nuke's index page, the browser starts searching the page without showing anytihg. ]]> ]]> ]]> ]]> Inline graphic How do you get your Admin back? This is too vague an error to trace down to anything specific with certainty, but there are indications (see Problems with header function) that it is related to the header() function of PHP and PHP's Bug #16842: header() function doesn`t work. The bug seems to have been fixed in newer versions of PHP,PHP but it might still appear, if you had a previous version that you did not uninstall cleanly (the old problem with DLLs not being correctly managed under Windows,Windows with old versions still lying around even after an uninstall). If you suspect this might be the case with you, uninstall PHP cleanly and reinstall.reinstall You get a lot of Notice lines in the output of PHP-NukeIf you get lots of Notice lines in your PHP-Nuke output like this:then the error level for the reporting is too high (see A lot of Notice lines in the output of PHP-Nuke). Set display_errors so that PHP will display all errors, except notices, in your php.ini.php.ini Edit php.ini with a decent text editor (see also ) as follows - the important line is the last one, which is the only uncommented one: How to get a more descriptive error messageIf you get an error, but you have no idea what is happening, you could try to narrow it down in the code, if you feel comfortable with PHP.PHP Then, after you found the offending line, you should insert the lineimmediately after it. This will give a more descriptive message of the error and hopefully lead you to a solution. We already used this trick in . See also Warning: mysql fetch row: supplied argument is not a valid MySQL result resource and submit news problem. Common miscellaneous errorsSome miscellaneous errors are discussed here.RSS block Error: There is a current problem with the headlines from this siteIf you encounter the errorafter some innocent changes in an RSS block, you are not alone. ]]> ]]> ]]> ]]> Inline graphic This is a known issue and a solution is presented in . MySQL errno: 145: Can't open file nuke_XXXX.MYIIf suddenly you get an error like:then you will know that your MySQL database has been corrupted. ]]> ]]> ]]> ]]> Inline graphic In the above example, the nuke_bbsearch_wordmatch table is damaged (see MySQL errno: 145 Can't open file nuke bbsearch wordmatch.MYI). Solution: Enter the MySQL prompt from the shell:shellwhere dbuname,dbuname dbhost and dbname are exactly the same as in your config.php () - you will also be prompted for your password,password which must also be the same as in config.php - and try the REPAIR TABLE command:commandYou can also try from the shell command-line the myisamchl utility:utilitySee on how to repair corrupt tables.tables Modules do not show up and/or disappear
Administration panel: Modules. ]]> ]]> ]]> ]]> Administration panel: Modules. Administration panel: Modules.
In PHP-Nuke version 7 alpha, when adding a module to the modules folder it won't show in admin/modules.modules When renaming a module,module with FTP or similar, the module also disappears (see Modules do not show and/or disappear).The problem is that in admin/modules/modules.modulesphp, of that version, on the line that inserts the modules in the folder modules,modules the number of fields is incorrect. In admin/modules/modules.modulesphp, the lines with:should have been:Notice the extra before the This error seems to affect v. 7 alpha and some of the 7.0 FINAL downloads.ads You should also be aware that there are some third party modules which alteralter the nuke_modules table. All you have to do to determine if this might be a problem for you, is to view your nuke_modules table through phpMyAdmin () or a similar tool, count the number of fields and then compare this number with the code in admin/modules.modulesphp:The above gives us 7 fields. Forums Error: Can't create a category without a nameYou want to create a category in the Forum (see ), but you get the error:Your strategy in coping with error messages, in case your error is not obvious or not well explained by the message, is to search the whole code tree for the error text (just as you would search for a link text in ). In this case,case it turns out that there is only one occurence, in modules/Forums/admin/admin_forums.php:As you can easily see, the error is issued if the category name contains only "white space"“White spacespace”, in the setting of the PHP trim(), function can contain only the following characters:" " (ASCII 32 (0x20)), an ordinary space.space"\t" (ASCII 9 (0x09)), a tab."\n" (ASCII 10 (0x0A)), a new line (line feed)."\r" (ASCII 13 (0x0D)), a carriage return."\0" (ASCII 0 (0x00)), the NUL-byte.NUL-byte"\x0B" (ASCII 11 (0x0B)), a vertical tab. (which is what the PHP trim function strips from the beginning and end of a string), in simple words:words if you did not enter any name for the category.category Logical, isn't it?But what happens if you swear that you did enter a name there? Isn't this error going to drive you nuts then? In such situations,ations you should keep your calmness and try to think further than the obvious: what could be happenning behind the scenes in PHP-Nuke? Here are some possibilities (see Can't create a category without a name):You entered an empty name - O.K., you already checked that, but let's include it, just for the sake of completeness. This means that $HTTP_POST_VARS['categoryname'], the value of the POSTPOST variable that holds the category name, is empty, or contains at most some white space.spaceYour browser does not send POST variables back to the server,server e.g. it does not support forms. Also quite unlikely.$HTTP_POST_VARS['categoryname'] was not empty when it arrived at PHP-Nuke, but PHP-Nuke changed it. In fact, PHP-Nuke subjects the POST and GET variables to some sanity checks (see for details), to see if they contain malicious code. If your category name contained any “forbidden” characters, it may be that some check routine in PHP-Nuke deleted it. Try a name that will not raise suspicions of SQL injection () and similar attacks.You are logged in as the administrator and as a user. In this case,case you browser has stored two cookies () on your computer and it is not clear under what ID your action has been evaluated by PHP-Nuke. Try to avoid such situations.ations If you must me logged in as both a user and an administrator at all costs,costs you might try to use two different browsers for each ID (not two instances of the same browser, but two different products). They will store the cookies in different locations and will (hopefully) not mess them up.Of course, YMMV. ]]> ]]> ]]> ]]> Inline graphic Left and right blocks are missing
Missing blocks. ]]> ]]> ]]> ]]> Missing blocks. Missing blocks.
If your PHP-Nuke site looks like the one in , i.e. lacking totally the left and right columns with all the blocks in them, then maybe your nuke_blocks table is corrupt (see Missing blocks and modules, as well as My blocks are gone and Blocks have disappeared). See on how to repair a corrupt table. How to upgrade PHP-NukeThe upgrade of your PHP-Nuke system to a new version is done in the following steps:stepsMake a database backup.backup (See and , for PHP-Nuke's own backup function,function for phpMyAdmin's functionality, which also includes a very good web interfaceinterface to database backups and , for home-made scripts that automate the backup work for you.)Verify that your current PHP-Nuke version has not been modified (excluding the theme,theme that does not needs an update). In case it has been modified through the addition of modules that required a change in the original PHP-Nuke files, or the database,base proceed manually as outlined in .Test the upgrade locally first and not directly on the production site.If all looks well, transfer the files and the database to the production site.The update to a new version itself, is an operation that consists of two parts, the update of the database and the overwriting of the old files with the new ones. The update of the database is done automatically through appropriate scripts that can be found in the upgrades folder of the PHP-Nuke package. You have to upload the right upgrade script to your PHP-Nuke root directory on the server (where also config.configphp is located), then point your browser to it - this will update the database.base See also How to upgrade PHP-Nuke and PHP-Nuke upgrade.If you are upgrading from a version that is more than one version apart from the version you are aiming at, then you have to apply all patches sequencially, from the old one, through any intermediate versions, up to the newest one. Thus, for the passage of 6.6 to 6.8, you must apply both upgrade66-67.phpupgrade66-67.php and upgrade67-68.php.upgrade67-68.phpIf you are upgrading from 5.6 to 6.0, you must also overwrite the config.phpconfig.php file with the new one, then edit it again with the right values (see ).The following sections cover some examples in detail.From 6.0 to 6.5See phpNuke Upgrade from 6.0 to 6.5.Upgrade instructions for <application>PHP-Nuke</application> 6.0 without Tom's bbtonuke portMake a backup of the database tables and all files.Using your current config.php as a guide configure the new config.php's settings, PHP-Nuke 6.5's config.php has a new variable: $sitekey, it is recommended that you change at least some of the letters/numbers in it to make it unique.Upload all files and folders included in Nuke's html folder so that they replace your current files.Upload upgrade60-65.php to Nuke's main directory (where config.php is) and point your browser to it. Delete it once done.If you were using Splatt forum with Nuke 6.0 and wish to transfer its data into the new bbtonuke forum, use NSN_Move Upgrade instructions for <application>PHP-Nuke</application> 6.0 with Tom's 2.0.6 bbtonuke portMake a backup of the database tables and all files.Using your current config.php as a guide configure the new config.php's settings, PHP-Nuke 6.5's config.php has a new variable: $sitekey, it is recommended that you change at least some of the letters/numbers in it to make it unique.Upload all files and folders included in Nuke's html folder so that they replace your current files.Upload nukebbsql.php to Nuke's main directory (where config.php is) and point your browser to it. Delete it once done. From phpBB to PHP-NukeIf you have an existing phpBB Forum and would like to integrate it into one of the newer PHP-Nuke versions that come with phpBB Forums, you should use the phpBB to PHP-Nuke Script from the PHP-Nuke UK Forums. To install it, put the code into a file, edit the variables at the top and save it as transfer.php,transfer.php for example. Upload the file to the same directory as your PHP-Nuke config.configphp and point your browser to it. See also How to integrate new PHP-Nuke with existing phpBB Forum. Always backup! Backup both your PHP-Nuke database and your phpBB database before running this script. PHP-Nuke upgrade scriptsWhat's in an upgrade script? Let's take a few representative examples of code and explain what they do, so that you get an idea of what is going on in such a scriptWe will assume all prefixes, like $prefix and $user_prefix to be “nuke”.:UPDATE (Version number): the PHP-Nuke version is updated in the nuke_confignuke_config table through the UPDATE command:commandPHP-Nuke Version Number Update ]]>sql_query("UPDATE ".$prefix."_config SET Version_Num='6.7'"); ]]>UPDATE (Forums): some forum parameters are modified through the UPDATE command.commandPHP-Nuke Forums Update ]]>sql_query("UPDATE ".$prefix."_bbconfig SET config_value='.0.4' where ]]>sql_query("UPDATE ".$prefix."_bbconfig SET config_value='3600' where ]]>INSERT:INSERT some values are inserted into the nuke_bbconfig table through the INSERT command:commandsql_query("INSERT INTO ".$prefix."_bbconfig VALUES ('config_id','1')"); ]]>DELETE: a recorde is deleted from the nuke_headlines table through the DELETEDELETE commandcommandsql_query("DELETE FROM ".$prefix."_headlines WHERE ]]>DROP TABLE: the whole table nuke_priv_msgs is deleted from the database through the DROP TABLE command.commandsql_query("DROP TABLE ".$prefix."_priv_msgs"); ]]>ALTER TABLE: the structure of the nuke_users table is modified through the ALTER TABLE command:commandsql_query("ALTER TABLE ".$user_prefix."_users CHANGE uname username ]]>CREATE TABLE: a new table (nuke_bbforum_prune) is created through the CREATE TABLE command:commandsql_query("CREATE TABLE ".$prefix."_bbforum_prune (prune_id mediumint ]]>See for the syntax of SQL code. How to move PHP-NukeWe discuss how to move PHP-Nuke from your computer to your ISP (), or from one ISP to another (). This is something that you should plan carefully. The following sections will show you how.Transferring a local installation to the WebYou may prefer to test PHP-Nuke on your local box and acquaint with its features at your own pace, without the need to be constantly online. In this case, when you are done with your evaluation,evaluation you will face the problem of transferring your local installation to your webspace.space A fresh installation on the Web may not be very attractive an option to you, if you did some more or less heavy customization of the code or preferences.For the files, simply upload the content of the html folder to your document root,root or wherever you want it to appear under that. For the database,base use mysqldump or phpMyAdmin (see ) to do a backup of the database and import the data into the MySQL of your web presence. To do a backup from the command line using mysqldump,mysqldump do: dbbackup.sql ]]>where dbhost,dbhost dbuname and dbname are exactly what you entered in config.php (see ) for these variables. To import the data using mysql from the command line, do:If you change your local files and/or tables regularly, you may choose to transfer only the files/tables that changed. In this case,case you should drop the affected tables before you reimport them. phpMyAdmin offers a convenient interface for this (see and ). It is a good idea to announce these measures to your community,community to avoid frustration among your users. Changing Web hosterSooner or later in the life of any webmaster, the time comes for a project that most of us wished would never happen: change the hosting company! In this chapter we will take the dread out of moving your nuked site by simply outlining all the necessary steps for this operation to succeed. You will see that, although it may take some planning and foresight, it is a straightforward procedure after all. ]]> ]]> ]]> ]]> Inline graphic During the whole procedure,procedure it is important to remember that in this case, unlike the one in , you have your users to take care of. Treat them with kindness and inform them of the coming changes, so they are prepared if something does not work as expected.Here is the step-by-step plan to change web hoster for your PHP-Nuke:Your current hoster X doesn't fit your needs anymore. You have found a better one, Y, with better conditions. But does the new hoster Y support all the functionality you need? How aboutApache (version?) and modules (mod_gzip,mod_gzip GD library, mod_auth, mod_rewrite and all the other modules you may be using at hoster X)PHP (version? how about PHP extensions?)MySQL (version? how many databases?databases)You obtained the new server or webspace at hoster Y. Set the time frame for your move. A small, amateur site may need only a few days, whereas for a big, commercialcommercial one two weeks may be more appropriate.Ask hoster X to lower the TTL (time to live) of your domain's zone files to 900 seconds or a similar value. Normally, TTL is set to a much higher value, since DNS information does not change very often. The new, lower TTL value will force DNS servers around the world to updatedate their records about your domain in a much more frequent pace than usually. This way, changes in your domain's DNS information will propagate much faster through the Internet.InternetMake sure the basic “software infrastructurestructure” is there on your new server (or webspace) and is working:Firewall with your custom settings (if any).E-Mail functionality up and runningWeb server configuration correct and adapted to your needsphpMyAdmin installed and workingLock your filesystem on X and move all files from X to Y. You don't move your database on X yet, but you do move all files, even files that control access to your site, like .htaccess, hosts.allow,hosts.allow hosts.deny etc . files.Do a first check using the file ]]>Put it somewhere on your new webspace, name it test.testphp and just point your browser to it. Check that the output (file locations,ations configuration etc.) is what you expected.Now it's time to move your PHP-Nuke database.base Do an announcement (see ) that you will be dumping the database,base then use mysqldump to dump it: From the command line, do: dbbackup.sql ]]>where dbhost,dbhost dbuname and dbname are exactly what you entered in config.php (see ) for these variables.If your database is small, say smaller than 10MB, you could try to use phpMyAdmin for the backup.backup But since phpMyAdmin is a PHP script like all the others, it is also subjectsubject to the same CPU time constraints (which you can see in the output of the test.testphp file above, if you run it on hoster X). The limit is usually set to 30 seconds, which is not enough for backupsbackups of large databases.databases You may end up with no backup or, worse, with corrupted data.data But for a small site, one with a small database that is, doing the backupbackup with phpMyAdmin is certainly an option. See for backups through the web and for instructions on how to repair a corrupted table or database.baseTransfer the dbbackup.backupsql file to your webspace on hoster Y (you may want to compress it before you do this - compression will reduce file size and transfer time dramatically). Import the data into MySQL on Y with the command or using phpMyAdmin.AdminTest PHP-Nuke on Y to ensure it is working properly. Since your domain still points (through the DNS records on hoster X) to the old webspace on X, you will have to use the IP address in the URL and in the preferences (see ) for the tests of PHP-Nuke on Y.If all looks good on Y, put a .htaccess file (see ) in the document root on your server at X to redirect any requests to the new server at Y. That is, any requests to your domain will be re-routed to the IP of the server at Y. The following line in your .htaccess file will do this for you:Update your domain's DNS records to point to the webspace at host Y. The lower TTL setting above will take care for a rapid propagation of the new DNS information throughout the world's name servers. Changes should propagate in a few hours.Keep your server at X for a couple of days to ensure that all DNS servers got the updated records, then cancel your services at X at your own leisure. Once you do so, you will no longer need to access Y with the IP address.In case you don't have direct control over the DNS record updates,dates you will have to monitor your Y site closely, especially after receipt of the confirmation mail announcing to you that your application has been approved by both hosters.hosters You may want to write a small cron job that accesses Y by name every 5 minutes and sends you an e-mail on success. As soon as your webspace on Y is accessible by your domain name, you will know that step 11 will be completed in a few hours or, in case you couldn't change TTL,TTL a day.The key idea to the above process is that you put a .htaccess file on X, redirecting from X (still accessed by domain name) to Y (accessed by IPIP address), as soon as you transfer the PHP-Nuke database to Y. See also How to move a PHP-Nuke site. Front end structure: user viewIn this chapter we will occupy ourselves, in detail, with all the functionalities implemented in PHP-Nuke, that is what our portal system can do and how. We will do this from the part of the visitor,visitor imagining that we are the one who visits our site and uses its functionality.functionality We will analyze all the preinstalled modules in the PHP-Nuke distributiondistribution and will give a look also at some very interesting modules that still have not been included in the official distribution.distribution We will differentiate between the 6.0 version and its successors, since there have been important changes starting from version 6.5 - the Splatt forum, for example, has been replaced by the phpBB f.orum, this has created changes in other modules,modules like Your_Account or Private_Messages, that are now interoperating with phpBB.phpBBBefore starting, we should spend two words on how PHP-Nuke is structured; this system is structured as a 3 column portal,portal the two lateral ones including the blocks, the central one displaying the function modules.modules This does not mean to say that the structure of our site cannot be modified completely. The initial skeleton is, favorably, the one to start from in order to create a super personalized portal.portal Beyond the 3 columns mentioned we have also a header (top of page) and a footer (bottom of page). Blocks:Blocks they are present in the left/right columns of our portalIn fact, a way exists to personalize the visualization of the blocks based on the page in which they are displayed to us, for example, in module news we see both the left and the right block, in module search instead, we see only the blocks on the left. and deliver functions that are repeated in all pages of the site (e.g. the menu,menu banner and login blocks).Modules:Modules They are the heart of the page, they appear in the center column and each one has its own function.function For example the news module delivers the articles, the search module makes an internal search of our site - they should be imagined as independent pages. They are the "heart" of the page that we visit (see ).
<application>PHP-Nuke</application> Homepage ]]> ]]> ]]> ]]> PHP-Nuke Homepage PHP-Nuke Homepage
The preinstalled modulesnews:news Born as the heart of PHP-Nuke, it was the obligatory Home Page in previous versions. In the last versions it is instead possible to define which modules should appear as the default page.The News module expands its branches on more pages. The first one we see is a collection of the latest News published (it is possible , from the configuration panel [admin&lyxarrow;preferences] to choose the number of latest news to be displayed, say 5, 10, 15, 20, 25, 30). In the main page only a small initial text of the news article is published. If the text is too large, it will be possible to read it whole by pressing the link “Read more”.The article module has many elements that distinguish it from other ones. In the first place, the title,title the topic, that is the main category and is usually characterized by an image that, if clicked, brings up a selection of the articles that belong to this topic (starting from version 6.6,6.6 it is possible to assign more than one topics to one article). We have a second way to classify the articles, which is to assign them a category they are supposed to belong (see ).
Classifying articles ]]> ]]> ]]> ]]> Classifying articles Classifying articles
IMPORTANT This category is NOT a subcategory of topics, but rather a cross-sectional category that is completely independent from topics. Probably its most important function is to distinguish between "articles" and other admin-defined classes of news for which it will be possible to NOT be automatically published on the start page. "Articles" will always appear on the start news page. For example, imagine a portal that talks about soccer and it has 3 topics:topics League ALeague BLeague CWe could think of cross-sectional categories like: ChampionshipChampionshipChampions LeagueLeagueSoccer player market We can have an article that talks about League A/Championship,Championship or of the Soccer player market League B. Clicking o topic, say League A, we will have a selection of all the articles that talk about League A, clicking on the category,category Soccer player market, will have a selection of the articles that independently talk about soccer market that independently of the League being A, B or C. At the bottom of the article we find more information about the article:article who inserted it, when & how many times it has been read etc. The counter is incremented only if the "Read more" link has been clicked. The counter does not increment unless the user clicks "Read more". It displays how many more bytes are still to be read, if there have been any comments on the article and what score has been given to the articlearticle by the readers. It is also possible to print the article in a printer-friendly format or you can send the link via e-mail to a friend.Clicking on " Read all " brings us to the page that contains the entire article and the comments pertaining to it. In this page the user can read the entire article and interact with it through a multitude of operations.ationsHe/She can cast a vote for the article,article thus expressing a judgement on its validity,validity can comment on the article or answer to comments inserted from other users, can follow the links associated with this article,article display it in a printer-friendly format and send the link via e-mail to a friend. You can also attach a survey to the article.articleIn we show how to modify the PHP-Nuke News module.moduleAvantGO:AvantGO It is a very simplified version of the news archive, cretated mainly from the need to visit the page via a Palm Pilot. AvantGO is a system for archiving and visualizing the pages on palmtoppalmtop screens due to the fact the Palm Pilot has a very small screen and has a low resolution (and even a low bandwidth connection) so they require simplified pages.Downloads Module:Module This module is deeply branched and is used to manage a file archive (present on our own or a third party site). It offers various modes of interaction the user (see ).
Downloads module ]]> ]]> ]]> ]]> Downloads module Downloads module
In the main page it is possible to use an internal search engine that searches for keywords among all the files cataloged. There is also the possibility to add external links to a file (these files will not be added immediately, but put in a waiting list until an administratoradministrator will approve them and they become visible). We can also base our selection on which files were downloaded most, or which ones obtained the highest score.score On this page we can have a list of categories that accompany the files (there may exist subcategories but in there is only 1 category,category “Linux Downloadsads”), the user is recognized when he/she views the downloads section after their first visit so if new downloads have been added since the last visit, the corresponding category will be have a "new" icon beside it.Once we have entered the desired section, we can download the files that interest us, cast a judgment vote,vote report a nonexistent link to the administrator or see more information regarding the author of the file.The file list may be ordered by insertion date,date judgment or popularityy (files downloaded most).Read if you are looking for a quick way to enter thousands of Downloads links. Further, in we show how to modify the PHP-Nuke Downloads module.moduleFeedback:Feedback Allows the user to send feedback and contact the webmaster of the site. The user just fills in the appropriate fields which are “Name”, “E-Mail” and then the “Message Text”. The system will then format an e-mail message that will arrive to the webmasterwebmaster of the site.Member List: It displays all the users registered on the site. It is possible to select the users on the basis of their basic informationinformation fields (name, nickname,nickname personal homepage and e-mail address). It is also possible to obtain a complete list of all the users and to order it by real name, e-mail address or homepage.homepagePrivate messages: All the registered users have access to an internal messaging system,system thus being able to exchange messages with each other. In the login box of each user the number of messages that are archivedarchived for this user will be displayed, and there is a management functionalityfunctionality allowing for replies or deletions (see ).
Private messages ]]> ]]> ]]> ]]> Private messages Private messages
The message that we compose has various parts:The RecipientThe Subject The animated icon that will accompany the subject of the messageThe text that can be equipped with emoticons (emotional icons) and an aid for formatting the message in HTML adding Hyperlinks, emphasized words,words bullet lists etc...In case there are private messages waiting for a user, this will be indicated in the login block.blockStarting from version 6.5,6.5 the Private Messages module has been changed: it has been integrated to the private messaging functionality of the phpBBphpBB forum.forum Sending functionality has not been changed, but there have been additions in other areas like:The list of sent messages.The list of drafts (messages that were written, but not have not yet been sent).The remaining space in the box containing the list of messages.The module has been integrated in a very strict fashion into the phpBB forum.forumRecommend Us: This module is so you can send an e-mail to a friend recommending visiting our PHP-Nuke site. The message that will be sent to the friend must be configured by the administrator.Book Reviewsviews: This module serves as an archive of product/services/site reviews.reviews The book review must be inserted by the administrator but also from a user (a book review will need , in this case,case be accepted by the administrator) who, after inserting a short description of the product then may express his judgment assigning a score to it. It is also possible to insert a descriptive image. The book reviews are catalogued in alphabetical order and the selection can be made based on starting letter. We discuss how to modify the Reviews module in .Search: It is the main search engine for PHP-Nuke, it does full text searches on articles, comments,comments sections, users and book reviews (see ). It is possible to make multiple searches (e.g.. an article of a certain category written by a certain author).
Search module ]]> ]]> ]]> ]]> Search module Search module
Sections:Sections This module is a classification system parallel to the one of the topics.topics The classification of articles in PHP-Nuke does not follow a tree-liketree-like scheme,scheme as in the following example:Series AAmateur footballfootballProfessional footballfootballGossipGossipSeries BAmateur footballfootballProfessional footballfootballGossipGossipInstead, classification is achieved through the use of two transversal criteria,criteria of which one is the “Section” and the other one the “Topic”, as is better captured by a table, whose two dimensions (rows and columns) cover the two criteria (see ).Classification with topics and sections Series A Series B Series C Amateur football x x Professional football x Gossip x x

We discuss how to modify the Sections module in .Statistics:Statistics The statistics module provides basic statistical information regarding use of the site. The information varies from the total number of displayed pages , to the type of browser and operating system used, up to the number of users that are registered,registered the version of PHP-Nuke used etc.(see ).
Statistics module ]]> ]]> ]]> ]]> Statistics module Statistics module
Stories archive: Archives all the articles by month enabling a chronological consultation. After having chosen the month, the corresponding articles are displayed with small flags besides them, visualizing the language they were written. Also in this plane it is possible to see the article in printable formatformat and to send it to a friend. An inner search engine is also comprised as well as the display of details regarding the article,article such as:number of comments number of readings scorescoreWe discuss how to modify the Stories Archive module in .Submit news: The users or the simple visitors of the site can propose to the administratoradministrator an article that will then be examined and, if approved, published. The users do not have all the possibility of classification that the administrator does, in fact they can only decide the article's title,title the topic, the language and the text. They cannot classify it or choose if it should appear in the Home Page or not. And they can neither decide to publish it on a temporary basis. We discuss how to modify the News module in .Surveys:Surveys Enables the administrator to create a survey that will later appear in a block () or in the survey list. The users can vote on this survey (not more than once in 24 hours), and possibly leave a comment. Moreover it is possible to display the list of the previous surveys and to consult their final results.Top10:Top10 It lists the top 10 active elements of our portal:10 most read articles10 most commented articles10 most active categories10 most read articles in the special sections10 most voted surveyssurveys10 most active authors10 most read book reviewsreviews10most downloaded files10 most read pagesTopics:Topics Lists the main categories of PHP-Nuke. Once we have entered this module,module we will be able, by clicking on the corresponding icon of the topic we are interested in, to carry out a selection of articles and in automatic mode, to see all the articles corresponding to this topic. We are also presented with a small search interface to finish our searchsearch in the chosen context.contextWebLinks:WebLinks It is a collection of web links. This module has the exact same functionality as the Download module so there is no need to explain it any more. Read if you are looking for a quick way to enter thousands of Web links. Further, in we show how to modify the PHP-Nuke Web Links module.moduleYour Account: It's the administration console for your “User Profile” (It only works for registered users), the implemented functions are (see ):Change your info:info enables management of your profile by changing your E-mail, Where you're from, AIM, ICQ,ICQ Avatar & Fake E-mail etc...Change your Home: creates a personalized menu (as a block) for navigation,navigation the user can put in there whatever he wants (tests,tests links, images).Setup comments:comments Configures the display of comments, assigning display criteria.Theme selection: Changes the theme of the site, allowing you to choose between all available themes.themesJournal:Journal enables you to write your own diary to be published on the portal. Something like a Weblog in a Weblog,Weblog so to say. ;-)Webmail:Webmail once configured correctly, this mail application allows you to read all your e-mails from all your e-mail accounts, without the need for any other mail client.Logout/Exit: It lets us exit from our current user profile,profile cancelling the cookie.cookieMy Headlines: Imports into the the user's private area those news in RDF/RSSRSS format that are published by preselected news sources.sources The user can thus set up together his own personalized newspaper.newspaper An even broader news functionality is offered by the My Headlines modulemodule (), whose functionality you can see in action at Chris' News-o-matic page.Broadcast Message: If the subject is aproppriate and the administrator has allowed it in the Preferences of the administration panel (), we can send messages that will be visible to all users on the home page of the site. It is also possible to disable the function,function so that we don't see messages broadcast by other users.Your private messages: This box displays the user's private messages.Last 10 articles: Offers a list of the last 10 articles posted by that user.
Your account ]]> ]]> ]]> ]]> Your account Your account
We then have a main menu that informs us of how many and which commentscomments we have inserted and how many stories we have published.In we show how to modify the PHP-Nuke Your Account module.module If you are looking for a module that extends the possibilities of the standard Your Account module,module have a look at the Your Account Tweak module in and the Approve Membership module in .Content:Content This is a module that allows you to create your pages just as you prefer: you can insert HTML code (even one created by those very ugly visual editors) and it will be incorporated into the look and feel of your themetheme when the article is displayed. The Content module posesses a series of fields. Some are displayed only in the first page, some others only in the last one. The “Page HeaderHeader” field is the principal one, it is possible to separate the content into subpages, inserting at the aproppriate places in the text the <!--pagebreak> tag. For example, if you write ]]>then the text “I visit it every day” will be on the second page. See also , and for other techniques to incorporate HTML content in PHP-Nuke.Encyclopedia: It is a system for creating one or more word dictionaries.dictionaries In the first selection scheme it requires you to enter the dictionary (displaying even a small flag that indicates the language), after the click we are invited to choose the letter that corresponds to the searched word or to use the inner search engine of the encyclopedia,encyclopedia once found it's enough to click on the word to discover its meaning.In , you can read how to internationalize the Encyclopedia module.module You can also use the Random Quotes block () to create a random encyclopedia.encyclopediaFAQ:FAQ It is an archive of Questions/Answers divided by category that can be consulted by the user as a first solution to his problems. He can divide the Questions/Answers by category in order to facilitate the consultation.If you want to display HTML code in a FAQ,FAQ have a look at . See also if you want to duplicate the FAQ module.moduleSplatt Forum:Forum (note: the Splatt forum is included in PHP-Nuke version 6.0, but not in the successive ones, where it was replaced by the phpBB Forum,Forum to be described subsequently). The functionalities implemented in this forum (on the user side) are many (see ), the forums are divided by category, have a dedicated inner search engine,engine users can associate to every post (participation in the forum) icons relating to the argument, cast a vote on a discussion, see various icons according to the degree of attention degree that a specific discussion has generated, see how many questions and answers a certain thread has received, see the profile of that user and many other functions.
Splatt Forum. ]]> ]]> ]]> ]]> Splatt Forum. Splatt Forum.
phpBB Forum:Forum This Forum module is installed in PHP-Nuke starting from version 6.5,6.5 replacing the Splatt Forum (). It offers a series of additional features,features like an optimal search functionality for threads or an optimal user profile management,management where it is now possible to insert alerts to inform a user via e-mail of the arrival of a responseresponse to a posting or private message of his.Among the novelties in the forum interface is a list of the users currently online, an interface for the formatting of the inserted text, the possibility to attach a survey to every thread etc.
phpBB Forum. ]]> ]]> ]]> ]]> phpBB Forum. phpBB Forum.
XDMP:XDMP Starting from version 6.8 of PHP-Nuke, it is possible to acquire News from the XDMP site. The News are available in many categories and will be automatically published on your site, once you acquire the service. For this to take place, you will only need to edit the modules/News/xdmp.php file, inserting the login and password you were assigned on acquisition.acquisition You can set up the news categories and the refresh intervalls from the interface offered by modules/News/xdmp.php. An even broader news functionality is offered by the My Headlines modulemodule (), whose functionality you can see in action at Chris' News-o-matic page. Non-installed modulesSee for some interesting add-on modules for PHP-Nuke. The preinstalled blocksModules: Lists all active modules.modules In case you are the Administrator, it displays also the inactive modules,modules as wel as those that are hidden. The Modules block is very often used for navigation purposes, see for example , , and . But is is also possible to use the Content block (see below) to obtain a similar result.
The standard Modules block ]]> ]]> ]]> ]]> The standard Modules block The standard Modules block
Administration:Administration Lists the links that lead to the administration area. It is divided into two blocks, one that lists shortcuts to some administrationadministration functions, and another that lists links to content awaiting approval (, or to reports of problems like broken links, broken downloads etc.
Waiting Content block. ]]> ]]> ]]> ]]> Waiting Content block. Waiting Content block.
Who is online: Lists the number of users that are online at the moment ().
Who Is Online block. ]]> ]]> ]]> ]]> Who Is Online block. Who Is Online block.
Search: Search block for the contents of the site.Languages: Allows you to change the language of the PHP-Nuke interface.interface In the Preferences of the administration panel (), you can select whether the block shall display flag icons () or a drop-down list for the language selection.
Languages block. ]]> ]]> ]]> ]]> Languages block. Languages block.
Random Headlines: Displays random phrases in a block.block See also the Random Quotes block in .User's custom box: A block where the user can have whatever he likes. The contents of the block will solely be visible to the user who created it.Categories Menu: Displays the available categories as links.Survey:Survey Displays the current survey in the block ().
Surveys block. ]]> ]]> ]]> ]]> Surveys block. Surveys block.
Login: A block where the registered user can enter his nickname and passwordpassword in order to be recognized as such and be granted access to the servicesservices of the site that are restricted to registered users only (). See for a logout module.module
Login block. ]]> ]]> ]]> ]]> Login block. Login block.
Big Story of Today: Displays the most read story of today in the block.blockOld Articles:Articles Lists old articles that are not shown in the central News column anymore.Advertising Blocklock: From this release on we have the possibility to insert our banners also in the blocks (buttons various of dimensions) being managed as if it were our own circuiting banner,banner counting clicks, impressions etc. See , for advertisements in PHP-Nuke blocks and , for advertisements in PHP-Nuke modules.modules For Google ads,ads you can also use the Google AdSense block of .Content:Content Displays the most active content. See for instructions on how to make a simple Content block yourself.Encyclopedia:Encyclopedia lists all active encyclopedias, clicking the link will bring us directly inside the list of terms of the chosen encyclopedia.encyclopediaIn , you can read how to internationalize the Encyclopedia module.module You can also use the Random Quotes block () to create a random encyclopedia.encyclopediaForums: The forums block lists the last 10 posted messages and a searchsearch engine that executes a query on all the posts of the forum.forumLast 5 articles: It lists the last 5 published articles offering information on how many readings and how many comments have been made.Last 10 referersreferers: It lists the sites from which the last 10 visits have arrived.Ephemerids:Ephemerids It is a block that manages the recurrent events. It lists the events happened on the same date but in the previous years. Read if you are looking for a quick way to enter thousands of ephemerids.ephemeridsReviews:Reviews It lists in a block the book reviews of the day. We discuss how to modify the Reviews module in .SectionsSections ArticlesArticles: lists the active sections. Clicking one we will get to the corresponding article list. We discuss how to modify the Sections module in .Top 10 Downloadsads: It lists the 10 most downloaded files. Read if you are looking for a quick way to enter thousands of Downloads links. Further, in we show how to modify the PHP-Nuke Downloads module.moduleTop 10 Links: It lists the 10 most clicked links in the archives.archives Back end structure: administrator viewThe administration page is reached by calling the page admin.adminphp (www.yoursite.com/admin.php) and carrying out the login procedure inserting your user and password.password (Remember that the normal users should not login from the page admin.phpadmin.php but from the appropriate module). Starting from version 6.5,6.5 one has also to type a security code in an extra field. The security code is chosen randomly each time and must be the same as the one displayed in a graphic and is “poisonedpoisoned” with “noisenoise” to make automatic number recognition by login scripts impossible (see the Electric Dice site for more information on the difficulties of creating truly randomrandom numbers and poisoned images).Once logged in, the administrator finds an interface that lists all the areas which can be acted upon (see ). If the administrator is a superadmin,superadmin he may work on all the areas of the site, if instead he is an administrator with limited powers he will see the links relative to the areas on which he is allowed to work. Through the preferences configuration we will be able to decide whether to display icons or just a textual interface.interface Depending on our choice, either a textual or an icon administration interfaceinterface will appear. shows the icon interface.interface Note that the icons of the admin panel are theme dependent.
Administration panel. ]]> ]]> ]]> ]]> Administration panel. Administration panel.
Remember that when you write new administration modules you must also create the corresponding icon, otherwise, when in visual administration mode, only the textual link corresponding to your module will appear and you won't be able to click it.In order to set up the graphical administration mode you must go to the preferences section and set up in "graphical options" the “graphical menu in administrationadministration” option to “yes”.The administration functions
Administration panel: Add story. ]]> ]]> ]]> ]]> Administration panel: Add story. Administration panel: Add story.
Add Story: It is the function that adds a new article to the News module.module (We discuss how to modify the News module in .) The options offered are many and will be analyzed here one by one Note that, starting from version 6.7, a news article may be associated with multiple topics.:Title: inserts the news title.titleTopic: Determines which Topic will be associated with the article.articleCategory:Determines which Category will be associated with the article.articlePublish in the Homepage: if this option is not selected, then the articlearticle will be displayed only in the topics or the relative categories and not in the main page of the news module .Activate comments:comments If it's not activated the users cannot comment on the article.articleLanguage:Language If in the preferences we have activated the multilingual option, we will be asked in which language we will publish the article.article (e.g. if I publish an article in english, I will see it displayed only if I clickclick on the small english flag in the languages block and so on...).Story Text: It is the text that appears in the preview.previewExtended Text: It is the text that appears when we click on "read all".Programmed article:article The administrator is given the ability to choose when the article should be published, deciding on the publishing date and hour. It is not a neccesary function but it is very useful.Preview or send: Depending on the choice made here determines whether the article will be displayed in preview mode or directly published.Survey:Survey It is possible to attach a survey to a specific article ().
Attaching a poll to an article awaiting admission. ]]> ]]> ]]> ]]> Attaching a poll to an article awaiting admission. Attaching a poll to an article awaiting admission.
In the case that this option is activated,activated when the reader clicks on "read all", a survey block will appear that is different from the survey blockblock on the home page. We thus have two survey blocks active:EnumerateThe survey block on the home page ().EnumerateThe survey block attached to the specific article ().
Article Poll block. ]]> ]]> ]]> ]]> Article Poll block. Article Poll block.

Administration panel: Backup DB. ]]> ]]> ]]> ]]> Administration panel: Backup DB. Administration panel: Backup DB.
Backup DB: It is the function that allows us to create a backup file that contains both structure and content of the PHP-Nuke database.base This is very useful in case our data gets lost. Once we click on “Backup DBBackup DB”, we will have to wait for the server to create the file. Waiting time varies from a few seconds to some minutes in the case of a large database.base Once created, we will be asked to download the file. Remember to keep your backup in a safe place! See for other backup solutions.
Administration panel: Banners. ]]> ]]> ]]> ]]> Administration panel: Banners. Administration panel: Banners.
Banners: You can manage your advertising strategy with this function:function you can add clients,clients then add banners images for each client. The banners will be displayed at the top of the page, before the headerheader (if you want to change banner placement, see ). You can control the number of impressions per banner and you can also gather statistics on the achieved views and clicks.See also , for advertisements in PHP-Nuke blocks and , for advertisements in PHP-Nuke modules.modules For Google ads,ads you can also use the Google AdSense block of .
Administration panel: Blocks. ]]> ]]> ]]> ]]> Administration panel: Blocks. Administration panel: Blocks.
BlocksBlocks: It's a very important function because it allows us to control the left and right columns of our portal.portal The scheme is presented with a list of the blocks that we have created, we can then activate,activate deactivate or edit them changing their position and order and assigning them permissions.permissions We can in fact decide if a block should be visible by all, only by the registered users, or only the administrator.administrator We can also make the block visible only in a specific language. Please note This info is also present in The PHP-Nuke blocks can be of 3 different types:RSS/RDF:RDF These are blocks that capture news put at our disposal from other sites. The files are in a standard format,format suitable for reading the text contained in them (for example, the site Spaghettibrain.com is a site that feeds news to other sites).RSS is a protocol, an application of XML,XML that provides an open method of syndicating and aggregating Web content. Using RSS files, you can create a data feed that supplies headlines,headlines links, and article summaries from your Web site. This function is done automatically by the backend.backendphp file of your PHP-Nuke system,system so that other sites that wish to display (we say “syndicatesyndicate” in this context) news from your site, only have to enter the address “http://www.yoursite.com/backend.phpbackend.php” . For more information on RSS,RSS see this RSS Workshop.Blocks of content: They are blocks which we insert simple HTML or text that will be displayed inside the block (see the following example)Blocks of files: They are PHP scripts that execute predetermined commands (see the following paragraph)In order to create a new block that will be added to the list of available blocks, we must scroll down the page and position ourselves on "add block". The title field is a common element for all and will be compiled in.If we want to create a RSS/RDF block we must choose the news source from the available list or add one by clicking on “setupsetup”. In this case we will supply the address of the file to read (this infoinfo generally will be supplied by the webmaster of the site from which we capturecapture the news,news or, if it is a site created with PHP-Nuke, simply by asking for the file backend.backendphp of that site). The other fields will all be compiled in with the exception of “filenamefilename” and “ContentContent”. There is a bug that will display a message, saying “There is a current problem with the headlines from this site.”, although everything will be set up right, see . If we want to create a block of simple text instead, we will omit the field “RSS/RDF file URLURL” and will complete “ContentContent” instead (Omitting ”filenamefilename”).If instead we want to include the PHP files that interface with a databasebase or perform particular functions, then we will omit “ContentContent” and “RSS/RDFRDF” and will choose between the available files the one that will create our block.block (If you want more info on how to create blocks, see ). Just choose the block from the drop-down list of available blocks and set a title for it (or leave the title untouched).Remember that before publishing a block,block we will be shown a preview of it. Use custom blocks for building navigation menus Many users think that the Modules block () is the obligatory way of building a navigation menu. However, it is just as possible to create custom blocks containing our HTML code and images or links - see for various approaches in this direction. Finally, the block can be positionedin the left/right column, orin the central column, either at the top or at the bottom.You can change the relative positioning of all the blocks inside a column by clicking on the up and down arrows in the table that lists all blocks in the blocks administration panel.panelSee for interesting add-on blocks.
Administration panel: Content. ]]> ]]> ]]> ]]> Administration panel: Content. Administration panel: Content.
ContentContent Manager: This function allows us to add new categories and new content inside the content section. Think of it as a container for creating empty pages. A noteworthy feature is the possibility to add the tag ]]>in order to create a multipage article.article The elements that comprise the Content module are:title,titlesubtitle,titlepage header text,page main text,page footer text,signature.natureThe ]]>function is only active in the page main text field.After you have created the desired categories you can then go to http://yoursite.com/admin.php?admin.phpop=content and start adding pages to the categories. You can create links that point directly to the pages created by the ContentContent module and use them in menus or buttons. The links could look as follows:where pid=1 is the page ID that uniquely identifies the Content page.An easy way to find out the correct URL to use in links to Content pages, is to click on the Content link in the modules block,block view each page and copy its URL from the browser's address window. You can then just add these URLs to a HTML block,block maybe like this: · ]]> ]]> ]]>
]]>· ]]> ]]> ]]>
]]>· ]]> ]]> ]]>
]]>and so on. See also , and for other techniques to incorporate HTML content in PHP-Nuke.

Administration panel: Downloads. ]]> ]]> ]]> ]]> Administration panel: Downloads. Administration panel: Downloads. Downloads: It creates categories, subcategories and adds files to the downloaddownload area. For security reasons, the system does not allow file uploads via HTTP,HTTP only their linking through their HTTP address. If for example the file files.zipzip is found in the directory files of our site, we would have to link it as www.oursite.com/files/file.zipzip. This allows us to link external resources also. If you have thousands of download links to enter, consult for an automated procedure.procedure Further, in we show how to modify the PHP-Nuke Downloads module.module

Administration panel: Edit Admins. ]]> ]]> ]]> ]]> Administration panel: Edit Admins. Administration panel: Edit Admins. EditEdit Admins: Enables us to add new administrators, defining their access levels. Besides having a super administrator it is in fact possible to activateactivate only partial functions for the various administrators. For example, for an editorial activity, you can create sub-administratorssub-administrators and enable only the News administration functions for them.

Administration panel: Edit Users. ]]> ]]> ]]> ]]> Administration panel: Edit Users. Administration panel: Edit Users. EditEdit Users: From here it is possible to manually add new users and to modify existing ones, choosing their profile by typing the nickname in the appropriate form. Through the same form it is also possible to delete a user, by simply changing the drop-down menu selection from “modify” to “delete”.

Administration panel: Encyclopedia. ]]> ]]> ]]> ]]> Administration panel: Encyclopedia. Administration panel: Encyclopedia. EncyclopediaEncyclopedia: Allows the creation of multiple word lists (choosing also the language), after having created an encyclopedia we can proceed to the insertion of terms.terms Attention! You can only insert terms in an encyclopedia after you have already entered the encyclopedia's title! The whole interface is contained in one single screen,screen so that for entering the encyclopedia terms you will have to scroll down, then insert the term, its description and also choose the encyclopedia you want to have it in. If you have thousands of terms,terms such an approach is not practical. You may want to have a look at the techniques presented in (for web links) and (for download links) and adapt them to the Encyclopedia module.moduleFor internationalization (i18n) issues regarding the Encyclopedia module,module see . You can also use the Random Quotes block () to create a random encyclopedia.encyclopedia

Administration panel: Ephemerids. ]]> ]]> ]]> ]]> Administration panel: Ephemerids. Administration panel: Ephemerids. Ephemerids:Ephemerids Allows the insertion of recurrent events choosing the date and inserting a description. Given such an event in the Ephemerids table, the Ephemerids block will display its description on the day that it occured. More than one events on a given day are possible, of course. To modify such an event,event you have to scroll up to the bottom of the screen, choose the desired date and then proceed as usual. For a more speedy alternative, see .

Administration panel: FAQ. ]]> ]]> ]]> ]]> Administration panel: FAQ. Administration panel: FAQ. FAQFAQ: Allows the creation of the main FAQ categories and all related questions/answers. After a category has been entered, you must click on its content to be able to enter, delete or modify a FAQ.FAQIf you want to display HTML code in a FAQ,FAQ have a look at . See also if you want to duplicate the FAQ module.module

Administration panel: Forums. ]]> ]]> ]]> ]]> Administration panel: Forums. Administration panel: Forums. Splatt ForumForum: The management of the forum is divided in 4 areasThis applies to PHP-Nuke version 6.0, that has the Splatt Forum installed, or to those installations of a later version that nevertheless use the Splatt Forum module. For the administration functions of the phpBB Forum, see .: Preferences:Preferences It manages the characteristics of the forum (For security reasons it's advisable to deactivate the option to mail in HTML).Categories and forum:forum defines the categories, the forums included in them, the moderators of every forum,forum levels of access etc... For a forum to be visible, you MUST activate at least one moderator otherwise the forum won't show up!Ranks:Ranks defines the attention thresholds for the forum. Upon reception of the nth post, aproppriate images will be attached to attract proper attention of the visitors.Users: moderator management through a complete list of the registered users.

Administration panel: HTTP Referers. ]]> ]]> ]]> ]]> Administration panel: HTTP Referers. Administration panel: HTTP Referers. HTTP ReferersReferers: It displays the URL of the site the visitor was on, before coming to our site. See also the IP Tracking module in and the Protector module in for a similar, but extended, functionality.functionality

Administration panel: Messages. ]]> ]]> ]]> ]]> Administration panel: Messages. Administration panel: Messages. MessagesMessages: It creates a central block in the Home Page in order to send selective messages to the users. The messages can be sent to only registered users, to non-registered users, to the administrator or one may carry out a selection by language. They also may carry a expiration date,date making it possible to say, for example, “show this message for 1, 2, 5, 15, 30 days, or for unlimited time”.

Administration panel: Modules. ]]> ]]> ]]> ]]> Administration panel: Modules. Administration panel: Modules. ModulesModules: Allows for the management of the modules installed. The modules can be activated,activated deactivated or be assigned read permissions. A module can be world-readable,world-readable readable only by the registered users, or only the administrator (). Further, you can define the module that will be “put in Home”, i.e. appear in the index.indexphp page (the “Homepage” of PHP-Nuke), but see if this seems to be not working.

Modules administration panel. ]]> ]]> ]]> ]]> Modules administration panel. Modules administration panel. Newsletter: the PHP-Nuke administrator can send a newsletter to the registeredregistered users who have consented to receive them or send them to all the registeredregistered users. Attention to spam!See if you want to allow HTML in your newsletter.newsletter

Administration panel: Optimize DB. ]]> ]]> ]]> ]]> Administration panel: Optimize DB. Administration panel: Optimize DB. Optimize DB: Optimizes the data in the database,base increasing database speed. Use with caution. Backup your database before! See for automated backups through the browser - and in case something goes wrong and you have to restore your database from a backup.backup

Administration panel: Preferences. ]]> ]]> ]]> ]]> Administration panel: Preferences. Administration panel: Preferences. Preferences:Preferences This subject will be treated in .

Administration panel: Reviews. ]]> ]]> ]]> ]]> Administration panel: Reviews. Administration panel: Reviews. Reviewsviews: It allows us to insert book reviews.reviews In every book review it is possible to cast a vote,vote a link relative to the subject and finally an image that represents the content. To insert an image, you must save it in the images/reviews folder, then enter its filename (without the path, e.g. pippo.png) in the aproppriate field.Further, you can set up a title and a description for the reviews main page.We discuss how to modify the Reviews module in .

Administration panel: Sections. ]]> ]]> ]]> ]]> Administration panel: Sections. Administration panel: Sections. Sections:Sections here you can manage the sections and their contents. It is possible to associate an image to the section subject,subject just as it is in the topics.topics It is possible to add articles to the sections selecting the aproppriate category through a radio button, to divide long texts using the <! -- pagebreak -- > tag and to edit or cancel already added sections.

Administration panel: Submissions. ]]> ]]> ]]> ]]> Administration panel: Submissions. Administration panel: Submissions. Submissions:Submissions Here you can manage articles inserted by others. It is the moderation area of the News module that we have already analyzed in this section. You can publish, modify or delete submitted articles - there is even a field for “notesnotes” that allows the webmaster to enter a comment to the article that will be visually distinguished from the main text by a cursive font.

Administration panel: Surveys. ]]> ]]> ]]> ]]> Administration panel: Surveys. Administration panel: Surveys. Surveys/Polls:Polls Creates a new survey for the site, edits or cancels old ones. It is possible to insert up to 10 different answers to every survey.survey In the context of the creation of the survey it is possible, on the same page, to publish a news article that announces its creation.

Administration panel: Topics. ]]> ]]> ]]> ]]> Administration panel: Topics. Administration panel: Topics. Topics: Allows you to create new topics and the association, through a pop-uppop-up menu,menu of corresponding images (). The images must have been copied to the images/topics folder previously.

Administration panel: Add a new topic. ]]> ]]> ]]> ]]> Administration panel: Add a new topic. Administration panel: Add a new topic.

Administration panel: Web Links. ]]> ]]> ]]> ]]> Administration panel: Web Links. Administration panel: Web Links. Web Links: Allows us to edit links published by others, create categories for archiving the links, eliminate links, see user messages informing us of any broken links through an interface very similar to the downloadsads section and add new links. If you have many links to enter, an automatic procedure based on scripting,scripting as discussed in , may be of interest to you. Further, in we show how to modify the PHP-Nuke Web Links module.module

Administration panel: Logout. ]]> ]]> ]]> ]]> Administration panel: Logout. Administration panel: Logout. Logout/ExitExit: Exits from the administration area rendering the cookie invalid. It is good practice to login logout after having finished working with PHP-Nuke. For security reasons (see ).phpBB Forum administration

Administration panel: Forums. ]]> ]]> ]]> ]]> Administration panel: Forums. Administration panel: Forums. Given the length of the administration interface of the phpBB Forum,Forum we will traverse its functions following the order of the menu in the left frame.frameAdmin Index:Index Leads back to the the administration panel of PHP-Nuke ().Forum Index:Index Leads back to the main Forum page.Preview Forum:Forum Offers a preview of the forum, keeping the left frame with the administration functions in place.Management: Here you can create the categories that will form the criteriacriteria for grouping the forums, old and new ones. It is also possible to change their order inside a category, lock and unlocklock a forum, and configure the pruning function for every forum.forum Pruning is the self-cleaning action that deletes all threads that did not receive a posting in the last N days, N being individually set by the administrator.Pruning:Pruning Another way to reach the pruning function (instead of the Management link above).Avatar management:management Deletes unwanted avatars.Backup database:base Makes a backup copy of the database. Since PHP-Nuke also posesses the same function,function it is recommended to use that one from PHP-Nuke's administration panel (). For a do-it-yourself solution, see , but bear in mind that all these methods will fail, if your database has become so large that PHP is exhausting its CPU time limit and breaks execution. In such a case, only the MySQL mysqldump command-line utility can backupbackup your DB.Configuration: This is the forum configuration panel.panel From all the functions present, we would like to bring the following ones to your attention:Flood interval: Minimum number of seconds that must pass between a post and the next one (by the same person).Topics per page: Number of threads per page.Posts per page: Number of posts per page.Posts for popular threshold:threshold Number of posts required to render a thread as “popular”.Allowed HTML tags: The HTML tags that the users are allowed to use in their text (e.g. links, tables etc.). See for the same subject regarding PHP-Nuke in general.Allow username changes: Enables changing one's nickname (don't set this to “yes”).Enable remote avatars:avatars Enables linking one's avatar to an image from a remote site (e.g. one's photo).E-mail settings:settings management of e-mail operations (be it mailing actions or mail notifications).Mass e-mails: Allows for mass e-mailing of users or groups through a newsletter.newsletter PHP-Nuke posseses this functionality too.Restore database:base Reloads a backup file of the database (don't play too much with this).Smilies: Allows a personalization of the character sequences that will be mapped to smiley icons.iconsWord censor:censor Enables censorship of bad words (the ones you enter in the list). PHP-Nuke posesses a similar bad word list in the config.configphp file ().Group/admin management:management Here you can create groups, which can be “open”, “closed” or “hidden”. In an open group, anyone can choose to join. A closed group is viewable,viewable but only administrators can add members to them. A hidden groups is only viewable by an administrator.administrator How to add a user to a group To add members you don't even need to be in the forum's admin section: in any normal forum page click on usergroups, you will see all available groups depending on your access level, if you have admin access you will be able to add/remove/approve users from this page. Permissions: You can assign permissions to a group here.Styles admin: In the standalone phpBB forum, you can manage the forum themesthemes from here. However, this function does not have any effect on PHP-Nuke, whose themesthemes are still managed from the administration panel (). If a theme does not work with the phpBB forum in PHP-Nuke, you should not try to activate it through this function,function it wil still not work. Try to contact the designer instead, and ask for a PHP-Nuke conforming theme.themeBan control:control Allows you to ban a username, an e-mail address, or an IP address (or a group of IP addresses). See and for add-on modules that pursue the same subject.subjectDisallow name: You can enter the usernames you wish to make unavailable to users.User admin/management: Allows the administrator to manage user data.dataPermissions: Allows the adminstrator to set user permissions.permissionsRanks:Ranks You can define user “categories” here, the so-called ranks. A user will attain a certain rank,rank after having posted a threshold number X of forum posts - the rank name, icon and threshold being freely configurable. The Preferences Page

Administration panel: Preferences. ]]> ]]> ]]> ]]> Administration panel: Preferences. Administration panel: Preferences. Here are the parameters needed for the configuration of the config.configphp file () through the admin/preferences area:General Site Info ():Site name: It corresponds to the title tag, it is what appears up in the right bar of the browser. It is very important for the search engines.Site URL:URL It is the internet address of your site.Logo:Logo It is the logo of your site. In standard themes and themes not modified much it is the Logo that appears up on the left.Slogan:Slogan It is equivalent to the description tag, it's also very important for the search engines.Beginning date of the site: It's the date that appears in the statisticsstatistics module.moduleAdministrator e-mail : it is the e-mail which will receive the notificationsnotifications for article insertions by third parties and the mails from the “contact us” module.moduleArticles in Top Page: Specifies the number of news articles that can be displayed in the main page of the news module.moduleArticles in Home: Specifies the number of news articles that can be displayed in the home page of the site (if the news module is the main one).Stories in old articles box: Specifies the number of news articles that can be displayed in the old articles box. Note, however, that articles never get moved anywhere. An archived article,article is any article except for the first 10 articles (or whatever number you have in Preferences for "number of stories in Home"). The Old Articles block starts with the 11th newest article,article and goes back from there (again, it depends on "stories in Home").Activate ultramode:ultramode specifies if other sites can take news titles from our site.Allow anonymous to post : Specifies whether anonymous users can write comments.commentsDefault theme:theme defines the default theme of the site.Select language: defines the default language of the site.local time format:format defines the format of the local time (depends on the server,server if it is running linux, this is controlled in /usr/share/locale). See also .

General site info in the Preferences page. ]]> ]]> ]]> ]]> General site info in the Preferences page. General site info in the Preferences page. Multilingual options:activate the multilanguage characteristics:characteristics choose whether the site should support a multilingual functionality or notdisplay the small flags in place of the list: if the multilingual option is activated then this decides whether the block should display the small state flags in place of a list of language names (see ).Banners options:activate banners : sets up the option to use banner rotation on the site. The banners will be positioned in the header.header See on how to change the banner's position in the header.header If you are interested in other ways of ad placement in PHP-Nuke, see on how to display ad banners in PHP-Nuke blocks and on how to display advertisements in PHP-Nuke modules.modulesFooter messages:For the footer of the page, imagine we have to insert 3 texts in a table that is 100% wide and positioned centrally:Page Footer Line 1: first text to insertinsertPage Footer Line 2: second text to insertinsertPage Footer Line 3: third text to insertinsertExample: Suppose you have some "powered by" icons in the images/powered directory, like powered_by_linux.png, powered_by_apache.png,powered_by_apache.png powered_by_mysql.png etc. Then you can insert the following HTML code in one of the above footerfooter lines and the icons will appear in the aproppriate footer line (): ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> Backend configuration:configurationBackend title:title The title that will appear in the file from which other sites get our newsfeed.newsfeedBackend language: language for the newsfeed file.Mail New Stories to Admin:AdminNotify new submissions by e-mail:e-mail It defines whether the administrator gets an e-mail when a user inserts a news article.articleE-mail to send the message: e-mail to which the notification message will be sent.E-mail subject:subject the text that will be inserted in the subject line of the message (e.g. “NEWS for my site”)E-mail message: notification text (e.g. “Hey! You got a new submission for your site.”).E-mail account (From): who has sent the message (typically something like “WebmasterWebmaster”).Comments moderation:moderationType of Moderation: chooses whether a moderation should be set up for the comments or not. The options available are: No moderationmoderationModeration by AdminAdminModeration by UsersComments option:Comment limit in Bytes: sets up the maximum size for the comments.commentsAnonymous default name: assigns a name to the persons who chose to remain unregistered.unregisteredGraphics options:Graphical administration menu:menu sets up whether to have icons or text in the administration area.Miscelaneous options:Activate HTTP referers:referers whether statistics regarding the origin of the visits should be gathered.How many referrers you want as maximum: the maximum number of statisticsstatistics pertaining to the origin of the visits (max 2000).Activate comments in polls:polls Whether comments are allowed in the surveys or not.Activate comments in articles: Whether comments are allowed in the articles or not.Users options:Minimum users password length: for security reasons it is advisable to set up a rather long password.passwordCensure options:Here you can choose to censor some words and also set up the criteria for word matching.matching The words to be censored have to be included in the $CensorList array in config.configphp ().WebMail service ptions (): Here you canset up a message to appear in the footer of every e-mail sent by any user of the site,set up the permissions for the e-mail and its attachments.attachments In case you allow attachments,attachments you can specify the directory that will temporarily hold them (however, this is not a good idea from the securitysecurity point of view, see ),allow for direct viewing of the attachments' content via web,specify the directory that will hold the attachments of the received e-mails,specify the maximum number of e-mail accounts that your users will be allowed to set up with WebMail,WebMailspecify the default POP3 server (i.e. server that will be used for querying for incoming e-mails),specify if the header of the e-mail is going to be visible (recommended).

WebMail service options in the Preferences page. ]]> ]]> ]]> ]]> WebMail service options in the Preferences page. WebMail service options in the Preferences page. PHP-Nuke add-onsWe present some interesting add-on themes (), blocks () and modules () for PHP-Nuke.Add-on themesIn this section we present some interesting add-on themes for PHP-Nuke:AutoTheme ().AutoThemeAutoTheme is an HTML Theme System for PostNuke and PHP-Nuke. The current theme system usually requires you to be somewhat familiar with PHP and the PostNuke or PHP-Nuke architecture.architecture AutoTheme removes this complexity.complexityAutoTheme's primary benefit is providing users the ability to create PHP-Nuke themes in HTML using their favorite editor , with no use of PHP.PHP In addition, AutoTheme provides easy customization of every part of your PHP-Nuke site; including block display, custom templates for the Home Page, User Pages and Admin Pages and individual modules.modules The addition of AutoBlocks provides unlimited locations for your blocks. All AutoTheme settings are easily configured from a graphical administrationadministration interface that is integrated into PHP-Nuke. You can get a better idea of AutoTheme's possibilities, if you compare the standard layout of a PHP-Nuke theme with the layout offered by AutoTheme.See also AutoTheme for PHP-Nuke, for more details on AutoTheme and , for more details on PHP-Nuke's theme structure.structure Add-on blocksIn this section we present some interesting add-on blocks for PHP-Nuke: Moon & Sun (), Meteosat (), Comic (), Menu Builder (), Treemenu (PHP) (), Treemenu (JS) (), AdSense (),Random Quotes ().Moon & Sun block

Moon, Moon & Sun and Sun blocks. ]]> ]]> ]]> ]]> Moon, Moon & Sun and Sun blocks. Moon, Moon & Sun and Sun blocks. The Moon and Sun blocks are very simple blocks: they show the current MoonMoon or Sun image, but technically they contain no dynamic components. The blocks incorporate an image with a fixed URL.URL It is left to the provider of the image (the U.S.U.S. Naval Observatory and the NASA Goddard Space Flight Center) to put whatever image is “current” into the that fixed URL.URL This simplifies the programming of the blocks substancially.The Moon block shows the daily Lunar Phase. It also shows the Julian Date, and some Moon info and uses a simple cachecache to wait x minutes before grabbing the image again remotely. Stores image in temp cache folder on your site.The Sun block grabs an image of the sun that is taken daily,daily and places it on your web page. Nice colored Solar Image, includes Sunrise and Sunset info,info that can be customized. Also caches image on your site, and fetches the new image every x minutes.The Moon & Sun block combines the two images in a single PHP-Nuke block, but omits the informationinformation and the caching functionality.functionality Caching Even if your PHP-Nuke block does not come with a caching mechanism (which is especially useful in cases where the block's content does not change on literally every page request), this does not mean you are excluded from reaping its benefits! In we discuss all the caching options you have in detail. You may want to use one of the standard solutions presented there, rather than implement a slightly different caching mechanism with each and every block you install on your site. Meteosat block

Meteosat block. ]]> ]]> ]]> ]]> Meteosat block. Meteosat block. The Meteosat block will display the most recent Meteosat images of the World and Europe.Europe It is a good example of a block that contains dynamic images whose filenames vary according to some date schema (see source code of the Meteosat PHP-Nuke blockActually, the source code for the PHP-Nuke block is slightly different, but the algorithm is exactly the same.):The images are taken from http://www.wetter.com/home/img/sat/METEOSAT_vis_c/xl/http://www.wetter.com/home/img/sat/METEOSAT-FULL_ir_c/xl/and are named YYYYMMDDHHMM.jpg, in GMT,GMT so the script has to compute the year, month, day, hour and minutes in GMT,GMT then round down the minutes to either 00 or 30. Thus, although the date and time variables ($year, $month, $day) are dynamic,dynamic the schema itself is fixed: the filename is always of the form $year$month$day$hour$minutes.jpg.Due to delays,delays the script doesn't try to get the exact latest image, it rather subtracts a safety intervall of 3600 sec from the current time, before it starts the calculations.ations This way it makes sure an image will always be there. Comic blockThis UserFriendly block will display the daily comic from the well-known User Friendly site. It reads the User Friendly daily cartoon page line by line, searches for the patternpatternwhatever, ]]>extracts the location of the image file (imagefile) from it and displays it in the block.block The PHP code of the User Friendly block is a classic example of how you can do this “scrappingscrapping” in PHP (-Nuke) and is discussed in . You must respect copyright law! Some people argue that, by using PHP to find out the right image filename and then send HTML code that instructs the client's browser to request that image from the original site and display it, you don't copy anything yourself, only the client's browser copies the file in the client's video memory, which would be necessary anyway. Thus, the argument goes, no copyright is infringed, since no copies are made by you. However, even if you don't copy the daily comic directly, you use the original author's work to produce a page that can be seen as a “derivative work”. Even if you argue that what you do is just the same as what any proxy would do, if it where instructed to strip all other content (like advertisements, for example) from the requested page and serve only the image, it is not sure that the court will follow you in this interpretation. To avoid even the remote possibility of breaking copyright law, you are well advised to ask the authors' permission, before you use any comics blocks on your site. Some may not agree, in which case you should respect their wish, but some may do give you permission, perhaps under some easy to accept conditions. For example, to obtain permission to show the UserFriendly cartoon on his site, Chris wrote the author, Illiad, who kindly agreed under the condition to reproduce the ads that come with it on the original UserFriendly page. This way, everybody's happy! ]]> ]]> ]]> ]]> Inline graphic Leges sine moribus vanae<footnote><para>Laws without morals are empty.</para></footnote> Actually, we shouldn't have to resort to legal arguments for this - moral alone should suffice to convince you. Please take a moment to think about it. See for a module which displays more than one daily comics.comics Menu Builder The Language Menu Builder generates a block with a menu on-the-fly from the administration panel.panel You can write the menu in your own language, choose your own images for the menu items and have certain options hidden for 'visitors'. The Menu Builder does not use or change any database items. Thus it wil not become obsolete when tables change in the database (this is true for the Treemenu too). See it in action at http://www.sengers-au.com, where you will find other interesting downloads around blocks and modulesmodules too. Treemenu with PHP

Treemenu block with <acronym>PHP</acronym>. ]]> ]]> ]]> ]]> Treemenu block with PHP. Treemenu block with PHP. The Treemenu for PHP-Nuke will read a simple, plain text file that contains the “nodes” and “leavesleaves” of a menu and will create a block with a Treemenu,menu as shown in . Features include:No database changes. You only change a text file.Grouping of menu items (“leavesleaves” of the Treemenu) under “nodes”.Expansion and collapse of the nodes based on the value of an URL parameter.parameter You can thus let a submenu stay “open” , even after you cliked on a leaf link.Custom images for nodes (open or closed) and leaves.leaves You can make it look like a window of a file manager.managerMore complicated logic possible (e.g. depending on categories etc.), see Treemenu block for PHPNuke: Refinements.This Treemenu is based on a PHP class and therefore does not require any client scripting (like Javascript). Thus it will still work on clients with Javascript disabled. On the other side, for every change of the menu,menu like expansion or collapse , a new HTTP page request is made to the server.server Like PHP itself, the Treemenu is a server-side technology.A detailed description of the Treemenu can be found in Treemenu block for PHPNuke. We also discuss it in , in the context of modifying blocks, specifically the Modules block.block Treemenu with Javascript

Treemenu block with Javascript. ]]> ]]> ]]> ]]> Treemenu block with Javascript. Treemenu block with Javascript. If you are looking for a Treemenu based on Javascript,Javascript you can see one in action at Nuke Turk and download from the PHP-Nuke downloads section there. Since Javascript is a client-based technology, the menu will be downloaded in whole once and no further page requests will be necessary to display its nodes and leaves.leaves This may result in slower downloads for the first time, but faster responseresponse times from the menu in expansions and collapses. But it will not work for clients with Javascript disabled.An alternative Menu Block is “Sommaire Param�trableParam�trable” This is the original name.(see also Neue Bloecke). You can download it from Customize Menu. This add-on allows the admin to set up his own menu for Nuke web sites (replaces the Modules block that lists all the active & visible modules).

Modules block. created with Sommaire Param�trable. ]]> ]]> ]]> ]]> Modules block. created with Sommaire Param�trable. Modules block. created with Sommaire Param�trable. Features of version 2.0 :Modules are grouped into categories (sub-menu).You can choose the display order of each module and category.categoryYou can set up a background color for each category.categoryYou can now add external links in your menu ! (You were restricted to modulesmodules only in v.1.0).Multilingual support.Categories' names can be centered.You can display a FLASH file instead of the category's name.You can set images for each module/link.You can separate categories with horizontal bars.barsYou can hide to visitors the modules for members only.You can choose the class (stylesheet css) for the categories' names.A 'new mail' icon appears before "Private Messages" if the member has unread Private Messages.MessagesThe administration console has been improved and is now completely part of the nuke administration panel.panel (2 languages included : French and English)However, it seems that it does not allow subcategories (FIXME:FIXME Is this correct?). The name of the file to download is sommaire_parametrable_v2.zip.zip Random Quotes blockThe Random Quotes block is an unintrusive block for PHP-Nuke 6.0 that takes its quotes from a "fortune" file of your choice ("fortune" is a humourous quotes program commonly available on most UNIX/Linux/BSD distributions). It snaps easily in place and does not break your layout.layout

Random Quotes block. ]]> ]]> ]]> ]]> Random Quotes block. Random Quotes block. It is easy to construct a fortune file with the content of your choice, then let block-Random_Quotes display it. The file type is just like the one for 'fortunes': enter quotes in plain text, separated by a per cent sign (%), see the fortunes file that comes with the block.block There also various ready-to-use fortune files available on the Net. There is no restriction on the file's content, so it does not have to be humourous - it could just as well be religious, political, philosophical, or just plain marketese.marketese You could for example use it to display random Encyclopedia terms,terms see Random Encyclopedia. Add-on modulesIn this section we present some interesting add-on modules for PHP-Nuke: Daily Comic (), Event Calendar (), Your Account Tweak (), Approve Membership (), Gallery (), IP Tracking (), Protector (), Web Cam (), My Headlines (), PHP-Nuke Tools (), Upload (), Upload add-on for phpBB (), ODP (), eCommerce (), WorkBoard ().Daily Comic moduleIn contrast to the UserFriendly block (), which shows only one cartoon,cartoon the Daily Comic module will show a whole series of different daily comics from various authors. However, instead of getting the images from the original web pages, it requests them from some third party web page. This way, the mechanics of achieving this result remain hidden to you - which is not very good from the educational point of view, even though the result is very pleasing. See it in action in Coding Network: Daily Comic module. Please read the admonition on copyright in , before you decide to use this module! Event calendarBased on version 1.5 by Rob Sutton, the Event Calendar () found in http://phpnuke.holbrookau.net is much updated and features many improvements and add- ons. For example, the adminstration area features configuration via a graphical interface,interface posting of events can be mode rated and users even have the option of adding comments to any event.event

Event Calendar ]]> ]]> ]]> ]]> Event Calendar Event Calendar For the installation,installation it is assumed that the user has some knowledge of MySQL and is comfortable with running simple queries before starting. It is highly recommended that you have phpMyAdmin (see ) installed on your server - it will simplify installation and help with error tracking.tracking

Calendar1 Block ]]> ]]> ]]> ]]> Calendar1 Block Calendar1 Block

Calendar2 Block ]]> ]]> ]]> ]]> Calendar2 Block Calendar2 Block Add new Block(s) using one or more of the 5 available calendar block types:Calendar1 () shows only events for that day. Calendar2 () is a month calendar with a daily events list. Calendar3 () scrolls a list of coming events. Calendar4 () is the monthly calendar with links and day/month view selection. Calendar5 () is an enhanced ( next 10 events) version of the scrolling calendar block.block

Calendar3 Block ]]> ]]> ]]> ]]> Calendar3 Block Calendar3 Block

Calendar4 Block ]]> ]]> ]]> ]]> Calendar4 Block Calendar4 Block

Calendar5 Block ]]> ]]> ]]> ]]> Calendar5 Block Calendar5 Block For installation instructions, read the readme.readmetxt file that comes in the docs folder of the unzipped eventcal-xxx.zip file. NSN Your Account Tweak moduleA module that allows the administrator to apply a fine-grained control over user management is NSN Your Account Tweak 650 3.0.2. According to the description, it offers the following features ():Provides for servers without mail support.Optionally send the admin an email when someone unregisters.Optionally send the admin an email when someone registers.Admins can allow user self deletion.Admins can block user theme changes.Admins can block user email changes.Blocks usernames with preset strings in them.Allows for Required User approval by Admin.AdminAdmins can suspend users.Users can be promoted to Admins by SuperUser ONLY.Admins can resend Activation Email.Admins can choose to bypass email activation.activationAdmins can now view pending user details.Admins can now modify pending user details.Improved NavBar scripting.scripting

Extra options for user management in the NSN Your Account Tweak module. ]]> ]]> ]]> ]]> Extra options for user management in the NSN Your Account Tweak module. Extra options for user management in the NSN Your Account Tweak module. Download the right NSN Your Account Tweak version! Be careful with the version you download from this module! The number 650, for example, indicates that it is only for PHP-Nuke 6.5. Use only the version that is in accordance with your installed PHP-Nuke version, otherwise you are guaranteed to mess up your installation completely. Approve Membership module

Pending applications in the Approve Membership module. ]]> ]]> ]]> ]]> Pending applications in the Approve Membership module. Pending applications in the Approve Membership module. The Approve Membership module allows an administrator to approve membership applications.ations The applicant's details are sent to a pending users table and a notificationnotification email is sent to the administrator.administrator A list of pending applicants is displayed to the administrator,administrator who can delete or approve as he thinks fit (see ). On approval,approval the normal email is sent to the applicant with the activation link. The following options are available: Add a customisable message to this email (see ).Send a follow up email to an applicant.applicantSend an email to a rejected applicant.applicantAll emails are customizable.customizable

Approval message in the Approve Membership module. ]]> ]]> ]]> ]]> Approval message in the Approve Membership module. Approval message in the Approve Membership module. See also Authorize accounts for an in-depth discussion. The new version 3.0 of the Approve Membership module for PHP-Nuke 6.9 offers even more facilities, such as:The option to include the activation link or not.The option to semi-automate the approval process. With this option, the admin can pre-approve known email addresses (from student lists, club members,members family and friends etc), see , .If an applicant is on the pre-approved list, his application is automatically approved without the intervention of adminadminIf an applicant is not on the approved list, there are various configurationsconfigurations for dealing with the application.applicationThe automated process is configurable from the administration panel ().

E-mail management in the Approve Membership module, part I. ]]> ]]> ]]> ]]> E-mail management in the Approve Membership module, part I. E-mail management in the Approve Membership module, part I.

E-mail management in the Approve Membership module, part II. ]]> ]]> ]]> ]]> E-mail management in the Approve Membership module, part II. E-mail management in the Approve Membership module, part II. If you want users to be registered directly, without confirmation mails, see or the New User Auto Activation Hack and the Auto Registration Activation For Nuke v7.0. If you want to disable registration,registration see . Gallery moduleThe Gallery module from Nuked Gallery is the “nukednuked” version of the standalone Gallery package. Gallery comes with a handy web based configuration wizard.wizard This wizard helps to make sure that your web server and operating systemsystem are set up correctly. It allows you to configure many of Gallery's options while determining as much as it can from your environment. The wizard will create an administrator account for you. This is a special account that allows you to create other user accounts, create albums,albums and set album permissions.

Gallery module. ]]> ]]> ]]> ]]> Gallery module. Gallery module. A photo or movie is the basic unit of Gallery.Gallery Photos and movies are grouped together into albums (). Once you have the photos in your album,album the fun begins. Typically an intermediate resized version and a thumbnail of the image are created for you. You can:Add captionscaptionsEdit the thumbnail.thumbnail Gallery comes with a small Java applet that lets you select a part of the image as the source for your thumbnail.thumbnailRotate your photo (in 90 degree increments)Highlight a photo (pick a photo to represent the album in the main Gallery)Reorder the photos in the album Hide photos (so that they're only visible to the owner)Delete photosphotosSort your album based on popularity, title, number of comments,comments and photo capture date.date Edit multiple captions at once To download the Gallery module,module go to Nuked Gallery, find the “Related files” block () and click on the link with the most recent stable version. Other Gallery related resources areThe Nuked Gallery Demo SiteThe Gallery FAQGallery DocumentationThe Gallery Wiki DocsThe Gallery Forums IP Tracking module

IP Tracking module: IP Tracking Info. ]]> ]]> ]]> ]]> IP Tracking module: IP Tracking Info. IP Tracking module: IP Tracking Info. To track your visitors' IP address, you can use the IP tracking module.module Get it at the Downloads section of ierealtor. After installation and activation of the module,module a click on the “IP TrackingTracking” link in the Modules block will display the “IP Tracking Info”, a list of IP addresses that accessed the site (). You can order the list by ascending or descending order of its column fields, by clicking on the respective up- and down-arrows.arrows Lazy man's Logfile Inspection Nothing beats regular inspection of the real web server logfiles - but if you are lazy, you want a quick info of what is going on, or you cannot do otherwise, the IP Tracking module will give you a quick solution to your logfile inspection problem. In the Page View Info (), be attentive to URL parameters that pass Javascript code or SQL queries to the database - they are a clear indication of cross-scripting () and SQL injection () attempts at your site respectively.

IP Tracking module: Page View Info. ]]> ]]> ]]> ]]> IP Tracking module: Page View Info. IP Tracking module: Page View Info. The IP addresses themeselves are links to a detailed view, the “Page View Info” (). It lists the pages that were requested by that IP address. Again, you can order the list by name or date using the arrows on the table header.header Note: administrators won't appear online since they are not entered in the nuke_session table. Code corrections necessary for <application>PHP-Nuke</application> v. 6.0 and/or old <acronym>PHP</acronym> versions! If you get the error:

You can't access this file directly...

then you are using an old PHP version that does not understand the _SERVER superglobal. Edit the index.php file of the module and change: to: You also have to edit iptracking.php. Change: to: and to: and to: If you are getting MySQL errors like the one of , complaining about non-valid MySQL result resources, then you are probably using an old PHP-Nuke version (like 6.0, for example) that uses the field “username”, instead of “uname” in the nuke_session table. In this case you have to change “uname” to “username” in the two WHERE clauses of the index.php file of the module. Change: to: and to: If your main motivation for using the IP tracking module is to be able to ban certain annoying visitors from certain IPs, check also the ProtectorProtector module () for a ready-made, full-featured solution to IP banning,banning as well as for a quick, do-it-yourself hack.hack Protector moduleThe Protector System gives you "high level" logs of session activity on your PHP-Nuke site. But not only this - it can be effectively used to ban IP addresses and users:Possibility to add a single IP or a whole range.rangeLogging of ALL IP(s) that hit your PHP-Nuke site.If a member joins the site the logger fetches the username and stores it with their IP.IP (Otherwise the IP gets the username Anonymous)If a member IP changes the new IP will be stored with their usernameusernameLogging of the real IP not just the proxy IP if that is the case.caseSearch function (with wildcards *) after the logged IP and user name. And sort order.Protection of your IP is done when you first install this system.system That means that no one can ban that IP.IPAs head admin (GOD) you can add several protected IP(s) in the Admin Panel. All other admins just see personal settings where they can change total amount of row they want to display in the banned & locate IP panels.Automaticallyupdate the date of a logged IP so that you can see when a particular IP or user was on your site.You can dns/trace/ping and more after you query the IP with the query tool that I have implemented.It is totally themes integrated system.systemSecurity check so that you can't ban yourself (the IP you currently use when your in the admin panel) or protected IP.IPDouble check so that there is no banning or logging of the same informationinformation twice.If a banned member is banned and they change their IP.IP The system will check the banned database and compare if the username(s) match.match If it does a new row with the new IP and same username is added in the ban list. So they are banned again automatically with the new IP.IPCounts on how many times a banned user is trying to reach the site.Possibility to instantly ban people from your list with logged IP.IPYou can of course un-ban IP numbers.Very simple to install, The Ban System will create all needed tables for the MySQL Database on the first run.As Forum admin can you reach the Edit User Function from the "Locate Panel". Also, a direct link to the public user information is there.In the Locate panel there are 4 different images close to the IP number.EnumerateA Green dot indicates that the IP is just logged.EnumerateA Red dot indicates that IP is banned.bannedEnumerateA Star indicates that this IP number is the IP you are currently using.EnumerateA blinking computer gif indicates if that logged user/IP is online.A small stat page where you can see some stats on the Ban Protector System.Anti hammering protection system.systemSpecial Notes to each logged IP is possible.Close the site function.function Only admins are able to be on the site when active.When a user attempts to access the admin page a note is added to their IPIP to warn you of potential hackers.hackersAn auto pruning system to prune logged IP addresses set from the maintenancemaintenance panel.panelGrant access to the Ban System for your (admin) users who are not a "super user".Auto Protect your IP if you logon using another pc with your user name and the old IP will be replaced with the new one until you logon again then your IP will be replaced again.Optimize and repair the tables in the Protector System to reclaim the unused space and to de-fragment the data file or if you get errors. WebCam module

camPortal block. ]]> ]]> ]]> ]]> camPortal block. camPortal block. If you are looking for a webcam module,module have a look at the camPortal. See it in action at The Sceptics Hour. camPortal's highlights include:Advanced Admin panelpanelStatic or Dynamic webcam image in block (optional, see )CategoriesCategoriesVote system ()Comment systemsystemHit countercounterUsers can report broken camsUsers can submit their camsLanguages included: English,English Spanish, Dutch, German.

camPortal module. ]]> ]]> ]]> ]]> camPortal module. camPortal module. You must have at least PHP-Nuke 6.5 and a newer PHP version (one that understands the _SERVER superglobal, for example) to use this module. The installation instructions are a bit outdated. In some parts, for example, they talk about “webcam”, when atually it should say “camPortal” - but with knowledge of the structure of a PHP-Nuke module (see ) you will figure it out. ]]> ]]> ]]> ]]> Inline graphic To grab the images from your webcam,webcam you can use ConquerCam. ConquerCam is a low-priced (only $10 USD), easy to use webcam manager for grabbing images from your web cam under Windows,Windows preparing them with various effects and uploading them to your web site (where you can use camPortalcamPortal to display them in PHP-Nuke). Using ConquerCam you are able to setup your computer as a security systemsystem as well, using the advanced motion detection and mail-notification systemsystem included.

ConquerCam: main window with the Options dialog opened up. ]]> ]]> ]]> ]]> ConquerCam: main window with the Options dialog opened up. ConquerCam: main window with the Options dialog opened up. ConquerCam can be customized in a variety of ways, e.g. by selecting how often you want to grab and upload images, which overlayoverlay effects you want to use (many of the well-known Adobe PhotoShop effects are available, such as Multiply or Darken) and unlimited numbers of textual captions to put on your grabbed image using a bunch of tags. Tags are replaced by dynamic data such as current date/time, WinAMP titletitle currently playing or the Swatch Internet Time. My Headlines module

MyHeadlines Box containing syndicated content. ]]> ]]> ]]> ]]> MyHeadlines Box containing syndicated content. MyHeadlines Box containing syndicated content. MyHeadlines is a personalized syndicated content module.module As a user you may subscribe to many news/content sources from the MyHeadlinesMyHeadlines database.base For each of your subscriptions this site will gather the latest headlines/stories/content from the source and present a consolidated view of all of your interests in one location. The MyHeadlines engine allows you to configure the layout of this page to suit your needs; It will allow you to place the "Boxes" containing the syndicated content () in any one of three possible places (Left, Right or Middle) on two rows (Top and Bottom) of the module's space on the front page. There are over 1000 sources in the MyHeadlines database:base from special interest groups, to regional news,news to technology sites, to company/corporation specific news,news and more. You can subscribe to the content you want. As an added bonus, MyHeadlines now sports a Stock Ticker "Box" that will allow you to watch your favourite Index,Index Stock, Bond, etc.Download it from the Downloads section of jmagar.com. See also the MyHeadlines FAQ. See it in action at jmagar and weenor. PHP-Nuke-Tools module

<application>PHP-Nuke</application> Tools block ]]> ]]> ]]> ]]> PHP-Nuke Tools block PHP-Nuke Tools block The PHP-Nuke Tools module is one of the most helpful modules.modules Whether you are developing for PHP-Nuke or want to write a module or blockblock really quickly, or even if you just want to learn how modules,modules blocks and the rest works in PHP-Nuke, you will appreciate its help.. It offers features such as:Module Creator (see ), Block Creator, Help for Module Creator, Help for Block Creator, HTML to PHP,PHP HTML to ASP, HTML to JSP,JSP HTML to Perl,Perl HTML to JavaScript,JavaScript Online HTML Editor, Meta Tag Creator, Scrollbar Creator, Popup Creator, Hex Colors

<application>PHP-Nuke</application> Tools module: Module Creator. ]]> ]]> ]]> ]]> PHP-Nuke Tools module: Module Creator. PHP-Nuke Tools module: Module Creator. and many others. It comes with an extra block containing links to all functions (). See it in action at disipal.net. Especially recommended for beginners (but not only)! You are a beginner in PHP(-Nuke), have just started your very first module or block, but you get errors and don't understand why? Give it a try with the PHP-Nuke Tools Module or Block Creator! It will help you see what you were missing and will also give you a feeling of how code looks before and after it is "nuked". ]]> ]]> ]]> ]]> Inline graphic For a much more ambitious project on automatic building of PHP-Nuke blocks and modules (towards a web-based integrated programming environment, IDE,IDE for PHP-Nuke) ckeck Raven's Block Builder. It is currently under development,development but very promising. Upload module

Upload module. ]]> ]]> ]]> ]]> Upload module. Upload module. The PHP-Nuke Upload module facilitates upload functionality for PHP-Nuke and has the following features:featuresUpload to virtual foldersDownload the files from these foldersList files in these foldersPossibly add a comment to each fileUse the same filename several times in one folderEach file is owned by one registered user. Each directory is owned by one registered user. Only the adminstrator can create new folders and assign them to a registeredregistered userThe adminstrator can change the ownership a existing file or folderThe owner of a file can change the permissions on the fileWhen uploading to a folder, the uploader (only registered users are allowed to upload files) may choose the initial permissions on the new file. The following permissions exist for owner and registered users: no permission,permission read permission, read/write permission.permission Also a flag is available, that allows direct download access for anonymousanonymous users (but nothing more) Full group membership access:access Each registered user can be a member of multiple groups, and each file can belong to one group, which allows no/read/read+write access (configurable for each file) Multiple Language supportMost links may also include images, to give the module a pretty layout.layoutSize display for each fileDownload counter for each fileQuota support based on group, user and folder quotas.quotasOptional thumbnail support for .jpg and .gif files based on the original files (so this is only a pseudo thumbnail at the moment). PHP-Nuke versions greater than 6.5 and the Upload module If you are using a version of PHP-Nuke greater than 6.5, you must do a minimal, but crucial, change in the index.php file of the Upload file. Otherwise, the SQL queries will use the wrong field (uid, instead of user_id) for the user in the nuke_users table, leading to errors. Find the line and change it to: = "6.5") {]]> This will make sure that the right field names are used for all versions greater or equal to 6.5, not only for the 6.5 version. ]]> ]]> ]]> ]]> Inline graphic Upload add-on for phpBBIf you are interested in an Upload add-on for your phpBB Forums, then you can check Photo Album Addon. This is a phpBB-based photo album/gallery management system. It is really powerful, stable, efficient, rich in features and highly customizable. The version 2 was written from the scratch for more security, performance, etc. It is not really a modification or hack, it is rather a phpBB-based system. ]]> ]]> ]]> ]]> Inline graphic Features:Fully integrated with phpBB2 backend (DB, session,session template, multi languages, etc.)Powerful and handy Admin Control PanelAuto-generated thumbnail s(requires GD)Manual-uploaded thumbnails (for those who don't have the GD librarylibraryTo find out if you have the GD library loaded, run a test script like test.php (see ), ConnectTest.php (see ) or analyze.analyzephp (see ).)Thumbnail cache (for better performance)Multi-categoriesMulti-categoriesPowerful and phpBB-like permissions systemsystemModerator Control PanelUpload QuotasPictures DescriptionRecent picsPersonal galleries (for member-oriented boards)Rate systemsystemComment systemsystemHot link prevention (can set allowed domainsdomainsSee for a do-it-yourself solution to hot link prevention.prevention)Auto-optimization for different GD versionsPic view countercounterAdmin/Moderator pic approvalapprovalProbably uploadable in PHP Safe Mode May not work with every <application>PHP-Nuke</application> version! The Photo Album is an add-on for the standalone phpBB Forums. It has been ported to PHP-Nuke with the Album module (see the Admin Panel Downloads Category of portedmods). This module was only tested with PHP-Nuke 6.5RC2 with phpbb module 2.1 and does not work on a site with the 2.0.6b version of the phpBB module! For yet another file attachment add-on to the PHP-Nuke phpBB Forums, see the “Attachment Mod” from the PHP-Nuke 6.5 / Ported Mods / Extra Downloads section of portedmods. See File Attachment Mod v2.3.6 for phpnuke6 with 2.06 for a complete list of its features.features For a discussion thread on Upload modules,modules see I cant find this Upload module. ODP module

ODP module. ]]> ]]> ]]> ]]> ODP module. ODP module. The ODP module displays the popular Open Directory inside your PHP-Nuke site (). It is based on the phpodp class. The whole functionality is encapsulated in the phpodp class in odp.php.odp.php The PHP-Nuke module practically only calls the odp.php script.If you would like to import all links of an ODP category into your Web LinksWeb Links or Downloads module,module have a look in and respectively for some interesting procedures. eCommerce moduleThere is certainly a lot going on currently in the area of eCommerce and PHP-Nuke. However, a ready-to-use PHP-Nuke port of the well-known osCommerce has yet to hit the streets. Keep an eye on the following promising links:osc2Nuke: The international project of merging osCommerce and PHP-Nuke. With links to national projects worldwide.Multishop: “We depart from the CMS PhpNuke and osCommerce to realize a virtual mall, a central portal where different shop, with all the funcionalities of a traditional eCommerce site (customer accounts,address book for different shipping,Order history,history..),converge”, the developers say.OSCommerce gets a Nuke-Module: a new SourceForge-Projects starts now!

Calloways Cart module: Add Product screen. ]]> ]]> ]]> ]]> Calloways Cart module: Add Product screen. Calloways Cart module: Add Product screen. For the moment, you could try CallowaysCart, a shopping cart recently released under the GPL and especially designed for PHP-Nuke (all versions) and Paypal's payment service ().A commercial (but with $35 USD certainly not expensive) eCommerce solution for PHP-Nuke is Emporium. The following is an incomplete list of its features,features but bear in mind that, since Emporium is under active and rapid development,development it will be outdated by the time you read this:Unlimited Products.Unlimited Categories.CategoriesUnlimited Brands to associate Products with Modularized Payment/Shipping methods.Unlimited currencies.currenciesAutomated currency conversions (using Yahoo,Yahoo XE, Oanda services).Unlimited Product Options for Products (radio,radio dropdown, multidropdown, checkbox, textfield,textfield textarea, inclusive [hidden], etc).Unlimited Product Media for Products.Tax classing (unlimited class types, associated with particular products... assign certain locations [states, countries] to tax classing with different tax structures).Instead of relying on a feature list, a better idea might be to test Emporium:Emporium you can go to the Emporium demo site ([admin:admin demo, pass: demo]), and have full access to Emporium and all of its features.features WorkBoard Module

Administration panel: WorkBoard. ]]> ]]> ]]> ]]> Administration panel: WorkBoard. Administration panel: WorkBoard. WorkBoard is a PHP-Nuke module for Project Management, distributed under the GNUGNU General Public Licence.LicenceTo install WorkBoard,WorkBoard Extract the archive and upload all files from directory 'html' to your rootroot PHP-Nuke directory.Insert sql/workboard.sql into your database,base orCopy 'wb_install.php' from directory 'installation' into your root PHP-Nuke directory, and then run script from your browser. Follow the instructions presented to you.Once installed, a click on the WorkBoard icon in the administration panelpanel () leads to the WorkBoard administration panel (). There, you can set up Projects and project positions.Tasks and task statuses and priorities.Project membersmembers

WorkBoard module: Administration panel. ]]> ]]> ]]> ]]> WorkBoard module: Administration panel. WorkBoard module: Administration panel. The WorkBoard module is still under rapid development.development Architecture and structure The structure of PHP-Nuke is organized into modules,modules all the files are managed by other files that are located in the PHP-Nuke root directory and include, according to the parameters passed to them, the intended module.moduleThese tasks are carried out from only 3 pages:index.indexphp : In order to display the main pagemodules.modulesphp : In order to include the internal modules.modulesadmin.php : In order to include the administration interface.interfaceIt's not possible to call a module by calling a direct path to it. This is so in order to make installation easier, render the graphics managementmanagement more independent (otherwise we would have to change the path of the imagesimages each time we position ourselves in an internal directory), have only a few files in the root directory and render the system more secure. Everything is being called, as we said, through URL parameters (strings) passed to the “modules.modulesphp” file which specify which files are to be included. If for example we want to call the Topics module,module the string to be passed should be:The command that is sent this way is "includes in the page created by modules.modulesphp the output of the file index.indexphp that is found in the folder modules/Topics/".The other files present in the PHP-Nuke root directory are:auth.php: Manages authentication through the cookies.cookiesmainfile.php: Contains all the necessary functions for the management of PHP-Nukeheader.php: manages the variables that are related to the header (inclusion of metatags,metatags Javascript...)footer.php: variables related to the footer.footerbackend.php: manages the output of the news that can be captured from other sitesultramode.txt: dittodittorobots.txt: contains instructions for the search engines informing them which folders not to indexindexDirectory structure The html folder of PHP-Nuke contains the following directories and files ():

<application>PHP-Nuke</application> directory structure. ]]> ]]> ]]> ]]> PHP-Nuke directory structure. PHP-Nuke directory structure. admin:admin Contains 4 subdirectories (links, language, case, modules) that manage the various administration modules.modules The folder that accommodates the operating files is modules/admin/.robots.robotstxt: Contains instructions for search engines. PHP-Nuke's default robots.robotstxt file contains the following:This means that if a search engine visits the site, it should not indexindex the folders mentioned. You can also insert other instructions in the robots.robotstxt file, for example disallow a certain search engine:engineIn this example, we forbid Excite's spider from indexing the site. However, our instructions will have no effect on a spider that does not honour the robots.robotstxt file. Some aggressive spiders are known for being notorious and not obeying to our instructions in robots.robotstxt. You could try to redirect them to an error page through a test on their IP address, User-agent string or some other criterium using mod_rewriterewrite (see ). Please note that the User-agent string can be easily faked.fakedblocks: Contains all the block files for all of our available blocks. images:images Contains all the images relating to PHP-Nuke, for example in the folder “topicstopics” we will find archived the images of the topics that will appear in the news,news in “bannersbanners” all banners in rotation etc...includesincludes: Here are all the files that are necessary to particular management situations,ations these files do not work independently but are included in other files, mainly in mainfile.php and header.php. The files are:counter.php : serves to identify the users based on the operating system used, the browser, the page of origin, date of the visit...javascript.php : includes all necessary Javascript (if you need particular JavascriptJavascript code, include it in this file, see also ).meta.php : contains the keywords to pass to the search engines and other parameters of the header.header It is an optimal system for learning how to create keywords and position the site with a good ranking in the search engines.my_header.php : manages the disclaimer message in the homepage.homepagesql_layer.php : serves to manage the database abstraction layer.layer Transforms SQL instructions to the language of the chosen database.base Remember that PHP-Nuke can manage various databases.databasesdb: Starting from version 6.5, PHP-Nuke uses a new SQL abstraction layer,layer, that of the phpBB forum (see the section “Using the SQL Abstraction Layer” in the ADDONS-MODULES file that comes with the standard PHP-Nuke package). The layer functions are the same as the ones of sql_layer.layerphp, but more extended. Now you can program your modules () using either the “old” sql_layer.layerphp (which will continue to be supported in the future for backward compatibility), or the functions found in the files of the DB folder.docs: Contains this book. Right, this is not only an official HOWTO of the Linux Documentation Project, but also the official PHP-Nuke guide!language: Contains translation files for the basic PHP-Nuke module.module The language file naming convention is lang-english.php.lang-english.php Attention! The translation of the modules must be inserted in the appropriate folders (modules/language) and not appended to these files, as it was done till now. Modules:Modules The modules of PHP-Nuke comprise all the functionality that one can add to it. In the Modules folder we insert the folders of every new module.moduleThemes:Themes Here we add the graphical interfaces known as “ThemesThemes”, every folder has the name of the corresponding theme and contains a main file called theme.themephp and all other support files.Upgrades: contains only the files that serve to upgrade the system from a previous version to a newer one (see ). Main page managementThe file “index.phpindex.php” is very simple one, it has the task to load the main PHP-Nuke page the module that was chosen as the default one to appear in the main page of our site.Here in detail is what happens when a client requests the page “index.phpindex.php” :the mainfile.php is included,a database query is made in order to see which module was set up as the default one,the origin of the visitor is checked (if he comes from a site that links us, this fact will be inserted in a table in the database).Various checks are also made and error messages are defined in case the connection to the database fails. This avoids (in part) the error messages from the PHP preprocessor.preprocessor Even if problems come up, the page will be presented in a standard designsign and the error message will be definable from the inside. Module managementFor reasons of order, the modules are managed through the files present in the subdirectories that contain them, every module has its own folder in the interior of the folder “modulesmodules”.In order to be loaded, the module files get included in the modules.php file by passing it the aproppriate parameters. The main page of each module must be called index.php, the other possibly pages possibly present in the module will have an additional variable in the inside of parameter strings by which they are called..For example in the AvantGo module (see ) in order to load the index.indexphp file, it is enough to pass the module name to the parameter string (by default, the file that will be searched for is index.php):If we instead wanted to call a page other than the default index.php (say, print.php), the string we will have to pass is :that is the file variable with a value (print) that corresponds to the name of the file we want to load without the .php extension.Inside the folder modules/nameofmodule there is also a subfolder called “language”. In this fashion we manage in a simple and immediate way the multilanguagemultilanguage functionality inside the modules.modulesThe modules.modulesphp file works this way:Includes mainfile.phpmainfile.phpVerifies whether the module is active or notVerifies whether the string passes a file name different from index.phpindex.phpVerifies the permissions of the module (whether everybody can see it, or only registered users, or only the administrator). Administration management Admin:Admin contains 4 subfolders (links, language, case, modules) that manage the various administration modules.modules The folder that contains the operating files is admin/modules,modules here we have the files that execute the different admin operations.ationsThe folder admin/linksadmin/links instead says which admin module has to be called and puts a link in the admin area for that module.moduleExample (administration module for the FAQ):This module:moduleVerifies that administration rights are present (this module may be managed by either the superadmin or an administrator that has been qualified to do so on the FAQ level),passes a case (op=FaqAdmin) that says to the admin.php file (that includesincludes all the admin modules) which module to load,load associates a value in order to translate the term “faqfaq” and associates an icon for the visual administration (faq.gif).The folder admin/caseadmin/case instead serves to define which module to use in certain cases. This is important when, using the same admin file, one needs to carry out different operations according to the case passed:In fact it says which module to load on verification of a case.case For example, in the module faq the cases are many, let's consider only the last 2:Both cases load the file adminfaq.php but they make it carry out different operations.ations The first one loads the file in the default scheme,scheme the second one instead gives the O.K. for the insertion of a new category.category This happens through a string likein the first case and in the second. Session managementI am indepted to Paul S. Owen,Owen Development Team Leader of phpBB, the standard forum for PHP-Nuke starting from the later 6.x versions, for giving permission to include the following explanation,explanation which can be found in http://www.phpbb.com/phpBB/viewtopic.php?t=69493, as well as in http://www.phpbb.com/kb/article.php?article_id=54:How sessions work in the forumsphpBB uses sessions to "track" users as they move between pages, forums, topics,topics etc. A session is made up of a unique 32 character session_id which identifies the current users. This value is stored in the sessions table and either a temporary (i.e. it's deleted when the browser window is closed) cookie on the users machine or if that doesn't seem to be working it's appended to all URLs.The problem with using just a session_id is that it becomes very easy to hijack (takeover) a session.session All a user need do is obtain the session_id and add it to the url as they browse the board.board If the id they grab happens to be a logged in admin or moderator ... well you get the picture.What we do to help complicate the situation is also tie the session to the users IP.IP Using this method someone would need to spoof an IP and obtain the session_idsession_id in order to hijack a session,session not incredibly difficult but certainly harder ... and with this sort of software it's really a case of making everything harder to do, thus disuading all but the most ardent "hackers"hackers from bothering to attempt anything.How do we obtain this IP?IP We check the availability of two variables, REMOTE_ADDR and HTTP_X_FORWARDED_FOR. Firstly we check for HTTP_X_ ..., this is typically set by "nice" proxies,proxies caches, etc. and contains "an" IP which may be the users "real" IP or some other IP.IP If that does not exist or it contains a private or restricted IP rangerange (several blocks of IPs are reserved by the international bodies responsible for IP allocation) we instead use the value contained in REMOTE_ADDR.REMOTE_ADDR This variable typically contains the users real IP.IPHowever, problems arise with how some ISPs operate their systems. Instead of forwarding the users real IP or indeed a different but static IP they simply make available only the IP of the proxy being browsed. The larger ISPs do not use a single proxy or cache,cache the load upon it and data passing through it would be far too great. Instead they use several systems in a "proxy farm" (I tend to refer to it as something containing most of those letters ... ). A user browsing the web may be switched between these machines from one page to another (to help distribute load), with the IP changing as they go.Obviously a problem then exists in that phpBB's ability to tie a users sessionsession to a unique id and an IP fails ... because the IP is constantly changing. There are some "nice" ISPs out there that run these farms within a single "class" or block of IPs,IPs e.g. 1.2.3.4,1.2.3.4 1.2.3.5, 1.2.3.6, etc.This is why in a previous release of phpBB we introduced a slightly reduced IP checking system which now checks only the first three "quads" of an IP,IP i.e. 1.2.3.4 is checked only for 1.2.3 the 4 is discarded. Remember, that an IPv4 address is 32bits wide, this is generally presentedpresented in the form of four 8 bit numbers. By checking just the first three numbers (24bits) we neglect 8 bits or 255 (253 in practice) possible IPs ... that's 253 seperate potential proxies ... IOW enough machines for practically any ISP on the planet. However we can go further and reduce that checking to just the first "two quads", that ignores 255 * 253 IPs!The problem is some ISPs don't arrange their IP allocation particularly well, either for historical or other reasons ... AOL is one significant culprit.culprit So what happens is that users can jump between completely different Class A (this is a full 32bit block of IPs) networks, e.g. 100.100.100.100 to 200.100.40.40,200.100.40.40 etc. This renders IP validation completely useless for such situationsationsSo you ask, "Okay, but why did 2.0.3 not cause all these Invalid_session errors?!". The answer is fairly simple. When you first visit phpBB (assuming you have autologin enabled) it looks to see if you have a session_id (either in a cookie or the URL). On a new visit you won't have such a session_id and so phpBB creates a new one. If you have autologin set it checks the relevant data and if that matches you are logged in with the appropriate user_id.user_id You can then immediately browse the board,board post messages, do admin tasks (if applicable), etc.Now let's take a situation where a naughty person creates a bogus form on their site. You are (for some reason) browsing this form. However, unknown to you this form contains all the necessary data to delete a pile of topics in a given forum (you having moderator rights on a certain board). When you submit that form it will be transmitted to the appropriate website.website No session exists so phpBB,phpBB as noted above creates a new one and immediately processes the form data ... all the relevant topics are deleted from the database and you only find out when the boards "The selected topics have been deleted" message appears ...To help negate the effectiveness of this we backported some code from phpBBphpBB 2.2 and introduced additional code. The admin control panel now appends your session_id to every url.url When you browse within that panel it checks the session_id in the url with that stored in the sessions table. If they match, great, if they don't it redirects you back to the ACP index.index This will help prevent users accidently, without their knowledge suffering issues as noted above.Similarly the Moderator control panel has the session_id appended to urls and carries out a check. The difference here is that it throws up an Invalid session if the ids do not match, note that redirection like the admin panel wouldn't alteralter the result here ... if you tried submitting data via the MCP with an invalid session you'd just be returned to MCP front page ... losing any data entered previously. Other issues with voting and posting were also addressed thanks to a concerned user notifying us. Thus similar checks were put in place there.The problem is that for users whose session is forever being renewed due to their IP changing this extra level of checking can cause issues. For many ISPs the noted changing of 6 to 4 in the IP validation check will be sufficient ... however AOL crops up (as per usual in nearly all similar situations with all software ...) as the sore thumb.thumb"What can you do about it?" you may ask, very little is the response.response We could remove the extra validation but that leaves a gap that frankly I'm not prepared to leave ... if hadn't addressed this I would make a handsome bet that at some near future point we would've had users shouting and screaming about how damage was done to their boards and why didn't we (phpBB) fix it if we knew about itWhat else can we do? As I said, very little that won't impact users completely unaffected by this issue (of which I'm betting there are a great many) ... in phpBB 2.2 we are introducing a feature to set the level of IP validationvalidation by the ACP,ACP including disabling it completely. However disabling IP validation will, as noted leave your users open to simplified hijacking.hijacking For many people this may not be a problem and thus could be a solution. To do this in phpBB 2.0 you need to either remove the validation code from sessions.php or change the 6 to a 0 (the relevant lines are as noted in this topic). Be aware of what you are doing though and keep quiet about it ... if people don't know IP validation isn't operational they may believe it still is. If you have security issues you can trace to users sessions being hijackedhijacked we don't want to know about itWe could introduce a change to sessions whereby what happens when a new session is created is "weakened". What do I mean by weakened? Well, at present we generate a new sessionsession whenever we cannot validate an existing one. Instead what we could do is compare the users current session_id (if they have one) with that in the database.base If a match is found and the time differential is some "small" number we instead continue that session.session The problem here is that it's just as open to hijacking as removing IPIP validation.validation Why? Because that check will ignore the users IP and care only about the session_id ... and thus isn't something I'm keen on without direct admin control.controlWe could, as per a new Mod listed elsewhere on the board, ignore IP validationvalidation whenever the users IP is within a given list. While this isn't as bad as removing validation completely it's not terribly far off. Why? Because instead of having to go to some trouble to obtain a users current IP you can instead (given you know a user connects via a given ISP or proxy) just look it up ... you still need to spoof it but a step has been removed ... and as noted previously all we can do is make these peoples lives harder. There are additional issues with the extra processing required (which may or may not be significant depending on the number of IPs,IPs users browsing, etc.) and of keeping the list up to date.dateWe could append a random set of alphanumerics to every single page, changing the value of it with every page view and storing the new data in the sessions table. This would add protection because a hijacker would need not only the session_idsession_id but also the current unique identifier.identifier Of all the ideas this is probably my favourite and may make it into a future release (unless I've missed something obvious which renders it useless or bad for performance!). How to eliminate session checks"Okay, fine but what can we do about it now?!" I hear you say. Well, you can remove or reduce validation as noted above (being aware of what you are doing), you could add the Mod noted above (you'll find it presently in another Invalid session topic ... no doubt it will be moved to one of the Mod forums in time) or finally you could remove the piece of code (from all affected pages) that looks like or similar to this:This removes the added security of validation so if you do this we aren't interested in any security related problems that may arise. I highly recommend that you do not remove the added security from the adminadmin control panel.panel Let's clarify a little the modifications that are needed:You can either edit line 294 in the includes/session.sessionphp:and change the 6 to a 4, or, as a last resort (not endorsed by the phpBBphpBB staff and quite unsafe for the above reasons), you can delete all occurences of the codein all files. There are 9 occurences in 6 files:But most of the time, just changing the cookie,cookie as described in , will solve the "invalid session" problem. Editing <acronym>PHP</acronym> (-Nuke) filesPHP-Nuke files are PHP files. PHP files contain plain ASCII text and as such they can be edited with any decent text editor.editor By “decentdecent” we do not only mean an editor that offers a minimum of comfort in editing texts - most of them do. By “decentdecent” we mean an editor that will not introduce extra (most of the time invisible) characters in your file, that will destroy the rest of your day with PHPPHP (amd PHP-Nuke).We wouldn't stress this point if we hadn't seen enough cases of people getting errors from the PHP interpreter complaining that their config.configphp file, for example, contained an error - were no error was visible. For this reason, a warning is in place: O quantum est in rebus inane!<footnote><para>How much emptiness there is in things!</para></footnote> Don't even think about editing a PHP (-Nuke) file with Notepad or Wordpad! You run the risk to introduce invisible characters in your text files, causing spurious errors that will be very hard to find and correct! What may seem to be just blanks or empty space, is going to drive you insane! So, if you are not supposed to use Notepad or Wordpad, what are the alternativesalternatives? What decent text editors are out there for editing our PHP and PHP-Nuke files? In the following sections, we will present a few of them. See also Decent Text Editor.viFIXMEFIXME EmacsFIXMEFIXME BluefishFIXMEFIXME UltraEditFIXMEFIXME WinSyntaxFIXMEFIXME HTMLKitFIXMEFIXME Crimson EditorFIXMEFIXME PHPEdFIXMEFIXME Modifying the <application>PHP-Nuke</application> databaseMore than 255 characters of user extra informationBy clicking on the icon with the title “Your Info” in the user account menu (see ), you arrive at a HTML form where you can enter various pieces of informationinformation about yourself, in addition to your personal preferences.preferences One of the fields, the “Extra Info” field, gives you the opportunity to tell something about yourself that other visitors can read when they click on your profile.profile However, you will not be able to enter more than 255 characters of extra information.information That's a bit too few, even for moderately turbulent biographies. To change that, you must find out where that information is stored in the database.base

Extra Info field of User Personal Information (Your Info) ]]> ]]> ]]> ]]> Extra Info field of User Personal Information (Your Info) Extra Info field of User Personal Information (Your Info) That extra information is stored in the field "bio" of the nuke_users table (assuming the table prefix,prefix $prefix,prefix is "nuke" for you, see ). Thus, what you have to do is log in your database and change the length of the bio field. Currently, it is defined as "tinytext"tinytext which gives the limitation of 255 characters (see MySQL String Types).Once logged in the MySQL database,base do on the MySQL promptSee edit module your_acount.:This will give you the next possible (see MySQL Column Type Storage Requirements) maximum length of 2^16-2. That's a little less than 65KB of text. That should be enough text for your visitors to write a small story of their life. ]]> ]]> ]]> ]]> Inline graphic Modifying <application>PHP-Nuke</application> textsAll texts that appear in PHP-Nuke are strings defined in so-called language files - and are thus fully customizable to your needs:General <application>PHP-Nuke</application> textsGeneral texts are stored in the files under the language folder. The naming of those language files follows the convention “lang-languagename.phplang-languagename.php”. Thus, english texts are held in language/lang-english.php,lang-english.php chinese ones in language/lang-chinese.chinesephp etc. All you have to do to change a text, is edit the aproppriate file for your language with a decent text editor (see also ). For example, to change the text that is displayed besides the Search button (“Search” for the english language), open language/lang-english.php with a decent text editor and find the line that contains the text:This is a PHP instruction that tells the PHP interpreter to define the constant _SEARCH as the text string “Search”. Thus, whatever you put in the text string will be the content of the _SEARCH_SEARCH constant. The developers (at least in an ideal world) will only use constants (and database-driven,database-driven dynamic information) for their texts, so that you only need to do your changes at one place to be valid everywhere. To change the search text to “Search my homepagehomepage”, you thus need to change the above line toIt is in this manner that internationalization of PHP-Nuke takes place, by the way. People who want to translate PHP-Nuke to their language, get a fresh copycopy of language/lang-english.php and start translating the text strings in the “define” directives,directives then send the lang-newlanguage.php file to phpnuke.org for inclusion in the next release. HTML code in text constants You are not confined to text, when you change the texts in PHP-Nuke's language files. This may sound paradoxical, but if you think that the language files are just usual PHP files that define some constants, then you will see that nothing really prevents you from “abusing” their purpose and mixing them with...HTML code, for example. ]]> ]]> ]]> ]]> eek! Thus it is perfectly legal to change: to: In this case, we entered a non-breaking space before the translation of the _WRITES constant. This is because we noticed that a space was missing before the "writes" in the “user writes” string that is printed next to an article in the news. Instead of correcting the code in the News module, we opted for the quick'n dirty way. It's not recommended, because it mangles user-supplied data with code - but it is nonetheless possible, see Posting Articles or Story. PHP-Nuke module textsPHP-Nuke module texts are also customizable,customizable but are stored in separate folders: each module comes with a language folder containing a lang-xxx.phplang-xxx.php file with the translation strings for the text constants that are relevant to only that module.module For example, the Forums module contains a language folder, stored as modules/Forums/language, the Your_Account module (which handles user logins, registration,registration authentication and management of the users' info,info mail, messages and personal settings) comes with a language folder stored as modules/Your_Account/language etc.To change a module specific text, edit the appropriate language file lang-xxx.phplang-xxx.php, exactly as described in for general PHP-Nuke texts. For example, to customize the email text sent to a new user after registration,registration open the file /modules/Your_Account/language/lang-english.php in a decent text editor, find the linesand change them to something more sophisticated,sophisticated likeLife has given nothing to mortals without hard work! PHP-Nuke module and block titlesYou can change a module's or block's title from the module or block administration panel respectively: for a module or active block,block click on the Edit link on the line for that module/block,block change and save. The text you enter in the “TitleTitle” field will be the new title to be displayed. Customising <application>PHP-Nuke</application> themes In this chapter we will talk about themes in PHP-Nuke. We will discuss the following topics:topicsStructure of a PHP-Nuke theme (),Modifying the PHP-Nuke theme HTML template (),Modifying the PHP-Nuke theme header (),Modifying the PHP-Nuke theme body (),Modifying the PHP-Nuke theme index (),Modifying the PHP-Nuke theme footer (),Modifying the PHP-Nuke theme icons (),PHP-Nuke theme rules (),How to change a buggy PHP-Nuke theme (),How to prevent users from changing the theme in PHP-Nuke (),How to change the PHP-Nuke theme depending on module (),How to change font size in PHP-Nuke ().Structure of a <application>PHP-Nuke</application> themeMaking your own personal graphical theme for your site is very important so that you don't have another PHP-Nuke clone, if your site looks the same as other sites it dosn't make you, the Webmaster look very professional. Personalising the portal starts from the graphical side of things. Knowing how to put your hands on a PHP-Nuke theme means being able to play with all of the graphical elements that we can use. The example theme we will use in this chapter is the NukeNews theme,theme made by Francisco Burzi for PHP-Nuke. It's a theme composed of a lot of HTML files, all included in theme.themephp. This is a very good solution that permits you to manage the graphical part of the theme through an editor like DreamWeaver using the least amount of PHP code.For a graphical anatomy of a PHP-Nuke theme,theme please have a look at the theme.html file. As you can see, each PHP-Nuke page follows the classic 3-column table layout:layout in the left and right columns you can position small blocks, while in the center, wider column, you should position the larger blocks. It is also the center column where the currently viewed module is shown.The NukeNews theme,theme for example, is structured in the following way ():theme.php: controls the main functions of the variables for the backgroundbackground colors.tables.php: controls the functions opentable() and closetable().header.html: controls the header for your site.footer.html: controls the footer for your site.blocks.html: controls the blocks.center_right.html: controls the layout of the page.center_left.html: controls the layout of the page.story_home.html: controls the layout of the page.story_page.html: controls the layout of the page.

Structure of the NukeNews theme. ]]> ]]> ]]> ]]> Structure of the NukeNews theme. Structure of the NukeNews theme. These files are included in the functions specified in theme.php We then have a style sheet (), called style.css (style/style.css), included in the header.html file in our theme folder. For convention, the style sheet must always be called style.css and must always be contained in one folder called "style" inside of our theme folder. The images generally are grouped in a folder called "images"images that is always found in our themes folder. The folder structure of the NukeNews theme will be : themes/NukeNewsthemes/NukeNewsthemes/NukeNews/style/themes/NukeNews/images/Always remember that case is important, you must respect the difference between UPPERCASE and lowercase for compatibility with any Unix systems. The theme.php file is the heart of all PHP-Nuke's graphical management.management The theme.php is the file that creates the managing functions of all of PHP-Nuke's components (header,header footer, central parts, block...).The technique of putting HTML code in separate files, that are then included in theme.themephp, is not used in all themes (see ). Some programmers include all the HTML in the theme.php file. However, including it separately solves many problems such as HTML formatting, that would otherwise be included in the PHP code. It also gives us the possibility of editing all with a visual editor (WYSIWYG).

Structure of other themes, without HTML templates. ]]> ]]> ]]> ]]> Structure of other themes, without HTML templates. Structure of other themes, without HTML templates. The themeheader() function manages the site header.header It is composed of various tables that form the heading, and sometimes also defines some elements of the body tag that are not included in the style sheet and the variables that are placed inside the included html files. Example: The variable $theuser is defined inside of the themeheader() functionfunction and is then shown in the header.headerhtml file in a table: Code in theme.themephp (that defines the $theuser variable)Create an account"; ]]>Code in header.html (that displays the $theuser variable) ]]> $theuser ]]>It is also in the themeheader() function that the position of the advertisement banners is hardcoded.hardcoded If you are not satisfied with the placement of your banners,banners look for the linesThese lines are responsible for the output of the banner.banner By changing their place in the PHP code, you can achieve a different bannerbanner placement.The themefooter(); function is responsible for the footer of our site.It has some interesting elements we have to analyse:analyseFirst of all, it identifies if the displayed page has got the $index variable set equal to 1, in this case we will also insert the right blocks on our page, but if instead $index==0 then the right blocks will not appear on our page. It then defines the footer messages (which are captured from config.php) and inserts all them in a variable that is recalled from the footer.html file. The function themeindex() manages the news in Home Page and formats them adding elements according to various cases using the function "if". It also includes the story_home.htm file.The function themearticle() instead manages the internal news page (that we can see by pushing on "Read more..."; remember that the layout part in this case is achieved by including the story_page.htm file, but the blocks that must be included (i.e. the article's survey,survey correlated links etc.) are defined by the news module. The function themesidebox() instead manages the layout of the box that we create or that we find already made (see ), it too includes a file called blocks.htm that defines the style and the layout.layout We have ignored an element of the file theme.php. These are the variables that format the text, some of them are inserted in css (the style sheet) but others are instead defined at the beginning of the theme.php file. Let's see the variables from the NukeNews theme:theme As you see the expression values of these variables are in decimal format.format Define your site colours - $bgcolor2 is generally used for table edges as you can see in the function opentable(), $bgcolor1 is used for table background.background The others two background variables use the same criteria.criteria $textcolor1 and $textcolor2 are used to format the text colour.colour Now we have to examine what is included in the tables.php file. This file creates 4 functions (opentable(); closetable(); opentable2(); closetable2();) that include HTML tags that open and close tables in a predefined way.It is very easy to use when creating modules (see ) , you don't have to rewrite the HTML every time you want to create a table but it's enough with the following syntax:syntaxIn this way you've created a table in a fast and effective way. But how is this function structured? We will examine first opentable(); then closetable(); Please note These are php functions so you have to respect the HTML syntax inside php adding \ before every " (ie align="left" must be written as align=\"left\") < tr >< td > \n "; ]]>< tr >< td > \n "; ]]>The syntax is very simple, isn't it? The function is openedNecessary variables are called ($bgcolor1, $bgcolor2) We open a table 100% wide and we define the background colours for itOpen Line, Open ColumnWe insert a new table 100% wide (for the edges) The width and height characteristics are defined.line columnWe stop on the column because it's here we will insert the table content (In fact opentable is where we start from to close this table!) \n"; ]]>In fact...The function is openedYou close the Column; You close the LineYou close the Inner TableYou close the Column; You close the LineYou close the Outer TableIts easy to construct HTML functions with PHP,PHP isnt it? Modifying the <application>PHP-Nuke</application> theme HTML templateIn this section we will see how to modify the HTML template that is used by the PHP-Nuke themes to display our page. Topics covered are:Example creation of HTML file to include in the theme ().Example creation of HTML file to include in the themeWe will not analyse the HTML syntax of all the files, we think it's better that you understand the principles that are used and that you learn a few tricks that allow you to use a visual editor such as DreamWeaver.DreamWeaver Example: The block is created in this way: ]]>< td align="left" > ]]> $$title ]]> ]]> ]]> ]]> ]]> ]]>As you see, we create a table of fixed width (in our case 150) and we assignsign it some colours (for the background etc...). We also assign two variables ($title and $content) that will, once included in theme.php, load the title and the content of the block.block It would have been useful, for a code clarity reasons, to define backgroundbackground values in the CSS tables instead.To have all the necessary cases to get the conclusions of this chapter and to write a pair of rules,rules we have to analyse a very simple module that includes a case we have still not mentioned, the images management:management

]]> ]]>The image is a spacer that adds a space of 15 pixels,pixels but where do we load the image from? Which path do we have to assign it? Remember that the theme.php file is included in the PHP-Nuke root directory , so the image path must start from root to the indicated theme.theme The path to the image "pixel.gif" is "themes/NukeNews/images/pixel.gif" Attention! When you add images in an automatic way by using a visual editor, the path will be only images/image.gif, and you will have to correct it by hand, adding the correct path. Another trick is to assign, in theme.php, a variable to the name of the theme,theme to make it independent from possible changes of the folder name. So for the variable $nameoftheme = " NukeNews ", the syntax of the image path will be: ]]> Modifying the <application>PHP-Nuke</application> theme headerThe theme header is constructed in the function themeheader() of the themetheme in question. You will find this function in the file theme.themephp, in the folder themes/YourTheme (where YourTheme is the name of your theme,theme e.g. themes/NukeNews). How to create a top navigation bar as in NukeNews theme Sometimes, like in the case of the NukeNews theme,theme the themeheader() function will include the contents of a separate file, written in pure HTML:HTMLThe header.headerhtml file, which is "evaluated" here, contains HTML code that creates the "top navigation bar", the one with the "Home", "Topics", "Downloadsads", "Your Account"Your Account etc. links (): ]]> ]]>$theuser ]]> ]]>Home ]]>Topics ]]>Downloads ]]>Your Account ]]>Submit News ]]>Top 10 ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]>Thus, if you want to delete or change this top navigation bar, you will have to delete or change the above code to reflect your needs (see How to change the top menu (top navigation bar) of PHP-Nuke and how to remove the search box from the top menu of PHP-Nuke). A similar technique is used in the Odyssey theme,theme where one uses the contents of themes/Odyssey/left_center.html, additionally to themes/Odyssey/header.headerhtml. How to insert a Search Box as in SlashOcean themeThe SlashOcean theme contains a Welcome message and a Search box in its header,header as a close inspection of the code in the themeheader() function of themes/SlashOcean/theme.themephp reveals: ]]> ]]> ]]> $\"Welcome$ ]]> ]]> ]]> ]]> ]]> ]]>"; ]]>
"; ]]>You can use this code if you wish to have a search box besides your logo,logo as in SlashOcean.SlashOcean You will find similar constructs in the other themes,themes e.g. Kaput or Slash.Slash How to change the <application>PHP-Nuke</application> header depending on some global featureIn some cases you may need to change the PHP-Nuke header according to some globally available information about the current user. For example, you may want to display a menu that is differently structured if the user's language is, say, french,french leaving the standard menu structure untouched otherwise.The key to such changes is always to declare the globally available feature as being “globalglobal” in the themeheader() function in theme.themephp. Then you can use its value for a simple check that will echo the right HTML incantations if the check succeeds. Let's take for example the above case,case where the globally available feature is nothing else but the current language setting:" ]]>\n"; ]]>" ]]>\n"; ]]>This code, put in the themeheader() function of theme.themephp in the aproppriate place (depending on where exacly you want it to appear), will display a special menu link if the user's language is french.french Instead of the current language, any user setting that is globally available can be used. The only work you have to do is to find out which variable stores the globalglobal setting you need ($currentlang in the above example).User information is stored in the userinfo array. This array is filled with a call to the getusrinfo() function.function Thus a simple way to arrive at some information that is special to the currently logged-in user, is to write somethink likeYou have then some user-specific settings at your disposal:disposaland can use them in the same manner as $currentlang above to build a highly customized header.header How to change the logo in the <application>PHP-Nuke</application> headerOne of the first things you will want to change once your PHP-Nuke is up and running, is the site's logo.logo For this, you only have to replace the logo.logogif file that came with the theme you are using. Search for themes/YourTheme/logo.gif.logo.gif Whatever graphic you put in logo.gif,logo.gif it will show as the site's logo in the PHP-Nuke header.header If you want to change the way the logo is displayed, perhaps by setting a width and height attribute, or specifying a border,border you will have to change the HTML code that displays it in the theme.theme To do this in a dynamic way, see . Here are the relevant code lines for each one of the standard PHP-Nuke themes:themes ]]>" ]]>" ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]>" ]]> ]]>\n" ]]> ]]>\n" ]]> ]]>\n" ]]> ]]>\n"; ]]> ]]> ]]>\n" ]]>This is also the place to put your change, if you want a second graphic besides your logo,logo or some other logo customization. How to change the logo's dimensions dynamicallyIf you have designed a logo that can be displayed equally well at many resolutions and you wish to be able to change its display dimensions dynamically, according to the display resolution of your visitor's monitor,monitor then you have to use Javascript.Javascript This is because PHP is a server-based technology and the web server has no means of knowing the monitor resolution of a client requesting a page. It would have to query that client for the resolution it uses, get an answer, then create the page with the right logo dimensions. But HTTP is a stateless protocol,protocol meaning that, when the server gets an answer, it has no means to relate it to some previous request - not without cookies,cookies URL parameters, sessions and all that extra stuff. This is where Javascript comes into play, obviating the need for a query-and-answer procedure.procedureSubstitute the image logo tag <img src=themes/YourTheme/images/logo.logogif alt=""._WELCOMETO." $sitename" border="0">of your theme (see ) with the following:\n"); ]]>')"); ]]>799)&&(swidth<1024)){\n"); ]]>')"); ]]>=1024){\n"); ]]>')"); ]]>\n"); ]]>Change the location of your logo in the $mod_log variable. The code will echo this Javascript in place of the image tag: ]]>')"); ]]>799)&&(swidth<1024)){ ]]>')"); ]]>=1024){ ]]>')"); ]]> ]]>which will be executed on the client's browser (if the client has JavascriptJavascript enabled, of course). It will query its resolution (screen width) and write the HTML image tag, with the correct dimensions for the logo image, into the page's HTML code. It may not work though, if the client's security settings do not allow querying the screen's width. See Different themes for different resolutions and banner next to logo for a discussion of the details. How to change placement of the banner in the <application>PHP-Nuke</application> headerSometimes the banner will appear at a position that you would feel is unfavourable for your theme and overall appearence of your site (of course, only if you enabled the banner functionality in the administration panel,panel see ). The code that controls whether the banner will appear or not, is a few lines long:and is found in the themeheader() function of the theme.themephp file. You don't need to bother about the included file, banners.bannersphp, that actually does all the job of selecting and displaying the appropriate banner,banner keeping banner statistics up-to-date and all that stuff. All you need is find out where to place those 3 lines in order to achieve the desired banner placement. As this is a highly theme dependent topic, there are no general recipes.recipes Just move the 3-liner around in themeheader() to get a feeling of the various elements and their positions, then experiment a little to find the right one for you. You might, for example, choose to include it in a table layout and echo it directly after the HTML <body> line:\n\n" ]]>\n" ]]>
]]>
\n" ]]>"; ]]>"; ]]>"; ]]>See Banner placement and banner next to logo for a discussion of banner placement in PHP-Nuke. How to display a watermark background imageIt may sound inconsistent (actually, it is inconsistent!), but in order to display a static background image (i.e. one that does not scroll down when you scroll), like a watermark, in PHP-Nuke, you must change the theheader() function in the theme.php file of your theme. ]]> ]]> ]]> ]]> eek! The code you will need for this nice effect should be placed in the body part of the page's HTML code (the part delimited by the <body> and </body> HTML tags). The reason we need this in the body part, is that in the header it will produce an error (at least in Mozilla):This is probably because the document body does not exist at the time the header is loading. Our code is a small Javascript, so you might think it belongs to the javascript.javascriptphp file under the includes folder (see ). Unfortunately, whatever is in that javascript.javascriptphp file, will be included in the HTML header of the page, i.e. the part of the HTML code delimited by the <head> and </head> tags (see ), so this will not serve our purpose. What we actually need is a file for code that belongs to the HTML body and comes preferably immediately after the <body> tag - but such a file does not exist in PHP-Nuke yet. Thus, the next best place to insert our Javascript is in the theme.themephp file of our theme.theme This is because the <body> tag is echoed precisely in this file, as demonstratesOf course, this also means that our change has to be applied for every theme and after every upgrade anew. ]]> ]]> ]]> ]]> Inline graphic .<body> tags in theme.<indexterm><primary>theme</primary></indexterm>php of various themes theme.php file PHP code that echoes the <body> tag for the theme themes/3D-Fantasy/theme.php echo "<body bgcolor=\"#ffffff\" text=\"#000000\" link=\"#363636\" vlink=\"#363636\" alink=\"#d5ae83\"> \n\n\n"; themes/Anagram/theme.php echo "<body bgcolor=\"#ffffff\" text=\"#000000\">\n"; themes/DeepBlue/theme.php echo "<body bgcolor=\"#0E3259\" text=\"#000000\" link=\"0000ff\">" themes/ExtraLite/theme.php echo "<body text=\"000000\" link=\"0000ff\" vlink=\"0000ff\">" themes/Kaput/theme.php echo "<body bgcolor=\"#FFFFFF\" text=\"#000000\" link=\"#363636\" vlink=\"#363636\" alink=\"#d5ae83\">\n" themes/Karate/theme.php echo "<body bgcolor=\"#ffffff\" text=\"#000000\" link=\"#363636\" vlink=\"#363636\" alink=\"#d5ae83\">\n" themes/Milo/theme.php echo "<body bgcolor=\"#ffffff\" text=\"#000000\" link=\"#363636\" vlink=\"#363636\" alink=\"#d5ae83\">\n" themes/NukeNews/theme.php echo "<body bgcolor=\"#505050\" text=\"#000000\" link=\"#363636\" vlink=\"#363636\" alink=\"#d5ae83\">"; themes/Odyssey/theme.php echo "<body bgcolor=\"#004080\" text=\"#000000\" link=\"#004080\" vlink=\"#004080\" alink=\"#004080\">"; themes/Sand_Journey/theme.php echo "<body bgcolor=\"$bgcolor1\">"; themes/Slash/theme.php echo "<body bgcolor=DDDDDD text=222222 link=660000 vlink=222222> themes/SlashOcean/theme.php echo "<body bgcolor=FFFFFF text=000000 link=101070 vlink=101070> themes/Sunset/theme.php echo "<body bgcolor=\"#FFC53A\" text=\"#000000\" link=\"#035D8A\" vlink=\"#035D8A\">"; themes/Traditional/theme.php echo "<body bgcolor=\"#FFFFFF\" text=\"#000000\" link=\"#000000\" vlink=\"#000000\">"

Find the line that echoes the <body> tag in your theme.themephp (look for the themeheader() function or consult ) and insert the following lines after it (if the line does not contain a semicolon at its end, you have of course to append these lines after the next most close line that contains it, otherwise you will mess up the code and get errors):\n"; ]]>\n"; ]]> \n"; ]]>Adapt the URL in the script (http://www.yoursite.com/images/watermark.watermarkgif) to reflect the full URL to your watermark image. That's all, if your theme does not define any background colours for tables! In practice, however, your theme will define at least two table background colours,colours those in the OpenTable() and OpenTable2() functions, as shown in this example, taken from the ExtraLiteExtraLite theme:theme\n"; ]]>\n"; ]]>\n"; ]]>\n"; ]]>You must delete those bgcolor attributes completely for this method to work! In fact, this will not be enough: you will have to delete every other table bgcolor attribute that appears in your theme.themephpThat is at least the way I managed to get it to work with the ExtraLight theme. Since everyt heme is different, you will have to experiment here.. Contrary to what is implied in Static Background Image, where this method is described in detail, deleting only the bgcolor attributesattributes for the above two OpenTable functions will not be enough. Alternative solution An alternative solution would be to add the background and bgproperties attributes directly in the <body> tags of the lines in , as in this example for the ExtraLite theme: "]]> bgproperties will also create a "watermark" on the page, a background image which does not scroll with the rest of the page (see bgproperties attribute. The only value it can attain is “fixed” and it must be used in conjunction with the background attribute. It is an MSIE extension, so use it, but don't rely on it. You will again have to delete all background colour attributes of the tables in theme.php. Contrary to the first method, however, there is no way to specify a no-repeat property, so that if your image does not fill the whole background space available (which depends on the client's monitor resolution), it will be repeated horizontally as well as vertically. How to display a Flash object in the <application>PHP-Nuke</application> headerTo show Flash in the PHP-Nuke header,header you simply have to echo the appropriate HTML code. Since the HTML code for a Flash object is something like ]]> ]]> ]]> ]]> ]]>the PHP-Nuke header code should contain something like " ]]> " ]]> " ]]>" ]]>"; ]]>You can put the above code in the themes/YourTheme/theme.themephp file, in the themeheader() function,function after the call to the banners code:The Flash object will be displayed after the banner,banner if you have one. See on how to show Flash in a PHP-Nuke block.block How to hide the left blocksFor some esoteric reason, you may want to hide the column with the left blocks, although it contains some crucial blocks, like the modules blockblock (), for example. To accomplish this, you have to edit the themeheader() function in the theme.themephp file of your theme (in the themes/YourTheme folder) and replace the line:withHere, we check if the module is the Forums module and suppress the call to blocks(left) if it is. This will hide the left column blocks in the Forums. It is easy to include more modules,modules as in the following example (see Hide left blocks when viewing Forum or ANY module, Como eliminar los bloques de la izquierda, Left Blocks on Index Page only):Don't forget to add $name to the list of global variables in themeheader():Of course, if you don't find the call to blocks(left), your theme already suppresses the left column of blocks. ]]> ]]> ]]> ]]> Inline graphic How to hide the right blocks Most of the time, if you want to hide any blocks, they will be the blocks in the right column, not the blocks in the left. See on how to hide the right blocks. From a theme design point of view, the above solution does not look satisfactory: you have to hardcode the names of the modules that should not display the left blocks into the code of the theme.theme Since you don't know in advance which ones these are, you create a dependencydependency relation to all existing and future modules.modulesA cleaner, alternative way is to declare the global $hideleft variable in themeheader() and check its value instead:Now, for every module that you want to hide the left blocks, insert the linesat the beginning of its code. As you see, with this method, the selection of the modules that hide the left blocks has become the job the modules' authors. The theme code can work with any module,module present or future one, without changes - as any theme should. More flexibility with the Block Modificator With Chris Sengers' Simple Blocks Manipulator for left blocks you can put any block left or right differently with any module. You can even use inactive blocks and also change the theme according to the module (we show how to do this yourself in ). Modifying the <application>PHP-Nuke</application> theme bodyIn this section we continue our study of PHP-Nuke themes - this time with the body of a theme! We cover topics like:How to get multipage News articles ().How to change the background colour ().How to get multipage News articlesIt appears that while Reviews,Reviews Section, and Content areas allow multipage bodies, the general News article does not. Contrary to what one would think, if you want to add such functionalityfunctionality in the News module,module the code under modules/News/ is not the right place. The right place is the themearticle() in the theme.themephp file of your theme!This is so, because it is the themearticle() function that outputs the articlearticle text, through a call to the FormatStory() function (which is also defined in theme.themephp):Thus, all we have to do is format $thetext accordingly, before it is passed to FormatStory. Just add the following code to the begining of the themearticle() functionfunction in theme.themephp, like thisNotice that we have added $page to the global variable list - other than that ,the first two lines are included here only for your orientation. (see Multipage articles, Pagebreaks in articles):", $thetext ); ]]> $pageno ) ]]> 1) { ]]>"; ]]>$contentpages[$arrayelement]
"; ]]>= $pageno) { ]]>"._NEXT." ($next_pagenumber/$pageno) ]]> ]]>"; ]]>
".nl2br($mypage[page_footer])."

"; ]]> ]]> ]]>"._PREVIOUS." ($previous_pagenumber/$pageno)"; ]]>

$previous_page $next_page

"; ]]>Now you can use  in your News stories, and the code above will split the text at the  and create the “previous” and “next” hyperlinks for you (don't forget to define _NEXT and _PREVIOUS in your language file, as shown in ). How to change background colourA well-constructed theme will offer you a simple way to change the various colours (see How to change the background colour): in the theme.themephp file of the NukeNews theme, for example, you can read:and immediately after that:The strings to the right side of the above assignments are hexadecimal representations of colours.colours They begin with a # and contain six hexadecimal digits, two for each colourcolour of the basic ones, red, green and blue. Thus, the string "#cfcfbb" fot $bgcolor4 means cf for red, cf for green and bb for blue. Each one of the three hexadecimal two-digit numbers has a range from 00 to FF (just as each hexadecimal digit goes from 0 to F: 0, 1, 2, 3..., 8, 9, a, b, c, d, e, f, where a means 10, b means 11, c means 12 ... and f means 15 in the hexadecimal system). This means a range from 0 to 255 - that's 256 different values for each colour.colour Colour wheels A useful tool in exploring the visible spectrum in HTML is the colour wheel. Just hover over the wheel with your mouse to view 4096 colors in their web safe, web smart and unsafe versions. ]]> ]]> ]]> ]]> Inline graphic You can also use the colour popups of the Tag-o-matic to show all 216 web-safe colours in a virtual colour card. But what do you do if your theme does not follow this scheme and does not offer you this possibility? In such a case, we need to applly our knowledgeknowledge on the structure of a theme (see ). We have seen that each theme comes with its own definition of the OpenTable() and CloseTable() functions. A brief look at the code of tables.tablesphp in modules/NukeNews reveals the place where $bgcolor1 and $bgcolor2 are used in the Nuke News theme:theme in the definitions of OpenTable() and CloseTable()! This is for example the OpenTable() function for the NukeNews theme (see modules/NukeNews/tables.tablesphp):\n"; ]]>\n"; ]]>Other themes construct their the OpenTable() and CloseTable() functions similarly, if not identically. We will use this fact to change the background colour in the Stories Archive module - and only there. To this end, we only need to define new OpenTable() and CloseTable() functions, with the colour of our choice, then use the new functions instead of the old ones everywhere in the module:moduleIn the theme.themephp file of your theme, add the following two functionsStrictly seen, the CloseTableNew() function is not necessarily needed, since no new colour is defined there, but it is good to have, to keep the functions conceptually separated from the standard ones.:\n"; ]]>\n"; ]]>\n"; ]]>Give the new background colours,colours $bgcolornew1 and $bgcolornew2, the values of your liking in the start of theme.themephp, for example:Then just change every occurence of "OpenTable" and "CloseTable" with "OpenTableOpenTableNew" and "CloseTableNew" respectively in modules/Stories_Archive/index.php.index.php That's all! The Stories Archive module will now use the new colours.coloursThere is one small detail you may also want to fix though: the colours of the cells for the “Articles | Comments | Reads | Score | Date | Actions” links. To change those too, you will have to change the $bgcolour2 colour in the table cells of the show_month function of modules/Stories_Archive/index.phpindex.php (see also Background color in Stories Archive):" ]]>"._ARTICLES."" ]]>"._COMMENTS."" ]]>"._READS."" ]]>"._USCORE."" ]]>"._DATE."" ]]>"._ACTIONS.""; ]]>For your design to be consistent, the best way would be to change the six occurences of $bgcolor2 in the above code, to your new background colourcolour $bgcolornew2. If you want to change the foregroundforeground colour,colour the easiest method might be to change the value of the text attribute in the <body> tag that is echoed in the themeheader() function of theme.themephp (see How to change the main font color):"; ]]>Settingfor example, should make all text appear in red. Modifying the <application>PHP-Nuke</application> theme indexThe themeindex() function displays and formats the News articles. In its standard form, it will attribute a news article to the administrator,administrator rather than the registered user who submitted it. It would be nice if the “Posted by” string pointed to the real author, not the administrator who approved and posted the submission (see ).
News article: “posted by” does not mean “submitted by”. ]]> ]]> ]]> ]]> News article: “posted by” does not mean “submitted by”. News article: “posted by” does not mean “submitted by”.
To give credit,credit where credit is due, you must change function themeindex() in the file theme.themephp of your theme, e.g. themes/NukeNews/theme.themephp. Change the following:$informant "; ]]>\"$thetext\"$notes\n"; ]]>to:or, if you want to be more flexible, to:$aid"; ]]>$informant"; ]]>$aid"; ]]>If you apply the latter solution, you should also declare $user_prefix and $dbi to be global variables in themeindex(). Every theme is different! Not all themes are like the NukeNews theme. Some may format the "Posted by" string in a separate function. The important thing to remember is that you must find the line in the themeindex() function. The name of the “informant” is echoed immediately after that line. That's the place to include the above pieces of code (perhaps replacing some function call). See submit news problem and Need to change some links for further discussion of this topic.The themeindex() function in theme.themephp is also the place where the “number of readsads” is printed after the “posted by” part (see How to remove the number of reads in News). Thus, if you want to remove the number of reads in the News module and your theme is NukeNews, for example, you have to edit themes/NukeNews/theme.themephp with a decent text editor (see also ), find the linein the themeindex() function and change it to: Modifying the <application>PHP-Nuke</application> theme footerHere is a little unorthodox example of what you can achieve by modifying the theme footer:footer Suppose you just wonder how you can make a new table to the right of each page (), perhaps because you want to put an advertisement table there. The standard way to do this would be to write a PHP-Nuke block (see ), insert it in PHP-Nuke through the block management panel (see ), position it in the right column, then define its relative position to the other blocks in the right column through the intuitive graphical arrowsarrows in the block table of the block management panel.panelAn alternative way is to edit your theme.themephp. There, in the function themefooter(), you should see an IF statement for the blocks(right):The $index variable controls whether the right column should be displayed at all (together with all the blocks that were positioned “right”). If it is equal to 1, the right column should be visible and a call to blocks(right) is made. You can echo the HTML for the extra table cell after this IF block.block This extra table cell will be visible in all pages and could contain a PHP-Nuke block with Google skyscraper ad (), or any other content of your choice. See for the details. What makes right blocks disappear... ...is the theme footer, as you can see from the code above! It is in the themefooter() function of theme.php in your theme folder where the value of $index is checked and blocks(right) is called to display the right blocks. If blocks(right) and the statements around it are called unconditionally, then the right blocks will never disappear, no matter what value $index has, and the method of will not work. You will then have to adjust themefooter() in your theme manually. See also Disable right blocks in News Module. How to insert an extra table to the right of the pageThe themefooter() function in the theme.themephp file of your theme is the right place to modify if you want to insert an extra table cell to the right of your page:Find the call to blocks(right) (see it in ) and modify it by adding code as follows: "; ]]>Some text here."; ]]>$foot2
$foot3
$foot4"; ]]>Or, as a more elaborate variation that includes an external piece of code (in this case the Login block): "; ]]>Some text here.
"; ]]>$foot2
$foot3
$foot4"; ]]>In both cases, it is important that the inserted code is outside the IF statement that controls the call to blocks(right). See Insert a new table for more details. The <application>PHP-Nuke</application> Copyright noticeThe theme footer also is the place where the PHP-Nuke copyright notice comes in. You don't need to do anything for this, it is done automatically as follows (see PHP-Nuke Copyright and Logo): The function themefooter() in theme.themephp contains a call to the footmsg() function,function as in the following example from the Milo theme (file themes/Milo/theme.php):\n" ]]>\n" ]]>\n" ]]>\n" ]]> ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n" ]]>\n"; ]]>\n" ]]>\n" ]]>\n"; ]]>footmsg, in turn, is defined in the footer.php file (located in the rootroot directory, together with config.php,config.php mainfile.php and the other important files). There, among some code that displays the computation time it took to display the page, we read:$totaltime
\n\n"; ]]>So that's the place where the Copyright notice for PHP-Nuke comes from! Does that mean that, now that we have found it, we are entitled to edit or remove it? Absolutely NOT! In the INSTALL file that comes with the PHP-Nuke package, Franzisco Burzi,Burzi the author of PHP-Nuke explicitly forbids this:PHP-Nuke license, to encrypt some parts of the # ]]>PHP-Nuke files # ]]>Still, even this simple and clear admonition from the author does not stop some folks to pose the same question in the forums again and again: Am I allowed to take the Copyright Notice away? The argument often presentedpresented is one that involves the Licence uder which PHP-Nuke is released, the GNU General Public Licence (GPL). If I am allowed to change the code under the GPL,GPL the argument goes, and the Copyright Notice is generated by a function call to footmsg(), why not just change the code and delete that call in my theme?theme I can do this, right?Wrong. In an article titled PHP-Nuke GPL Copyright Removal Question Finally Solved, MissS writes:
A while back, questions were raised as to whether or not the copyright notice at the bottom of PHPNuke created pages could be removed. Now there is an answer to this question, straight from the GNU people. The GNU website states that if you have any questions concerning licensing, you can simply email them for clarification. That is exactly what I did and what follows is my email to them...
So MissS wrote to licensing@gnu.org on Sept. 19th, 2002 and asked:
I have a question about the GNU/GPL license. There is a program called PHP-Nuke that has been released under this license. (This program can be found at www.phpnuke.org) This program is a content management system that provides the structure for a website along with the means to administer that site. What I would like to know is this: if I use this PHPNuke program to create my website,website must the copyright notice (that is included at the bottom of each page that is created with PHPNuke) remain there in order to remain in compliance with this license? There is also a copyright notice within the source code files themselves.
Dave Turner's answer was clear, albeit somewhat lapidary:
Yes. See section 2c of the GPL for details.
MissS was also confused as to whether PHP-Nuke can be technically considered as what the GPL in its 2c section calls a program that “normally reads commands interactively when run” , in which case it must, among other things, “print or display an announcement including an appropriate copyright notice”:
This subject came up a while back at PHPNuke.PHPNukeorg and no-one seemed to know the realanswer. I have spent quite sometime reading over your license and can't definitively figure outthis answer for myself. (I had questions such as: is the output from a program like this trulyconsidered interactive or not?) Please let me know. I don't want to remove the copyright footers on the output pages if I amnot legally allowed to do so.
To which Dave Turner replied:
I think a web-based message board clearly reads commands interactively. So, if there is such a notice, you can't remove it. But you could alter its form, so long as it is still appropriate.-Dave TurnerFree Software Licensing GuruGuruThis is not legal advice. If you need legal advice, see a lawyer.
This pretty much says it all. Modifying the <application>PHP-Nuke</application> theme iconsYou are not allowed to use PHP-Nuke's own icons (found in phpnuke.org: Topics). From the PHP-Nuke FAQ:
Can I copy and use your topics graphics?graphicsAbsolutely No. All the topics graphics has been made by me and have copyright.copyright You can't copy, modify and/or use those graphics.graphics You can only use "phpnuke.gif" topic image to setup a topic in your web site that refers "only" to PHP-Nuke. Will be exceptions to this rule for PHP-Nuke community's sites. If you run a community support site (for PHP-Nuke ONLY), drop me line. You'll need my written permission to use them. Be fair and don't play with my hard work.
Thus, you must use your own icons.icons You will have to either use icons that are royalty free, or licence some for use on your site, or create your own ones. To create your own PHP-Nuke icons,icons you can use some of the tools available specifically for this purpose, e.g. The Topic Dude. Theme construction: the rules to follow Considering that the example is always on NukeNews,NukeNews I suggest you always use this theme as an example, by using the HTML template without directly inserting too many tags in the PHP code, you save time and increase the sites stylistic effect by easily making changes across your site.When you add images in an automatic way by using a visual editor,editor the path will be only images/image.gif, and you have to correct it by hand with the right path.You can insert variables in the HTML that will then be called by PHP - it is important that they are inserted in the global part of the functionfunction that will include the file.The visual editor has the defect to open and close the tables,tables correcting what it thinks is an error. Pay attention because sometimes, in the html files we use, a table is not closed because it will be closed by the successive html file. For example, as often happened, DreamWeaver would close a header by making a mistake in the tables.tables The header must be closed in the following way: ]]>Where this table is that one that includes the right blocks.Try to validate the HTML code as much as possible and to use the style sheets (see ) as much you can. In this way you will save a lot of time when you will modify colors, fontsfonts etc. How to change a buggy <application>PHP-Nuke</application> themeYou changed your PHP-Nuke theme to one that is buggy. Now, you cannot see anything, or you only see errors and the Administration panel cannot be reached to change the theme - a chicken-and-egg problem... ]]> ]]> ]]> ]]> Inline graphic There are various solutions to this problem:Copy the following code into a file and save it as fixtheme.themephp: ]]>If you don't have the NukeNews theme uploaded in your site then change the value for $def_theme in the code above so that it reflects one of your working themes,themes save it, upload it to where nuke's config.php file is, then point your browser to http://yoursite.com/fixtheme.themephp (thanks to Humpa for this).Just rename the DeepBlue theme (or some other theme known to work) folder to the problematic one.Use phpMyAdmin and change the default_theme field in the nuke_config table. How to prevent users from changing the theme in PHP-NukePHP-Nuke comes with several standard themes.themes It gives your registered users the possibility to change the theme at the click of a button (see ). But what if you don't want your users to do that? What if you want them to stay with the default theme you chose in the Preferences (see ) of the administration panel?panelThere are two ways to achieve this (see I do not want to let users choose their own themes):You delete all themes except the one chosen by you. Themes are stored in the themes folder, under directories that carry the theme name. PHP-Nuke counts the available themes in function nav() of the file modules/Your_Account/navbar.php:If the theme count $thmcount is greater than 1 - and only then - , the registered user is presented the possibility to change the theme.theme This is done again in function nav() of modules/Your_Account/navbar.php a few lines further down: 1) { ]]>" ]]> ]]>
" ]]>" ]]>" ]]>"; ]]>Thus, by deleting all other themes you will get a theme count of only 1 and the theme change functionality will not be available to the user.Why get to all the trouble and delete whole theme directories? From what we said above, it should suffice just as well to replace the line 1) { ]]>with 1000) { ]]>Unless you really installed more than a thousand themes,themes your users are not going to get the chance to change the default one!Choose the first solution, if you don't want to touch the code, choose the second one, if you are lazy. ]]> ]]> ]]> ]]> Inline graphic Don't delete themes if you already have registered users! Do the above changes before you go online and start getting registered users. Why? Because if you already have some, you don't know if the theme they chose in the User Preferences was the one you want to be the default. If it is not, and you apply either solution above, then those users will not be able to get into your site! Either the theme they specified will not be there, or they will not be able to change it. The first solution has the extra disadvantage that if you choose to change the default theme, you will need to move it under the themes folder. Thus, even for a very short period of time, you will end up having two themes available. You never know if a user just chose the theme you wanted to remove as her default theme. That user will be denied access to your site the next time she tries, because the theme will not be there anymore! In cases you do have registered users, you are thus advised to run the following SQL statement, either from the MySQL prompt, or through a graphical frontend, like phpMyAdmin: This will set the theme to blank for all users, making it for them possible to change it to the default one afterwards, see disabling themes and also Where is the themeheader function located?. How to change the <application>PHP-Nuke</application> theme depending on the moduleFor some web designs, it is desirable to always use the same theme for a few modules,modules while letting the user choose his own theme for the rest. Let's say you want to use the NukeNews theme for the News and SectionsSections modules, but let the user's personal theme be applied to the other modulesmodules of your site.The theme is set in the get_theme function of mainfile.php.mainfile.php Thus, all you have to do is declare the $name variable to be global in that function,function then check its value before the selected theme is returned (i.e. immediately before the return statement) and, if it is, say "News", or "Sections"Sections, to choose the NukeNews theme (see Truly Global Variables): Declare $name to be global. Check if the module name, $name, is News or Sections. Set the selected theme to NukeNews. Of course, there is nothing magic about $name. You could take just any other variable and make the theme selection be dependent on it. You would only have to declare it global in the get_theme() function and in the modules that you would like to se t it. How to change the font size in PHP-NukeSince every theme comes with a CSS (style.css,style.css see also and ) in the styles folder of the theme itself (see ), it is very easy to apply global formatting changes to our PHP-Nuke site: we just edit the CSS file. For example, to change the font size for all documents, we don't have to chase tags in the PHP code - we only need to edit the style.css of our theme.theme is deprecated in HTML 4.x tags are deprecated in the HTML standard, starting from version 4.0, see Font modifier elements: FONT and BASEFONT. Typically, in style.css there will be one or more lines specifying the font size, like:or Font size is usually specified in pixels (px), but other units are also possible (see CSS Font-Size):Relative units - they specify a length relative to another length.em: the 'font-size' of the relevant font.ex: the 'x-height' of the relevant font.px: pixels,pixels relative to the viewing device.Thus, the 'em' unit is equal to the computed value of the 'font-size' property of the element on which it is used. The exception is when 'em' occurs in the value of the 'font-size' property itself, in which case it refers to the font size of the parentparent element. That's what the following joke refers to:What did one .em say to the other .em? Who's your Daddy? ]]> ]]> ]]> ]]> Inline graphic Absolute units:in: inches -- 1 inch is equal to 2.54 centimeters.centimeterscm: centimeterscentimetersmm: millimetersmillimeterspt: points -- the points used by CSS2 are equal to 1/72th of an inch.pc: picas -- 1 pica is equal to 12 points.Depending on where you make the font size change, it may apply only to the title,title the content or even the wholy body. Inheritance in the HTML document tree is applied by the browser to decide which properties can be passed on from the “parentparent” elements to the “children” or the “descendantsdescendants”. This is called “cascadingcascading” and is responsible for the first “C” in “CSSCSS”. You need to understand cascading to use the full potential of CSS,CSS but for simple changes like this one, you can just experiment and get the idea (see for a short discussion of CSS syntax).However, it is better, from the "Accessibility" point of view, to let your users decide themselves what font size they like, by setting it in up in their browsers (see How to change font size). Read Using relative font sizes for the background on this. Using the advice given in that article,article Chris has the following in the CSS file for DocBook that controls the appearence of the PHP-Nuke HOWTO (and actually, all other documents on his site):BODY P { ]]>There's a lot going on here, and it's all important, so pay attention (taken from Using relative font sizes):First, we're defining an absolute size (12px) for every . All browsers apply this style, including Netscape 4.Then we include the odd-looking comment "/*/*/". Due to bugs in Netscape 4, everything between this comment and the following one will be ignored. That's right, all the following styles will only be applied in non-Netscape-4non-Netscape-4 browsers.Immediately after the odd-looking comment, we include an empty rule "a {}". Opera 5 for Mac is buggy and ignores this rule (and only this rule). It applies everything else.We have now carved out a realm where we can define rules that are applied in all browsers except Netscape 4. Now we can start defining relative font sizes (which Netscape 4 can't handle). The first thing we do is use a "body p" selector to redefine the behaviour of the p tag. Due to the way CSS works, this will override our previous p selector.selector (In technical terms,terms "body p" is a more specific selector than "p".)We redefine the font size of all tags to be x-small. This is a font size keyword which, at default settings, Internet ExplorerExplorer 5 for Windows will translate into 12px.12px However, if the user changes their "Text Size" (under the View menu), this text will scale larger or smaller, depending on the user's setting. This is what we want. (Note: we've now defined font-size twice for IE5/Win, but that's okay, because the more specific selector always wins, and the previous selectorselector is simply ignored.)Unfortunately, IE5/Win an off-by-1 bug with its font size keywords;words every other browser in the world (IE5/Mac, Netscape 6, Mozilla,Mozilla IE6/Win) will translate x-small to 10px,10px not 12px. Luckily for us, IE5/Win has its own parsing bug that we can exploit:exploit it looks at that odd-looking voice-family and mistakenly thinks that this entire "body p" selector is over, so it ignores all the lines until the "}".Now we have carved out a smaller realm where we can define rules that are applied in all browsers except IE5/Win (and Netscape 4, which is still blissfully ignoring all of this). So we redefine font-size to small, which modern non-IE5/Win browsers (the only ones still listening) correctly interpret as 12px (at default settings). Again, if the user sets their "text size" to larger, this text will scale larger, which is what we want.But wait! Opera 5 has the same parsing bug that IE5/Win has, so it was also confused by the voice-family hack,hack but it correctly interprets font size keywords,words so now our text will look too small in Opera 5. Luckily, Opera 5 supports a third type of selector,selector "html>body p". (Again, this is "more specific" than "body p", so it takes precedence over the previous selector.selector) IE5/Win does not support this type of selector, so it will just ignore it, which is what we want (since we've already compensated for it's off-by-1 bug and don't want to go mucking that up now). IE6/Win also does not support it, but that's OK, because we caught it with the "font-size:font-size small" after the "voice-family: inherit" hack in the "body p" selector.selector All other browsers support "html>body" selectors, so for them we end up defining font-size four times. Again, that's not a problem, because the most specific selector always wins, and the rest are simply ignored.Finally, we have a set of empty comments:comments /* */. This triggers Netscape 4's parser to start listening again. If we defined any further rules after these empty comments,comments all browsers (including Netscape 4) would apply them.To recap:Netscape 4 displays text at 12px,12px regardless of user setting.Internet Explorer 5 for Windows displays text at x-small, which works out to be 12px at the default setting, but would scale larger if the user set their "Text Size" setting larger in the View menu.menuInternet Explorer 6 for Windows displays text at small, because of the "font-size:font-size small" rule in the "body p" selector. This works out to 12px at the default setting, but would scale larger if the user set their "Text Size" setting larger.Internet Explorer 5 for Mac, Opera, Netscape 6, Mozilla,Mozilla and (hopefully) all future browsers will display text at small, because of the "font-size:font-size small" rule in the "html>body p" selector.selector This works out to 12px at the default setting, but would scale larger if the user used the "Text Zoom" feature. Dive into Accessibility! By the way, the whole Dive into Accessibility document by Mark Pilgrim is highly recommended reading for everyone. It will open your eays to a different world - that also uses the Internet! Modifying the <application>PHP-Nuke</application> HTML headerThe PHP-Nuke HTML header (i.e. everything that goes between the <head> and </head> tags in the HTML code of the generated page) is fully customizable through the includes/my_header.headerphp file. This file contains whatever custom stuff you need to include in your site when the header loads.ads This can be used for third party banners,banners custom javascript, popup windows, etc. With this file you don't need to edit system code each time you upgrade to a new version. Just remember, in case you add code here to not overwrite this file when updating! Whatever you put here will be between <head> and </head> tags.Here are some example customizations of the PHP-Nuke HTML header:headerHow to implement a favourites icon (favicon.ico)Would you like to use a custom icon to appear in the URL address field at the top of the IE window when people are at your site? This is a “faviconfavicon”, a favourites icon, that small icon that you see besides the URL when you visit some cool sites. This “functionalityfunctionality” was introduced by the Internet Explorer.Explorer When you add a site to your Favourites list, Internet Explorer (version 5 and above) asks the server if it has a file called favicon.faviconico. If present, this file will be used to provide an icon that is displayed next to the bookmark text. It is not visible in the old browsers, but newer ones, like Mozilla and Konqueror,Konqueror will also display it.To display a favicon,favicon you have first to create one. The icon has to be in the ICO format which, contrary to common belief, is NOT the same as GIF, or PNG.PNG You have to transform your GIF or PNG file to ICO format.format For Windows,Windows you can use one of the numerous icon tools (). For Linux,Linux simply create a 16x16 PNG file and convert it to an icon resource with png2ico. Upload the ICO file to, say, images/favicon.faviconico. Then add the following lines in the includes/my_header.headerphp file, somewhere between the “<?php” and “?>” tags:"; ]]>“]]>” Note: If you did the above and your browser still does not show the icon, remember that it may be using an old cache. Empty the cache and remember that even with a new cache, the browser may be using some old information, so you will have to be patient, or check it with a browser that did not visit that URL before. For more information on how to create and use a favicon,favicon see How To Create And Install A favicon.ico. How to prevent the statistics module from gathering hits from certain hostsIf you are still in the phase of editing and tweaking your PHP-Nuke site while it is already online, you may find out that your frequent visits are counted just as every other visit to your site by the statistics module. During a very productive phase, this can skew the statistics of your site quite a bit! ]]> ]]> ]]> ]]> Inline graphic Contrary to what you might have expected, to prevent the statistics modulemodule from gathering hits from certain hosts, like your own one, you have to edit the header.headerphp file, not any other file from the modules folder. header.php and includes/my_header.php Do not confuse header.php, a file located in the PHP-Nuke root directory, with the my_header.php file, located under the includes directory. The former contains standard PHP-Nuke functions for the PHP-Nuke header, the latter is there for your own, personal additions to the header. In your header.headerphp file, find the code:and replace it withSee Block hosts from total hits in statistics module.:Put your administrator name in place of the "PutYourAdminNameHere" string in the above code and visits by that administrator will not increase your statistics counter any more. ]]> ]]> ]]> ]]> Inline graphic How to block all administrators from the statistics counter A simpler fix, which will block all administrators from the statistics counter, is: Modifying mainfile.phpThe mainfile.php file in the root directory of PHP-Nuke contains all commonly used functions and plays a crucial role in PHP-Nuke. We devote this chapter to a closer investigation of this central file. We show:How to allow special HTML tags ().How to change the order of messages (). Warning Most of the changes discussed in this chapter have direct or indirect security implications (see ). No line in mainfile.php was put there without some reason, the reason being often security-related. Whenever you comment a line that seems to do a too restrictive check on user input, for example, bear in mind that in the worst of all cases you may run the risk of being hacked because of the absence of exactly a check like that. How to allow special HTML tagsUser input is checked and filtered automatically by PHP-Nuke. For this purpose the functions filter_text and check_html are used. filter_text checks and replaces bad words, then calls check_html,check_html which in turn checks for HTML tags and strips them completely off, if the second parameter is “nohtmlnohtml”. shows all modules that call filter_text,filter_text together with the line the call is made on. You can see that filter_text is used to filterfilterthe text of a mail response in the WebMail modulemodulethe comments in the News modulemodulethe comments in the Reviews modulemodulethe subject,subject story and extended story text in the Submit_News modulethe subject and comments in the Surveys modulemodulethe username and message in the Your_Account modulemoduleCalls to filter_text from <application>PHP-Nuke</application> modules (v.6.8) Module Line with call to filter_text modules/WebMail/readmail.php $res = filter_text($res); // Security fix by Ulf Harnhammar 2002 modules/News/comments.php $comment = FixQuotes(nl2br(filter_text($comment))); modules/News/comments.php $subject = FixQuotes(filter_text($subject, "nohtml")); modules/News/comments.php $comment = FixQuotes(filter_text($comment)); modules/Reviews/index.php $comments = FixQuotes(nl2br(filter_text($comments))); modules/Submit_News/index.php $subject = FixQuotes(filter_text($subject, "nohtml")); modules/Submit_News/index.php $story = FixQuotes(nl2br(filter_text($story))); modules/Submit_News/index.php $storyext = FixQuotes(nl2br(filter_text($storyext))); modules/Submit_News/index.php $story = FixQuotes(filter_text($story)); modules/Submit_News/index.php $storyext = FixQuotes(filter_text($storyext)); modules/Surveys/comments.php $subject = FixQuotes(filter_text($subject, "nohtml")); modules/Surveys/comments.php $comment = FixQuotes(nl2br(filter_text($comment))); modules/Surveys/comments.php $comment = FixQuotes(filter_text($comment)); modules/Your_Account/index.php filter_text($username); modules/Your_Account/index.php if ($bio) { filter_text($bio); $bio = $EditedMessage; $bio = FixQuotes($bio); } modules/Your_Account/index.php $the_message = FixQuotes(filter_text($the_message, "nohtml"));

check_html,check_html in turn, is not only called from filter_text, but also in its own right. shows all modules that call check_html and the line it is called on. You can see that check_html is called to check the HTML input inthe query string in the Downloads,ads Encyclopedia, Web Links and Search sectionsthe title,title text, reviewer, URL text and comments in the Reviews moduleuser name, e-mail,e-mail various user info fields in the Your Account modulebodytext and comments in the Journal modulemoduleCalls to check_html from <application>PHP-Nuke</application> modules (v.6.8) Module Line with call to filter_text modules/Downloads/index.php $query = check_html($query, nohtml); modules/Encyclopedia/search.php $query = check_html($query, nohtml); modules/Encyclopedia/search.php $query = check_html($query, nohtml); modules/Reviews/index.php $title = stripslashes(check_html($title, "nohtml")); modules/Reviews/index.php $text = stripslashes(check_html($text, "")); modules/Reviews/index.php $reviewer = stripslashes(check_html($reviewer, "nohtml")); modules/Reviews/index.php $url_title = stripslashes(check_html($url_title, "nohtml")); modules/Reviews/index.php $title = stripslashes(FixQuotes(check_html($title, "nohtml"))); modules/Reviews/index.php $text = stripslashes(Fixquotes(urldecode(check_html($text, "")))); modules/Reviews/index.php $comments = stripslashes(FixQuotes(check_html($comments))); modules/Search/index.php $query = stripslashes(check_html($query, nohtml)); modules/Web_Links/index.php $query = check_html($query, nohtml); modules/Your_Account/index.php $username = check_html($username, nohtml); modules/Your_Account/index.php $user_email = check_html($user_email, nohtml); modules/Your_Account/index.php $user_email = check_html($user_email, nohtml); modules/Your_Account/index.php $femail = check_html($femail, nohtml); modules/Your_Account/index.php $user_website = check_html($user_website, nohtml); modules/Your_Account/index.php $bio = check_html($bio, nohtml); modules/Your_Account/index.php $user_avatar = check_html($user_avatar, nohtml); modules/Your_Account/index.php $user_icq = check_html($user_icq, nohtml); modules/Your_Account/index.php $user_aim = check_html($user_aim, nohtml); modules/Your_Account/index.php $user_yim = check_html($user_yim, nohtml); modules/Your_Account/index.php $user_msnm = check_html($user_msnm, nohtml); modules/Your_Account/index.php $user_occ = check_html($user_occ, nohtml); modules/Your_Account/index.php $user_from = check_html($user_from, nohtml); modules/Your_Account/index.php $user_interests = check_html($user_interests, nohtml); modules/Your_Account/index.php $realname = check_html($realname, nohtml); modules/Journal/display.php $row[bodytext]=check_html($row[bodytext], $strip); modules/Journal/display.php $row[comment]=check_html($row[comment], $strip);

check_html uses the $AllowableHTML array that is defined in config.php.config.php The idea is that only the tags that are included in the $AllowableHTMLAllowableHTML array should be allowed. However, even if you explicitly allow the img tag in $AllowableHTML,AllowableHTML it will be stripped away by check_html (and by filter_text,filter_text which also calls it). The line that does this is ]*)[[:space:]]*>", ", $str); ]]>You can comment out that line - though it is certainly a security issue (allowing people to post harmful code in img tags). You can also comment out the line that eliminates all anchor attributesattributes exept href in the <a> tag:]*href[[:space:]]*=[[:space:]]*\"?[[:space:]]*([^\" >]*)[[:space:]]*\"?[^>]*>", '', $str); # " ]]>These changes will affect the checks done at all places shown in both and , so again, be careful with security issues. You have to trust your users to give them this comfort.Put the tags you want to allow in the $AllowableHTML array in the config.phpconfig.php file. Here is a (quite liberal) example:1, ]]>1, ]]>2, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>1, ]]>2, ]]>1, ]]>2, ]]>2, ]]>2, ]]>2, ]]>2, ]]>2, ]]>1, ]]>1, ]]>1); ]]>The numbers that appear next to each tag have the following meaning:a 1 means the tag does not accept any attributesattributesa 2 indicates that the tag may also contain attributesattributesSee also . How to change the order of messages
Administration panel: Messages. ]]> ]]> ]]> ]]> Administration panel: Messages. Administration panel: Messages.
The default for PHP-Nuke is to display messages in ascending order of midmid (the id number for each message). You can use Add Story () to post articles on your site and these will appear in reverse order, i.e. last posted at the top (see also , on how to order articles in Sections and , on how to order articles in the Stories Archive). Thus you could have a main “Welcome Message” at the top which will always be there as a home page, followed by a seriesseries of announcements appearing in reverse order below the Welcome Message. But what happens if you don't use “Add Story” to add articles, but would rather like to use Messages () for communicating your news?newsIf you really want to use Messages and have them appear in reverse order (last one at the top), you need to edit mainfile.php using a decent editoreditor (see ).At around line 334 in mainfile.php,mainfile.php in function message_box(), changetoand this will display your messages in reverse order (last one at the top). See also How to reverse the order of Messages in the Homepage. How to change the duration of a public broadcast messageSo you want the public broadcast message to show for a longer/shorter period? There is a simple solution (see How to change the duration of a public broadcast message):You can increase the time the message will be displayed by editing the following lines in mainfile.php:mainfile.phpand Adjust the 600 to a value that matches the time you want the message displayed. Modifying <application>PHP-Nuke</application> blocksIn this chapter we show how to modify PHP-Nuke blocks. If you are interested in creating PHP-Nuke blocks, read . We cover the topics:topicsHow to change a buggy block (),How to build custom module blocks (),How to build RSS blocks with variable number of news items (),How to get scrolling headlines in blocks ().How to change a buggy blockYou activated a buggy PHP-Nuke block. Now, your site is broken and you get a blank page, or you only see errors and the administration panel is unreachable because the block breaks your page's design... ]]> ]]> ]]> ]]> Inline graphic There is a very simple solution to this very annoying problem (see Site crashed when block was created): just replace the broken block,block say block-Broken.php, with a script that does not contain anything but the following line: ]]>Then, the administration panel should be reachable and you can deactivateactivate the offending block.block How to build custom module blocks
The standard Modules block ]]> ]]> ]]> ]]> The standard Modules block The standard Modules block
A module block is a block that displays links to all available modules of a PHP-Nuke site (). It is the block that appears at the top of the left column, with the standard title “ModulesModules”. The module block is a standard PHP-Nuke block,block for its construction you have to follow the same rules as for any other block (see ). It is thus fairly easy to construct your own module block,block if you are not satisfied with the standard one. Below are some examples:Simple module block (),Treemenu block ().Simple module blockThe links that are inside the standard PHP-Nuke module block are constructed dynamically, using information that is available about the modules in the database.base For example, to present only active modules in the links, the block (located in blocks/block-Modules.Modulesphp) checks the “active” field of the $prefix_modules table (which is table nuke_modules,modules if $prefix is left to the standard “nuke” in config.php,config.php see ):As we can easily read in the SELECT query above, only modules with the “active” bit set to 1 are selected. But we also see that the order in which they are selected is the standard ascending lexicographic order of the modules' title (ORDER BY title ASC). If we wish a different ordering, we are left with only a few possibilities:Change the order from ascending (ASC) to descending (DESC):Change the field on which the ORDER BY clause is applied, e.g. use custom_title instead of title:titleAdd an extra field to the $prefix_modules table, populate it with customcustom values (e.g. “1” for the module we want to be the first in the list, , “2” for the second, “3” for the third etc. if we decided to use a numeric field ) for each module, and sort in ascendingascending order of this new field:But if we wish a custom grouping of the modules links, we will have to write our own modules block.block You can use the following code as a starting point for your own creations.ations This script will display certain links only when an admin or user is logged in. Just name it block-menuSample.php and put in the blocks folder, deactivateactivate the block-Modules.Modulesphp and activate this one (see Different links - some for registered users only and How would I add a clickable link in a Modules Block?): ]]>Navigation ]]> ]]>� ]]>Start Page

]]>Information
]]>� ]]>News
]]>� ]]>About us
]]>� ]]>Entry with Some word
]]> ]]>Other things ]]> ]]>� ]]>Links
]]>� ]]>All sorts of Pictures
]]>� ]]>Reviews
]]> ]]>Interact ]]> ]]>� ]]>Guestbook
]]>� ]]>Feedback
]]>� ]]>Recommend Us
]]> ]]>Misc. ]]> ]]>� ]]>Links
]]>� ]]>FAQ
]]>� ]]>Add A Link
]]>� ]]>Downloads
]]>� ]]>Site Statistics
]]>� ]]>News Headlines
]]> ]]>User Control Panel ]]>"; ]]>� ]]>Reg. Users Login.
"; ]]>� ]]>Your Account
]]>� ]]>Edit Profile
]]>� ]]>Members Photo upload
]]>� ]]>View Member List
]]>� ]]>logout
]]> ]]>Private Messages ]]> ]]>� ]]>View Messages
]]>� ]]>Compose A Message
]]> ]]>Send Content ]]> ]]>� ]]>Submit News
]]>� ]]>Write A Review
]]>� ]]>Add A Link
]]>� ]]>Add images to the Gallery
]]> ]]> ]]> ]]> ]]> ]]> Treemenu blockA commonly asked question in PHPNuke forums (see for example Menu Hack Needed (show different menu or block depending on the category)), is if there exists some Module block out there that displays a dynamicdynamic view of the available modules.modules The webmaster needs a functionality that will allow for the display of only certain module links, depending on, say, the interests, access level,access level or preferences of the viewer. A typical Module block,block as shipped with the standard PHPNuke package, looks as in .
The standard Modules block. ]]> ]]> ]]> ]]> The standard Modules block. The standard Modules block.
What we need instead is a module block that displays some links (to modules,modules or generally, to pages) when a certain condition is met (say, when Category A was previously chosen) and some other ones when a different conditioncondition is true (e.g. when Category B was chosen).The general idea To met the above requirements,requirements the Treemenu block for PHP-Nuke adapts the well-known Treemenu concept to a PHPNuke Block and creates a PHPNuke block containing a Treemenumenu which looks as in .
Treemenu Block. ]]> ]]> ]]> ]]> Treemenu Block. Treemenu Block.
When the user clicks on an item like “Links”, the subtree under this item is unfolded ().
Treemenu Block with “Links” expanded. ]]> ]]> ]]> ]]> Treemenu Block with “Links” expanded. Treemenu Block with “Links” expanded.
A further click on the subcategory “My work” will reveal another level of groups ().
Treemenu Block with “My work” expanded. ]]> ]]> ]]> ]]> Treemenu Block with “My work” expanded. Treemenu Block with “My work” expanded.
Finally, a click on a subsubcategory like “LinuxLinux” will unfold the “leavesleaves” of the Treemenu ().
Treemenu Block with “Linux” expanded. ]]> ]]> ]]> ]]> Treemenu Block with “Linux” expanded. Treemenu Block with “Linux” expanded.
Of course, the naming and nesting of categories and/or items is fully arbitrary. The above functionality can easily be adapted to suit more advanced needs too (see refinements of the PHP-Nuke Treemenu). What is Treemenu The Treemenu block makes use of a Treemenu in a PHPNuke Block.lock Treemenu is a PHP class created by Bjorge Dijkstra (original script to be found Treemenu Class from Bjorge) and adapted by Denny Shimkoski (his version to be found in Treemenu from Denny). Chris have fixed some bugs in the latter one and integrated it into a Treemenu block for PHP-Nuke.There are two ways you can use the Treemenu class - Chris uses the one that takes as input a simple text file and creates a tree menu,menu in a style that most users are familiar with from a graphical file manager (see ). Navigation through such a tree is done intuitively by expanding and collapsingcollapsing the various tree levels by clicking on the node icons (the icons are discussed in custom node icons for the PHP-Nuke Treemenu).To create a Treemenu,menu once you have written the input text file with your favorite text editor (see input file method for the Treemenu) or used the alternative method to fill the nodes and leaves of the Treemenu, you just have to write this 3-liner to get it up and running:show(); ]]> Note In order to be able to display the output of the above code in a PHPNuke Block, we have to capture it in an output buffer with the ob_start(), ob_get_contents() and ob_end_clean() mechanism: show(); ]]> See Treemenu block for PHP-Nuke for more information of how to use the Treemenu block as a module blockblock for PHP-Nuke. How to build RSS blocks with variable number of news itemsIf you have created an RSS block from the block administration fuction of the administration panel,panel you may have noticed that, notably after some change on a previously working RSS block (for example, in the title,title or the refresh time), or even from the very start, you get the error:This is not always due to some error on your part - it is a bug too. Often, the only solution would be to delete the block and add it anew. The problem is in the file admin/modules/blocks.php. There, the problematic code is","",$items[$i]); ]]>.*","",$link); ]]>","",$items[$i]); ]]>.*","",$title2); ]]>· $title2
\n"; ]]>which has the number of news items (10) hardcoded into it. The problem is caused by the fact that, if there aren't that many headlinesheadlines being returned, and in many unlucky cases, there aren't, you will either get an array out of bounds error, or nothing will be returned, and the content of the block will be set to equal nothing. You could fix that by changing the “10” in the code above to “5”, for example. However, that fix wouldn't work for a site that had only three headlinesheadlines in their RSS file. What needs to happen is to modify the For a modification of the mainfile.php and admin/modules/blocks.php files that also allows for a variable number of items to be chosen from the administration panel individually for each RSS block,block see Digital Nick Downloads, for a discussion thread on this bug,bug see Problems when saving RSS block. How to get scrolling headlines in blocksYou may have noticed those scrolling headlines in blocks of some sites. Perhaps you abhor them, because they distract you from reading the context,context or because the scrolling effect is not supported by all browsers. But if you are fascinated by this effect and wondering how to achieve it in your own PHP-Nuke RSS blocks, here's how:In mainfile.php,mainfile.php find the code for the headlines() function:There, near the end, replace the lineswith the lines$content"; ]]>$content"; ]]>Enclosing the old $content variable in the marquee code and assigning it to the $content variable again before the call to the themesidebox or themecenterbox functions, gives the desired scrolling effect for our RSS headlines.headlines Modifying <application>PHP-Nuke</application> modules
Administration panel: Modules. ]]> ]]> ]]> ]]> Administration panel: Modules. Administration panel: Modules.
In this chapter we will talk about modifying PHP-Nuke modules.modules If you are interested in creating PHP-Nuke modules,modules read . We will talk about:Modifying any PHP-Nuke module (),Modifying the PHP-Nuke Homepage (),Modifying the PHP-Nuke FAQ module (),Modifying the PHP-Nuke Reviews module (),Modifying the PHP-Nuke Web_Links module (),Modifying the PHP-Nuke Your_Account module (),Modifying the PHP-Nuke News module (),Modifying the PHP-Nuke Submit News module (),Modifying the PHP-Nuke Sections module (),Modifying the PHP-Nuke Downloads module (),Modifying the PHP-Nuke Stories Archive module ().Modifying any <application>PHP-Nuke</application> moduleTalking about modifying any PHP-Nuke module in general, we will show:How to hide the right blocks (),How to change a buggy module ().How to hide the right blocksIf your module needs more space than is available in the central column of the PHP-Nuke layout,layout you may want to hide the right column of blocks. This is accomplished very easily from within the code of any module:module find the line and change it to:Of course, if the line is not there, then $index is already 0, so your module already hides the right blocks. ]]> ]]> ]]> ]]> Inline graphic How to hide the left blocks If you want to hide the left blocks, you have to modify the theme header. See . How to change a buggy moduleYou activated a buggy PHP-Nuke module. Now, your site is broken and you get a blank page, or you only see errors and the administration panel is unreachable... ]]> ]]> ]]> ]]> Inline graphic Connect to the MySQL database and change the value of the "active" field in the $prefix_modules table to 0 for that module's entry. Example (see Site crashed when block was created and logout-Fehler): suppose the broken module is Mod_Broken,Mod_Broken your $prefix is "nuke" and the value of the module id, "mid"mid, field for the Mod_Broken module is "7"):or (if you prefer to select by title and not by module id) Modifying the <application>PHP-Nuke</application> HomepageThe PHP-Nuke Homepage is the “Home” module.module The Home module is chosen in the modules administration panel.panel We show:How to redirect users to the Login page (),How to restrict the Homepage only to registered users ().How to redirect users to the Login pageIf you want your users to be redirected straight to the Login page, rather than the Homepage, do the following:Right at the begining of the index.indexphp file , add this code after the 'require_once(“mainfile.phpmainfile.php”);' line, like this:This will send anyone who is not logged in (or registered) to the Your Account (Login) page. See for the inverse procedure — but don't try both. ]]> ]]> ]]> ]]> Inline graphic See how to redirect from forms in a PHP-Nuke block for redirection from other places, like blocks. How to restrict the Homepage only to registered usersSuppose that you have set up the News module as the “Homepage modulemodule” of your PHP-Nuke, but you want the news articles to be visible only to registered users. Can this be done?Well, not exactly. Since you want the News module to be visible only to registered users, you cannot have it in the "Home". This means you must put a different module in Home (see hide articles from logged out users). You can do this from the "Put in Home" link in the modules table shown in the modules administration panel (, ).Once the News module is not in Home anymore, you can edit it and choose that it be visible only by the registered users. The "Who can View This?" selection box is not available, as long as the module remains the "Home" module of your P HP-Nuke installation. That's why you can't restrict the visibility of the Home module, no matter which module this is. T he reason for this is that it makes little sense to have a Home module and restrict its availability only to registered users, unless you want your site to be generally available only to registered members. Modifying the <application>PHP-Nuke</application> FAQ module
Administration panel: FAQ. ]]> ]]> ]]> ]]> Administration panel: FAQ. Administration panel: FAQ.
In this section we modify the PHP-Nuke FAQ module:moduleHow to add more than 127 FAQ answers ().How to add more than 127 FAQ answersYou have 127 Q&A. You cannot add more, if you delete one, you can add one.Cause: Looking at the sql/nuke.sql script that creates the PHP-Nuke tables on installation,installation we see the following for the structure of the nuke_faqAnswer table:From the MySQL manual on column types, we see:
TINYINT[(M)] [UNSIGNED] [ZEROFILL]A very small integer.integer The signed range is -128 to 127.127 The unsigned range is 0 to 255.
so that tinyint is a very small integer indeed in this case.caseSolution: Change the length of id and id_cat of nuke_faqAnswer.nuke_faqAnswer You can do this with phpMyAdmin,Admin or by logging into MySQL from the console and, after choosing the PHP-Nuke database ("use xxxx;"), by typing:See also FAQ problem. Modifying the <application>PHP-Nuke</application> Reviews module
Administration panel: Reviews. ]]> ]]> ]]> ]]> Administration panel: Reviews. Administration panel: Reviews.
In this section we modify the PHP-Nuke Reviews module:moduleHow to allow only registered users to enter a review (),How to choose images from a dropdown list ().How to allow only registered users to enter a reviewIf you want only your registered users to be able to enter a review, you can achieve it with the following simple change:Edit the modules/Reviews/index.indexphp file and find the write_review() function:Add the following check after the call to OpenTable():logged in or ]]>become a member ]]>This check will only allow registered users to continue with a review, while pointing others to the login or register page. Of course, the IF statement has to be closed - just put a } at the end of the function,function as shown below:Unregistered users will be able to view reviews,reviews but only site members will be able to submit new ones. Tip This simple check can be used to restrict access to registered users in any module that does not offer this functionality, not only in Reviews. How to choose images from a dropdown listIsn't it more comfortable being able to choose the image for your review (if you are an administrator) from a dropdown list that offers the names of all available images in your image directory, rather than having to enter the full URL to the image each time? You could easily incorporate this functionality if you just cut and pasted the code from the admin/modules/topics.php file. The functionality is in the Topics module already - you don't need to write full URLs to the topics icons, do you? ]]> ]]> ]]> ]]> Inline graphic The relevant part in the Reviews to introduce the code from the Topics modulemodule is the following code in modules/Reviews/index.php:index.php"._RIMAGEFILE.":
]]>
]]>"._RIMAGEFILEREQ."

]]>"._RIMAGEFILE.":
]]>"; ]]>$tlist[$i]n"; ]]>
"; ]]>"._RIMAGEFILEREQ."

]]>The part of code that was stolen from the Topics module (from the admin/modules/topics.topicsphp file) is between the blank lines in the above code. It will offer you a dropdown list of all images in the images/reviews folder. Just like with the topics images,images you must use all small letters and no underscores or other special characters. See choose image for review. Modifying the <application>PHP-Nuke</application> Web_Links module

Administration panel: Web Links. ]]> ]]> ]]> ]]> Administration panel: Web Links. Administration panel: Web Links. In this section we modify the PHP-Nuke Web Links module:moduleHow to display Web Links in the same window (),How to change the number of Web Links per page ().How to display Web Links in the same windowThe Web_Links module will display each web link in a separate window. To change this behaviour and make it display the link in the same window, you have to change each occurence of toin the modules/Web_Links/index.indexphp file. This is a straightforward search and replace procedure.procedure In vi, you would do How to change the number of Web Links per pageYou can change the number of Web Links that are displayed per page very easily - no programming necessary! ]]> ]]> ]]> ]]> Inline graphic Just change the value of $perpage in modules/Web_Links/l_config.php:l_config.php Make use of the module configuration files! It definitely pays off to have a look at the configuration files of the various modules! The l_config.php file, for example, located in the Web_Links folder under the modules directory, offers many variables that can be used to achieve the desired appearence of the Web Links module: $perpage: How many links to show on each page? $popular: How many hits need a link to be listed as popular? $newlinks: How many links to display in the New Links Page? $toplinks: How many links to display in The Best Links Page? (Most Popular) $linksresults: How many links to display on each search result page? $links_anonaddlinklock: Lock Unregistered users from Suggesting New Links? (0=Yes 1=No) $anonwaitdays: Number of days anonymous users need to wait to vote on a link $outsidewaitdays: Number of days outside users need to wait to vote on a link (checks IP) $useoutsidevoting: Allow Webmasters to put vote links on their site (1=Yes 0=No) $anonweight: How many Unregistered User vote per 1 Registered User Vote? $outsideweight: How many Outside User vote per 1 Registered User Vote? $detailvotedecimal: Let Detailed Vote Summary Decimal out to N places. (no max) $mainvotedecimal: Let Main Vote Summary Decimal show out to N places. (max 4) $toplinkspercentrigger: 1 to Show Top Links as a Percentage (else # of links) $toplinks: Either # of links OR percentage to show (percentage as whole number. #/100) $mostpoplinkspercentrigger: 1 to Show Most Popular Links as a Percentage (else # of links) $mostpoplinks: Either # of links OR percentage to show (percentage as whole number. #/100) $featurebox: 1 to Show Feature Link Box on links Main Page? (1=Yes 0=No) $linkvotemin: Number votes needed to make the 'top 10' list $blockunregmodify: Block unregistered users from suggesting links changes? (1=Yes 0=No) Modifying the <application>PHP-Nuke</application> Your_Account moduleIn this section we modify the PHP-Nuke Your Account module,module one of the most central modules of PHP-Nuke. We show:How to redirect users to the Homepage (),How to redirect Your Info to the Forums user profile (),How to redirect users to Login and back (),How to disable registration (),How to let users register immediately (),How to approve users before registration (),How to register users through iBill (),How to change the maximum allowed length for user names ().How to redirect users to the HomepageAre you looking for a way to redirect a user to Home rather than Your AccountYour Account when they login?login Would you rather prefer them to go to Your Account only when they choose to and be automatically redirected to Home when they login?login There is a simple way to accomplish this (see How to redirect users to the Homepage and Redirect login to home):Find the following lines in function login() in the modules/Your_Account/index.indexphp:Change it to this:See for the inverse procedure — but don't try both. ]]> ]]> ]]> ]]> Inline graphic How to redirect Your Info to the Forums user profile

Your Info link in the User Preferences panel. ]]> ]]> ]]> ]]> Your Info link in the User Preferences panel. Your Info link in the User Preferences panel. With the advent of phpBB forums in PHP-Nuke (starting from somewhere around v. 6.5), you not only have to cope with two administration panels, one for PHP-Nuke in general and one for the Forums in particular, your users can maintain their profile in two places too, from the Your Info link in the User Preference panel (), as well as the Forums profile link in the Forums module ().

Forum Profile link in the Forums module. ]]> ]]> ]]> ]]> Forum Profile link in the Forums module. Forum Profile link in the Forums module. The Your Info link has the URLURLand leads to a panel similar to the one of .

User profile in Your Info. ]]> ]]> ]]> ]]> User profile in Your Info. User profile in Your Info. The Profile link in the Forums module, on the other hand, has the URLURL(optionally with the session ID parameter, sid,sid which is not shown here) and leads to the panel shown in .Both panels use the same database tables in the background,background so it doesn't matter which one you use. This may be confortable for some, but also confusing for other users.If your users find it confusing to use two different entry points for their personal information,information you can modify the Your_Account module to redirect them to the Forum profile (), even when they click on the Your Info link ().

User profile in the Forums. ]]> ]]> ]]> ]]> User profile in the Forums. User profile in the Forums. The Your Info link is output (“echoed”) in modules/Your_Account/navbar.php, in the following code block:block" ]]> ]]>
" ]]>" ]]>" ]]>"; ]]>To redirect the users to the Forum profile (), you can change the above block to:" ]]> ]]>
" ]]>" ]]>" ]]>"; ]]>As you can easily see, we have changed only the two links (one for the image and one for the text), the other lines are for your reference only. It is not necessary to compute the user's numeric ID and pass it on the URL through the u parameter - the mode=editprofile parameter on the URL will find the user automatically (but mode=viewprofile will not!). But wait a minute! Is this really all we have to change? Is the Your Info link () the only one that leads a user to the profile screen of the Your_InfoYour_Info module ()? How about the user name links in other modules,modules for example? Search for the string “op=edituseredituser” and you will already find a ton of those links in various places (Newsletter,Newsletter language files, Reviews.Reviews..) And how about a new user? Will the new user registration screen be the one of Your_Account or the one of Forums?Instead of chasing links in the code, there is a more elegant solution that will eliminate any attempt to bring a user to the Your Info profile at its very beginning! It is also a very good example of what type of controlcontrol you can achieve over your PHP-Nuke, if you put your knowledge about the way a module works (see ) into practice:In modules/Your_Account/index.indexphp find the lines:and replace them with:This will take care of the “edit user” case.case We need to do the same for the “new user” case too. Just replacewith:The idea here is the following: instead of searching all code of all modulesmodules for links that point to the Your Info profile,profile we look at the parameters that such a link passes on the URL.URL A typical Your Info profile link is of the form:so the parameters it passes to the modules.modulesphp script are:name: the name of the module to execute (Your_Account)op: the operation to execute (edituser)The second URL parameter,parameter op, is checked at one single place in the code, in the switch statement of modules/Your_Account/index.php:index.phpThis is the one and only point of control for the actions taken by the Your_Account module. We make use of this fact and change the actions that are to be taken for the operations "edituser" and "new_user". We don't change the links, we change the actions that follow when the links are clicked. ]]> ]]> ]]> ]]> Inline graphic This will make the Your Info profile practically inaccessible in your systemsystem and will present the Forums profile instead. Missing functionality in the Forums profile! Bear in mind that, depending on the versions of PHP-Nuke and Forums, you may be missing some functionality in the Forums profile, that was present in the profile that was accessible through the Your Info link. This may include changing the fake email address, changing the subscription to the newsletter, or changing the extra info (). However, this is planned to be corrected in the future. How to redirect users to Login and backWe have already seen how to redirect users to the Login page (), to the Homepage () and to the Forum profile from the Your Info profile (). Finally, it is time that we consider the general redirection problem:You are using some module,module say an eCommerce module like the Emporium Shopping Cart (), and at some point you need to ask the user to login (if not already done) to finish off the order. You would like to redirect the user to the Login screen (), then bring him back where he was to continue.This is already implemented in PHP-Nuke at some places, like the Private Messages part of the Your Account module:module in the forums for example, if you aren't logged in, you see the link 'Log in to check your private messages', which when clicked on it, takes you to Your Account (address line becomes : http://www.yoursite.com/modules.modulesphp?name=Your_Account&redirect=privmsg&folder=inbox), and upon login in, you get taken back to PMs.To accomplish this from an arbitrary module,module that serves as the starting point for the redirection,redirection open that module's code and find the place where the redirection has to happen. Initiate the redirection with the following two lines:CLICK HERE TO LOGIN ]]>The value of $redirect is what you will key off in the next step. In this example we use the module name as the key that will point the way back, but you can use anything, as long as you know how to use it later, to trace your way back with the right link.Now go to modules/Your_Account/index.indexphp and look for the following code in the login() function:functionAdd the following after it:where XXXXXXXXX is the value of $redirect from the first step and YYYYYYYY is the name of the module you want them dumped into after login.loginYou might think that we are done by now, but there is a caveat: the above will work as long as they log in correctly on the first try. If they make a mistake and have to try a second or more times, they will get dumped in Your Account,Your Account after they log in successfully, not in the module they came from. This is also true for the Private Messages example above.To fix this, find the following code in Your_AccountYour_Account\index.indexphp at the bottom of the login function.and change it to:Then it will redirect even if they log in incorrectly the first time. See How to redirect. How to disable registrationIf you want to make registration of users impossible, you can apply a variation of the solution in : you can redirect the users to the main page (index.indexphp) whenever they try to register (e.g. by clicking on some registration link). Note that just by deleting the registration links from the code (see on how to find them), you still can't prevent a determined user from enteringin the URL box of his browser by hand, thus triggering the “operation new_usernew_user” in PHP-Nuke. By this, it becomes clear that a real solution must at least change the behaviour of PHP-Nuke for the value “new_usernew_user” of the op URL parameter.parameterAgain, instead of chasing links in the code, there is a more elegant solution:In modules/Your_Account/index.indexphp find the lines:and replace them with with:This will only disable registration from the Your Account module (more accurately: it will redirect every registration attempt to the main index.indexphp page).To disable it in the Forums too, edit modules/Forums/profile.profilephp. Findand change it to something like:i.e. we again redirect the user to the index.indexphp page. See also How to disable registration. It's also possible without programming! As so often in life, it all depends on what you want. You can of course achieve a similar effect, without any programming, if you make the Your Account module accessible to admins only, from the modules administration, in the administration panel. If you want users to be registered directly, without confirmation mails, see . If you want to approve every user who applied for registration,registration you can use the Approve Membership module (see ). How to let users register immediatelyWhen new users register, you may want them to be able to do so immediately, without having to wait for an email notification with an activation link. Do you trust your users? If you let everyone post without being registered, you will not have *any* data as to who wrote that inflammatory, libellous, pornographic or whatever post in your forum that caught FBI's attention. Thus you should really trust your users not to abuse your system, if you plan to bypass email notification on registration. You have two options, if you are not in the mood of programming it yourself ]]> ]]> ]]> ]]> Inline graphic : From the administration panel, Preferences, just choose that non-registered users are allowed to post. Then, from the modules and blocks administration panels, for each module or block you use, choose that all users are allowed to see it. That should come very close to what you want - that all users be able to use all parts of your site without registration. A module that allows the administrator to bypass email activation is NSN Your Account Tweak 650 3.0.2. According to the description, administrators can choose to bypass email activation. But the module offers a lot of other useful features around user management, see .See also Authorization and avatars. Download the right NSN Your Account Tweak version! Be careful with the version you download from this module! The number 650, for example, indicates that it is only for PHP-Nuke 6.5. Use only the version that is in accordance with your installed PHP-Nuke version, otherwise you are guaranteed to mess up your installation completely. See also the New User Auto Activation Hack and the Auto Registration Activation For Nuke v7.0. If you want to disable registration,registration see . If you want to approve every user who applied for registration,registration you can use the Approve Membership module (see ). How to approve users before registrationIf you want to enforce the opposite of what is described in , i.e. be able to approve each and every user before he is allowed to register, then you should have a look at the Approve Membership module.module See and Authorize accounts for more details.If you want users to be registered directly, without confirmation mails, see . If you want to disable registration,registration see . How to register users through iBillTheoretically, you could modify the Your Account module easily to accomodatedate for a registration through the iBill credit card option. You could proceed along the following lines (see Replacing registration with iBill credit card option):The iBill system essentially works by users entering information into the iBill script. The script would then connect to the web server and create an account in an .htaccess file () in the PHP-Nuke root directory. When a paid user account would expire,expire iBill's server could then remove the user account from the .htaccess file.With iBill controlling the .htaccess file, there would be no need for a Registration option in PHP-Nuke. The only thing that would be needed would be to change the code in block-Login.php, perhaps replacing the Register link with a link to a static html page, where the iBill sign up scripts would do the trick. Or you could just put the iBill code in a block and remove the Register option.There is no ready-made solution for this scenario yet, but the procedureprocedure outlined above points to the right direction. How to change the maximum allowed length for user namesThe standard maximum length for user names is 25 characters. If your users really pick up such long nicknames, they may break your blocks' layout,layout depending on your theme and resolution. This is because they may appear as authors of news articles etc. in headlines that appear in various blocks.To prevent your users from using long user names, you must change the maximum allowed length in modules/Your_Account/index.php,index.php in the function userCheck(). Find the line: 25) $stop = ""._NICK2LONG.""; ]]>and change the 25 to a lower length. A better programming style would be to define a constant for this and do the check against the constant. Modifying the <application>PHP-Nuke</application> News module

Administration panel: Add story. ]]> ]]> ]]> ]]> Administration panel: Add story. Administration panel: Add story. In this section we modify the PHP-Nuke News module,module which is also one of the most important ones:How to get rid of the need to use for new lines ().How to get rid of the need to use for new linesIt is one of the most annoying requirements for users who want to submit a News article to your site: they have to write the text either in BBcode,BBcode or in HTML.HTML While BBcode is easy to learn and use, HTML can be a real pain for the average Jo user. Worse yet, for sites that have disabled BBcode,BBcode HTML is the only available language for the aspiring journalist. Thus, a lot of people find themselves forced to write their articles with the editor of their choice, then export that document to HTML with the editor's own export function.function Although this scenario will not alleviate the need for a subsequent scrutinyscrutiny of the HTML code thus produced, for the purpose of locating and eliminating the HTML tags that are not allowed by the PHP-Nuke site (see ), it definitely has its merits, especially for long text.Those users however, who will rather opt for a quick entering of the text directly in the form fields, will most often be reminded the hard way, by a text totally lacking paragraph structure,structure that something is missing from their text: two break tags ( ) for the insertion of a blank line, something that is used intuitively to separate paragraphs. Even seasoned HTML coders will find themselves routinely omitting the obligatory tags, so a way to avoid the need for them is great help for both beginners and specialists alike.To eliminate the plague once for all, you only have to enter a 2-liner in the modules/news/index.indexphp file. Find the lines:and append the following two ones to them:Then, in the modules/News/article.articlephp, find the lines
"._NOTE." $notes"; ]]>
$bodytext$notes"; ]]>and add in 2 more lines, like this:The nl2br PHP function (newline to break) will automatically insert HTML tags (breaks) before every newline in the short ($hometext) and extended text ($bodytext) of the news article (see also How do I stop using the br tag, Linebreaks when entering text). Modifying the <application>PHP-Nuke</application> Submit News module

Administration panel: Submissions. ]]> ]]> ]]> ]]> Administration panel: Submissions. Administration panel: Submissions. In this section we modify the PHP-Nuke Submit News module:moduleHow to bypass article approval ().How to bypass article approvalThe standard workflow for a news article is that the user writes it, submits it for approval by the administrator,administrator the administrator reads it, approves and publishes it on the site. This has some advantages:Everybody can post, even anonymous users. Since the posts are checked, there is no risk of getting flooded with garbagegarbage posts.postsBut it also has some disadvantages too:Users have to wait to see their post published. This may not be what they expect, if actuality of content is highly important for the topics of your site.The administrators have to spend time on approving news articles. Waiting content () can be quite an administrative headache,headache if the site receives many user submissions a day (see, for example phpnuke.org,phpnuke.org where there are dozens of submissions awaiting approval at any given time).

Waiting Content block. ]]> ]]> ]]> ]]> Waiting Content block. Waiting Content block. Fortunately, to bypass article approval,approval the solution is relatively simple (see Automatic Article Posting):For versions before PHP-Nuke 6.5:6.5In the modules/Submit_News, in the function submitStory(), find this Change it to this:The story will get posted immediately, so you will want to make the Submit_News module only available to Users. Also, you will notice that it will now say “Posted By Some_user”, and it will no longer show in italics. For PHP-Nuke 6.5 and later, the solution is slightly different. Replace this:with this:You will also want to change the language file "defines", or edit these lines in the function submitStory (this is what is displayed when the submission is sent."._SUBSENT."

" ]]>"._THANKSSUB."

" ]]>"._WEHAVESUB." $waiting "._WAITING.""; ]]>The formatAidHeader() functionIf you want to make the “Posted By Some_user” also be a link to the User's profile,profile then you can edit the function formatAidHeader in your mainfile.php.mainfile.php The following refers to PHP-Nuke 6.5 and above.The function is simple: it takes an argument, the author id $aid, searches the nuke_authors table for that author id and, if found, it prints a link to the web page of the author. Only if the web page link fiels of nuke_authors is empty for that author, it prints a link to the author's e-mail (which is always there):sql_query($sql); ]]>sql_fetchrow($result); ]]>$aid"; ]]>$aid"; ]]>You could easily change this behaviour. For example, you could take out the check against the $url and leave only the e-mail part, if you wanted the “Posted By Some_user” to be an e-mail link, rather than a link to a web page (see Change Posted by... Name (Website) to Name (Email)):sql_query($sql); ]]>sql_fetchrow($result); ]]>$aid"; ]]>You could make it even more sophisticated,sophisticated by making “Posted By Some_user” a link to the user's profile (see for the related subject of user profile redirection). The formatAidHeader function should then be:sql_query($sql); ]]>sql_fetchrow($result)) { ]]>$aid"; ]]>$aid"; ]]>sql_query($sql); ]]>sql_fetchrow($result); ]]>$aid"; ]]> Modifying the <application>PHP-Nuke</application> Sections module

Administration panel: Sections. ]]> ]]> ]]> ]]> Administration panel: Sections. Administration panel: Sections. In this section we modify the PHP-Nuke Section module:moduleHow to order the articles in the Sections module ().How to order the articles in the Sections moduleSometimes you may not be satisfied with the order of articles in the SectionsSections module.module To change it, edit the following line of the modules/Sections/index.php:index.phpChange it toSee How to sort in Sections. Changing the order of results This is a typical example of changing the order of results of a database selection. This was achieved by solely adding "ORDER BY artid DESC" to the SQL query string. In plain text, this means "order the results by descending article id". The "right way" would of course be to sort by time. But lacking an extra timestamp field, we make use of the fact that later articles have a higher id. Thus, sorting by descending id will give last articles first. Think of this simple trick whenever you seek a simple way to change the order of some results. Modifying the <application>PHP-Nuke</application> Downloads module

Administration panel: Downloads. ]]> ]]> ]]> ]]> Administration panel: Downloads. Administration panel: Downloads. In this section we modify the PHP-Nuke Downloads module:moduleHow to add URLs longer than 100 characters in Downloads and Web Links ().How to add URLs longer than 100 characters in Downloads and Web LinksNot always is the database the sole culprit when you stumble upon an arbitrary limitation of the functionality: constraints are, for some obscure designsign reason, also eagerly set in the code of PHP-Nuke itself. A typical example of this situation, is the limitation of the URL length in the Downloads and Web_Links modules to just 100 characters. To remove this constraint you need to make changes to the database tablestables and the programming code. The database change consists of a MySQL command that changes the length of the relevant field. For the Downloads module,module the relevant field is the “urlurl” field in the nuke_downloads_downloads table, for the Web_Links module it is the “urlurl” field in the nuke_links_links table. To change its length, type on the MySQL command linefor the Downloads module,module andfor the Web_links module.module Changing the length of database fields If you don't feel comfortable with the MySQL command line, you can use a graphical user interface (GUI) for it, like phpMyAdmin (see ). But you can also pack the above commands in a PHP program: ]]> Upload it to your web server in the PHP-Nuke root directory (the one where config.php and mainfile.php are also located) and point your browser to it. The script even takes care to print a descriptive error message (a good programming practice), if an error occurs. But you are not done yet: for the length change to really take effect, you must change all relevant occurences of "maxlength"maxlength in the PHP code to reflect the new length of the field in the various HTML forms. This means searching not only the modules folder, but also the admin folder, for files related to the two modules and containing the string “maxlengthmaxlength”. For the Downloads module,module those are:EnumerateThe modules/Downloads/index.indexphp file:
"; ]]>

" ]]>The admin/modules/download.php file: [ "._CHECK." ]
" ]]>
"; ]]> [ "._CHECK." ]
" ]]>For the Web Links module,module they are:The modules/Web_Links/index.indexphp file:
"; ]]>

" ]]>The admin/modules/links.php file: [ "._VISIT." ]
" ]]>
"; ]]> [ Visit ]
" ]]> [ "._VISIT." ]
" ]]> Search for "maxlength" thoroughly! If it still does not work, then you forgot to change "maxlength" somewhere - perhaps in a file under the admin folder. Search thoroughly! Modifying the <application>PHP-Nuke</application> Stories Archive module

Administration panel: Add story. ]]> ]]> ]]> ]]> Administration panel: Add story. Administration panel: Add story. In this section we modify the PHP-Nuke Stories Archive module:moduleHow to order the articles in the Stories Archive module ().How to order the articles in the Stories Archive moduleSometimes you may wish a different order of articles in the Stories module.module To change the article order so that the articles appear in alphabetical topic order, instead of a LIFO (last-in-first-out) order, edit the following line of the modules/Sections/index.php:index.phpChange it to (see Sorting the Stories Archive by Topic first): Changing the order of results This is a typical example of changing the order of results of a database selection. This was achieved by solely replacing "ORDER BY sid DESC" with "ORDER BY topic ASC" in the SQL query string. In plain text, this means "order the results by ascending topic". Whenever you are not satisfied with the order of your results, you will know that you have to add or change an ORDER BY clause to an SQL query string somewhere in your module. Of course, you will still have to find where, but hopefully there will be only a few calls to sql_query() in the code, so that, in the worst case, you could try them all and find the one that works. Modifying the <application>PHP-Nuke</application> administration panel

Administration panel. ]]> ]]> ]]> ]]> Administration panel. Administration panel. This chapter is devoted to modifications of the administration panel - a rather exotic topic, but with interesting applications:ationsHow to set an arbitrary "Stories Number in Home" (),How to allow HTML in the Newsletter ().How to set an arbitrary "Stories Number in Home"

Administration panel: Preferences. ]]> ]]> ]]> ]]> Administration panel: Preferences. Administration panel: Preferences. You want to display only, say, 3 News on the hopepage of your PHP-Nuke. But in the administration panel you get only the options to change the "Stories Number in Home" to 5, 10, 15, 20 , 25 and 30.Go to admin/modules/settings.settingsphp and change at line 61Line numbers are subject to change. If you don't find what you expected, search for it. ]]> ]]> ]]> ]]> Inline graphic :" ]]>" ]]>$storyhome" ]]>3" ]]>5" ]]>10" ]]>15" ]]>20" ]]>25" ]]>30" ]]>" ]]>Now you can select "3" from the drop-down list. You get the idea. See How to set an arbitrary "Stories Number in Home". Creating <application>PHP-Nuke</application> blocks

Administration panel: Blocks. ]]> ]]> ]]> ]]> Administration panel: Blocks. Administration panel: Blocks. Having seen how to modify a PHP-Nuke block (), we can gradually try our skills in creating one. We proceed by showing:The characteristics of the various types of blocks (),How to create a new block (),A simple Content block (),How to include PHP/HTML files in a PHP-Nuke block (),How to use Javascript in PHP-Nuke blocks (),How to display Flash in PHP-Nuke blocks (),How to show advertisements in PHP-Nuke blocks (),How to display images in PHP-Nuke blocks (),How to display HTML forms in a block:block Paypal ().The characteristics of the various types of blocksThere are 3 different types of PHP-Nuke blocks:RSS/RDF:RDF They capture news that's available from other sites in standard reading format, i.e. text (For example the site spaghettibrain has a lot of news that are at other sites' disposal).Blocks of contents:contents blocks in which we insert simple text or HTML text that will be then displayed inside the block (See following example)Blocks of files: They are PHP scripts that execute fixed commands (see )In this paragraph we will see a simple example of how to insert the links and the text in a text block.block If you already know a little HTML there is no point in following this example.We suppose you want to insert a block with text and a link to 3 different sites:The Webmaster who wrote this book manages the following sites:spaghettibrain.comspaghettiopen.comspaghettipython.comThe text will be formatted in this way in order to be inserted in the blockblock (see ): webmaster who writes this book manages the following sites:
]]>spaghettibrain.com ]]>claudioerba.com ]]>
Block example ]]> ]]> ]]> ]]> Block example Block example
Some Small HTML lessons: It is for bold text, it opens a tag. All words that we write after this tag will be bold until (which closes the tag). It is for a page break, it does not need to be closed.<ahref="http://siteyouwant.com">SiteName</a> is used to open the http://siteyouwant.com. How to create a new blockTo create a block of the third type, i.e. a php script that interfaces with the database and extrapolates the data,data first of all we have to understand how these blocks are structured. They are contained in a folder called blocks, the name of the block must be block-blockname.php. It is very important all blocks start with “block-” . Every block in which the name will start with block- will be included in the screen of the blocks that can be activated.activated We will find in the blocks administration menu all the available blocks in the file_name drop-down list. If not assigned by the administrator,administrator the name will be the same that follows block- We can't use break spaces in a block name, they must be replaced by using underscore _ . All the blocks that will respect these rules will be inserted in the blocks admin menu.menuWe describe:How to create a block,block theoretical approach (),How to create a block,block a practical example ().How to create a block, theoretical approachYou have to follow these rules when creating a block:blockIn every block you create you have to insert the following code at the beginning:By using this code you protect the file avoiding users approaching it directly from the blocks folder, and the block will be displayed only when selected from your site. In the blocks you can include everything you want, Perl, java, php, flashflash etc...All the block output must have a value that can be obtained from the variable $content.Remember that you have a limited amount of space in the block,block pay special attention to the layout! Warning In order to have W3C standard compatible blocks, Francisco Burzi says:
"To respect the W3c standards for HTML 4.01 Transitional,Transitional it is very important that you replace all "instances of &" in the URL by the tag "& "
For example the URL: ]]>must be written: ]]>and don't use, for example, the tag "li" (used to create a list), but leave that in the style sheet (CSS) which will make it for you. The background for the tables and font etc., are better left to the style sheet (CSS).We will now see how to construct a block starting from the beginning. How to create a block, a practical exampleWe will make a very simple block that shows the pages visited in our site the day before. We'll have a single query and a single value, in order to make things easier. Our block is called "hits", so the complete name of the block will be block-hits.phpFirst of all, we open the php tagThen we insert the protection script we've seen before:And now we insert the variables that we want to call (in this case the parameterparameter $prefix and $dbi, which handles the database abstraction): Now we continue inserting the query that reads from the database how many pages were seen in our site: (the instruction would be “read the first line value of the table nuke_counter in the cell count”) Finally, we pass the “$content” variable that will be echoed by the block and close the PHP tag: ]]>Our complete script will be : ]]> Simple Content block
Administration panel: Content. ]]> ]]> ]]> ]]> Administration panel: Content. Administration panel: Content.
PHP-Nuke comes with a Content module (). But how about a Content blockblock? How to display links to Content pages in a PHP-Nuke block?block A block may be desirable in case you wish to place a link summary of the Content module's er...content, somewhere in the left, central or right columns.After you have created the desired categories for the Content module,module you can then go to http://yoursite.com/admin.php?admin.phpop=content and start adding pages to the categories. To find out the link to these pages, you will have to click on the ContentContent link in the modules block,block view each page and copy its url from the browser's address window, then just add these urls to a html block with maybe the following HTML code:·

]]>Page Title 1
]]>·

]]>Page Title 2
]]>·

]]>Page Title 3
]]>·

]]>Page Title 4
]]>·

]]>Page Title 5
]]>A block that does the job is the following:·

]]>Page Title 1
"; ]]>·

]]>Page Title 2
"; ]]>·

]]>Page Title 3
"; ]]>·

]]>Page Title 4
"; ]]>·

]]>Page Title 5
"; ]]> ]]>Name it block-Content,Content put it in the blocks folder, then "create" it in the blocks administration (see ). How to include PHP/HTML files in a <application>PHP-Nuke</application> blockSuppose you want to write a block,block block-bar.php, that includes the file foo/bar.php. The way PHP-Nuke displays a block is that it first includes the block,block with a statement like then makes a table and puts in the title,title and makes another table row, and "echo"es the $content variable. Thus, the $content variable must contain all the output of foo/bar.php, if your block has to contain its output. The PHP output control functions come in here very handy. The PHP output control functions allow you to control when output is sent from the script. This can be useful in various situations,ations especially if you need to send headers to the browser after your script has began outputting data.data The output control functions (or output buffering functions, as they are often called and as the ob_ prefix in their name suggests) do not affect headers sent using header() or setcookie(), only functions such as echo() and data between blocks of PHP code.Output buffering is a powerful tool in PHP which allows you to buffer a script's output. You can even edit this buffer before returning it to the client. The PHP functions that constitute the output buffering toolbox are:ob_start([callback function]) - Starts an output buffering session.sessionob_flush() - Send the contents of the buffer to the client and clear the buffer.bufferob_get_contents() - Returns the contents of the buffer.buffer The buffer is not cleared. ob_end_clean() - Ends the current buffering session and purges the buffer.buffer ob_end_flush() - Ends the current buffering session and displays the buffer.bufferob_get_length() - (Version >= 4.0.2) Return the size of the current buffer.buffer ob_get_clean() - (Version >= 4.3) Composite of ob_get_contents() andob_end_clean(). The buffer is returned and the session ends.How can we use output buffering to include the output of foo/bar.php in our PHP-Nuke block?block The idea is simple: rather than having PHP send output directly to the standard output device (the browser) as the script gets executed, we will define a special output buffer which stores all the output generated by the script during its lifetime. When we do this, the output of the script is never seen by the user unless we explicitly make the contents of this buffer visible via a call to PHP's output control API (through one of the above functions). We put the foo folder in the main phpnuke directory, and use this code our block:blockThis way the $content variable will contain the output of foo/bar.php, which will thus be shown in the block.block To learn more about PHP output buffering,buffering see Output Buffering with PHP and PHP Output Buffering tutorial. See also Scripting a new Block Problem, for a complete example of including a PHP scoring application in a PHP-Nuke block.block How to use Javascript in <application>PHP-Nuke</application> blocksJavascript can be used with PHP-Nuke without problems, as long as you remember that they operate in different environments (see Frames, JavaScript, and PHP Overview):PHP-Nuke, like PHP,PHP is server side. Therefore, if you want to pass data from a form to PHP-Nuke, you have to submit it and load the page again. There is no getting around it.Javascript is client side (run in the browser), and can help you with dynamicdynamic functionality.functionality You can easily use JavaScript and PHP-Nuke together. However, just like PHP,PHP PHP-Nuke knows nothing about Javascript.Javascript PHP-Nuke will just echo the Javascript code to the HTML page, just as it would echo the value of a string variable.Thus, from the point of view of PHP and PHP-Nuke, there is no difference between ]]>and ]]> ]]>'; ]]> ]]>They both echo strings,strings of which the first one is simply displayed in the client's browser as a welcome message, while the second one is interpreted by the client's browser and leads to the browser sending a request for the News module,module which in turn sends the usual home page of a PHP-Nuke site to be displayed on the client.With this in mind, Javascript does not demand any special treatment when used in PHP-Nuke blocks. Just append the Javascript code to the $content variable of the block and you are done. Of course, you have to escape double quotes - and it is a good idea to add a newline (\n) to the end of each Javascript line (see Javascript and BLOCKs). If you use sed, the following sequence of sed commands, applied to a Javascript file, will produce the right PHP code to include in the PHP-Nuke block:block 1,$s/"/\\"/g 1,$s/^/\$content \.= "/ 1,$s/$/";/ 1,$s/";$/\\n";/ Escape all double quotes. Add the string '$content .= "' at the start of every line. Add the string '";' at the end of every line. Add a newline \n at the end of each JS line. You can put them in a file, sedscr,sedscr and tell sed to read sedscr for commands, while editing the original Javascript file (javascript): block-Javascript.php ]]>Of course, you can use vi () too - see for a similar example - or just do the substitutions manually. The examples in this section demonstrate what you have to do (see also Javascript in a PHP-Nuke block):How to create a Hello World block (),How to create a fade block (),How to create a Help Center Live block ().How to create a Hello World block

Hello World block with Javascript. ]]> ]]> ]]> ]]> Hello World block with Javascript. Hello World block with Javascript. We will start with a very simple block,block one that just displays “Hello World”. Once you get the idea, you will be able to construct any Javascript blockblock for PHP-Nuke - they all follow the same rules.rulesWe will keep the Javascript code in a separate file, say hello-world.php,hello-world.php in the PHP-Nuke includes directory. The includes directory is a natural place for it, because it also contains the javascript.javascriptphp file (see ). You can use the javascript.javascriptphp file to store your own Javascript functions (as shown in Javascript in a PHP-Nuke block), but for this simple example, hello-world.php is more than enough. It contains only a few lines: ]]>Now, create a block,block block-Hello_World.php, in the blocks folder that contains:"; ]]> ]]>As you can see, block-Hello_World.php loads the hello-world.php from the includesincludes folder as a Javascript code. hello-world.php,hello-world.php in turn, is executed and echoes the document.write command in the HTML file that is sent to the client's browser. When a the browser receives it (and has Javascript enabled), executes the code writing the "Hello World" message in the place it was called - in the Hello World block.blockUsing this technique, you can create blocks that are very rich in functionalityfunctionality - just echo their code with a PHP file and call that file as JavascriptJavascript code from the block.block See for a non-trivial example. How to create a fade blockSo you have seen this cool fade effect on a site and you decided to incorporatecorporate it in a PHP-Nuke block on your site too? I mean that effect that makes the image fade gradually away, when you pass over it with the mouse cursor - and comes again gradually back the next time you revisit it with the mouse cursor. Before you plunge into this, consider that it is just an effect - and one that will work only with Internet Explorer.Explorer If you still feel you must have it, here is the PHP-Nuke block that demonstrates this fade effect: \n"; ]]> destOp){ \n"; ]]> \n"; ]]>

"; ]]> ]]>This is an adaptation of the Dynamic Highlight II Script, by J Mark Birenbaum,Birenbaum that just appends the Javascript code in the $content variable of a PHP-Nuke block.block You can adjust some parameters, such as the transparency level, the time between trasparency changes and amount of change each time - see the commentscomments in the script's code. You should of course at least adapt the image source file (images/xxx.pngpng in the code) to your situation. How to create a Help Center Live blockWe will now move on to consider a block that can integrate the whole functionality of a Help Center:Center the Help Center Live block for PHP-Nuke. Help Center Live is an Open Source Application that is distributed under the GNU Genreal Public License (GPL). It helps you build a real support department for your business.business With Help Center Live you can:Create online accounts for your departments.Create online accounts for your support operators and assign them to departments.Create FAQs for your customers.customersIf an operator is online, he can see which hosts currently view the company's page and can initiate chat sessions with those hosts.If someone from a support department is online (has logged in Help CenterCenter Live), the visitors browsing the company's page can see this and initiate a chat session with that support person. Thus, a customer can directly contact support personnel and seek a solution to his problem.At the end of the chat session,session a transcript of the session can be sent to the participants, at e-mail addresses of their choice. If nobody from the support department(s) is online, the visitor still has the possibility to issue a trouble ticket.ticketTrouble tickets are tracked through a database and there exists a sophisticatedsophisticated backend for dealing with them.How can you incorporate all this functionality into your PHP-Nuke site?At first, you must install Help Center Live on our site, or, if we only want to test it, local system.system For this, download the package from Help Center Live and extract its contents into some folder of your web root,root say under /helpcenter. Then you must edit the config.configphp file in the inc directory of that folder with the decent text editor () of your choice. There are various parameters you can set up there, but the most important are the $URL_* onesas well as the DB_* ones:The $DB_host, $DB_user, $DB_pass and $DB_name variables could be the same as the $dbhost, $dbuser,dbuser $dbpass and $dbname variables in config.php respectively (see ), although not necessarily so. Terminate the DB_prefix with an underscore! If you use a $DB_prefix, make sure it ends in an underscore (_), otherwise it will be directly concatenated with the table names, rendering them difficult to tell apart. The $URL_site, $URL_dir and $URL_secure variables are only used in calls to the PHP setcookie() function:Calls to setcookie() like the above are scattered throughout the code - lists all files and lines containing such calls. If you experience the infamous login loop problem, it is probably because the setcookie() function was not able to set the cookie on the client. ]]> ]]> ]]> ]]> Inline graphic Help Center Live: setcookie() calls File setcookie() call cp/logout.php setcookie("HelpCenterLiveOperator", $LOGIN_username, $time, $URL_dir, $URL_site, $URL_secure); cp/logout.php setcookie("HelpCenterLivePassword", $LOGIN_password, $time, $URL_dir, $URL_site, $URL_secure); cp/login.php setcookie("HelpCenterLiveOperator", $LOGIN_username, $time, $URL_dir, $URL_site, $URL_secure); cp/login.php setcookie("HelpCenterLivePassword", $LOGIN_password, $time, $URL_dir, $URL_site, $URL_secure); lh/live_request.php setcookie("HelpCenterLiveGuest", $REQUEST_name, $time, $URL_dir, $URL_site, $URL_secure); lh/live_request.php setcookie("HelpCenterLiveGuest", $REQUEST_delname, $deltime, $URL_dir, $URL_site, $URL_secure); lh/live_request.php setcookie("HelpCenterLiveGuest", $REQUEST_name, $time, $URL_dir, $URL_site, $URL_secure); lh/live_mail.php setcookie("HelpCenterLiveUser", $LOGIN_username, $time, $URL_dir, $URL_site, $URL_secure); lh/live_mail.php setcookie("HelpCenterLivePass", $LOGIN_password, $time, $URL_dir, $URL_site, $URL_secure); tt/user_register.php setcookie("Help Center LiveUser", $REGISTER_username, $time, $URL_dir, $URL_site, $URL_secure); tt/user_register.php setcookie("Help Center LivePass", $REGISTER_password, $time, $URL_dir, $URL_site, $URL_secure); tt/user_login.php setcookie("HelpCenterLiveUser", $LOGIN_username, $time, $URL_dir, $URL_site, $URL_secure); tt/user_login.php setcookie("HelpCenterLivePass", $LOGIN_password, $time, $URL_dir, $URL_site, $URL_secure); tt/user_logout.php setcookie("HelpCenterLiveUser", $LOGIN_username, $time, $URL_dir, $URL_site, $URL_secure); tt/user_logout.php setcookie("HelpCenterLivePass", $LOGIN_password, $time, $URL_dir, $URL_site, $URL_secure); tt/user_info.php setcookie("Help Center LiveUser", $INFO_username, $time, $URL_dir, $URL_site, $URL_secure); tt/user_info.php setcookie("Help Center LivePass", $INFO_password, $time, $URL_dir, $URL_site, $URL_secure);

This happens if, for example, you are installing Help Center Live locally, and the host name for $URL_site is taken from a hosts file and not from DNS.DNS One way to get around this is to change all calls to setcookie() listed in and take out the last two parameters, $URL_site and $URL_secure, as in the following example:After the installation of Help Center Live, you can point your browser the the address you entered for $URL_maindir (http://midas/helpcenter, in our example) and, after a successful login,login you will be presented with the main screen ().

Help Center Live: Main screen. ]]> ]]> ]]> ]]> Help Center Live: Main screen. Help Center Live: Main screen. Now, create a PHP-Nuke block that uses the method of our Hello World example in to incorporate Help Center Live's functionality:functionality"; ]]> ]]>We named the block above "block-Online_Support"block-Online_Support, but of course you can use whatever title you like, as long as it is passed as the "needle" string to the eregi() function of the block.block The main code consists of only one line, which inserts a Javascript code, whose source file is the lh/live.php PHP script of Help Center Live. We did the same in to output a Hello World message, but now, this simple line opens a whole world of possibilities for our PHP-Nuke page! Let's see what happens when we activate the Online Support block we just created:As long as all Help Center operators are logged off, the block will display a “Live Support is Offline” message, as in .

Help Center Live block: Live Support is Offline. ]]> ]]> ]]> ]]> Help Center Live block: Live Support is Offline. Help Center Live block: Live Support is Offline. In this case,case a click on the arrow in the block's inside will open a window that gives the customer the possibility to enter a trouble ticket (). The window also offers a link to the FAQ and offers the choice to refer to an existing trouble ticket or create a new one.

Help Center Live block: Creating a trouble ticket. ]]> ]]> ]]> ]]> Help Center Live block: Creating a trouble ticket. Help Center Live block: Creating a trouble ticket. On the other side, if some support operator is online and has launched the request monitormonitor (which opens a window for the operator,operator displaying the live connections he is currently maintaining), the block will display it with a “Live Support is Online!” message ().

Help Center Live block: Live Support is Online. ]]> ]]> ]]> ]]> Help Center Live block: Live Support is Online. Help Center Live block: Live Support is Online. The request monitor,monitor on the operator's side, will display all hosts that are currently viewing the PHP-Nuke page with the Online Support block showing the “Live Support is Online!” message (). In other words,words both users and operators are informed of each other's online presence.

Help Center Live block: Request monitor for the operator. ]]> ]]> ]]> ]]> Help Center Live block: Request monitor for the operator. Help Center Live block: Request monitor for the operator. Now - and this adds a tremendous value to that tiny block we just created - each side can initiate an online chat with the other part:The operator can click on the “Initiate” link and, after selecting the aproppriate department, initiate a chat with the selected user. The user will get pop-up window, notifying him of the operator's wish for a chat (). The user can then decide whether to accept or decline the chat request.

Help Center Live block: User notification of the operator's chat request. ]]> ]]> ]]> ]]> Help Center Live block: User notification of the operator's chat request. Help Center Live block: User notification of the operator's chat request. On the user's side, everybody can click on the arrow besides the “Online!” message in the Online Support block.block This will initiate a chat request on behalf of the user (). The operator will get a pop-up window notifying him of the user's request, which he can accept or decline as well.

Help Center Live block: User chat request. ]]> ]]> ]]> ]]> Help Center Live block: User chat request. Help Center Live block: User chat request. Either way, initiating from the operator's or user's side, a chat sessionsession starts between the two, hopefully leading to the solution of the user's problem. A transcript of the chat can be sent to an e-mail address of the participant's choice for future reference.This completes our brief review of Help Center Live's features.features If you have a look at the code of the Online Support block above and the code of the Hello World block in , you will see that they both use the same method to incorporate functionalityfunctionality in a PHP-Nuke block through Javascript.Javascript The method is the same, but what a huge difference in functionality! There, a simple “Hello World” output - here, a full-featured Help Center! This demonstrates the broad spectrum of possibilities that a simple line like"; ]]>can offer, when used intelligently in a PHP-Nuke block with Javascript.Javascript Help Center Live is looking for a sponsor! HCL is getting well over a million hits per month and its on a huge increase keeping in mind that Fantastico now has HCL as a featured script for install. Mike, the developer of HCL, offers it under the GPL - however, he is looking for sponsor to help him continue its development for free and cope with the ever-increasing hosting fees and other expenses. Please contact Mike, if you are interested and serious about sponsoring HCL. How to display Flash in <application>PHP-Nuke</application> blocksTo show Flash in a PHP-Nuke block,block you simply have to include the appropriate HTML code in the $content variable. Since the HTML code is something like ]]> ]]> ]]> ]]> ]]>the PHP-Nuke block code should be something like " ]]> " ]]> " ]]>" ]]>"; ]]>See on how to display Flash in the PHP-Nuke header, like a banner.banner How to show advertisements in <application>PHP-Nuke</application> blocksAdvertisements are a popular source of revenue for webmasters. It doesn't take long until the young webmaster feels attracted to the sirene call of affiliate programs, banners or context relevant advertising. Advertisements are often created through the use of a Javascript function,function called at the right place in the HTML code. We have already treated the subject of Javascript in PHP-Nuke blocks (see ) and modules (see ) and seen that Javascript does not pose any special problems with PHP-Nuke. However, due to the increasing popularity of Google's AdSense program, there has been an increasing demand for ready-to-use solutions in the PHP-Nuke field. The following code examples should be seen as representative examples of how such advertising functionality can be incorporated in PHP-Nuke blocks. You can use them as starting point for similar advertising solutions, as offered by today's modern search engines or affiliate programs. Ready-to-use Google AdSense Block If you don't feel like writing your own Google AdSense block, just use a ready-made one! Go to http://home.vie4life.com/downloads-cat-13.html and download a ready-to-use AdSense block. Create a block called block-AdSense.AdSensephp and add the following in the file: ]]> ]]> ]]> ]]>"; ]]> ]]> Don't forget: Add your Google client number in the script. Activate the AdSense block in your administration panel (see ) by clicking on the “BlocksBlocks” links and choosing it from the blocks list as a new block.block How to display images in <application>PHP-Nuke</application> blocksBlocks offer a quick way to incorporate content in PHP-Nuke. They are happily used to display images,images since they can be placed anywhere in the three layout columns - and their position can be comfortably changed from the administration panel.panel A very common use of blocks in PHP-Nuke is to display dynamicdynamic images,images i.e. images that change depending on some parameter of dynamic nature,nature most offen time: a daily quote, a daily weather forecast or a daily comic.comicMost of the time you will not be the original author of the quote, forecastforecast or comic.comic You will want to fetch this content from some popular source on the Internet.Internet Before you proceed: think on copyright! We will describe the tecnology that allows you to use somebody else's work to make your site more beautiful, attractive or informative. This almost certainly touches that person's copyright. Please take the time to read the admonition on copyright in ! PHP enables you to read a remote URL,URL store its whole content in one (!) variable, then search the contents of the variable for any regular expression (for regular expressions, see ). We will use this technique to find out the filename of the User Friendly daily comic strip,strip in order to display it in a PHP-Nuke block. This UserFriendly block reads the User Friendly daily cartoon page line by line, searches for the patternpatternwhatever ]]>extracts the location of the image file (imagefile) from it and displays it in the block.block The PHP code of the User Friendly block is a classic example of how you can do this “scrappingscrapping” in PHP (-Nuke): ufurl: $ufurl
";]]> could not be opened
";]]> .*", $line, $out)) {]]> ";]]> $\"User$ ";]]> ]]> This is the standard check at the start of every PHP-Nuke block: if the name of the script, as it was called by the user, contains the full name of the block, then the user must have called the block directly. In this case we redirect him to the home page. As with modules, a direct call of a block not only will not work, it will also bypass all security measures of PHP-Nuke (see for example ). The URL of the remote page containing the dynamic image. Initialization of the image filename. We open the remote page for reading ("r"). This operation returns a "file handle", a unique identifier for the opened file, which is stored in $textfile. If the opening operation failed, we output an error message in the content variable of the block and quit. If the opening operation succeeded, we start reading the content of the remote page in a loop, line-by-line, until the end-of-file (eof) character is encountered. We only read 1500 characters at a time. This is more than enough for our purposes. This is where all the magic takes place! We search the line we just read for occurences of a regular expression. The expression itself means whatever<IMG ALT="Latest Strip"whateverSRC="imagefile">whatever where "whatever" may be any content, including space. The regular expression contains a subexpression in the place of the image filename. This results in the file name being stored in the $out array, as its first element. We copy the first element the $out array to the $imagefile variable. By construction of the regular expression above, $imagefile now contains the image filename of the daily comic strip. We only have to display it! We echo an image anchor using as source the filename we just "scrapped" from our source page. This displays the daily comic strip without fetching the image to our web server (hot linking!). A similar technique is used in news aggregators,aggregators like the MyHeadlines module (see ), that “scrap” news sources for pieces of dynamic information that are not otherwise available (i.e. not available as RSS/RDF news feeds), see Template Based Scraping. For each source page, a regular expression is stored in a table. Its subexpressions will automatically store the dynamic information pieces that are of interest to us in the elements of some $out array. We would then only have to display those elements for each source. Quod medicina aliis, aliis est acre venenum<footnote><para>One person's medicine is another's foul poison.</para></footnote> If you are an artist whose images are being hot-linked with the above methods without your permission, you are certainly not excited. But don't despair! You can defend your work with a simple technique that requires only the Apache mod_rewrite module and a few lines in your .htaccess file. See . How to display random images in <application>PHP-Nuke</application> blocksWe now move to a more advanced example of a PHP-Nuke block:block a block that displays random images.images Suppose you have a collection of images in a directory of your webserverserver and would like to display a random image each time in a PHP-Nuke block.block Using PHP-Nuke's own positioning capabilities for blocks (in the administrationadministration panel,panel from the “BlocksBlocks” link, see ), you can achieve an almost arbitrary positioning of random images in your page - a functionality that could be used to display whatever visual content you like, ranging from a “daily babebabe” to a random skyscraper banner.bannerTo create a random image block for PHP-Nuke, proceed as follows (see Random Picture Block):Make a script called block-RandomPics.php and put it in the blocks folder. The code for block-RandomPics.php is:read()) { ]]>handle); ]]>"; ]]>

"; ]]>
"; ]]> ]]>The block-RandomPics.php block reads all .gif's and .jpg's from the $whereimgs directory into an array ($imglist), computes a random index between 0 and the maximum array index ($a) and uses the random index to select an image name from the array. It then writes some HTML code to display a thumbnail of 120 pixels width with a ling to the original picture. The link itself passes the show parameters on the URL as the concatenationconcatenation of the $whereimgs directory and the random image name ($image) to a script we still have to write, PicShow.php.PicShow.php The right images path Taking into account that block-RandomPics.php has to be located in the blocks folder, then, if your images folder is the folder “pictures” under the “PHP-Nuke root” directory (i.e. under the same directory where mainfile.php, index.php, config.php etc. are located), then you have to prepend a “../” to “pictures”, as we did in the code, assuming that you don't want to give an absolute, fully qualified URL there. For PicShow.php,PicShow.php which is the script that will show the full image, we have to write code that behaves just like a standard PHP-Nuke module (but without any administration functions), so you can see it as an example of a minimal module:module

Go back!

]]>

]]>"; ]]> ]]> How to display HTML forms in a block: PaypalA lot of sites have a block,block asking for donations through PayPal. It is easy to construct your own, all you need is get an account from PayPal,PayPal then construct an HTML form that contains your data,data for example: ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]> ]]>The meaning of the form fields is the following:cmd: Must be set to "_xclick" (required).business:business This is your PayPal ID, or email address, where payments will be sent. This email address must be confirmed and linked to your Verified Business or Premier account. (required).item_name:item_name Description of donation (maximum 127 characters). If omitted, donor will see a field in which they have the option of entering an Item Name (optional).amount: The price or amount of the purchase, not including shipping, handling, or tax.tax If omitted, this value will be editable by the buyer at the time of purchase (optional).no_note: Including a note with payment.payment If set to 1, your customer will not be prompted to include a note. If omitted or set to 0, your customer will be prompted to include a note (optional).currency_code: The currency of the payment.payment Defines the currency in which the monetary variables (amount, shipping, shipping2, handling, tax) are denoted. Possible values are USD (U.S.U.S. Dollar), EUR (Euro), GBP (Pound Sterling), CAD (Canadian Dollar), JPY (Yen). If omitted, all monetary fields will be interpreted as U.S.U.S. Dollars (optional).tax:tax Transaction-based tax override variable. Set to a flat tax amount you would like to apply to the transaction regardless of the buyer s location. If present, this value overrides any tax settings that may be set in the seller s Profile. If omitted, Profile tax settings (if any) will apply (optional). PayPal hyperlink variables There are many more hyperlink variables that you can use in your PayPal block, covering all aspects of a donation transaction. You should consult the PayPal Donations Manual, to learn about all the possibilities!

PayPal donation button ]]> ]]> ]]> ]]> PayPal donation button PayPal donation button Pasting the code above into your website would generate a button that looks like . To create a block out of this HTML Form, all we have to do is add the obligatory check for the block name, transform all lines to strings and append them to the $content variable, taking care to escape all double quotes between the string quotes:quotes"; ]]>"; ]]>"; ]]>"; ]]>"; ]]>"; ]]>"; ]]>"; ]]>"; ]]>"; ]]> ]]>Put the above code in a file called block-Donations.ationsphp in the blocks folder. Then, just activate and position the block from the blocks management link in the administration panel.panel

PayPal donation block. ]]> ]]> ]]> ]]> PayPal donation block. PayPal donation block. Depending on your theme,theme the block will look as in . You can experiment with various button images from the PayPal site. For more information on donations with PayPal,PayPal see the PayPal Donations Manual. Creating modulesAfter having seen how to modify PHP-Nuke modules,modules we are in a position to try our skills at creating one - in this chapter we will show you how! We cover:Module structure (),The rules to follow (),Module creation, the public part (),Module creation, administrator part (),How to include a HTML file in a PHP-Nuke module (),How to include a HTML file and its links in a PHP-Nuke module (),How to include a HTML file and its links using an iframe in a PHP-Nuke modulemodule (),How to include a plain text file in a PHP-Nuke module (),How to use Javascript in PHP-Nuke modules (),How to create a Logout module (),How to show advertisements in PHP-Nuke modules (),How to display HTML forms in a module ().Module structure The PHP-Nuke modules are PHP-written applications that manage the central part of the site. For example, the “News”, “ForumForum”, “Members List” etc. are all modules.modules Each module, based on it's complexity,complexity is structured using one part for the user's and another for the administrator,administrator in this case there are some contents we have to modify. It's all managed from the modules.modulesphp file which alone, carries out the job of authentication and management of the access rights on that module.module The modules.modulesphp file checks and verifies if the module was activated or not, and verifies the access rights. This saves us a lot of work because we don't have to insert these controls in every module we create.We refer you to what is written in to be more exhaustive.For example in the avantgo module, in order to load the index.indexphp file, it's enough to pass the module name to the parameter string, the file that will be searched for is index.php.index.phpIf instead we wanted to call a page different from the default index.phpindex.php (say, print.php), the string we will have to pass is :That is the file variable with a value (print) that corresponds to the name of the file we want to load without the .php extension. Inside of the folder modules/nameofmodule there is also a subfolder called "language". In this fashion we manage in a simple and immediate way the multilanguagemultilanguage functionality inside the modules.modulesThe rows modules.modulesphp work in this way:It includes the mainfile.phpmainfile.phpVerifies if the module is activeVerifies whether the string passes a file name different from index.phpindex.phpVerifies the permissions of the module (whether everybody can see it, or only registered users, or only the administrator). Creating fully compatible modules: the rules to followFor people who have a base knowledge of the PHP language it is very simple to construct a module.module Generally to create a PHP-Nuke module means:To create PHP files for the users, ie the public part of the siteTo create an administrator interface To verify that everything we have created is in keeping with the PHP-Nuke development rules.rulesBut what about the development rules?rules It is a good idea to stop on this point before continuing on to the programming part.Rule:Rule the modules must be included in the folder modules/namemodule in the public part and the folder admin/modules in the administration partRule:Rule the main file of the module included in modules/nameofmodule must be called index.phpindex.phpRule: the tables in the php syntax are indicated by prefix.prefix For example Nuke pages will be indicated with "$prefix."_pages, where $prefixprefix takes the value from the config.configphp file which is nuke by default.Rule:Rule the location of the images or links must start from the root of your html directory and not from the folder modules/nameofmodule because the files contained in it are included in a file placed in html's root directory that's called modules.modulesphpRule:Rule to manage the multilanguage function in an optimal way we have to create some text abstractions that we will insert in the files by making a folder called “language” inside the folder of the module.module Everything will then be automatically recalled. For example, if we need to create a module that we call Topolino (the ItalianItalian name of Mickey Mouse) we must give the possibility to those who use the Italian interface to read "Topolino"Topolino and to those who use the English one to read "Mickey Mouse" ; -).How do we do it?First of all we create the folder “language” inside the folder modules/topolino We insert in this folder two php files that we will call lang-italian.php and lang-english.php We create an abstractionabstraction for topolino,topolino in the lang-italian.php it will be: And in English it will be:In this way inserting in the module the abstraction "_TOPO" this will be automatically replaced by Topolino in the Italian interface and by Mickeykey Mouse in the English interface.interface Module creation, the public partWe continue using the example of Topolino from and create a very simple module that displays a GIF of Topolino with a list of 3 predefined names that are editable by the users. This is a nonsense module but it's simple enough to be understood by everybody. The DB we will use is MySQL,MySQL but the example, by changing some detail, works with all DB's. First of all let's see the skeleton of every module that we will construct: ]]> Before making anything it's necessary to create a folder called "modules/Topolino", the file we have just created (with the other contents) must be called index.php and must stay in that folder. We create a table in the database called nuke_topolino that is structured in this way:idperson:idperson It is a cell that contains the id of person (int 11, primary)nameperson: It is a cell that contains the names of the people (varchar 60)And we manually insert (by using PHPMyAdmin - see - or an equivalent interface) the names of the 3 people we are interested in, see (the module, for simplicity reasons doesn't allow you to add or to cancelcancel people but only editing those that already exist).Id 1: TopolinoTopolinoId 2: MinnieMinnieId 3: PlutoPluto

PHPMyAdmin: inserting values ]]> ]]> ]]> ]]> PHPMyAdmin: inserting values PHPMyAdmin: inserting values It's possible to include the footer at the end of every function. It's a solution that is a bit more complex because we must write more lines, but I have to stress how much alot of modules use it. Once that the table of the DB is ready we can begin to enjoy creating the code that will give us back our output. Our output will be one simple query with a cycle that will give back the values inserted in the database (the simplest thing in the world, Gosh!). Attention! To maintain the abstraction of the DB so that it can work on various database's in an independent way, we cannot use classic PHP syntax that is generally used by the MySQL addicted ; -), instead we must use the syntax illustrated in the file include/sql_layer.php The query that we will compile will be structured in the following way:"; ]]>Very simple, isn't it? OK!, before passing to the administrator's interfaceinterface for this module,module we will start to modify it with the intention of giving it a minimum style dignity.I would propose:to insert the results in a table to put a title to it and a description for the module.moduleWe can do this by rendering all of the module's compatible with the multilanguage system of PHP-Nuke: We define the abstractions that will compose the two phrases we need, in the file lang-english.php we have to insert:insertPHP-Nuke module is created"); ]]> ]]>Remember to insert a file called index.indexhtm in our language folder! We need it to protect the inside of that folder from undesired navigations.navigations We are nearly at the end of the frontend part, now we have to insert the stylistic part in the code that we have created and to assemble everything. We take two code pieces previously constructed (The initial one and the one created by us) and we join the stylistic modification:"; ]]>
"; ]]>"; ]]>
"; ]]>"; ]]> ]]>We have only added text, some breaks for the headers and an “Opentable();” and a “Closetable();” to include the text. The result can be seen in

Example module. ]]> ]]> ]]> ]]> Example module. Example module. Module creation, administrator partIt's time to create the administration part of the module.module In this very simple module the only function that will work on the DB will be the one in which we can modify the text of one of the three languages that we have created. First of all, we have to create the files to insert in the folders:admin/caseadmin/caseadmin/linksadmin/linksadmin/modules It's important to remember how much we have just said in :Admin:Admin contains 4 subdirectories (links, language, case, modules) that manage the various administration modules.modules The folder that holds the files is modules/admin/ .The folder admin/linksadmin/links instead says that the admin module must recall and position one language in admin for that determined module.moduleExample (Administration for the FAQ module):This module:moduleVerifies the administration rights (This module can be set up so it can be viewed by the superadmin or an admin)It passes a “CASECASE” (op=FaqAdmin) that indicates to the admin.adminphp file (that includes all the admin modules) the module to call, associates a value in order to translate the term “FAQFAQ” and associates an image for the visual administration (faq.faqgif).The folder admin/caseadmin/case instead serves to define the module to be used in each specified case . This is important when, using the same admin file, we need to perform more operations using a CASE statement:CASE statementIn fact it says which module to call in order to verify the CASE condition.condition For example, in the FAQ module there are lots of cases, here are the last 2:Both CASE statements call the adminfaq.faqphp file, but they are used for different operations.ations The first one calls the file with the default scheme,scheme the second, on the other hand, gives its O:K. to insert a new category.category This happens through a string like “admin.php?admin.phpop=FaqAdmin” in the first case and “admin.php?admin.phpop=FaqCatGo” in the second.We will now create, in the following order, the files:admin/modules/topolino.topolinophpadmin/case/case.topolino.topolinophpadmin/links/links.topolino.topolinophp In order to create the file inside the modules folder (modules/topolino.topolinophp) we must have a structure of this type:Starting part of the file (Similar for all the modules)Definition of the necessary functions.Definition of the necessary cases in order to call the various functions for the admin module.moduleFinal part of the file.The syntax for the starting part of the file is the following:This part of the file controls the administration rights for whoever calls it, a control on which language to use and (not in this module) a controlcontrol on the administrator's rights. An administrator could have only partial rights of administration on modulesmodules or some modules can be managed only by a superadmin.superadmin In our specific case the module can be managed only by the superadmin because the control is only:In case there are some specific rights (for example in the reviews module) the rights to control would have been:Activating the rights on two levels on new modules indeed isn't simple, you must specify in the nuke_authors table a new field that designates the rights, then modify admin/modules/authors.php adding the checkbox for the rights of the new module and modify the corresponding UPDATE queries.queriesLet's go back to our module:module we have already seen the initial part, which is obligatorily. The end of the open IF statement is:All that we find in the middle, are the management functions and the cases that must be checked, which we will now go on to construct. There are a couple of rules to follow in order to construct the admin functions:We must include a header at the beginning of the function and a footer at the end:We have to include the GraphicAdmin(); function immediately after the header.header It will display the navigation panel that leads to all the other adminadmin links. The functions we'll now go to create are:Display of the database recordsSelection of the record and its insertion in a modifiable text fieldModification of the record through insertion in the database of the value modified in the text field.Here is the code of the function which accomplishes the record selection:Select mouse
"; ]]>The next function to implement is the one that corresponds to the selection of one of the three records:"; ]]>

"; ]]> "; ]]> "; ]]> "; ]]>"; ]]>It is very important to take note of some things:The variables that we insert will be the ones to be checked, in fact you can see the variable “$idtopo” was inserted between the used variables. The value checked in the CASE statements is passed to us through a hidden form field). ]]>The last function we consider is the one that corresponds to the updatedate of the values in the database (Here too we added the two variables that we were interested in ($nameperson, $idperson): The last two elements to insert are the definitions for the CASE statementsstatements (that is, which function to call according to the variable passed to the module) and the closing of the file. Definition of the cases:The complete modules/topolino.topolinophp file is thus (see also Problems with new mods):Select mouse
"; ]]>"; ]]>

"; ]]> "; ]]> "; ]]> "; ]]>"; ]]> ]]>The cases definition page is very easy to construct, it gathers the cases that are included in the file admin/modules/topolino.topolinophp and puts them in the file admin/case/case.topolino.topolinophp This is the syntax:syntax ]]>The last two things we have to make are the compilation of the file admin/links/link.topolino.topolinophp and the creation of a language module: Compilation of the file link.topolino.topolinophp ]]>Where: admin.php?op=topolino defines which module must be called, " _EDITTOPOLINO_EDITTOPOLINO" is the term to translate (it must be compiled in admin/language). For the modification of the language module I refer you to the previous paragraph with one single note. The language file of the admin section is common for all (admin/language), the relative languages must be added to the end of those that already exist. Just another thing, the syntax of this example is not perfect, its beyond the scope of this to make it work perfectly but it does illustrate the operation of the module (Which you will find available for download at www.spaghettibrain.com so you will be able to study it). How to include a HTML file in a <application>PHP-Nuke</application> moduleFrom what we have said about the structure of a PHP-Nuke module (see ), it is easy to include a HTML file in a module - all we have to do is use the PHP include command,command to include it between the calls to OpenTable() and CloseTable() functions:Create a folder under the modules directory. Call it whatever you like, but take care to replace blanks with underscoresunderscores in the name.Using a decent text editor (see ), create a text file called index.indexphp in that newly created directory.Copy the following code in index.php:index.phpPHP-Nuke */ ]]>GNU General Public License as published by */ ]]> ]]>Change the licence to reflect your decisions. Of course, I urge you to use the GNU General Public License whenever possible, to help the cause of free software - PHP-Nuke is itself set under the GPL,GPL after all, so why would you want a different licence for your module?module. Then just enter the right path to the HTML file you want to include, replacing the “path/to/the/html/file” string. This can be either a full filesystem path, or a relative one - relative to the PHP-Nuke root directory, which is always the same directory where config.configphp is located. But it may also very well be a URL to a HTML file of another site. Examples:Finally, activate the module from the modules administration (see ). Javascript in modules There is nothing that prevents you from including a file that contains Javascript code in a module. As long as the Javascript functions defined in the included file are not also present in the includes/javascript.php file (see ), and the HTML page created with the Javascript does not break the table layout of your theme, there should be no problem. In this way you could create a PHP-Nuke Guestbook module, for example, if you already had the Javascript code for a guestbook (see Javascript in themes). If you want to include two files in the module, so that they appear side-by-side, rather than one after the other, you can use the usual HTML table trick to show the files in two separate cells of the same table row (see Using "include" for HTML pages):"; ]]>"; ]]>An alternative way to include a HTML file in the module,module is to terminate PHP interpretation of the file with a closing ?>, include the HTML code verbatim and then reopen the PHP context with a new <?php line: ]]> AND ]]> ]]>Note that we have inserted a closing ?> after the call to OpenTable() and an opening <?php before the call to CloseTable(). Whatever comes in between, should be plain HTML code, not PHP.PHP This method is suitable for small HTML texts, for larger texts the include method is recommended. How to include a HTML file and its links in a <application>PHP-Nuke</application> moduleIf the HTML file you included in your module with the methods shown in contains links to HTML files that you would also like to have included, you will need to apply some additional handwork. The problem here is that, although the included file will show correctly inside your module (and your theme), as soon as you click on one of its HTML links, you will be shown the target HTML file as is, i.e. outside your PHP-Nuke environment, like any other file independent of PHP-Nuke. This is certainly not something you are going to like - otherwise, why go into the trouble of including the first HTML file anyway? It is clear that, for a collection of interlinked HTML documents, a better approach is needed. See the <application>PHP-Nuke</application> HOWTO module! For a real world example of including a large collection of HTML documents in a PHP-Nuke module, download and install the PHP-Nuke HOWTO module. Then, see how modules/PHP-Nuke_HOWTO/index.php is programmed, as well as how the HTML links to files of the HOWTO were set up. In the method we will present here, we use an URL parameter (“page”) to find out which file to include in index.php.index.php Every link to a file of our collection is changed to contain this URL parameter.parameter The page URL parameter is validated through an associative array, minimizing the risk for SQL injection and other cracking attacks (see ). For a simpler, but not universal, method using iframes,frames see .Proceed in two steps as follows:Change every HTML link that appears in your HTML documents and points to another document of the same collection (links to other documents should be left unchanged) For example, a link to somefile.html like the following one ]]>should be changed to ]]>where you should replace "Your_Module"Your_Module with the name of your module, of course. This link passes the filename as the value of the page URL parameter to Your_Module.Your_Module You should do this for every link in your HTML document collection that points to another file of the same collection.As a next step, you modify the index.indexphp file of your PHP-Nuke module slightly (this is the file modules/Your_Module/index.php,index.php if we stay with the module naming of our example). You add a line for every file that was involved in a link modification above. This means that for every file like somefile.html in the above example, you add a lineThus, if your HTML file collection consists of the filesthen, following the above step 1, you should change every HTML link in those files as shown in .Changing HTML links for use in a custom <application>PHP-Nuke</application> module Original link Changed link <a href="accelerating-php-nuke.html"> <a href="modules.php?name=Your_Module&page=accelerating-php-nuke.html"> <a href="add-on-blocks.html"> <a href="modules.php?name=Your_Module&page=add-on-blocks.html"> <a href="add-on-modules.html"> <a href="modules.php?name=Your_Module&page=add-on-modules.html"> <a href="administration-functions.html"> <a href="modules.php?name=Your_Module&page=administration-functions.html"> <a href="admin-management.html"> <a href="modules.php?name=Your_Module&page=admin-management.html">

After that, following step 2 above, you should insert the following lines in the index.php file of Your_Module:Your_ModuleThe ACCEPT_FILE plays the role of a validator for the page URL parameter.parameter It connects a value of “page”, as passed by some URL,URL with the name of a file that has to be selected. The way we programmed it above, ACCEPT_FILE points to the file accelerating-php-nuke.html when given the “page” argument 'accelerating-php-nuke.html' (i.e. when “page” was 'accelerating-php-nuke.html' on the URL). This may look trivial,trivial but is not. What's more, there is nothing that would prevent you from choosing a different (and less intuitive) mapping from the values of “page” to the selected filenames. Thus, you could decide that a “page” (URL parameter) value of “1” means the accelerating-php-nuke.html file, a vlaue of “2” the add-on-blocks.html file etc. Then, the ACCEPT_FILE assignments would look as follows:while the HTML links in the files themselves should be changed as indicated by .Alternative way of changing HTML links for use in a custom <application>PHP-Nuke</application> module Original link Changed link <a href="accelerating-php-nuke.html"> <a href="modules.php?name=Your_Module&page=1"> <a href="add-on-blocks.html"> <a href="modules.php?name=Your_Module&page=2"> <a href="add-on-modules.html"> <a href="modules.php?name=Your_Module&page=3"> <a href="administration-functions.html"> <a href="modules.php?name=Your_Module&page=4"> <a href="admin-management.html"> <a href="modules.php?name=Your_Module&page=5">

The idea is that you retain control of what filename is selected. If you would blindly set the name of the selected file to be equal to the passed parameter value of “page”, then a malicious user could use the URLURLand read the contents of the system's password file (or whatever other file readable by the web server,server for that matter). The use of an associative mapping between URL parameters and filenames, as the one implemented by the ACCEPT_FILE array above, is thus not a gimmic, but a necessity. It protects your module from SQL injections and other attacks that rely on the programmer being too lazy to verify user input. See for more on PHP-Nuke security in general and for SQL injections with PHP-Nuke in particular.However, even with these precautions in place, the module is still vulnerable to a serious attack, as waraxe has pointed out in a security advisory (to be published): if the $ACCEPT_FILE array is not initialized, one could “poison” it. This means that an attacker could pass the parameters '...&page=xxx&ACCEPT_FILE[xxx]=/etc/passwd' on the URL and could still get /etc/passwd (or any other file for that matter) back! This will not work if safe_mode is ON in php.ini, but it still poses a very serious threat. For this reason, we must initialize the array first:PHP global variable space. Thanks to waraxe for pointing this out! ]]>Now you can hopefully see how important is the following rule: Don't forget: Always initialize your variables! The complete code of modules/Your_Module/index.indexphp is thus:PHP-Nuke */ ]]>GNU General Public License as published by */ ]]>PHP global variable space. Thanks to waraxe for pointing this out! ]]>= 41) { ]]> ]]>As you can easily deduce from the above code, the &qu

Go back! ]]>

Go back!

]]>