Recent changes to Installation Instructions

Installation Instructions modified by Peter Bowers

Peter Bowers — Mon, 05 Jan 2015 21:40:38 -0000

--- v11
+++ v12
@@ -18,7 +18,7 @@

 Troubleshooting:

-1. If you get "Internal Errors" go into app/Config/core.php and set debug from 0 to 2.
+1. If you get "Internal Errors" go into app/Config/core.php and set debug from 0 to 2.  You'll probably need to log in again, but then you should get a much more helpful error message.

 2. If you get errors regarding timezone, go into app/Config/core.php and uncomment the line containing the date_default_timezone_set() call and change it from 'UTC' to the appropriate value for your locale.

Installation Instructions modified by Peter Bowers

Peter Bowers — Sat, 03 Jan 2015 15:51:07 -0000

--- v10
+++ v11
@@ -13,17 +13,8 @@
         * other elements may be modified if needed but should not normally require change
     * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database
         * prefix is not yet implemented
-4. Initial setup
-    * From your browser, go to the URL corresponding to the ptsignup/users/superlogin directory (www.example.com/ptsignup/users/superlogin)
-    * Enter your sycamore username and password and approve the app (click on yes).
-    * When it comes back from Sycamore to your URL, ignore errors and click on the Admin Menu  (or append "/admin" to the URL -- `www.example.com/ptsignup/admin`)
-        * The "(Re-)Login as Superuser" option simply goes to the superlogin URL you already used.
-    * Now proceed through the 3 import stages in order.  Each one may take multiple minutes so be patient.  At the end of each import stage you will be redirected back to the admin menu.
-    * Click on the "view/edit Time Slots" button and add time slots as appropriate for the day(s) and time(s) you wish to hold your conferences.  When you are done go back to the Admin Menu.
-    * Optionally edit other information, deleting teachers, etc.
-    * Click on the "Fill Slots" button. It should report back a relatively large number of slots created (calculate one slot for each teacher for each timeslot)

-Now your system is ready for parents to log in.  They will go to the same URL referenced in "Initial setup" (www.example.com/ptsignup, for instance) and they will be taken to Sycamore where they will need to log in and approve the app.  When they come back they will be able to click on the slots they want to sign up for.
+Proceed to Initial Setup instructions in [Administrator Instructions].

 Troubleshooting:

Installation Instructions modified by Peter Bowers

Peter Bowers — Sat, 03 Jan 2015 15:21:31 -0000

--- v9
+++ v10
@@ -14,16 +14,13 @@
     * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database
         * prefix is not yet implemented
 4. Initial setup
-    * From your browser, go to the URL corresponding to the ptsignup directory
-    * You will be taken to Sycamore to log in - you must log in with a user with superuser authorization
-    * You must approve the app (click on yes)
-    * When you are taken back to the URL on your server it will report an error because you have no data.  Click on the "Admin Menu" button or append "/admin" to the URL.
-    * Now you will have to click on the "re-log in" button in order to truly get superuser authority.
-        * If you want to bypass this step then instead of a URL to the ptsignup directory in the first step you should append "/users/login/superuser:1" to that url.  So it might look like "http://www.example.com/ptsignup/users/login/superuser:1
-    * Re-enter your sycamore username and password and approve the app again (click on yes).
-    * When it comes back, once again go to the Admin Menu  (either by clicking the button or by appending /admin to the URL)
-    * Now proceed through the 3 import stages in order.  Each one may take 1-5 minutes so be patient.
+    * From your browser, go to the URL corresponding to the ptsignup/users/superlogin directory (www.example.com/ptsignup/users/superlogin)
+    * Enter your sycamore username and password and approve the app (click on yes).
+    * When it comes back from Sycamore to your URL, ignore errors and click on the Admin Menu  (or append "/admin" to the URL -- `www.example.com/ptsignup/admin`)
+        * The "(Re-)Login as Superuser" option simply goes to the superlogin URL you already used.
+    * Now proceed through the 3 import stages in order.  Each one may take multiple minutes so be patient.  At the end of each import stage you will be redirected back to the admin menu.
     * Click on the "view/edit Time Slots" button and add time slots as appropriate for the day(s) and time(s) you wish to hold your conferences.  When you are done go back to the Admin Menu.
+    * Optionally edit other information, deleting teachers, etc.
     * Click on the "Fill Slots" button. It should report back a relatively large number of slots created (calculate one slot for each teacher for each timeslot)

 Now your system is ready for parents to log in.  They will go to the same URL referenced in "Initial setup" (www.example.com/ptsignup, for instance) and they will be taken to Sycamore where they will need to log in and approve the app.  When they come back they will be able to click on the slots they want to sign up for.

Installation Instructions modified by Peter Bowers

Peter Bowers — Fri, 02 Jan 2015 00:08:17 -0000

--- v8
+++ v9
@@ -13,6 +13,20 @@
         * other elements may be modified if needed but should not normally require change
     * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database
         * prefix is not yet implemented
+4. Initial setup
+    * From your browser, go to the URL corresponding to the ptsignup directory
+    * You will be taken to Sycamore to log in - you must log in with a user with superuser authorization
+    * You must approve the app (click on yes)
+    * When you are taken back to the URL on your server it will report an error because you have no data.  Click on the "Admin Menu" button or append "/admin" to the URL.
+    * Now you will have to click on the "re-log in" button in order to truly get superuser authority.
+        * If you want to bypass this step then instead of a URL to the ptsignup directory in the first step you should append "/users/login/superuser:1" to that url.  So it might look like "http://www.example.com/ptsignup/users/login/superuser:1
+    * Re-enter your sycamore username and password and approve the app again (click on yes).
+    * When it comes back, once again go to the Admin Menu  (either by clicking the button or by appending /admin to the URL)
+    * Now proceed through the 3 import stages in order.  Each one may take 1-5 minutes so be patient.
+    * Click on the "view/edit Time Slots" button and add time slots as appropriate for the day(s) and time(s) you wish to hold your conferences.  When you are done go back to the Admin Menu.
+    * Click on the "Fill Slots" button. It should report back a relatively large number of slots created (calculate one slot for each teacher for each timeslot)
+
+Now your system is ready for parents to log in.  They will go to the same URL referenced in "Initial setup" (www.example.com/ptsignup, for instance) and they will be taken to Sycamore where they will need to log in and approve the app.  When they come back they will be able to click on the slots they want to sign up for.

 Troubleshooting:

Installation Instructions modified by Peter Bowers

Peter Bowers — Thu, 01 Jan 2015 23:26:51 -0000

--- v7
+++ v8
@@ -13,3 +13,11 @@
         * other elements may be modified if needed but should not normally require change
     * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database
         * prefix is not yet implemented
+
+Troubleshooting:
+
+1. If you get "Internal Errors" go into app/Config/core.php and set debug from 0 to 2.
+
+2. If you get errors regarding timezone, go into app/Config/core.php and uncomment the line containing the date_default_timezone_set() call and change it from 'UTC' to the appropriate value for your locale.
+
+3. If you have difficulty with 404 (page not found) errors you may need to include a RewriteBase of your sub-directory ("RewriteBase /ptsignup", for example) in the .htaccess files in ptsignup and ptsignup/app and ptsignup/app/webroot.

Installation Instructions modified by Peter Bowers

Peter Bowers — Thu, 01 Jan 2015 21:41:08 -0000

--- v6
+++ v7
@@ -1,7 +1,7 @@
 1. Download the code and place it on the server
     * Use svn with this repository: svn://svn.code.sf.net/p/ptsignup/svn
         * `svn checkout --username=yourusername svn+ssh://pbowers@svn.code.sf.net/p/ptsignup/svn ptsignup-svn`
-    * Place the files downloaded in a directory called ptsignup on your server
+    * Place the files downloaded in a directory called ptsignup on your server (in your htdocs or www directory, presumably)
 2. Set up your database
     * Execute the commands within ptsignup.sql (in the root of those files).  This can be done by copy/paste into the SQL window in phpMyAdmin or by running the script directly.
 3. Modify configuration files

Installation Instructions modified by Peter Bowers

Peter Bowers — Thu, 01 Jan 2015 21:40:27 -0000

--- v5
+++ v6
@@ -1,5 +1,6 @@
 1. Download the code and place it on the server
     * Use svn with this repository: svn://svn.code.sf.net/p/ptsignup/svn
+        * `svn checkout --username=yourusername svn+ssh://pbowers@svn.code.sf.net/p/ptsignup/svn ptsignup-svn`
     * Place the files downloaded in a directory called ptsignup on your server
 2. Set up your database
     * Execute the commands within ptsignup.sql (in the root of those files).  This can be done by copy/paste into the SQL window in phpMyAdmin or by running the script directly.

Installation Instructions modified by Peter Bowers

Peter Bowers — Wed, 31 Dec 2014 20:54:57 -0000

--- v4
+++ v5
@@ -7,7 +7,7 @@
     * app/Config/ptsignup.php
         * client_id and client_secret are according to the Sycamore app
             * you must create your own at https://app.sycamoreeducation.com/developer/applications.php?task=applications
-        * url and path should match your server and location where ptsignup is installed
+        * url and path should match your server and location where ptsignup is installed (from step #1 above)
         * cookie_key should be a long, random password
         * other elements may be modified if needed but should not normally require change
     * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database

Installation Instructions modified by Peter Bowers

Peter Bowers — Wed, 31 Dec 2014 20:54:10 -0000

--- v3
+++ v4
@@ -6,6 +6,7 @@
 3. Modify configuration files
     * app/Config/ptsignup.php
         * client_id and client_secret are according to the Sycamore app
+            * you must create your own at https://app.sycamoreeducation.com/developer/applications.php?task=applications
         * url and path should match your server and location where ptsignup is installed
         * cookie_key should be a long, random password
         * other elements may be modified if needed but should not normally require change

Installation Instructions modified by Peter Bowers

Peter Bowers — Wed, 31 Dec 2014 20:50:12 -0000

--- v2
+++ v3
@@ -9,4 +9,5 @@
         * url and path should match your server and location where ptsignup is installed
         * cookie_key should be a long, random password
         * other elements may be modified if needed but should not normally require change
-    * app/Config/database.php - change host, username, password, etc. as appropriate for your database
+    * app/Config/database.php - change host, login, password, database, etc. as appropriate for your database
+        * prefix is not yet implemented