Installation/Upgrade 3.0

From SubjectsPlus
Jump to: navigation, search

As was the case with 2.0, 3.0 has an installer/updater/configurator feature that means that you no longer have to mess with the config.php file.

Install

  • Download the files and extract to your webserver.
  • Create a blank database with a user for SubjectsPlus. This user should have SELECT, INSERT,

UPDATE, ALTER and DELETE privileges. Note the name of your db, user, and password.

  • Point your browser to the control folder, i.e., www.yoursite.edu/sp/control/
  • Follow the instructions

Upgrade

  • Backup your data! Perhaps work with a copy of your database.
  • Download the files and extract to your webserver
  • Check your MySQL user permissions--you will need SELECT, INSERT,

UPDATE, ALTER, DELETE, CREATE and DROP privileges

  • Point your browser to the control folder, i.e., www.yoursite.edu/sp/control/
  • Follow the instructions
  • If you have custom pluslets, look down to "updating custom pluslets"

Additional Configuration

After either installing or upgrading, you should go to admin > site config and look at the options.

Drag'n'drop catalog search box (used in guides) will need to be localized. Go to lib/SubjectsPlus/Control/Pluslet/lasses/5.php and put in your own search form. The default example is from a Voyager catalog (circa 2011) WITHOUT the form action being set.

Folder Permissions

For everything to work smoothly, some folders need special permissions which they might not have by default. (The first two probably were OK or else the installer would have conked out.)

/control/includes/config-default.php --- readable by php to make config.php

/control/includes/ --- writable by php to write config.php

/subjects/.htaccess --- writable by php to write .htaccess

/api/.htaccess --- writable by php to write .htaccess

/assests/users/ --- writable by php to make new user folders

/assets/images/video_thumbs --- writable by php to add new video thumbnails

Updating Custom Pluslets

If you have any custom pluslets. please follow the following steps to successfully migrate over.

Move custom pluslets from '/control/includes/classes' to '/lib/SubjectsPlus/Control/Pluslet'

Rename files to remove 'sp_Pluslet_'. For example, rename 'sp_Pluslet_111.php' to '111.php'

Edit each file to add the following lines to the top of the file:

namespace SubjectsPlus\Control;

require_once("Pluslet.php");

Edit each file to remove 'sp_' from class declaration. For example, edit 'class sp_Pluslet_6 extends sp_Pluslet {' to 'class Pluslet_6 extends Pluslet {'