System requirements ----------------------------------- PHP: Any PHP version >= 5.2 (PHP 5.3+ is strongly recommended) MySQL: MySQL server 5.0+ 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. There are .zip and .gz archives 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, and 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. You can also check out the detailed Installation Guide Note for people upgrading from previous XOOPS versions: ------------------------------------ 1) If you use custom templates, you should convert them into files inside your theme folder before upgrading. The option to store custom templates in DB is deprecated 2) The option to store images in DB is also deprecated. Upgrading from a previous version ----------------------------------- Upgrading from 2.5.0 to 2.5.1: 1. Get the right update package from the sourceforge file repository 2. Overwrite files in XOOPS directory on your server with the content of /htdocs * make sure that you copy the content of /xoops_lib to whatever directory you keep it on the server now (it should be your current XOOPS_TRUST_PATH directory), then delete the /xoops_lib directory. There can NOT be two directories with the content of /xoops_lib 3. Update the "system" module from the modules administration interface. Other modules, especially "Profile" and "Protector" are recommended to update as well Upgrading from previous versions older than 2.5.0: The upgrade scripts from older versions to 2.5.0 are not complete, however it won't affect your XOOPS site. The scripts will be improved in next release. Following is an instruction for upgrading from XOOPS 2.4.5 to 2.5 provided by John Healy: 0. Verify the system requirements, in particular the version of PHP. Backup your XOOPS database and site directory. (There are several ways to do these actions, which are discussed elsewhere.) Turning your site off is optional. Change the permissions on mainfile.php and /include/license.php to be writable, for example: File Normal For upgrade mainfile.php 400 700 /include/license.php 444 777 Get the correct update package from the SourceForge file repository. 1. In the upgrade package folder, move the "upgrade" folder inside the "htdocs" folder, if it's not already there. Remove the install folder from the "htdocs" folder, if it's there. Remove the mainfile.php file from the "htdocs" folder, if it's there. If you've moved the xoops_data and xoops_lib folders outside your site's root directory, move these folders out of the "htdocs" folder in the upgrade package folder. 2. Delete the /modules/system directory on your current XOOPS site (to get rid of any old unnecessary files). 3. Overwrite the files in the XOOPS directory on your current XOOPS site with the content of "htdocs" folder of the upgrade package. (There are several ways to do this action, which are discussed elsewhere.) As noted above, if relocated, overwrite the files in your current xoops_data and xoops_lib with the content of those in the upgrade package. 4. If you have Protector previously installed, open the "mainfile.php" file , and remove the Pre-check and Post-check lines (if they exist): include XOOPS_TRUST_PATH.'/modules/protector/include/precheck.inc.php' ; include XOOPS_TRUST_PATH.'/modules/protector/include/postcheck.inc.php' ; 5. At your site's address (URL), login as administrator. Access/升级/使用浏览器，并按照说明（以及更新XOOPS数据库的说明）执行。应用所有更新后（绿色勾选），注意更新器中的链接来更新“系统”模块，并进行更新。6. 从您网站的“htdocs”目录中删除“升级”文件夹。7. 如有必要，更新（重新加载）其他模块，特别是“资料”和“保护者”。8. 将上述文件的权限更改回正常状态。9. 如果之前已关闭，则重新启动您的网站。调试信息显示级别 ----------------------------------- 自XOOPS 2.3.1起，调试信息显示级别作为一个临时的解决方案启用，以便向不同级别的用户显示调试信息：向所有用户、成员或仅管理员。配置可以在/xoops_data/configs/xoopsconfig.php中进行设置。文件完整性检查 ----------------------------------- 全部XOOPS软件包附带一个脚本，可以检查是否所有系统文件都已正确上传到服务器。要使用它，请按照以下说明操作：1. 将位于XOOPS包根目录下的checksum.php和checksum.md5文件上传到您的XOOPS服务器文件夹（将它们放在mainfile.php旁边）。2. 使用浏览器执行checksum.php。3. 如有必要，重新上传缺失或损坏的系统文件。4. 从您的服务器上删除checksum.php和checksum.md5。模块 ----------------------------------- 本版本仅包含“系统相关模块”。如果您需要额外的功能，请浏览XOOPS模块存储库。注意：由于正在构建新的存储库，当前存储库可能不是最新的，请确保访问个别开发者的网站以使用模块的最新版本。如何贡献 ----------------------------------- 漏洞报告：http://sourceforge.net/tracker/?group_id=41586&atid=430840 补丁和增强：http://sourceforge.net/tracker/?group_id=41586&atid=430842 功能设计：http://sourceforge.net/tracker/?group_id=41586&atid=430843 发布公告：https://lists.sourceforge.net/lists/listinfo/xoops-announcement Xoops引擎开发：http://www.xoopsengine.org XOOPS开发团队 2011年4月5日