System requirements ----------------------------------- PHP: Any PHP version >= 4.3 (PHP 4.2.x may work but is not officially supported, PHP 5.0+ is strongly recommended) MySQL: MySQL server 3.23+ (MySQL 5.0+ is strongly recommended) Web server: Any server supporting the required PHP version (Apache highly recommended) Downloading XOOPS ----------------------------------- Your can get this release package from the sourceforge.net file repository. Both .zip and .gz archives are provided. Installing XOOPS ----------------------------------- 1. Copy the content of the htdocs/ folder where it can be accessed by your server 2. Ensure mainfile.php and uploads/ are writable by the web server 3. For security considerations, you are encouraged to move directories "/xoops_lib" (for XOOPS libraries) and "/xoops_data" (for XOOPS data) out of document root, or even change the folder names. 4. Make the directory xoops_data/ writable; Create (if not already present) and make the directories xoops_data/caches/, xoops_data/caches/xoops_cache/, xoops_data/caches/smarty_cache/ and xoops_data/caches/smarty_compile/ writable. 5. Access the folder where you installed the htdocs/ files using your web browser to launch the installation wizard Installing Protector in XOOPS ----------------------------------- We also highly recommend the installation of the PROTECTOR module which will bring additional security protection and logging capabilities to your site: To install protector module with a fresh new installation of XOOPS, delete the mainfile.dist.php available at the xoops root, copy /extras/mainfile.dist.php.protector to /htdocs/mainfile.dist.php and rename it to mainfile.dist.php BEFORE installing XOOPS. To install protector module with upgrading from a previous version to XOOPS 2.3.1, delete the mainfile.dist.php available at the xoops root, copy /extras/mainfile.dist.php.protector to /upgrade/upd-2.0.18-to-2.3.0/mainfile.dist.php and rename it to mainfile.dist.php BEFORE upgrading XOOPS. Upgrading from a previous version ----------------------------------- Upgrading from XOOPS 2.3.1 or 2.3.2 (easy way) 1. Get the right update package from the sourceforge file repository 2. Overwrite your existing files with the new ones 3. Move the "upgrade" folder inside the "htdocs" folder (it's been kept out as it's not needed for full installs) on your local machine 4. Access /upgrade/ with a browser, and follow the instructions 5. Follow the instructions to update your database 6. Delete the upgrade folder from your server 7. Update the "system" module from the modules administration interface, other modules, especially "profile" are recommended to update as well Upgrading from XOOPS 2.0.* above 2.0.14 and 2.2.* (using the full package) 1. Move the "upgrade" folder inside the "htdocs" folder (it's been kept out as it's not needed for full installs) on your local machine 2. Delete htdocs/mainfile.php, htdocs/install/, htdocs/cache/, htdocs/extras/, htdocs/template_c/, htdocs/themes/ and htdocs/uploads/ from the "htdocs" folder on your LOCAL machine 3. Upload the content of the htdocs folder on your LOCAL machine over your existing files on your server 4. For security considerations, you are encouraged to move directories xoops_lib (for XOOPS libraries) and xoops_data (for XOOPS data) out of document root, or even change the folder names. 5. Make the directory of xoops_data/ writable; Create and make the directories of xoops_data/caches/, xoops_data/caches/xoops_cache/, xoops_data/caches/smarty_cache/ and xoops_data/caches/smarty_compile/ writable. 6. Ensure the server can write to mainfile.php 7. Access /upgrade/ with a browser, and follow the instructions 8. Follow the instructions to update your database 9. Write-protect mainfile.php again 10. Delete the upgrade folder from your server 11. Update the "system" module from the modules administration interface, other modules are recommended to update as well Upgrading from any XOOPS ranging from 2.0.7 to 2.0.13.2 (using the full package): 1. Move the "upgrade" folder inside the "htdocs" folder (it's been kept out as it's not needed for full installs) on your LOCAL machine 2. Delete htdocs/mainfile.php, htdocs/install/, htdocs/cache/, htdocs/extras/, htdocs/template_c/, htdocs/themes/ and htdocs/uploads/ from the "htdocs" folder on your LOCAL machine 3. Upload the content of the htdocs folder on your LOCAL machine over your existing files on your server 4. Delete the following folders and files from your server (they belong to an old version): * class/smarty/core * class/smarty/plugins/resource.db.php 5. Ensure the server can write to mainfile.php 6. For security considerations, you are encouraged to move directories xoops_lib (for XOOPS libraries) and xoops_data (for XOOPS data) out of document root, or even change the folder names. 7. Make the directory of xoops_data/ writable; Create and make the directories of xoops_data/caches/, xoops_data/caches/xoops_cache/, xoops_data/caches/smarty_cache/ and xoops_data/caches/smarty_compile/ writable. 8. Access /upgrade/ with a browser, and follow the instructions 9. Write-protect mainfile.php again 10. Delete the upgrade folder from your server 11. Update the "system" module from the modules administration interface, other modules are recommended to update as well Upgrading a non UTF-8 site: UTF-8 encoding has been introduced into XOOPS 2.3 as default charset. However, there might be some problems with converting existent websites from non UTF-8 charset to UTF-8. Before there is a good enough solution for this conversion, following settings are recommended when you upgrade an existent website if you are not an experienced user: - Select "Do not change" option in "Database character set and collation" step during upgrade process - Modify /languages/yourlanguage/global.php to use existent _CHARSET value if it has been changed to UTF-8 in your new global.php file as

