view jamendo/sparql-archived/SeRQL/lib/http_settings.pl @ 27:d95e683fbd35 tip

Enable CORS on urispace redirects as well
author Chris Cannam
date Tue, 20 Feb 2018 14:52:02 +0000
parents df9685986338
children
line wrap: on
line source
/*  This file is part of ClioPatria.

    Author:
    HTTP:	http://e-culture.multimedian.nl/
    GITWEB:	http://gollem.science.uva.nl/git/ClioPatria.git
    GIT:	git://gollem.science.uva.nl/home/git/ClioPatria.git
    GIT:	http://gollem.science.uva.nl/home/git/ClioPatria.git
    Copyright:  2007, E-Culture/MultimediaN

    ClioPatria 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.

    ClioPatria 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 ClioPatria.  If not, see <http://www.gnu.org/licenses/>.
*/

:- module(http_settings,
	  [ http_show_settings/3,	% +Options
	    http_apply_settings/4	% +Request, +Options
	  ]).
:- use_module(library('http/html_write')).
:- use_module(library('http/http_parameters')).
:- use_module(library(option)).
:- use_module(library(lists)).
:- use_module(library(debug)).
:- use_module(library(settings)).

%%	http_show_settings(+Options)// is det
%
%	Emit an HTML representation of the current settings.  Options:
%	
%		* edit(+Boolean)
%		
%		* hide_module(+Boolean)
%		If true, hide module headers from the user.
%		
%		* module(+ModuleList)
%		If present, only show settings from modules in ModuleList.
http_show_settings(Options) -->
	{ findall(M-N, current_setting(M:N), List),
	  keysort(List, Sorted),
	  join_by_key(Sorted, ByModule)
	},
	(   { option(edit(true), Options, true),
	      option(action(Action), Options, '/http/settings')
	    }
	->  html(form([ action(Action),
			method('GET')
		      ],
		      table(class('settings'),
			    \settings_table(ByModule, Options))))
	;   html(table(class('settings'),
		       \settings_table(ByModule, Options)))
	).

settings_table(ByModule, Options) -->
	(   {ByModule = [M-List],
	    \+ option(hide_module(_), Options)
	    }
	->  show_module(M, List, [hide_module(true)|Options])
	;   show_modules(ByModule, Options)
	),
	(   { option(edit(true), Options, true) }
	->  html(tr(td([ colspan(2),
			 align(right)
		       ],
		       [ input([ type(reset) ]),
			 input([ type(submit), value('Apply') ])
		       ])))
	;   []
	).


show_modules([], _) -->
	[].
show_modules([M-List|T], Options) -->
	show_module(M, List, Options),
	show_modules(T, Options).

show_module(Module, _Settings, Options) -->
	{ 
	    option(modules(ListOfModules), Options),
	    \+ memberchk(Module,ListOfModules), 
	    !
	}, 
	[].

show_module(Module, Settings, Options) -->
	show_module_header(Module, Options),
	show_settings(Settings, Module, odd, Options).

show_module_header(_Module, Options) -->
	{ option(hide_module(true), Options, false)}, !.
show_module_header(Module, _Options) -->
	html(tr(th([colspan(2), class('settings-module')], Module))).
	  
show_settings([], _, _, _) -->
	[].
show_settings([H|T], Module, EO, Options) -->
	show_setting(H, Module, EO, Options),
	{ negate_odd_even(EO, EO2) },
	show_settings(T, Module, EO2, Options).

show_setting(H, Module, EO, Options) -->
	{ setting_property(Module:H, comment(Comment)),
	  setting_property(Module:H, type(Type)),
	  setting(Module:H, Value),
	  debug(settings, '~w: type=~w', [H, Type])
	},
	html(tr(class('settings-entry-'+EO),
		[ td(class('settings-comment'), Comment),
		  td(class('settings-value'), 
		     \show_value(Type, Value, Module:H, Options))
		])).
			

show_value(Type, Value, Id, Options) -->
	{ option(edit(true), Options, true) }, !,
	input_value(Type, Value, Id).
show_value(Type, Value, _, _Options) -->
	show_value(Type, Value).

%%	show_value(+Type, +Value)// is det.
%
%	Emit a Value in non-editable representation.

show_value(list(Type), Values) --> !,
	html(div(class(list), \show_list(Values, Type))).
show_value(_, Value) -->
	{ format(string(S), '~w', [Value])
	},
	html(S).

show_list([], _) -->
	[].
show_list([H|T], Type) -->
	html(div(class('list-element'), \show_value(Type, H))),
	show_list(T, Type).


%%	input_value(+Type, +Value, +Id)// is det.
%
%	Emit an form-field for Value.

:- multifile
	input_item/5.			% input_item(+Type, +Value, +Id)//

input_value(Type, Value, Id) -->
	{ html_name(Id, Name) },
	(   input_item(Type, Value, Name)
	->  []
	;   builtin_input_item(Type, Value, Name)
	).

