{"version": "1.6","name": "XOOPS Cube Legacy","subline": "Installation guide","username": "Xoops Cube","created": "01/11/2011","website": "http://xoopscube.sourceforge.net/site/index.php","update": "12/12/2011","update_today": false,"email": "xoopscube-modules@gmail.com","intro": "XOOPS Cube Legacy Installation Guide. If you have any questions that are beyond the scope of this help file, please feel free to join <a href=\"http://xoopscube.org/\">XOOPS Cube Project's community</a>.\nHave Fun creating!","sections": [{"title": "Preface","id": "preface","content": "<p>\tBefore starting the installation process, we (the XOOPS Cube team) aim to provide <span class=\"st\">the information you need</span> to install and support XOOPS Cube Legacy.<br>\n\tSince XOOPS Cube Legacy is server based, we try to make it as easy to install as normal desktop software.<br>\n\tGet familiar with setting up and installing the software listed below.<br>\n\tUsually 80% of our support questions wind up being improper configurations with the server components or two pieces of software conflict.</p>\n<p>\t<span class=\"st\">Verify that your web server is <em>configured to run</em> the operations that are required by XOOPS Cube Legacy web application</span>.</p>\n<p>\tTo install XOOPS Cube Legacy for the first time, we recommend you to have the following server software pre-installed:</p>\n<ul>\t<li>\t\tHTTP Server (<a href=\"http://www.apache.org/\">Apache</a> or IIS) &quot;Note, XCL only officially supports Apache&quot;</li>\n\t<li>\t\t<a href=\"http://www.php.net/\">PHP</a> 5.x.x and higher</li>\n\t<li>\t\t<a href=\"http://www.mysql.com/\">MySQL</a> Database 5.x.x and higher</li>\n</ul>\n<p>\tBefore starting the XOOPS Cube Legacy Installation Wizard, be sure to have:</p>\n<ul>\t<li>\t\tSetup the HTTP, PHP and MySQL database server properly.</li>\n\t<li>\t\tCreate a database for your <a href=\"http://xoopscube.sourceforge.net/\">XOOPS Cube Legacy</a> installation<br>\n\t\t(Have your hosting company create one if you can&#39;t.<br>\n\t\tThe install script does provide this capability with the proper privileges).</li>\n\t<li>\t\tSetup a MySQL user account with the proper database permissions.</li>\n\t<li>\t\tSetup a FTP user account with proper permissions.</li>\n\t<li>\t\tThe ability to set the directories and files permissions (world writeable, read/write, chmod 777).</li>\n\t<li>\t\tEnable cookies and <span class=\"missingpage\">JavaScript</span> support in your browser.</li>\n</ul>\n"},{"title": "Acquisition and Unpacking","id": "acquisition_and_unpacking","content": "<p>\tDownload the latest release package from the<a href=\"http://sourceforge.net/projects/xoopscube/files/legacy/\"> XOOPS Cube Legacy download page</a>.<br>\n\t&nbsp;</p>\n<ol>\n\t<li>\t\tSelect either .gzip or .zip as you prefer.</li>\n\t<li>\t\tCreate a logically named folder (e.g., xcl22-unpacked) on your local drive.</li>\n\t<li>\t\tUnpack (unzip) the XOOPS Cube Legacy package into the folder you create.</li>\n</ol>\n<p>\tYou can now get familiar with the XOOPS Cube Legacy folder/file structure<br>\n\tbefore running through the setup processs.</p>\n"},{"title": "Folders and Files","id": "folders_and_files","content": "<p>\tAll folders and files in the unzipped package are organized under a directory named after the current release.<br>\n\tYou will install the files and folders contained within this directory (but not the full file tree);<br>\n\tdo not install the container directory itself!<br>\n\t<br>\n\t<strong>XOOPS Cube Legacy</strong> is designed to work exactly as the folders and files are organized in the unzipped package,<br>\n\tit is critical that you do not move, nor rename, any of the folders or files;<br>\n\tdoing so will cause XOOPS Cube Legacy to not function.<br>\n\t<br>\n\tThe unzipped package will contain two directories that contents must be upload :</p>\n<p style=\"margin-left: 40px;\">\n\t<strong>html/<br>\n\txoops_trust_path/</strong></p>\n<p>\tThe folders in the package are:</p>\n<h2>\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> docs</h2>\n<p>\tProvides instruction on installing and upgrading, changelog and copyright notice.</p>\n<h2>\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> extras</h2>\n<p>\tProvides common css framework, images, extra_interfaces (php class), extra_languages, modules, preload, themes installer-ftp, utility_tools.</p>\n<h2>\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> html</h2>\n<p>\tAll the core scripting and modules functionality is kept in this folder.</p>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> class</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> common</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> core</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> images</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> include</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> install</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> kernel</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> language</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> modules</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> preload</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> themes</h2>\n<h2 style=\"margin-left: 40px;\">\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> uploads</h2>\n<h2>\n\t<img alt=\"file\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/linedpaper32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> Files :</h2>\n<p style=\"margin-left: 40px;\">\n\t<strong>admin.php<br>\n\tbackend.php<br>\n\tbanners.php<br>\n\tedituser.php<br>\n\tfavicon.ico<br>\n\tfooter.php<br>\n\theader.php<br>\n\timage.php<br>\n\timagemanager.php<br>\n\tindex.php<br>\n\tlostpass.php<br>\n\tmainfile.dist.php<br>\n\tmainfile.php<br>\n\tmisc.php<br>\n\tnotifications.php<br>\n\tpmlite.php<br>\n\treadmsg.php<br>\n\tregister.php<br>\n\trobots.txt<br>\n\tsearch.php<br>\n\tuser.php<br>\n\tuserinfo.php<br>\n\tviewpmsg.php<br>\n\txoops.css</strong></p>\n<h2>\n\t<img alt=\"folder\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/folder32.png\" style=\"width: 32px; height: 32px; vertical-align: text-bottom;\"> xoops_trust_path</h2>\n<p>\tXOOPS_TRUST_PATH was introduced by GIJOE (based on minahito&rsquo;s idea as GIJOE credited).<br>\n\tThe concept of XOOPS_TRUST_PATH is to secure a XOOPS Cube Legacy module by moving all of the module&rsquo;s PHP files out of web root or DOCUMENT_ROOT.</p>\n<p>\tThe second benefit of using XOOPS_TRUST_PATH is that D3 modules duplication become easily manageable.<br>\n\tWith the introduction of XOOPS_TRUST_PATH and duplicable modules &ndash; or Duplicable V3/D3, webmasters are free to duplicate and rename installed modules. A XOOPS Cube Legacy website can have many instances of the same module with each own template files and MySQL table files, and all run securely from a single module outside of the web root directory. So far there are many modules that take advantage of the idea, and most of Japanese developers release modules based on D3.</p>\n<ul>\t<li>\t\t<strong>The folder XOOPS_TRUST_PATH can be renamed to whatever name you wish.</strong></li>\n\t<li>\t\t<strong>The module name under XOOPS_TRUST_PATH can not be changed.</strong></li>\n\t<li>\t\t<strong>To differentiate the two instance of a module, you can customize template files</strong></li>\n</ul>\n<p>\t<strong><u>/!\</u> of Caution Using D3</strong><br>\n\tThe template files are centralized - if your UPDATE the module, the template files of all duplicated modules will be overwritten.</p>\n"},{"title": "Local Installation","id": "local_installation","content": "<p>\tIf you&#39;re running a local environment for development or testing, make sure that you have met the previous requirements.</p>\n<p>\tOnce this is done :</p>\n<ol>\n\t<li>\t\tcopy the contents of the <strong>HTML</strong> directory to the root document path of your web environment.</li>\n\t<li>\t\tcopy the contents of the <strong>XOOPS_TRUST_PATH</strong> directory to the root document path of your web environment.</li>\n\t<li>\t\tCreate a database</li>\n</ol>\n<p>\tOnce the files are copied there, you can start the install by typing <strong>http://localhost/html/</strong></p>\n<p>\tThis will start the install process.</p>\n"},{"title": "Hosting platform","id": "hosting_platform","content": "<p>\tIf you&#39;re running in a hosted environment, unpack the XOOPS Cube Legacy files locally or on the server if you have telnet or SSH access.</p>\n<p>\tOnce this is done :</p>\n<ol>\n\t<li>\t\tcopy the contents of the <strong>HTML</strong> directory to the root document path of your web environment<strong>*</strong></li>\n\t<li>\t\tcopy the contents of the <strong>XOOPS_TRUST_PATH</strong> directory to the root document path of your web environment.</li>\n\t<li>\t\tCreate a database</li>\n</ol>\n<p>\tOnce the files are copied there, you can start the install by typing <strong>http://my-site-domain.com/</strong>.<br>\n\tThis will start the install process.</p>\n<p>\t<strong>*</strong> your provider usually provides this location with directions.</p>\n"},{"title": "Install Wizard","id": "install_wizard","content": "<p>\tAfter performing the above procedures, you&#39;re ready to continue installing XOOPS Cube Legacy with the Install Wizard.<br>\n\tThe first screen in the install Wizard takes you to will be the welcome screen.</p>\n<p>\t<img alt=\"Step 1\" height=\"330\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_2.png\" width=\"780\"></p>\n<p>\tClick the Next button to continue on to the next screen.</p>\n<p>\t&nbsp;</p>\n<p>\t<img alt=\"Step 2\" height=\"834\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_8.png\" style=\"width: 780px; height: 834px;\" width=\"780\"></p>\n<p>\tThe next part of the install Wizard is designed to check your file and directory permissions.<br>\n\tIf you&#39;re running in a Win32 environment, this should be a pretty painless install.<br>\n\tIf you&#39;re running in a UNIX environment, the Wizard will display any problems and the corrective actions to take if there are problems.</p>\n<p>\t<img alt=\"Step 3\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_7.png\" style=\"width: 780px; height: 320px;\"></p>\n<p>\tIf all lights are green on the Wizard, click Next to continue.<br>\n\tIf not, please read the screen and perform the necessary actions recommended by the Wizard</p>\n<p>\tThe next part of the Wizard is for writing the settings to the mainfile.php file.</p>\n<p>\t<img alt=\"Step 4\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_9.png\" style=\"width: 640px; height: 640px;\"></p>\n<p>\tThe General Settings screen is self explanatory so, input the required information into the form and click next.</p>\n<p>\tThe next four Wizard screens are informational displaying the settings from the General Settings screen<br>\n\tfor your confirmation and to show that the values were written correctly.</p>\n<p>\t<img alt=\"Step 5\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_6.png\" style=\"width: 780px; height: 580px;\"></p>\n<p>\tIf you seen any Red lights, please click the Back button to make the proper corrections.<br>\n\tThe next Wizard screen is will be to show the progress for accessing the database.</p>\n<p>\t<img alt=\"Step 8\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_5.png\" style=\"width: 780px; height: 330px;\"></p>\n<p>\tIf you&#39;re in a hosted environment without the proper access to create databases, please check with your provider for help in getting a database.<br>\n\tIf your provider (or you) created the database, all lights should be green.<br>\n\tIf you get a red light stating the DB does not exist and your user name has the ability to create databases, and then click next<br>\n\tand the install Wizard will attempt to create the database for you.<br>\n\tIf your user id does not have the rights to create a database, please correct this and continue the install.<br>\n\tThe next two screens are informational on trying to create and access the database.<br>\n\tClick Next or Back depending on the Wizard screen.</p>\n<p>\tAfter clicking next a couple of times, you will come to an informational screen showing the results of table creation.<br>\n\tIf there is a problem, please refer to the <a href=\"http://xoopscube.org/modules/pukiwiki/\">FAQ</a> or <a href=\"http://www.xoopscube.org/\">XOOPS Cube Forums</a> for further assistance.</p>\n<p>\t&nbsp;</p>\n<p>\tIf all lights are green, you&#39;re ready to proceed by clicking Next.<br>\n\tThe next Wizard screen is for inputting site administrative information.</p>\n<p>\t<img alt=\"Step Admin User\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_4.png\" style=\"width: 780px; height: 570px;\"></p>\n<p>\tPlease be careful here and write down or remember your administrative password.<br>\n\tYou&#39;ll need this after the install to continue setting up your XOOPS Cube website.<br>\n\tOnce you have completed inputting the correct information, click Next to continue.<br>\n\t<br>\n\t* Note, try to refrain from using names with spaces for the Admin name.<br>\n\t<br>\n\tThe next screen is informational. If all the lights are green, click Next to continue.</p>\n<p>\t<img alt=\"Install Wizard Legacy Modules\" src=\"http://xoopscube.sourceforge.net/documentation/assets/images/image_3.png\" style=\"width: 780px; height: 640px;\"></p>\n"},{"title": "Congratulations!","id": "congratulations","content": "<p>\tYour installation should now be complete. You can check the site out by clicking the &quot;HERE&quot; text on the last screen.<br>\n\tIf all went well, then your new site should be up and running.<br>\n\tIf not, please refer to the <a href=\"http://xoopscube.org/modules/pukiwiki/\">FAQ</a> or <a href=\"http://www.xoopscube.org/\">XOOPS Cube Forums</a> for further assistance.</p>\n"}],"use_sub": false,"logo": "http://xoopscube.org/themes/cube_default215/images/logo.png","favicon": "","customcss": "","easing": "swing","easingduration": "700","bgimage": "","bgrepeat": "repeat","bgattachment": "scroll","bgcolor": "EEEEEE","textcolor": "383838","linkcolor": "3581E6","hrcolor1": "D4D4D4","hrcolor2": "FFFFFF","sidebarbgimage": "","sidebarbgrepeat": "repeat","sidebarbgcolor": "343838","sidebartextcolor": "FFFFFF","sidebarlinkcolor": "FFFFFF","sidebaractivecolor": "333636","sidebaractivetextcolor": "E6AD27","sidebarhrcolor1": "212424","sidebarhrcolor2": "494F4F","cufon": "","itemURL": "","sendJSON": "","sendZIP": "","sendPWD": "","cke_455_uiElement": false,"cke_458_uiElement": false,"cke_462_uiElement": false,"cke_465_uiElement": false,"cke_469_uiElement": false,"cke_472_uiElement": false,"cke_476_uiElement": false,"cke_479_uiElement": false}