100% Open Source Review Site Software

CIOpenReview is a lightweight, powerful, and easy to use CMS for building review sites quickly and easily

CIOpenReview Installation Guide

Installing CIOpenReview Before Installing, please make sure you have the following: Getting the Files The files can be downloaded from our GitHub Page

Transferring The files

You will need either an FTP client or shell access to your server (some shared hosting will not have shell access so you will need to use FTP).

Uploading With FTP

You will need an FTP program, you can use a free one like FileZilla which is available for Windows, Mac or Linux.

After connecting to your hosting account with your FTP client you should see a directory called "public_html" or "htdocs" which is where your website files are stored. This is the directory where you will be uploading the script. If you want to put the script in a sub-directory, create a directory inside "public_html" or "htdocs" called, for example, "reviews".

Now upload the contents of the directory you unzipped earlier to your chosen directory on your server. With FileZilla, you would find the unzipped script directory, select everything in that directory and drag and drop them to the directory on your server.

When the upload is complete, go to the Preparing For Installation section.

Uploading with Shell Access

You can transfer the file directly from our gitHub page to yours: (skip this if you are using FTP)

			cd ~
			mkdir ciopenreview
			cd ciopenreview
			wget https://github.com/jimok82/CIOpenReview/archive/master.zip
			

or

			cd ~
			mkdir ciopenreview
			cd ciopenreview
			curl -O https://github.com/jimok82/CIOpenReview/archive/master.zip
			

then unpack the file and move the files into your "public_html" folder:

			unzip master.zip
			cp htdocs/* /path/to/your/public_html/
			
Preparing For Installation

Before going any further, it's worth going to the install page in your browser just to check if there are any issues with your server. It's better to do this now than spend any more time getting the files, directories and database ready only to find your server needs a setting changed or has an old version of PHP

In your browser, go to the install page, the url will be something like this:

http://yourreviewsite.com/install

or

http://yourreviewsite.com/subdirectory/install

You should see the first page of the installer.

NOTE: The installer will check the version of CIOpenReview you have installed and will not allow to re-install on top of an existing install. This is for security purposes since someone could use a re-install to override your manager credentials!

The installer will check your server settings and let you know if any changes need to be made to your server or settings. If you are unsure how to change server settings or you have any other hosting issues, it's unlikely we will be able to help you with this so please contact your host for help.

It's possible the installer will tell you several files and directories are not writeable... and that's what we're going to look at next.

Set Permissions

Certain files and directories need to be writeable so that the script can upload files, resize images and update config files. With your FTP client you need to go to each of the following files and directories and change the permissions to 755 (with FileZilla this is as simple as right-clicking the file or directory and selecting "File Permissions..." from the menu).

Change permissions on these directories and files:

If you are using shell not FTP you should chmod these directories and files to 755.

As a safety precaution, it is advised to chmod all files to 644 and directories to 755

			find . -type d -exec chmod 755 {} \;
			find . -type f -exec chmod 644 {} \;
			

You will also want to make sure all files are owned by the user running PHP. On shared hosts this is usually your FTP username, and on dedicated servers, this is usually the name of the service ("apache" or "nginx")

			chown -R your_php_username htdocs/*
		
Create A Database

By default, CIOpenReview needs a MySQL database (it's possible to use other types of database but as most hosts will have at least one MySQL database available for you to use, we just assume MySQL).

NOTE: if you are upgrading CIOpenReview or installing on top of OpenReviewScript, the database update procedure will not overwrite any data that you have in the database, except for the manager credentials. Regardless A full MySQL backup is HIGHLY RECOMMENDED!

You will need to log in to your hosting account control panel to set up the database. Some hosts provide one database already created and ready to use. If not, create a database in your control panel and grant a user access to that database.

Now go back to your browser (you should still be on the first page of the installer) and click the 'Next Step' button.

Enter the database details on the form:

NOTE: if you have problems with your database settings it is possible your database name and user name will have had a prefix added when you created them. For example, you called your database 'mydata' and your server named it 'abc_mydata'.

Click 'Next Step' when you are ready and you should see the next page. If you see a message telling you there was a problem connecting, check all the details again.

Final Step Site And Manager Information

In the final step of the installation, you will be choosing a name for your site, providing an email address where site emails will be sent and a manager username and password. All of these details can be changed later in the manager area.

It is a good idea to keep a copy of your password somewhere safe but should you lose the password there is a process for resetting it.

Complete the form and click 'Next Step'

Installation Complete

Congratulations, you just installed CIOpenReview!!!

Before you continue there is just one more quick job you may need to do. The installer should delete the 'install' directory automatically, but if it doesn't, you can do so using your FTP client (or shell users 'cd' to your "public_html" directory and

rm -rf ./install

simply renaming it is probably not a good idea. Leaving the directory there could be a security risk and would make it easier for evil people to do bad things to your site, so even if you don't do this right now, you really should delete it as soon as possible. When the directory has been deleted, click one of the links on the page to see your site or to log in to the manager area.

To get started with your new site, read the User Guide.

Thank you for choosing CIOpenReview!

Note: This install guide has been taken from the original OpenReviewScript and modified as necessary