define('_CHARSET', 'UTF-8');

Upgrading XoopsEditor package: In the XOOPS package, there are five editors included: dhtmltextarea and textarea for plain text, fckeditor, tinymce and koivi for WYSIWYG HTML. Since there are some directory structure changes in both fckeditor and tinymce editors, you are recommended to remove existent editors before uploading the new additors. And if you are using fckeditor for modules, please modify module specific configs following the files in /fckeditor/modules/, especially if you use "article" module. Debug information display level ----------------------------------- Since XOOPS 2.3.1 debug information display level is enabled as a temporary solution for 2.3* to show debug information to different level of users: to all users, to members or to admins only. The configuration can be set in /xoops_data/configs/xoopsconfig.php A new debug information renderer is redesigned in XOOPS 3.0 Files integrity check ----------------------------------- The full XOOPS package is released with a script able to check if all the system files have been correctly uploaded to the server. To use it, follow these instructions: 1. Upload the checksum.php and checksum.md5 files located in the XOOPS package root to your XOOPS server folder (putting them next to mainfile.php). 2. Execute checksum.php with your browser 3. If necessary, re-upload the missing or corrupted system files 4. Remove checksum.php and checksum.md5 from your server Modules ----------------------------------- This release contains only the "system-related modules". You are invited to browse the XOOPS modules repository to if you need additional functionality. Note: as a new repository is being built, the current repository is not up-to-date, PLEASE VISIT INDIVIDUAL DEVELOPERS' WEBSITES TO MAKE SURE YOU ARE USING LATEST VERSION OF MODULES. How to contribute ----------------------------------- Bug report: http://sourceforge.net/tracker2/?group_id=41586&atid=430840 Patch and enhancement: http://sourceforge.net/tracker2/?group_id=41586&atid=430842 Feature design: http://sourceforge.net/tracker2/?group_id=41586&atid=430843 Release announcement: https://lists.sourceforge.net/lists/listinfo/xoops-announcement XOOPS Development Team Feb 22nd, 2009 ========================================== XOOPS Changelog ============================ 2009/02/02: Version 2.3.3 RC ============================ Updates from Sourceforge trackers: - Fixed bug #2414112: Hardcoded Style (mowaffak/dugris) - Fixed bug #2419532: maxlength (25) for adminname and display strong password generator (bandit/dugris) - Fixed bug #2501237: merger complete configuration files (default and custom) (zoullou/dugris) - Fixed bug #2426129: XoopsFormEditor class uses the selected XoopsEditor customized renderValidationJS method when exists (luciorota) - Fixed bug #2164522: Last login date display fixed for user had never logged (julionc/marco/colossus) - Fixed bug #2164510: "Url" field in Profile module isn't a link (julionc/marco/colossus) - Fixed bug #2217070: CSS Language files were not adequately loaded in Cpanel GUI and wrong css file (julionc/tititou) - Fixed bug #2331727: rank image was not required in edit form but checked upon submission (phppp/burning/marco) - Fixed bug #2163373: removed extra ':' from smilie form (phppp/tititou) - Fixed bug #2341118: blank page only guests (dhcst) - Fixed bug #1193857: UTF-8 for non-english Websites(dhcst) - Fixed bug #2340000: display *=required for the required fields (dhcst) - Fixed bug #2172528: Fatal error: Call to a member function isAdmin() (dhcst) - Fixed bug #2378095: module pm - wrong start values (mcleines) - Fixed bug #2332106: exm css warning (dhcst) - Fixed bug #2158984: Remember me checkbox set to on by default (dhcst) - Fixed bug #2344245: module pm - prune function - Fixed bug #2494356: Upgrade Smarty 2.6.22 (dhcst) - Fixed bug #2340215: [img] and [url] (dhcst) - Fixed bug #2192934: PM - Can't delete - Fixed bug #2414383: Blocks were not sorted correctly once data are not reconciled (phppp/mcleines/dejadingo) - Fixed bug #2571592: Element id is not recognized in XoopsFormCheckBox (phppp/madreus) - Fixed bug #2579969: typo in config "filterxss_on_display" (phppp/marco/grandoc) - Fixed bug #2549140: CAPTCHA image is not displayed with some IE browsers (phppp/saba/dhcst) - Fixed bug #2489130: element id is not used correctly (phppp/trabis) - Fixed bug #2573097: request parameters are not stored in block admin (phppp/sabahan) - Fixed bug #2380971: display informative message for notification options (phppp/bandit-x) - Fixed bug #2483646: caption for username is missing (phppp/sabahan/mcleines) - Fixed bug #2586854: date format is hardcoded in form elements (phppp/Reintjan) - Fixed bug #2340302: username is truncated when editing a user by admin (phppp/GPboarder) - Fixed bug #2602337: variable "XOOPS_VAR_PATH" is wrongly typed in upgrader 2.0.18 to 2.3.0 (phppp/mcleines) - Fixed bug #2340700: improvement on readme (phppp/ghia/Phmo) + Implemented feature #2154340 or meta tags for register, user and userinfo files for SEO Optimization (julionc/kerkyra) + Implemented feature #2193964 or localization in Installer system (julionc/voltan) Updates upon community: - Fixed pagenav - extra parameter contains an anchor (dugris) - Fixed sort categories - module profile (dhcst/trabis) - Fixed permission for Usergroups - module profile (dhcst) - Fixed bug in user.php: page is not accessible due to infinitive redirect loop if profile module is installed but permission is not set properly (phppp/AAAAAgg) - Refactoring XoopsLogger in /class/logger/xoopslogger.php (julionc/phppp/tititou) - Changed language folder from 'dutch' to 'nederlands' in upgrade (phppp) - Improved installer (dugris/phppp/ezsky/marco) - Improved system_siteclosed.html in default and Zetagenesis Theme (mamba/aph3x/kris/dugris) - Improved system_redirect.html in defautl and Zetagenesis theme (kris) - Improved template cache handler to allow module-wide cache update (phppp) + Added search field groups - module profile (only for webmasters) + Added checks for XOOPS_TRUST_PATH outside DocumentRoot, Xoops_Cache is writable (dhcst) + Implemented template to homepage (phppp) + Implemented localization support for content rendering (phppp/julionc/rowdie/irmtfan/mamba/voltan) + Implemented localization support for RSS feeds (phppp/dugris) + Added module names to not installed module list (phppp) + Added module preference entrance to system preference list (phppp/herve) + Added double_encode support to MyTextSanitizer::htmlSpecialChars (phppp/dugris/dhcst) + Added Stylesheet for pagenav (burning/kris) Third-party updates: - Upgraded Snoopy Class to 1.2.4 (julionc) - Upgraded Smarty to 2.6.22 (dhcst) Modified language files: /language/english/global.php added: "_REQUIRED" (dhcst) /language/english/admin.php added: "_AD_WARNINGINSTALL", "_AD_WARNINGWRITEABLE", "_AD_WARNINGNOTWRITEABLE" and "_AD_WARNINGXOOPSLIBINSIDE" (phppp/dhcst) /language/english/user.php (julionc) /modules/system/language/english/admin/preferences.php added: "_MD_AM_MODULEPREF" (phppp) /modules/profile/language/english/modinfo.php added: "_PROFILE_MI_NEVER_LOGED_IN" (julionc) /modules/profile/language/english/main.php added: "_PROFILE_MA_ACTUS" and "_PROFILE_MA_FOUNDUSER" (dhcst) /install/language/english/install.php (phppp) /install/language/english/welcome.php (phppp) /install/language/english/finish.php (phppp) Added language files: /language/english/backend.php (phppp) /language/english/style.css (phppp) /themes/zetagenesis/language/english/ (phppp) /themes/zetagenesis/language/english/main.php (phppp) /themes/zetagenesis/language/english/script.js (phppp) /themes/zetagenesis/language/english/style.css (phppp) /upgrade/language/english/style.css (phppp) /install/language/english/support.php (dugris) /install/language/english/support.png (dugris)