builtin_input_item(boolean, Value, Name) --> !,
	builtin_input_item(oneof([true,false]), Value, Name).
builtin_input_item(between(L,U), Value, Name) --> !,
	html(input([ type(range),
		     name(Name),
		     min(L), max(U), value(Value)
		   ])).
builtin_input_item(oneof(List), Value, Name) --> !,
	html(select([name(Name)], \oneof(List, Value))).
builtin_input_item(atom, Value, Name) --> !,
	html(input([name(Name), size(40), value(Value)])).
builtin_input_item(_, Value, Name) -->
	{ format(string(S), '~q', [Value])
	},
	html(input([name(Name), size(40), value(S)])).

oneof([], _) -->
	[].
oneof([H|T], Value) -->
	(   {H == Value}
	->  html([ option([selected(selected),value(H)], H) ])
	;   html([ option([                   value(H)], H) ])
	),
	oneof(T, Value).


		 /*******************************
		 *	   APPLY SETTINGS	*
		 *******************************/

%%	http_apply_settings(+Request, +Options)// is det
%
%	Process  form  data  created   by  http_show_settings//1,  apply
%	changes to the settings and create   a  feedback page indicating
%	which settings have changed.  Options:
%	
%		* save(Boolean)
%		If =true= and some settings have changed, call
%		save_settings/0.  
%		
%		* save_as(File)
%		If some settings have changed, call save_settings(File).
%		The option =save_as= overrules =save=.

http_apply_settings(Request, Options) -->
	{ http_parameters(Request, [],
			  [ form_data(Data)
			  ]),
	  debug(settings, 'Form data: ~p', [Data]),
	  phrase(process_settings_form(Data), Changes)
	},
	report_changed(Changes, Options).
	

report_changed([], _) -->
	html(div(class('settings.updated'), 'No changes')).
report_changed(L, _) -->
	{ memberchk(error(_), L) },
	report_errors(L).
report_changed(L, Options) -->
	{ length(L, N),
	  forall(member(change(Id, _, Value), L),
		 set_setting(Id, Value)),
	  (   option(save_as(File), Options)
	  ->  save_settings(File)
	  ;   option(save(true), Options, true)
	  ->  save_settings
	  ;   true
	  )
	},
	html(div(class('settings.updated'), ['Changed ', N, ' settings'])).

report_errors([]) --> 
	[].
report_errors([error(Error)|T]) -->
	report_error(Error),
	report_errors(T).
report_errors([_|T]) -->
	report_errors(T).

report_error(no_setting(Id)) -->
	{ format(string(Name), '~w', [Id]) },
	html(div(class('settings.error'), ['Setting ', Name, ' does not exist.'])).
report_error(bad_value(Id, RawValue)) -->
	{ format(string(Name), '~w', [Id]) },
	html(div(class('settings.error'), ['Wrong value for ', Name, ': ', RawValue])).
	

%%	process_settings_form(+FormData)//
%
%	Process the raw form data, producing a list holding terms of the
%	form:
%	
%		* error(no_setting(Setting))
%		* error(bad_value(Setting, Value))
%		* change(Setting, Old, New)

process_settings_form([]) -->
	[].
process_settings_form([Name = Value|T]) -->
	(   { html_name(Setting, Name) }
	->  process_form_field(Setting, Value)
	;   [ error(no_setting(Name)) ]
	),
	process_settings_form(T).

process_form_field(Id, RawValue) -->
	(   { setting_property(Id, type(Type)) }
	->  (   { catch(convert_setting_text(Type, RawValue, Value), _, fail) }
	    ->	{ setting(Id, OldValue) },
		(   { Value == OldValue }
		->  []
		;   [change(Id, OldValue, Value)]
		)
	    ;	[ error(bad_value(Id, RawValue))]
	    )
	;   [ error(no_setting(Id)) ]
	).
	      


		 /*******************************
		 *	       UTIL		*
		 *******************************/

%%	html_name(+Settings, -Name) is det.
%%	html_name(-Settings, +Name) is det.
%
%	Convert between Module:Setting and Name for use in form-fields.

html_name(Module:Setting, Name) :-
	concat_atom([Module, Setting], ':', Name).


%%	negate_odd_even(+OddEven, -EventOdd)

negate_odd_even(odd, even).
negate_odd_even(even, odd).

%%	join_by_key(+KeyedList, -Joined:list(Key-Values)) is det.
%
%	Join values on the same key of a list sorted by keysort/1.

join_by_key([], []).
join_by_key([M-N|T0], [M-[N|TN]|T]) :-
	same_key(M, T0, TN, T1),
	join_by_key(T1, T).

same_key(M, [M-N|T0], [N|TN], T) :- !,
	same_key(M, T0, TN, T).
same_key(_, L, [], L).