系统要求 ----------------------------------- PHP: 任何版本 >= 4.3 (PHP 4.2.x 可能运行但不受官方支持，强烈推荐使用 PHP 5.0+) 请注意：XOOPS 2.4.0 是最后一个在 PHP4 上测试并支持 XOOPS 的版本。我们未来的版本将仅在 PHP5 上进行测试和认证：了解更多 这里 MySQL: MySQL 服务器 3.23+（强烈推荐使用 MySQL 5.0+）请注意：XOOPS 2.4.0 是最后一个在低于 5.0 版本的 MySQL 上测试并支持的版本。我们未来的版本将仅在 MySQL 5.0+ 上进行测试和认证：网络服务器：任何支持所需 PHP 版的网络服务器（强烈推荐使用 Apache）下载 Xoops ----------------------------------- 您可以从 Sourceforge 文件库 获取此版本软件包。提供 .zip 和 .gz 归档：xoops-2.4.0.zip：Md5：cfad8035f0093c82684a7bf4780ae7c6 Sha1：3a7d1bd527e7d9d8790bcd0fb42d688447161eeb xoops-2.4.0.tar.gz：Md5：edfe5b380626f61320702c4962df3251 Sha1：c8ffd83b355582897b92b6f074fc0f99e2d3c83a 安装 Xoops ----------------------------------- 1. 将 htdocs/ 目录的内容复制到您的服务器可以访问的位置 2. 确保主文件 mainfile.php 和 uploads/ 可被网络服务器写入 3. 考虑到安全性，强烈建议将 "/xoops_lib" 目录（Xoops 库）和 "/xoops_data" 目录（Xoops 数据）移出 文档根，并更改文件夹名称。 4. 使 xoops_data/ 目录可写入；创建（如果尚不存在）并将 xoops_data/caches/、xoops_data/caches/xoops_cache/、xoops_data/caches/smarty_cache/ 和 xoops_data/caches/smarty_compile/ 目录设置为可写入。 5. 使用网络浏览器访问您已安装的 htdocs/ 文件夹以启动安装向导 从旧版本升级 ----------------------------------- 从 XOOPS 2.3.x 升级（简单方法） 1. 从源forge 文件库获取正确的更新包 2. 使用新文件覆盖您现有的文件 * 确保将 /xoops_lib 的内容复制到您在服务器上的任何目录（例如，如果您已将其移出文档根）。不能有两个包含 /xoops_lib 内容的目录 3. 将 “升级” 目录移动到本地计算机上的 “htdocs” 目录内（之前已经移除，因为它在完整安装中不需要） 4. 访问/upgrade/ 使用浏览器进行升级，并按照以下步骤操作 5. 按照指示更新您的数据库 6. 从您的服务器上删除升级文件夹 7. 从模块管理界面更新 "system" 模块，其他模块，尤其是 "profile" 建议也进行更新 从XOOPS 2.0.*以上版本（2.0.14和2.2.*使用完整包）升级： 0. 在您的本地计算机（例如PC）的一个临时目录中解压缩存档文件。 1. 将 "upgrade" 文件夹移动到 "htdocs" 文件夹内部（因为完整安装不需要它，所以之前没有包括在内），在您的本地计算机上。 2. 从您的本地计算机的 "htdocs" 文件夹中删除 htdocs/mainfile.php, htdocs/install/, htdocs/cache/, htdocs/extras/, htdocs/template_c/, htdocs/themes/ 和 htdocs/uploads/ * 如果您的服务器上已创建XOOPS_TRUST_PATH文件夹，将/xoops_lib的内容复制到该目录，并从您的本地计算机的 "htdocs" 文件夹中删除/xoops_lib。 3. 将您的本地计算机上的 htdocs 文件夹内容上传到您服务器上的现有文件。 4. 考虑到安全性，建议将目录xoops_lib（XOOPS库）和xoops_data（XOOPS数据）从Document Root移动出来，并更改文件夹名称。 5. 使得xoops_data/目录可写；创建并使得xoops_data/caches/、xoops_data/caches/xoops_cache/、xoops_data/caches/smarty_cache/和xoops_data/caches/smarty_compile/目录可写。 6. 确保服务器可以写入mainfile.php文件。 7. 访问/upgrade/ 使用浏览器进行升级，并按照以下指示操作 8. 按照指示更新您的数据库 9. 再次使mainfile.php具有写保护 10. 从您的服务器上删除升级文件夹 11. 从模块管理界面更新 "system" 模块，建议也更新其他模块 从2.0.7到2.0.13.2的任何XOOPS版本升级（使用完整包）： 0. 在您的本地计算机（例如PC）的一个临时目录中解压缩存档文件。 1. 将 "upgrade" 文件夹移动到 "htdocs" 文件夹内部（因为完整安装不需要它，所以之前没有包括在内），在您的本地计算机上。 2. 从您的本地计算机的 "htdocs" 文件夹中删除 htdocs/mainfile.php, htdocs/install/, htdocs/cache/, htdocs/extras/, htdocs/template_c/, htdocs/themes/ 和 htdocs/uploads/ * 如果您的服务器上已创建XOOPS_TRUST_PATH文件夹，将/xoops_lib的内容复制到该目录，并从您的本地计算机的 "htdocs" 文件夹中删除/xoops_lib。 3. 将您的本地计算机上的 htdocs 文件夹内容上传到您服务器上的现有文件。 4. 从您的服务器上删除以下文件夹和文件（它们属于旧版本）： * class/smarty/core * class/smarty/plugins/resource.db.php 5. 确保服务器可以写入mainfile.php文件。 6. 考虑到安全性，建议将目录xoops_lib（XOOPS库）和xoops_data（XOOPS数据）从document root移动出来，或者甚至更改文件夹名称。 7. 使得xoops_data/目录可写；创建并使得xoops_data/caches/、xoops_data/caches/xoops_cache/、xoops_data/caches/smarty_cache/和xoops_data/caches/smarty_compile/目录可写。 8. 访问/upgrade/ 使用浏览器进行升级，并按照以下指示操作 9. 再次使mainfile.php具有写保护 10. 从您的服务器上删除升级文件夹 11. 从模块管理界面更新 "system" 模块，建议也更新其他模块 非UTF-8站点升级： UTF-8编码在XOOPS 2.3中被引入作为默认字符集。然而，将现有网站从非UTF-8字符集转换为UTF-8可能存在一些问题。在此转换有足够好的解决方案之前，当您升级现有网站时（如果您不是经验丰富的用户），以下设置是推荐的： - 在升级过程中，选择 "不更改" 选项的 "数据库字符集和校对" 步骤 - 修改/languages/yourlanguage/global.php以使用先前 _CHARSET 的值，如果它在新 global.php 文件中已更改为UTF-8，请按以下操作进行修改

定义('_CHARSET', 'UTF-8');

Upgrading XOOPS Editors: In the XOOPS package, there are four Editors included: dhtmltextarea and textarea for plain text, CKeditor and TinyMCE for WYSIWYG HTML. There are six additional WYSIWYG Editors available: FCKeditor, Koivi, NiceEdit, Wymeditor, Xinha, and Spaw2 that you can download from XOOPS SourceForge (https://sourceforge.net/projects/xoops/files/XOOPS%20Editors/) 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 tools will be available for 2.4 using FireBug (see http://tinyurl.com/nmnjdp) 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/tracker/?group_id=41586&atid=430840 Patch and enhancement: http://sourceforge.net/tracker/?group_id=41586&atid=430842 Feature design: http://sourceforge.net/tracker/?group_id=41586&atid=430843 Release announcement: https://lists.sourceforge.net/lists/listinfo/xoops-announcement XOOPS Development Team October 25th, 2009 ================================ Change Log: 2009/10/23: Version 2.4.0 =============================== Updates from Sourceforge trackers: - Fixed bug #2872644 : Find users bug - MAX_JOIN_SIZE (trabis/ghia/mowaffak) - Fixed bug #2877987 : setExtra of XoopsFormElement is unusable (trabis/instantzero) - Fixed bug #2720792 : Hardcoded "Re:" in pmlite.php (trabis/arabxoops) Removed language defines: /language/english/comment.php _CM_RE Added Language defines: /language/english/global.php _RE Updates upon community: + Added System key (wishcraft, trabis) - Changed: Oxygen updates (Voltan, Kris_fr) - Fixed a bug in xoopslist.php/language define fallback (trabis) - Fixed $_SESSION bug on some servers(xoops token not working) - Fixed Security Vulnerabilities (wishcraft) + Added missing local style for imagemanager and pmlite (mowaffaq) - Fixed Slash Double Quote Bug Fix - All Fields incur \" in database (wishcraft) - Fixed Removed Duplicate Cookie (wishcraft) - Added Protector 3.40 (Voltan, Trabis) =============================== 2009/09/10: Version 2.4.0 RC =============================== Updates upon community: - Removed soap authentication and classes(trabis) - Removed extra databases support (trabis) Removed language defines: /modules/system/language/english/admin/preferences.php _MD_AM_AUTH_CONFOPTION_SOAP /modules/system/language/english/admin/preferences.php _MD_AM_SOAP_* =============================== 2009/09/6: Version 2.4.0 Beta 2 =============================== Updates from Sourceforge trackers: - Fixed bug #2586854: date format is hardcoded in form elements (dugris/marco) - Fixed bug #2835056: ldap / soap syntax error (frankblack/julionc) - Fixed bug #2723428: Search Results - SEO (arabxoops/julionc) - Fixed bug #2838534: Error in oxygen orange css file (tititou/julionc) - Fixed bug #2839949: Wrong display of mandatory fields in oxygen GUI theme (tititou) - Added patch #2838667 : HTML syntax error + various formating in oxygen GUI, and clean up! (tititou/julionc) - Added feature request #2816381: Images Manager Sorting(trabis/Slyss) Updates upon community: - Fixed : some php4 related bugs in installer and xoopslogger (trabis) - Removed : System key (trabis) - Changed : Admin GUI's are now using a theme factory, modules can make use of $xoTheme and $xoopsTpl (trabis) + Added : Preload system, modules can now respond to system events(trabis) + Added : Support to php5.3 (trabis) + Added : jquery support. If you need to use jquery.js, please use $xoTheme->addScript('browse.php?Frameworks/jquery/jquery.js'); (trabis/phppp) Modified Language files: /modules/system/class/gui/oxygen/language/english/admin.php _AD_XOOPSMODULES, _AD_LOCALSUPPORT Removed language defines: /modules/system/language/english/admin/preferences.php _MD_AM_SYSTEMKEY /modules/system/language/english/admin/preferences.php _MD_AM_SYSTEMKEYDSC upgrade/upd-2.0.18-to-2-3-0/language/english.php LEGEND_XOOPS_MAINFILE_FORPROTECTOR upgrade/upd-2.0.18-to-2-3-0/language/english.php XOOPS_MAINFILE_LABEL_FORPROTECTOR Added Language File: /language/english/localsupport.php /class/calendar/JSCal2/JSCal2/src/js/lang/en.js /class/calendar/JSCal2/language/english.php Third-party updates: ============================ 2009/08/12: Version 2.4.0 Beta 1 ============================ Updates from Sourceforge trackers: - Fixed bug #2761876: Indexes issues/improvements (trabis/Instant-Zero) - Fixed bug #2788739: missing language definition _XOOPS_FORM_ALTYOUTUBE (trabis/voltan) - Added feature req #2414148 : removing harcoded 'administration' from cpanels (trabis/mowaffaq) - Fixed bug #2782360: Profile Module - Registration steps and user creation (trabis/instantzero) - Fixed bug #2730373: Removing content from homepage template (trabis/instantzero) - Fixed bug #2704179: CaritaFoto and Link to image with a space in the dir name (trabis) - Fixed bug #2624953: Can't save value of DATE and LONGDATE in profile module (trabis) - Fixed bug #2691957: Images not given in the image manager (trabis) - Fixed bug #2661850: Bug on [mp3] tags and update player.swf (trabis) Updates upon community: - Fixed bug: Updating countries list and moving harcoded names to language folder (trabis) - Fixed bug: Parsing issues with Oxigen(class mapper) (trabis/mamba) - Fixed bug: Blocksadmin - Cookies for remembering display list settings (trabis) - Fixed bug: Undefined 'OS' in logger/render.php (trabis) - Fixed bug: Inclusion of custom config file for text sanitizer (trabis) - Fixed bug: XoopsList.php (Timezone return is not true must be array) (wishcraft) - Fixed bug: Xoops Captcha Class This class would call third party Framewok Files. If the file was not found, this would either report no error or cause a WSOD. (Catzwolf) - Fixed bug: class/captcha/xoopscaptcha: Fixed many suppression errors that would lead to either WSOD or report no error. (Catzwolf) - Fixed bug: Can not delete notifications. Cache was being used and Token validation was failing. (trabis) - Fixed bug: Cookie Domain Dope now has constant set in common.php - XOOPS_COOKIE_DOMAIN (wishcraft) - Fixed bug: XoopsCache - XOOPS URL Include with Cache Filename (Cause issue with multiple domains) (wishcraft) - Fixed bug: XoopsTpl - XOOPS URL Include with Cache Filename (Cause issue with multiple domains) (wishcraft) - Fixed bug: XoopsObject - $this->vars[$key]['changed'] not set to true if value is the same and unchanged. (wishcraft) - Fixed bug: XoopsAuth - Some installs of xoops } would physically be missing from auth_ldap.php, xoops_ads.php [rep: brandonheyer] (wishcraft) - Changed: Xoops Captcha Config: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops Captcha Image: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops Captcha Text: Cleaned and Formatted code for consistency. (Catzwolf) - Chanded: XoopsDatabase: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: XoopsDatabaseFactory: Cleaned and Formatted code for consistency. Added error checking on file inclusion with error reporting. (Catzwolf) - Changed: XoopsFormCheckBox: Added check to see if class has already been loaded and changed include to use xoops_load function. (Catzwolf) - Changed: XoopsFormDhtmlTextArea: Added check to see if class has already been loaded and changed include to use xoops_load function. (Catzwolf) - Changed: XoopsGroupPermForm: Added Check to see if form have been loaded ppreviously nad changed includes to use xoops_load function (Catzwolf) - Changed: XoopsLists: Cleaned and Formatted Code. (Catzwolf) - Changed: Xoops ThemeForm and TableForm: Fixed the tables td to a fixed width 40%. (catzwolf) - Changed: XoopsForm: ThemeForm and TableForm: Replaced htmlspecialchar to a preg_replace to remove any malious code rather than just changing it to a readable form. (Catzwolf) - Changed: Auth Classes: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops Model Classes: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops Cache Classes: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops File Classes: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops Logger: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Xoops MultiMailer: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Functions,php: Cleaned and Formatted code for consistency. (Catzwolf) - Changed: Moved xos_kernel_Xoops2 Class from common.php to its own class file in /class (Catzwolf) - Changed: Common.php: Moved Many items into xos_kernel_Xoops2. (Catzwolf) - Changed: Moved Defines into own file called defines.php in include directory. (Catzwolf) - Chanded: refactored xoops_loadLanguage in function.php This was due to the way that this classed used error suppression and now also checks for $xoopsOption and sanitizes it. (Catzwolf) - Changed: Removed extra globals from module.errorhandler.php (do we really need this class now). (Catzwolf) - Changed: Change class Xoopstree function. Added 'extra' to the selection to allow for onchange etc (Catzwolf) - Changed: Formatted code and headers to conform to the Xoops coding standards. (Catzwolf) - Changed: Changed global calls to the database ($GLOBALS['xoopsDB'] To &XoopsDatabaseFactory::getDatabaseConnection(); which is the correct method of calling the database. - Changed: Changed initVar calls to the XoopsObject class to support enumeration array for XOBJ_DTYPE_ENUM (wishcraft) - Changed: Default Control Panel Theme set to oxygen by voltan (tnx Iran) [wishcraft] - Changed: Profile Module (Support for new Object Types and Refactorised Authentication Library) + Added: Query timers to logger (trabis) + Added: Blocksadmin - groups selection to block forms (trabis) + Added: Deprecated methods on kernel/module.php (trabis) + Added: XOBJ_DTYPE_FLOAT - Object Type for Floating Points (php4) - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_DECIMAL - Object Type for Decimals/Doubles (php4) - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_ENUM - Object Type for Enumerators (Database Support) - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_TXTBOX - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_TXTAREA - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_URL - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_EMAIL - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_ARRAY - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: XOBJ_DTYPE_UNICODE_OTHER - Object Type for Unicode and Escaped Characters - see /class/object.php (wishcraft) + Added: xoops_base_domain - Function for retrieving TLD of domain of any URL - see /include/functions.php (wishcraft) + Added: xoops_convert_encode - Function for Converting Bit Strings Storage in any format database in a string - see /include/functions.php (wishcraft) + Added: xoops_convert_decode - Function for Converting Bit Strings Storage in any format database in a string - see /include/functions.php (wishcraft) + Added: xoops_hex2bin - Function for Unicode Storage in any format database with hex - see /include/functions.php (wishcraft) + Added: xoops_hex2bin - Function for Unicode Storage in any format database with hex - see /include/functions.php (wishcraft) + Added: xoops_ishexstr - Function for Checking for a hex string with length limiting - see /include/functions.php (wishcraft) + Added: xoops_aw_decode - Array Walking Function for Unicode Storage see func: xoops_bin2hex - see /include/functions.php (wishcraft) + Added: xoops_aw_encode - Array Walking Function for Unicode Storage see func: xoops_hex2bin - see /include/functions.php (wishcraft) + Added: WCAG 2.0 - Sight Impaired Assisted Forms (Disability Access - Form Objects) - see /class/xoopsforms/ (wishcraft) + Added: getTitle - WCAG 2.0 - Object HTML Title Tag (Text to Speach 4 Prompted Forms) - see /class/xoopsforms/formelement.php (wishcraft) + Added: WCAG 2.0 - Label Associations with WCAG1/2 - see form objects render (wishcraft) + Added: New Class to XoopsForms: XoopsFormTree Class. The ability to add XoopsTree directly into any form. (Catzwolf) + Added: New Class to XoopsForms: XoopsFormSelectCheckGroup. This class will allow developers to add Xoops Groups into forms for permissions. (Catwolf) + Added: Class XoopsMySQLDatabase: Added the ability to take items from the database as an object and cleaned and formatted code. (Catzwolf) + Added: New Admin Theme "Oxygen" (Voltan) Updates upon community: + Added: Added functionality where items in the Xoops Form Element can span over two columns rather than into one. This was done for items such as tinymce to prevent cramping into one little box (Catzwolf) + Added: XoopsLists: Added correct method to connect to database. Changed from using the $GLOBAL and added file check when including language file. Editors like tiny mce were not cramped into one little box. (Catzwolf) + Added: New XoopsForm Class: XoopsFormButtonTray: This will allow developers to quicker add Cancel, Reset and Submit (Delete is used with a Switch) buttons in form with just one line. (Catzwolf) + Added: Two new defines in common.php NWLINE to insert newlines and DS as a shortcut of DIRECTORY_SEPARATOR. We should be using this method with XOOPS_ROOT_PATH when dealing with paths correctly. (Catzwolf) + Added: Auth Class: Added some class and file checks with error_triggers to prevent white pages (Catwolf) + Added: Xoops File Classes: Added file and class inclusion checks and added error reporting. (Catzwolf) + Added: Xoops Logger: Added check to see if error number was 2048 and return true as this error is not required to be checked and helps speeds up the logger class (Catzwolf) + Added: Xoops MultiMailer: Added file check . (Catzwolf) + Added: Module Helper Function: In Functions called xoops_getModuleOption. This will allow module developers to quickly Access $xoopsModuleConfig across all modules. Based on News Module Version (Catzwolf, Herve) + Added: New Core function in functions.php xoops_getConfigOption. Allow to get $xoopsConfig() in a safer and static version. (Catzwolf) + Added: New Core function in functions.php xoops_setConfigOption. Allow to set $xoopsConfig() in a safer. (Catzwolf) + Added: New function to xos_kernel_Xoops2 called pathExists. When using $xoops->path($file), this call will check that the file exists or throw friendly error (Catzwolf) + Added: New Function: triggerError. To allow Core and modules to add errors with custom messages. (Catzwolf) Modified language files: /modules/profile/language/english/modinfo.php : Fixed typo in "PROFILE_MI_NEVER_LOGED_IN" - it should be "LOGGED_IN" (mamba) /upgrade/language/english/upgrade.php : "_NO_NEED_UPGRADE" (trabis) Added Language defines: /modules/system/language/english/cpanel.php : Added _MD_CPANEL_SITE_ADMINISTRATION (trabis/mowaffaq) /language/english/formdhtmltextarea.php : Added _XOOPS_FORM_ALTYOUTUBE (trabis/voltan) /language/english/banners.php : Added _BANNERS_CHANGE to defines (trabis) /language/english/global.php : Added _RESET /language/english/global.php : Added _XO_AD_USERBENNED_HEADER /language/english/global.php : Added _XO_AD_USERBENNED_TEXT /upgrade/language/english/upgrade.php : Added '_UPDATE_SYSTEM_MODULE' (trabis) Removed language defines: /language/english/admin.php : _AD_PRESSGEN Added Language File: /language/english/countries.php (trabis) /language/english/logger.php (trabis) /language/english/errors.php (Catzwolf) Third-party updates: - Added nuSoap - sourceforge (wishcraft) - Upgraded Smarty to 2.6.26 (trabis)