-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
122 lines (81 loc) · 5.21 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
RosterSynch is a Penn State specific product designed to enable integrators (or site managers)
to control access to their sites. It is made to work in conjunction with the PSU ANGEL API. The developer must set up
access to this API prior to using RosterSynch.
Installation
In old-school Plone style, copy the RosterSynch folder to your products directory and restart your zope instance.
Install the product in your Plone site through the Add-On Products control panel (or via the ZMI portal quick installer).
**With Buildout**
If you use buildout, you can use the infrae.subversion recipe to pull this directly from the WebLion repository. See the following
example.
In buildout.cfg:
Add a line to your [buildout] parts section. You can call it whatever you like (I call mine externals in this example).
<pre>'[buildout]
parts =
...
externals
...'
</pre>
Then add the externals section:
<pre>'[externals]
recipe = infrae.subversion
urls = https://weblion.psu.edu/svn/weblion/collegeOfIst/RosterSynch RosterSynch'
</pre>
Finally, add a line to the products section of your [instance]
<pre>'[instance]
products =
...
${buildout:directory}/parts/externals
...'
</pre>
Re-run buildout and it should pull this new product.
Install the product in your Plone site through the Add-On Products control panel (or via the ZMI portal quick installer).
Configuration
Special Notes:
1. You will have to set up access to the ANGEL api with the PSU ANGEL team.
2. Your python must be compiled with ssl support to open secure (https) urls.
Setup Options:
**_Required Fields_**
* **API URL** - Required. This tells RosterSynch where to find the roster. Some servers will have access to the production api and
some the development api. You also may want to just point this to a test file while you are experimenting with the product. This property
allows you to change that without editing the python script.
* **API Username** - Required. Get this from the ANGEL team.
* **API Password** - Required. Get this from the ANGEL team.
* **Section ID** - Required. This number is found in ANGEL. See the screenshot link on the setup page to see where you find this number.
The format of this ID is very important (including the spaces), so don't edit it.
**_Optional Fields_**
Use the following fields to grant access to users who are not in the ANGEL Roster.
**NOTE: All additional users should be added here instead of through the standard Plone User Management tool. Only users here
and in the ANGEL roster are respected when RosterSynch is run. If users are not listed in one of these two places, they will be removed from the
the Plone users and groups.**
To add users to your site, add them to the appropriate group below. To remove users from your site, remove them from the groups below or remove
then from your course in ANGEL.
* **Additional Instructors** - Optional. If you add users here, RosterSynch will create that user and add him or her to the Instructors group.
If you wish to remove those users, remove them from this list and re-run RosterSynch.
* **Addtional Course Editors** - Optional. If you add users here, RosterSynch will create that user and add him or her to the Course Editors group.
If you wish to remove those users, remove them from this list and re-run RosterSynch.
* **Addtional Course Editors** - Optional. If you add users here, RosterSynch will create that user and add him or her to the Students group.
If you wish to remove those users, remove them from this list and re-run RosterSynch.
To Do List
- Enable option to create plone users during RosterSynch.
- Enable importing of ANGEL groups into plone site.
- Write some tests.
Credits and Contact
Credit for inspiration and paving the way for this go to the members of the former IST Solutions Institute. Thanks also goes to the PSU WebLion team for
their help and patience in answering questions. To the degree that this product is useful, credit goes to those parties.
On the other hand, problems, bugs and other issues are the fault of Joe DeLuca, who did most of the work on this project. If you find issues, please contact
him at jdeluca at psu dot edu. He would also like to hear your comments and suggestions for improvements for future versions.
License
Copyright (c) 2008 The Pennsylvania State University.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
This document is written using the Structured Text format for conversion
into alternative formats.