source: main/trunk/greenstone3/resources/web/servlets.xml.svn@ 37716

Last change on this file since 37716 was 37716, checked in by davidb, 12 months ago

Fixed typo in comment
File size: 10.4 KB
Line 
1<servlet>
2 <!-- !!!! -->
3 <!-- This file was automatically generated from $GSDL3SRCHOME/resources/web/servlet.xml.in -->
4 <!-- !!!! -->
5
6 <servlet-name>library</servlet-name>
7 <description>The standard gsdl3 library program</description>
8 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
9 <!-- this is the servlet url path - needs to match what you have specified in servlet-mapping below -->
10 <init-param>
11 <param-name>library_name</param-name>
12 <param-value>library</param-value>
13 </init-param>
14
15 <!--
16 Production versions of Greenstone will typically need to set 'init-param' valus below if
17 the DL operates through a Reverse Proxy server, such as Apache2, which publically presents
18 externally over 'https' but internally routes things through to an http running instance
19 of tomcat providing Greenstone3.
20
21 For example, to have a Greenstone3 appear as:
22 https://mydomain.org/my-greenstone3/library
23
24 In your Apache2 configuration file include:
25
26 ProxyPass /my-greenstone3 http://localhost:8383/greenstone3
27 ProxyPassReverse /my-greenstone3 http://localhost:8383/greenstone3
28 <Location /my-greenstone3>
29 ProxyPassReverseCookiePath /greenstone3 /my-greenstone3
30 </Location>
31
32 The <Location> tags future proof things for the case where you run more than one
33 Greenstone3 on the same server. This can just be the ProxyPassReverseCookiePath
34 entry, if there is only one GS3 server running.
35
36 In the params below we break things down into constituent parts to make some of the
37 XSL template rules easier to write.
38 -->
39
40 <!--
41 Leave the following commented out if you are using http://localhost:8383/greenstone3/
42 as this is construted automatically from build.properties for use as the HTML <base> tag
43 -->
44 <!-- **** TODO: consider changing this to be built up from servlet_domain, servlet_opt_port, servlet_context / -->
45 <!--
46 <init-param>
47 <param-name>servlet_url_prefix</param-name>
48 <param-value>//mydomain.org//my-greenstone3/</param-value>
49 </init-param>
50 -->
51
52 <init-param>
53 <param-name>site_name</param-name>
54 <param-value>localsite</param-value>
55 </init-param>
56 <init-param>
57 <param-name>interface_name</param-name>
58 <param-value>default</param-value>
59 </init-param>
60 <init-param>
61 <param-name>receptionist_class</param-name>
62 <param-value>DefaultReceptionist</param-value>
63 </init-param>
64 <init-param>
65 <param-name>default_lang</param-name>
66 <param-value>en</param-value>
67 </init-param>
68 <init-param>
69 <!-- Does this servlet provide a favourites option? true/false-->
70 <param-name>favouritebasket</param-name>
71 <param-value>true</param-value>
72 </init-param>
73 <init-param>
74 <!-- Does this servlet provide a documentbasket option? true/false.
75Note, this currently doesn't work properly -->
76 <param-name>documentbasket</param-name>
77 <param-value>false</param-value>
78 </init-param>
79
80 <!--
81 The cookie consent manager is a component of the default interface that alerts the end user
82 to Greenstone's cookie usage. It also allows them to consent to non-essential cookies.
83 It can be customised by editing the 'cookieconsent-init.js' file in the default interface's 'js' folder.
84 To disable the manager for all interfaces that support it, remove or comment out this entire parameter.
85 -->
86 <init-param>
87 <param-name>cookie_consent</param-name>
88 <param-value>comment_this_entire_param_to_disable</param-value>
89 </init-param>
90 <!-- if you want to use a non standard greenstone cookie path (by default it will use greenstone.context in build.properties), then set the value of it here. If you are mapping to an address without this part (eg my-site.org/library) then cookie path will be / -->
91 <!--
92 <init-param>
93 <param-name>cookie_path</param-name>
94 <param-value>/greenstone3</param-value>
95 </init-param>
96 -->
97
98 <!-- ***** -->
99 <!-- Google related keys and id credentials -->
100 <!-- ***** -->
101
102 <!--
103 <init-param>
104 <param-name>google_tracking_id</param-name>
105 <param-value>UA-?????.....?????</param-value>
106 </init-param>
107 -->
108
109 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
110 <!-- More details at: https://developers.google.com/identity/sign-in/web/sign-in -->
111 <init-param>
112 <param-name>googlesignin_client_id</param-name>
113 <param-value>@googlesigninclientid@</param-value>
114 </init-param>
115 -->
116
117 <!-- For details on how to set up a Google API key to use with Google Maps, see:
118 https://developers.google.com/maps/documentation/javascript/get-api-key
119 -->
120 <!-- TLDR:
121 1. On the Credentials page, create an API key (copy the displayed value)
122 2. Then restrict it to your website
123 3. Further restrict calls to just Google Maps API
124 4. Give the key a name you will remember
125 5. Press Save
126 6. Paste the key into the <param-value> below
127 -->
128 <!--
129 <init-param>
130 <param-name>googlemaps_api_key</param-name>
131 <param-value>?????.....?????</param-value>
132 </init-param>
133 -->
134</servlet>
135
136<!-- the /* in the url-pattern below is necessary for the restful URLs to work.
137 e.g. greenstone3/library/collection/lucene-jdbm-demo/page/about
138-->
139<servlet-mapping>
140 <servlet-name>library</servlet-name>
141 <url-pattern>/library/*</url-pattern>
142</servlet-mapping>
143
144<servlet>
145 <servlet-name>halftone-library</servlet-name>
146 <description>A library servlet using the standard content, but with the halftone interface.</description>
147 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
148 <init-param>
149 <param-name>library_name</param-name>
150 <param-value>halftone-library</param-value>
151 </init-param>
152 <init-param>
153 <param-name>site_name</param-name>
154 <param-value>localsite</param-value>
155 </init-param>
156 <init-param>
157 <param-name>interface_name</param-name>
158 <param-value>halftone</param-value>
159 </init-param>
160 <init-param>
161 <param-name>receptionist_class</param-name>
162 <param-value>DefaultReceptionist</param-value>
163 </init-param>
164 <init-param>
165 <param-name>default_lang</param-name>
166 <param-value>en</param-value>
167 </init-param>
168
169 <!-- For Google Analytics -->
170 <!--
171 <init-param>
172 <param-name>google_tracking_id</param-name>
173 <param-value>UA-?????.....?????</param-value>
174 </init-param>
175 -->
176
177 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
178 <!--
179 <init-param>
180 <param-name>googlesignin_client_id</param-name>
181 <param-value>?????.....?????.apps.googleusercontent.com</param-value>
182 </init-param>
183 -->
184</servlet>
185
186<servlet-mapping>
187 <servlet-name>halftone-library</servlet-name>
188 <url-pattern>/halftone-library/*</url-pattern>
189</servlet-mapping>
190
191<!--<servlet>
192 <servlet-name>gs2-library</servlet-name>
193 <description>Greenstone 2 lookalike library program: uses localsite with the gs2 interface</description>
194 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
195 <init-param>
196 <param-name>library_name</param-name>
197 <param-value>gs2-library</param-value>
198 </init-param>
199 <init-param>
200 <param-name>site_name</param-name>
201 <param-value>localsite</param-value>
202 </init-param>
203 <init-param>
204 <param-name>interface_name</param-name>
205 <param-value>gs2</param-value>
206 </init-param>
207 <init-param>
208 <param-name>default_lang</param-name>
209 <param-value>en</param-value>
210 </init-param>
211 <init-param>
212 <param-name>session_expiration</param-name>
213 <param-value>1800</param-value>
214 </init-param>
215 <init-param>
216 <param-name>params_class</param-name>
217 <param-value>GS2Params</param-value>
218 </init-param>
219</servlet>
220
221<servlet-mapping>
222 <servlet-name>gs2-library</servlet-name>
223 <url-pattern>/gs2-library/*</url-pattern>
224</servlet-mapping>
225-->
226
227<!--<servlet>
228 <servlet-name>nzdl-library</servlet-name>
229 <description>gsdl3 library program</description>
230 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
231 <init-param>
232 <param-name>library_name</param-name>
233 <param-value>nzdl</param-value>
234 </init-param>
235 <init-param>
236 <param-name>site_name</param-name>
237 <param-value>nzdl</param-value>
238 </init-param>
239 <init-param>
240 <param-name>interface_name</param-name>
241 <param-value>nzdl</param-value>
242 </init-param>
243 <init-param>
244 <param-name>default_lang</param-name>
245 <param-value>en</param-value>
246 </init-param>
247 <init-param>
248 <param-name>params_class</param-name>
249 <param-value>NZDLParams</param-value>
250 </init-param>
251 <init-param>
252 <param-name>session_expiration</param-name>
253 <param-value>600</param-value>
254 </init-param>
255</servlet>
256
257<servlet-mapping>
258 <servlet-name>nzdl-library</servlet-name>
259 <url-pattern>/nzdl/*</url-pattern>
260</servlet-mapping>
261
262-->
263
264<!--<servlet>
265 <servlet-name>gateway</servlet-name>
266 <description>gsdl3 library based on gateway site and basic interface. It uses SOAP to talk to localsite</description>
267 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
268 <init-param>
269 <param-name>library_name</param-name>
270 <param-value>gateway</param-value>
271 </init-param>
272 <init-param>
273 <param-name>site_name</param-name>
274 <param-value>gateway</param-value>
275 </init-param>
276 <init-param>
277 <param-name>interface_name</param-name>
278 <param-value>basic</param-value>
279 </init-param>
280 <init-param>
281 <param-name>default_lang</param-name>
282 <param-value>en</param-value>
283 </init-param>
284</servlet>
285
286<servlet-mapping>
287 <servlet-name>gateway</servlet-name>
288 <url-pattern>/gateway/*</url-pattern>
289</servlet-mapping>
290-->
291
292<!--<servlet>
293 <servlet-name>basic-library</servlet-name>
294 <description>basic gsdl3 library program: uses localsite and the basic interface</description>
295 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
296 <init-param>
297 <param-name>library_name</param-name>
298 <param-value>basic-library</param-value>
299 </init-param>
300 <init-param>
301 <param-name>site_name</param-name>
302 <param-value>localsite</param-value>
303 </init-param>
304 <init-param>
305 <param-name>interface_name</param-name>
306 <param-value>basic</param-value>
307 </init-param>
308 <init-param>
309 <param-name>default_lang</param-name>
310 <param-value>en</param-value>
311 </init-param>
312 <init-param>
313 <param-name>allow_client_side_xslt</param-name>
314 <param-value>true</param-value>
315 </init-param>
316</servlet>
317
318<servlet-mapping>
319 <servlet-name>basic-library</servlet-name>
320 <url-pattern>/basic-library/*</url-pattern>
321</servlet-mapping>
322-->
Note: See TracBrowser for help on using the repository browser.