- Publicity: Public Only All
util-procs.tcl
Utility procedures for the ArsDigita Templating System
- Location:
- packages/acs-templating/tcl/util-procs.tcl
- Authors:
- Karl Goldstein <karlg@arsdigita.com>
- Stanislav Freidin <sfreidin@arsdigita.com>
- CVS Identification:
$Id: util-procs.tcl,v 1.45 2024/09/11 06:15:48 gustafn Exp $
Procedures in this file
- anchor_form (public)
- stack_dump (public, deprecated)
- template::resource_path (public)
- template::stack_dump (public)
- template::stack_frame_values (private)
- template::streaming_template (public)
- template::themed_template (public)
- template::util::array_to_vars (public, deprecated)
- template::util::get_opts (public)
- template::util::get_url_directory (public)
- template::util::is_nil (public)
- template::util::is_true (public, deprecated)
- template::util::is_unique (public)
- template::util::list_of_lists_to_array (public)
- template::util::list_of_ns_sets_to_multirow (public)
- template::util::list_to_array (public, deprecated)
- template::util::list_to_lookup (public)
- template::util::list_to_multirow (public)
- template::util::lnest (public)
- template::util::lpop (public)
- template::util::master_to_file (public)
- template::util::multirow_quote_html (public)
- template::util::multirow_to_list (public)
- template::util::number_list (public)
- template::util::nvl (public, deprecated)
- template::util::read_file (public)
- template::util::resolve_directory_url (public)
- template::util::set_file_encoding (public)
- template::util::url_to_file (public)
- template::util::vars_to_array (public, deprecated)
- template::util::write_file (public)
Detailed information
anchor_form (public)
anchor_form [ -id id ] [ -vars vars ] [ -action action ] \ [ -label label ]
return an inline form with the appearance of an anchor
- Switches:
- -id (optional)
- -vars (optional)
- -action (optional)
- -label (optional, defaults to
"link"
)- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
stack_dump (public, deprecated)
stack_dump
Deprecated. Invoking this procedure generates a warning.
return the whole call stack as HTML DEPRECATED: does not comply with OpenACS naming convention.
- See Also:
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::resource_path (public)
template::resource_path [ -verbose ] -type type -style style \ [ -relative ] [ -subsite_id subsite_id ] [ -theme_dir theme_dir ]
Process the templating "style" and return the stub (path without extensions). When the style is not an absolute path, check if the resource can be obtained from the theme, if not fallback to the resources directory of acs-templating.
- Switches:
- -verbose (optional, boolean, defaults to
"false"
)- -type (required)
- type of resource (e.g. "forms" or "lists")
- -style (required)
- name of the resource within the type (e.g. "standard")
- -relative (optional, boolean)
- return optionally the path relative to the OpenACS root directory
- -subsite_id (optional)
- subsite_id to determine theming information
- -theme_dir (optional)
- theming directory (alternative to determination via subsite), higher priority
- Returns:
- path of the resource (without extension)
- Author:
- Gustaf Neumann
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::stack_dump (public)
template::stack_dump
Return the whole call stack as HTML
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::stack_frame_values (private)
template::stack_frame_values level
return the variables and arrays of one frame as HTML
- Parameters:
- level (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::streaming_template (public)
template::streaming_template [ -subsite_id subsite_id ]
Return the path of the streaming template
- Switches:
- -subsite_id (optional)
- id of the subsite. Defaults to [ad_conn subsite_id]
- Returns:
- path to themed template
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::themed_template (public)
template::themed_template [ -verbose ] path
Given a path like /packages/acs-admin/www/index pointing to an .adp file, this function tries to locate this path in the ResourceDir of the subsite (determined by the theme). If found the themed template is returned, otherwise the passed template path.
- Switches:
- -verbose (optional, boolean, defaults to
"false"
)- Parameters:
- path (required)
- absolute path within the open acs tree (without extension)
- Returns:
- path to themed template or input value (without extension)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::array_to_vars (public, deprecated)
template::util::array_to_vars arrayname
Deprecated. Invoking this procedure generates a warning.
Declare local variables for every key in an array.
- Parameters:
- arrayname (required)
- The name of an array in the calling frame. DEPRECATED: this is a trivial idiom that can just be inlined.
- See Also:
- array
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::get_opts (public)
template::util::get_opts argv
Builds an array named "opts" in the calling frame, containing all switches passed at the end of a proc. The array values are either switch parameters or 1 if no parameter was specified. Problem: there is currently no way to specify an option parameter that begins with a dash. This particularly problematic for negative numbers.
- Parameters:
- argv (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- get_opts
template::util::get_url_directory (public)
template::util::get_url_directory url
Get the directory portion of a URL. If the URL has a trailing slash, then return the entire URL.
- Parameters:
- url (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- get_url_directory
template::util::is_nil (public)
template::util::is_nil ref
Determines whether a variable both exists and is not an empty string.
- Parameters:
- ref (required)
- The name of a variable to test in the calling frame.
- Returns:
- 1 if the variable either not exist or is an empty string. 0 if the variable is either an array reference or a nonempty scalar.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- util_is_nil
template::util::is_true (public, deprecated)
template::util::is_true x
Deprecated. Invoking this procedure generates a warning.
interprets its argument as a boolean.
- Parameters:
- x (required)
- the value to test DEPRECATED 5.10.1: since October 2015 this proc is implemented via the standard Tcl idiom "string is true -strict ..." that can be easily inlined.
- Returns:
- 0 if the variable can be interpreted as false; 1 for true if it can't.
- See Also:
- string
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::is_unique (public)
template::util::is_unique table columns values
Queries a database table for the existence of a particular row. Useful for validating form input to reduce the possibility of unique constraint violations.
- Parameters:
- table (required)
- The name of a database table.
- columns (required)
- A list of columns on which to select the row.
- values (required)
- A list of values for each specified column.
- Returns:
- 1 if the row exists, 0 if not
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::list_of_lists_to_array (public)
template::util::list_of_lists_to_array lists array_ref
Converts a list of lists in the form { { key value } { key value } ... } to an array.
- Parameters:
- lists (required)
- array_ref (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::list_of_ns_sets_to_multirow (public)
template::util::list_of_ns_sets_to_multirow -rows rows \ -var_name var_name [ -level level ]
Transform a list of ns_sets (e.g. produced by db_list_of_ns_sets) into a multirow datasource.
- Switches:
- -rows (required)
- The data to be transformed
- -var_name (required)
- The name of the multirow to create
- -level (optional, defaults to
"1"
)- How many levels up the stack to place the new datasource, defaults to 1 level up.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::list_to_array (public, deprecated)
template::util::list_to_array values array_ref columns
Deprecated. Invoking this procedure generates a warning.
Converts a list of values into an array, using a list of corresponding column names for the array keys.
- Parameters:
- values (required)
- A list of values
- array_ref (required)
- The name of the array to create in the calling frame.
- columns (required)
- A list of column names to use for the array keys. The length of this list should be the same as the values list. DEPRECATED: as of August 2022 no OpenACS code is using this proc. The operation it implements can be easily achieved via plain Tcl idioms.
- See Also:
- array
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::list_to_lookup (public)
template::util::list_to_lookup values array_ref
Turn a list into an array where each key corresponds to an element of the list... Sort of like a sparse bitmap. Each value corresponds to the key's position in the input list.
- Parameters:
- values (required)
- A list of values
- array_ref (required)
- The name of the array to create in the calling frame.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- util_list_to_lookup
template::util::list_to_multirow (public)
template::util::list_to_multirow name rows [ level ]
populate a multirow data source from a list string gotten from a call to template::util::multirow_to_list
- Parameters:
- name (required)
- the name of a multirow data source
- rows (required)
- a representation of a multirow data source as a list, suitable for passing by value in the form { { row } { row } { row } ... }
- level (optional, defaults to
"1"
)- See Also:
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::lnest (public)
template::util::lnest listref value next [ args... ]
Recursive procedure for building a hierarchical or multidimensional data structure in a list.
- Parameters:
- listref (required)
- value (required)
- Either a list or scalar value to store in the list.
- next (required)
- A key value that determines the next node to traverse outward in the data structure.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::lpop (public)
template::util::lpop ref
Removes the last item from a list. The operation is performed in-place, rather than returning the new list.
- Parameters:
- ref (required)
- The name of a list in the calling frame on which to operate.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- xowiki_test_cases, create_form_with_form_instance
template::util::master_to_file (public)
template::util::master_to_file url [ reference_url ]
Resolve a URL into an absolute file path, but respect styled master configuration for named masters (e.g. acs-templating/resources/masters/... containing 2cols.adp)
- Parameters:
- url (required)
- reference_url (optional)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::multirow_quote_html (public)
template::util::multirow_quote_html multirow_ref column_ref
implements template::util::quote_html on the designated column of a multirow
- Parameters:
- multirow_ref (required)
- name of the multirow
- column_ref (required)
- name of the column to be
- Author:
- simon
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::multirow_to_list (public)
template::util::multirow_to_list [ -level level ] name
generate a list structure representative of a multirow data source NB: if the multirow is generated by db_multirow, db_multirow must be called with the -local option
- Switches:
- -level (optional, defaults to
"1"
)- Parameters:
- name (required)
- the name of an existing multirow data source
- Returns:
- a representation of a multirow data source as a list, suitable for passing by value in the form { { row } { row } { row } ... }
- See Also:
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::number_list (public)
template::util::number_list last_number [ start_at ]
Return a list of numbers, {1 2 3 ... n}
- Parameters:
- last_number (required)
- start_at (optional, defaults to
"0"
)- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- number_list
template::util::nvl (public, deprecated)
template::util::nvl value value_if_null
Deprecated. Invoking this procedure generates a warning.
Analogous to SQL NVL DEPRECATED: a plain Tcl oneliner can easily replace this proc
- Parameters:
- value (required)
- value_if_null (required)
- See Also:
- expr {$value ne "" ? $value : $value_if_null}
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::read_file (public)
template::util::read_file path
Reads a text file.
- Parameters:
- path (required)
- The absolute path to the file
- Returns:
- A string with the contents of the file.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_file_get_document, read_write_file
template::util::resolve_directory_url (public)
template::util::resolve_directory_url url
Resolve the filename for a directory URL
- Parameters:
- url (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::set_file_encoding (public)
template::util::set_file_encoding file_channel_id
Set encoding of the given file channel based on the OutputCharset parameter of AOLserver. All ADP, Tcl, and txt files are assumed to be in the same charset.
- Parameters:
- file_channel_id (required)
- The id of the file to set encoding for.
- Author:
- Peter Marklund
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- read_write_file
template::util::url_to_file (public)
template::util::url_to_file url [ reference_url ]
Resolve a URL into an absolute file path.
- Parameters:
- url (required)
- reference_url (optional)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::vars_to_array (public, deprecated)
template::util::vars_to_array arrayname [ args... ]
Deprecated. Invoking this procedure generates a warning.
Place local variables into an array
- Parameters:
- arrayname (required)
- The name of an array in the calling frame.
- See Also:
- array
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
template::util::write_file (public)
template::util::write_file path text
Writes a text file
- Parameters:
- path (required)
- The absolute path to the file
- text (required)
- A string containing the text to write to the file.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- read_write_file
Content File Source
ad_library { Utility procedures for the ArsDigita Templating System @author Karl Goldstein (karlg@arsdigita.com) @author Stanislav Freidin (sfreidin@arsdigita.com) @cvs-id $Id: util-procs.tcl,v 1.45 2024/09/11 06:15:48 gustafn Exp $ } # Copyright (C) 1999-2000 ArsDigita Corporation # This is free software distributed under the terms of the GNU Public # License. Full text of the license is available from the GNU Project: # http://www.fsf.org/copyleft/gpl.html namespace eval template {} namespace eval template::util {} namespace eval template::query {} ad_proc -public template::util::get_opts { argv } { Builds an array named "opts" in the calling frame, containing all switches passed at the end of a proc. The array values are either switch parameters or 1 if no parameter was specified. Problem: there is currently no way to specify an option parameter that begins with a dash. This particularly problematic for negative numbers. } { upvar opts opts set size [llength $argv] # append a switch break lappend argv "-*" for { set i 0 } { $i < $size } {} { # Get a switch set opt [string trimleft [lindex $argv $i] -] # Get the next arg set next [lindex $argv [incr i]] if { [string index $next 0] ne "-" || ![regexp {[a-zA-Z*]} [string index $next 1] match] } { # the next arg was not a switch so assume it is a parameter set opts($opt) $next # advance the counter past the switch parameter incr i } else { # the next arg was a switch so just use 1 as the parameter set opts($opt) 1 } } } # * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * # * Utility procedures for manipulating lists, arrays and ns_sets * # * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ad_proc -public template::util::is_nil { ref } { Determines whether a variable both exists and is not an empty string. @param ref The name of a variable to test in the calling frame. @return 1 if the variable either not exist or is an empty string. 0 if the variable is either an array reference or a nonempty scalar. } { upvar $ref var return [expr { ![array exists var] && (![info exists var] || $var eq "") }] } ad_proc -public template::util::is_unique { table columns values } { Queries a database table for the existence of a particular row. Useful for validating form input to reduce the possibility of unique constraint violations. @param table The name of a database table. @param columns A list of columns on which to select the row. @param values A list of values for each specified column. @return 1 if the row exists, 0 if not } { set query "select count(*) from $table where " for { set i 0 } { $i < [llength $columns] } { incr i } { set value [ns_dbquotevalue [lindex $values $i]] lappend conditions "[lindex $columns $i] = $value" } append query [join $conditions " and "] set count [db_string get_count $query] return [expr {$count == 0}] } ad_proc -deprecated template::util::is_true { x } { interprets its argument as a boolean. @param x the value to test DEPRECATED 5.10.1: since October 2015 this proc is implemented via the standard Tcl idiom "string is true -strict ..." that can be easily inlined. @see string @return 0 if the variable can be interpreted as false; 1 for true if it can't. } { #expr {[string tolower $x] ni {0 f false n no off ""}} string is true -strict $x } ad_proc -public template::util::lpop { ref } { Removes the last item from a list. The operation is performed in-place, rather than returning the new list. @param ref The name of a list in the calling frame on which to operate. } { upvar $ref the_list set the_list [lrange $the_list 0 end-1] } ad_proc -public template::util::lnest { listref value next args } { Recursive procedure for building a hierarchical or multidimensional data structure in a list. @param value Either a list or scalar value to store in the list. @param next A key value that determines the next node to traverse outward in the data structure. @param args Subsequent nodes to traverse. } { upvar $listref inlist if { ! [info exists inlist] } { set inlist [list] } # inlist represents the top level of the data structure into which # we are inserting. We need to turn the list into an array to determine # which branch to follow next. array set values $inlist # next determines the next branch to follow as we look for the proper # location of the value. if the key is not found, create a new branch by # adding an empty list to inlist if { [info exists values($next)] } { set next_list $values($next) } else { set next_list [list] } # the number of additional arguments after next determines how many # more branches or levels we need to traverse before reaching the actual # insertion point into the data structure. set remaining [llength $args] if { $remaining == 0 } { # we have reached a leaf lappend next_list $value } elseif { $remaining == 1 } { # continue for one more step to the leaf lnest next_list $value [lindex $args 0] } else { # more branches to go. Call the procedure recursively starting with # the current branch. lnest next_list $value [lindex $args 0] [lrange $args 1 end] } # At this point the branch has been updated. Update the branch in the # array. set values($next) $next_list # Update inlist. set inlist [array get values] } ad_proc -deprecated template::util::array_to_vars { arrayname } { Declare local variables for every key in an array. @param arrayname The name of an array in the calling frame. DEPRECATED: this is a trivial idiom that can just be inlined. @see array } { upvar $arrayname arr foreach { key value } [array get arr] { uplevel [list set $key $value] } } ad_proc -deprecated template::util::vars_to_array { arrayname args } { Place local variables into an array @param arrayname The name of an array in the calling frame. @param args Any number of local variables to include in the array DEPRECATED: this is a trivial idiom that can just be inlined. @see array } { upvar $arrayname arr foreach var $args { upvar $var value set arr($var) $value } } ad_proc -deprecated template::util::list_to_array { values array_ref columns } { Converts a list of values into an array, using a list of corresponding column names for the array keys. @param values A list of values @param array_ref The name of the array to create in the calling frame. @param columns A list of column names to use for the array keys. The length of this list should be the same as the values list. DEPRECATED: as of August 2022 no OpenACS code is using this proc. The operation it implements can be easily achieved via plain Tcl idioms. @see array } { upvar $array_ref array for { set i 0 } { $i < [llength $values] } { incr i } { set key [lindex $columns $i] set value [lindex $values $i] set array($key) $value } } ad_proc -public template::util::list_of_lists_to_array { lists array_ref } { Converts a list of lists in the form { { key value } { key value } ... } to an array. } { upvar $array_ref array foreach pair $lists { lassign $pair key value set array($key) $value } } ad_proc -public template::util::list_to_lookup { values array_ref } { Turn a list into an array where each key corresponds to an element of the list... Sort of like a sparse bitmap. Each value corresponds to the key's position in the input list. @param values A list of values @param array_ref The name of the array to create in the calling frame. } { upvar $array_ref array set i 1 foreach element $values { set array($element) $i incr i } } d_proc -public template::util::multirow_to_list { {-level 1} name } { generate a list structure representative of a multirow data source <b>NB:</b> if the multirow is generated by db_multirow, db_multirow must be called with the -local option @param name the name of an existing multirow data source @return a representation of a multirow data source as a list, suitable for passing by value in the form { { row } { row } { row } ... } @see template::util::list_to_multirow } { upvar $level $name:rowcount rowcount set rows [list] for { set i 1 } { $i <= $rowcount } { incr i } { upvar $level $name:$i row lappend rows [array get row] } return $rows } ad_proc -public template::util::list_to_multirow { name rows { level 1 } } { populate a multirow data source from a list string gotten from a call to template::util::multirow_to_list @param name the name of a multirow data source @param rows a representation of a multirow data source as a list, suitable for passing by value in the form { { row } { row } { row } ... } @see template::util::multirow_to_list } { upvar $level $name:rowcount rowcount set rowcount [llength $rows] set rownum 1 foreach rowlist $rows { lappend rowlist rownum $rownum upvar $level $name:$rownum row array set row $rowlist incr rownum } } d_proc -public template::util::list_of_ns_sets_to_multirow { {-rows:required} {-var_name:required} {-level 1} } { Transform a list of ns_sets (e.g. produced by db_list_of_ns_sets) into a multirow datasource. @param rows The data to be transformed @param var_name The name of the multirow to create @param level How many levels up the stack to place the new datasource, defaults to 1 level up. } { upvar $level $var_name:rowcount rowcount $var_name:columns columns set rowcount [llength $rows] set i 1 foreach row_set $rows { ns_set put $row_set rownum $i upvar $level $var_name:$i row array set row [ns_set array $row_set] if {$i == 1} { set columns [array names row] } incr i } } # * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * # * Utility procedures for interacting with the filesystem * # * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ad_proc -public template::util::read_file { path } { Reads a text file. @param path The absolute path to the file @return A string with the contents of the file. } { if {![file exists $path]} { error "File $path does not exist" } # # Use ad_try to make sure that the file descriptor is finally # closed. # ad_try { set fd [open $path] template::util::set_file_encoding $fd set text [read $fd] } on error {errMsg opts} { dict incr opts -level ns_log error "template::util::read_file on fd $fd: $errMsg,\n$::errorInfo" return -options [dict replace $opts -inside $opts] $errMsg } finally { close $fd } return $text } ad_proc -public template::util::set_file_encoding { file_channel_id } { Set encoding of the given file channel based on the OutputCharset parameter of AOLserver. All ADP, Tcl, and txt files are assumed to be in the same charset. @param file_channel_id The id of the file to set encoding for. @author Peter Marklund } { set output_charset [ns_config "ns/parameters" OutputCharset] set tcl_charset [ns_encodingforcharset $output_charset] if { $tcl_charset ne "" } { fconfigure $file_channel_id -encoding $tcl_charset } } ad_proc -public template::util::write_file { path text } { Writes a text file @param path The absolute path to the file @param text A string containing the text to write to the file. } { file mkdir [file dirname $path] set fd [open $path w] template::util::set_file_encoding $fd puts -nonewline $fd $text close $fd } ad_proc -public template::util::master_to_file { url {reference_url ""} } { Resolve a URL into an absolute file path, but respect styled master configuration for named masters (e.g. acs-templating/resources/masters/... containing 2cols.adp) } { if { [string index $url 0] ne "/" } { set master_stub [template::resource_path -type masters -style $url] if {[file exists $master_stub.adp]} { set path $master_stub } else { set path [file dirname $reference_url]/$url } } else { set path $::acs::rootdir/$url } return [ns_normalizepath $path] } ad_proc -public template::util::url_to_file { url {reference_url ""} } { Resolve a URL into an absolute file path. } { if { [string index $url 0] ne "/" } { set path [file dirname $reference_url]/$url } else { set path $::acs::rootdir/$url } return [ns_normalizepath $path] } ad_proc -public template::util::resolve_directory_url { url } { Resolve the filename for a directory URL } { set path $::acs::pageroot$url if { [file isdirectory $path] && [file exists ${path}index.adp] } { set url ${url}index.acs } return $url } ad_proc -public template::util::get_url_directory { url } { Get the directory portion of a URL. If the URL has a trailing slash, then return the entire URL. } { set directory $url set lastchar [string range $url [string length $url]-1 end] if {$lastchar ne "/" } { set directory [file dirname $url]/ if {$directory eq "//"} { # root directory is a special case set directory / } } return $directory } ad_proc -public template::util::multirow_quote_html {multirow_ref column_ref} { implements template::util::quote_html on the designated column of a multirow @param multirow_ref name of the multirow @param column_ref name of the column to be @author simon } { upvar $multirow_ref:rowcount rowcount for { set i 1 } { $i <= $rowcount } { incr i} { upvar $multirow_ref:$i arr set arr($column_ref) [ns_quotehtml [set arr($column_ref)]] } } ad_proc -deprecated template::util::nvl { value value_if_null } { Analogous to SQL NVL DEPRECATED: a plain Tcl oneliner can easily replace this proc @see expr {$value ne "" ? $value : $value_if_null} } { if {$value eq ""} { return $value_if_null } return $value } ad_proc -public template::util::number_list { last_number {start_at 0} } { Return a list of numbers, {1 2 3 ... n} } { set ret [list] for {set i $start_at} { $i <= $last_number } {incr i} { lappend ret $i } return $ret } d_proc -public template::themed_template { {-verbose:boolean false} path } { Given a path like /packages/acs-admin/www/index pointing to an .adp file, this function tries to locate this path in the ResourceDir of the subsite (determined by the theme). If found the themed template is returned, otherwise the passed template path. @param path absolute path within the open acs tree (without extension) @verbose boolean flag; report tried path in the system log @return path to themed template or input value (without extension) } { if {[string index $path 0] eq "/"} { set style [string range $path 1 end] } else { set style $path } set stub [template::resource_path \ {*}[expr {$verbose_p ? "-verbose" : ""}] \ -type templates -style $style -relative] if {[file readable $::acs::rootdir/$stub.adp]} { if {$verbose_p} { ns_log notice "themed_template: found template in $stub" } return $stub } else { if {$verbose_p} { ns_log notice "themed_template: no themed template found for '$path'" } } return $path } d_proc -public template::streaming_template { -subsite_id } { Return the path of the streaming template @param subsite_id id of the subsite. Defaults to [ad_conn subsite_id] @return path to themed template } { if { ![info exists subsite_id] } { set subsite_id [ad_conn subsite_id] } set template [parameter::get -package_id $subsite_id \ -parameter StreamingHead \ -default "/packages/openacs-default-theme/lib/plain-streaming-head"] return [template::resource_path -type masters -style $template -relative] } d_proc -public template::resource_path { {-verbose:boolean false} -type:required -style:required -relative:boolean -subsite_id -theme_dir } { Process the templating "style" and return the stub (path without extensions). When the style is not an absolute path, check if the resource can be obtained from the theme, if not fallback to the resources directory of acs-templating. @param type type of resource (e.g. "forms" or "lists") @param style name of the resource within the type (e.g. "standard") @param relative return optionally the path relative to the OpenACS root directory @param theme_dir theming directory (alternative to determination via subsite), higher priority @param subsite_id subsite_id to determine theming information @verbose boolean flag; report tried path in the system log @return path of the resource (without extension) @author Gustaf Neumann } { if {![regexp {^/(.*)} $style path]} { if { ![info exists theme_dir] } { if { ![info exists subsite_id] } { set subsite_id [ad_conn subsite_id] } set theme_dir [parameter::get -parameter ResourceDir -package_id $subsite_id] } if {$theme_dir ne ""} { if {![file isdir $::acs::rootdir/$theme_dir]} { ns_log warning "ResourceDir '$theme_dir' does not exist under '$::acs::rootdir';\ ignore parameter setting of subsite $subsite_id" set theme_dir "" } } if {$theme_dir ne ""} { set path $theme_dir/$type/$style set lookup_path [expr {[file extension $path] eq "" ? "${path}.adp" : $path}] if {$verbose_p} { ns_log notice "themed_template: try themed template '$lookup_path'" } if {![file exists $::acs::rootdir/$lookup_path]} { unset path } } if {![info exists path]} { set path /packages/acs-templating/resources/$type/$style } } if {$relative_p} { return $path } else { return $::acs::rootdir/$path } } ad_proc -private template::stack_frame_values {level} { return the variables and arrays of one frame as HTML } { set varlist "" foreach i [if {$level} { uplevel \#$level {info locals} } else {info globals} ] { append varlist " <li><b>$i</b> = " if {$i eq "page" && $level == [info level]-1 || $i eq "__adp_output" || $i eq "errorInfo"} { append varlist "<em>value withheld to avoid messy page</em>\n" } elseif {[string match -nocase "*secret*" $i]} { append varlist "<em>value withheld as the name contains \"secret\"</em>\n" } else { if {[uplevel \#$level array exists $i]} { append varlist "<em>ARRAY</em><ul>\n" foreach {key value} [uplevel \#$level array get $i] { append varlist " <li><b>$key</b> = '$value'\n" } append varlist " </ul>\n" } else { if {[catch {append varlist "'[uplevel #$level set $i]'\n"}]} { append varlist "<em>bad string value</em>\n" } } } } return $varlist } ad_proc -deprecated stack_dump {} { return the whole call stack as HTML DEPRECATED: does not comply with OpenACS naming convention. @see template::stack_dump } { return [template::stack_dump] } ad_proc -public template::stack_dump {} { Return the whole call stack as HTML } { append page "<h1>Tcl Call Trace</h1>\n<ul>" for {set x [info level]} {$x > 0} {incr x -1} { append page "<li>$x. [info level $x]<ul>[template::stack_frame_values $x]</ul>\n" } append page "</ul>\n<h2>Globals</h2>\n<ul> [template::stack_frame_values 0] </ul>\n" } d_proc -public anchor_form { {-id} {-vars ""} {-action ""} {-label link} } { return an inline form with the appearance of an anchor } { set inputs "" foreach {name value} $vars { append inputs "<input type='hidden' name='$name' value='$value'>" } template::add_body_script -script [subst { document.getElementById('$id-control').addEventListener('click', function (event) { event.preventDefault(); document.getElementById('$id').submit(); return false; }); }] return [subst { <form id="$id" action="$action" method="post" style='display:inline;'>$inputs<a id='$id-control' href="#" class='button'>[ns_quotehtml $label]</a></form> }] } # Local variables: # mode: tcl # tcl-indent-level: 4 # indent-tabs-mode: nil # End: