When the value "O'Malley" is inserted int an SQL database, the single quote can cause troubles in SQL, one has to insert 'O''Malley' instead. Deprecated: in general, one should be using bind variables rather than calling DoubleApos.

Parameters:

string (required)

Returns:

string with single quotes converted to a pair of single quotes

See Also:

• ns_dbquotevalue
• bind variables

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

returns a plain text version of the passed ns_set id

Parameters:

set_id (required)

See Also:

• util::ns_set_to_tcl_string DEPRECATED: does not comply with OpenACS naming convention

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

We use this when we want to send out just the headers and then do incremental writes with ns_write. This way the user doesn't have to wait for streamed output (useful when doing bulk uploads, installs, etc.). It returns status 200 and all headers including any added to outputheaders. DEPRECATED: does not comply with OpenACS naming convention.

See Also:

• util_return_headers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a Yahoo-style hierarchical navbar. Use ad_context_bar instead.

Returns:

an HTML fragment generated by ad_context_bar

See Also:

• ad_context_bar

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Signs pages with ad_admin_owner (usually a programmer who can fix bugs) rather than the signatory of the user pages

See Also:

• Documentation on the site master template for the proper way to standardize page footers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Switches:

-focus (optional)

Parameters:

page_title (required)

See Also:

• Documentation on the site master template for the proper way to standardize page headers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns:

E-mail address of the Administrator of this site.

See Also:

• ad_host_administrator

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This function is an alias to acs_community_member_admin_link and receives identical parameters, but the former finds out the name of the user if a blank is passed. That's why it's marked as deprecated.

Parameters:

user_id (required)

name (required)

Returns:

the HTML link of the community member page of a particular admin user.

Authors:

Unknown

Roberto Mello

See Also:

• acs_community_member_admin_link

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns 1 if the system is configured to use and approval system. DEPRECATED: this proc's utility was probably transitional and is as of 2022-09-07 not used anywhere in the codebase. One can always query the parameters directly in case.

See Also:

• parameter::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

A filter that detect attempts to smuggle in SQL code through form data variables. The use of bind variables and ad_page_contract input validation to prevent SQL smuggling is preferred.

Parameters:

conn (required)

args (required)

why (required)

See Also:

• ad_page_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Calls a procedure with particular arguments, only if the procedure is defined. Deprecated: very simple tcl commands idioms can replace this proc

Parameters:

proc (required)

See Also:

• "info commands" based idioms

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a Yahoo-style hierarchical navbar. Use ad_context_bar instead.

Returns:

an HTML fragment generated by ad_context_bar_html

See Also:

• ad_context_bar

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a Yahoo-style hierarchical navbar. Use ad_context_bar instead.

Returns:

an HTML fragment generated by ad_context_bar

See Also:

• ad_context_bar

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

sets up the head of a form to feed to /tools/form-custom.tcl Deprecated: there are many better ways now to create forms in OpenACS

Parameters:

return_url (required)

item_group (required)

item (required)

See Also:

• ad_form
• template::form
• Generic::Form
• xowiki::Form
• xowiki::FormPage

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Generates the HTML fragment for choosing, editing and creating user customized data This proc was ported from the old ACS, but the data model was not.

Parameters:

user_id (required)

item_group (required)

item_set (required)

item_type (required)

target_url (required)

custom_url (required)

new_string (optional, defaults to "new view")

See Also:

• https://cvs.openacs.org/browse/OpenACS/web/openacs/www/doc/sql/user-custom.sql

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

load a persisted user customization as saved by for example table-custom.tcl. This proc was ported from the old ACS, but the data model was not.

Parameters:

user_id (required)

item_group (required)

item (required)

item_type (required)

See Also:

• https://cvs.openacs.org/browse/OpenACS/web/openacs/www/doc/sql/user-custom.sql

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

set the page defaults. If the form is empty do a returnredirect with the defaults set

Parameters:

defaults (required)

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This proc is used for pages using double click protection. table_name is table_name for which we are checking whether the double click occurred. id_column_name is the name of the id table column. generated_id is the generated id, which is supposed to have been generated on the previous page. return_url is url to which this procedure will return redirect in the case of successful insertion in the database. insert_sql is the sql insert statement. if data is ok this procedure will insert data into the database in a double click safe manner and will returnredirect to the page specified by return_url. if database insert fails, this procedure will return a sensible error message to the user.

Switches:

-bind (optional)

Parameters:

statement_name (required)

table_name (required)

id_column_name (required)

generated_id (required)

return_url (required)

insert_dml (required)

See Also:

• xotcl-request-monitor provides a double-click protection feature that does not rely on the database and is transparent to the developer.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

set the variables defined in option_list from the form provided (form defaults to ad_conn form) or to default value from option_list if not in the form data.

You only really need to call this if you need the variables (for example to pick which select statement and table to actually use)

Parameters:

option_list (required)

options_set (optional)

See Also:

• ns_set

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

given a dimensional slider definition this routine returns a form to set the defaults for the given slider. NB...this does not close either the table or the form...

Parameters:

define (required)

current (required)

See Also:

• ad_form
• template::form
• Generic::Form
• xowiki::Form
• xowiki::FormPage

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Note This proc is deprecated in favor of export_vars. They're very similar, but export_vars have a number of advantages:

• It can sign variables (the :sign flag)
• It can export variables as a :multiple.
• It can export arrays with on-the-fly values (not pulled from the environment)

Helps export variables from one page to the next, either as URL variables or hidden form variables. It'll reach into arrays and grab either all values or individual values out and export them in a way that will be consistent with the ad_page_contract :array flag.

Example:

doc_body_append [export_vars { msg_id user(email) { order_by date } }]

The args is a list of variable names that you want exported. You can name

• a scalar variable, foo,
• the name of an array, bar, in which case all the values in that array will get exported, or
• an individual value in an array, bar(baz)
• a list in [array get] format { name value name value ..}. The value will get substituted normally, so you can put a computation in there.

A more involved example:

set my_vars { msg_id user(email) order_by }
    doc_body_append [export_vars -override { order_by $new_order_by } $my_vars]

Switches:

-form (optional, boolean)

set this parameter if you want the variables exported as hidden form variables, as opposed to URL variables, which is the default.

-exclude (optional)

takes a list of names of variables you don't want exported, even though they might be listed in the args. The names take the same form as in the args list.

-override (optional)

takes a list of the same format as args, which will get exported no matter what you have excluded.

Parameters:

include (optional)

Author:

Lars Pind <lars@pinds.com>

Created:

21 July 2000

See Also:

• export_vars

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Writes a horizontal rule, a mailto address box (ad_system_owner if not specified as an argument), and then closes the BODY and HTML tags

Parameters:

signatory (optional)

suppress_curriculum_bar_p (optional, defaults to "0")

See Also:

• Documentation on the site master template for the proper way to standardize page footers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Gets the user ID. 0 indicates the user is not logged in. Deprecated since user_id now provided via ad_conn user_id

See Also:

• ad_conn

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Sets first_names, last_name, email in the environment of its caller.

Returns:

ad_return_error if user_id can't be found.

Authors:

Unknown

Roberto Mello

See Also:

• acs_user::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

writes HEAD, TITLE, and BODY tags to start off pages in a consistent fashion

Switches:

-focus (optional)

Parameters:

page_title (required)

extra_stuff_for_document_head (optional)

See Also:

• Documentation on the site master template for the proper way to standardize page headers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This is the version of the ad_header that accepts extra stuff for the document head and pre-page content html

Switches:

-focus (optional)

Parameters:

page_title (required)

extra_stuff_for_document_head (optional)

pre_content_html (optional)

See Also:

• Documentation on the site master template for the proper way to standardize page headers

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Just like ns_httpget, but first headers is an ns_set of headers to send during the fetch. ad_httpget also makes use of Conditional GETs (if called with a Last-Modified header). Returns the data in array get form with array elements page status modified.

Switches:

-url (optional)

-headers (optional)

-timeout (optional, defaults to "30")

-depth (optional, defaults to "0")

See Also:

• util::http::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Checks to see if a user is logged in. If not, redirects to [subsite]/register/index to require the user to register. When registration is complete, the user will return to the current location. All variables in ns_getform (both posts and gets) will be maintained. Note that this will return out of its caller so that the caller need not explicitly call "return". Returns the user id if login was successful.

See Also:

• auth::require_login

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Makes a new sort_by string, sorting by "key". If the key is followed by "*", that indicates the ordering should be reversed from the default ordering for that key. Old sort keys are retained, so the sort appears to be a little more stable. That is, suppose two things are sorted into an order, and their values for a different column are the same. If that different column is used as the primary sort key to reorder, the things which have the same value for the newly-sorted column will remain in the same relative order.

Parameters:

key (required)

keys (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the keys of an ns_set as a Tcl list, like array names. This proc can be easily replaced by a Tcl dict operation. Furthermore, newer versions of NaviServer have "ns_set keys" and "ns_set values" operations.

Switches:

-colon (optional, boolean)

If set, will prepend all the keys with a colon; useful for bind variables

-exclude (optional)

Optional Tcl list of key names to exclude

Parameters:

set_id (required)

Author:

Lars Pind <lars@pinds.com>

See Also:

• ns_set keys

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Takes a sort_by spec, and translates it into an "order by" clause with each sort_by key dictated by the sort info in tabledef

Parameters:

sort_by (required)

tabledef (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Package instances can have parameters associated with them. This function is used for accessing and setting these values. Parameter values are stored in the database and cached within memory. New parameters can be created with the APM and values can be set using the Site Map UI.. Because parameters are specified on an instance basis, setting the package_key parameter (preserved from the old version of this function) does not affect the parameter retrieved. If the code that calls ad_parameter is being called within the scope of a running server, the package_id will be determined automatically. However, if you want to use a parameter on server startup or access an arbitrary parameter (e.g., you are writing bboard code, but want to know an acs-kernel parameter), specify the package_id parameter to the object id of the package you want.

Note: The parameters/ad.ini file is deprecated.

Switches:

-localize (optional, boolean)

-set (optional)

Use this if you want to indicate a value to set the parameter to.

-package_id (optional)

Specify this if you want to manually specify what object id to use the new parameter.

Parameters:

name (required)

package_key (optional)

default (optional)

Returns:

The parameter of the object or if it doesn't exist, the default.

See Also:

• parameter::set_value
• parameter::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This function is an alias to acs_community_member_link and receives identical parameters, but the former finds out the name of the user if a blank is passed. That's why it's marked as deprecated.

Parameters:

user_id (required)

name (required)

Returns:

the HTML link of the community member page of a particular user

Authors:

Unknown

Roberto Mello

See Also:

• acs_community_member_link

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Pages that are consider whether to display a user's name or email address should test to make sure that a user's priv_ from the database is less than or equal to what ad_privacy_threshold returns. Now deprecated.

See Also:

• ad_conn

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Works like the "return" Tcl command, with one difference. Where "return" will always return TCL_RETURN, regardless of the -code switch this way, by burying it inside a proc, the proc will return the code you specify.

Why? Because "return" only sets the "returnCode" attribute of the interpreter object, which the function actually interpreting the procedure then reads and uses as the return code of the procedure. This proc adds just that level of processing to the statement.

When is that useful or necessary? Here:

    set errno [catch {
        return -code error "Boo!"
    } error]
    

See Also:

• ad_try
• try

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

returns the opposite sort order from the one it is given. Mostly for columns whose natural sort order is not the default.

Parameters:

order (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Makes a link to this page, with a new value for "variable".

Parameters:

variable (required)

value (required)

text (required)

form (optional)

See Also:

• export_vars

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Use security::secure_conn_p instead.

See Also:

• security::secure_conn_p

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

    #
    # Register special rules for form variables.
    #
    # Example:
    #
    #    ad_set_typed_form_variable_filter /my_module/* {a_id number} {b_id word} {*_id integer}
    #
    # For all pages under /my_module, set_form_variables would set
    # $a_id only if it was number, and $b_id only if it was a 'word'
    # (a string that contains only letters, numbers, dashes, and
    # underscores), and all other variables that match the pattern
    # *_id would be set only if they were integers.
    #
    # Variables not listed have no restrictions on them.
    #
    # By default, the three supported datatypes are 'integer', 'number',
    # and 'word', although you can add your own type by creating
    # functions named ad_var_type_check_${type_name}_p which should
    # return 1 if the value is a valid $type_name, or 0 otherwise.
    #
    # There's also a special datatype named 'nocheck', which will
    # return success regardless of the value. (See the docs for
    # ad_var_type_check_${type_name}_p to see how this might be
    # useful.)
    #
    # The default data_type is 'integer', which allows you shorten the
    # command above to:
    #
    #    ad_set_typed_form_variable_filter /my_module/* a_id {b_id word}
    #

    ad_page_contract is the preferred mechanism to do automated
    validation of form variables.
    

Parameters:

url_pattern (required)

See Also:

• ad_page_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

return the primary (first) key of an order spec used by

Parameters:

orderby (required)

See Also:

• template::list::create
• xo::Table
• regexp

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Adds to the SQL statement. This is unused and untested code.

Switches:

-select (optional)

-from (optional)

-where (optional)

-groupby (optional)

-orderby (optional)

Parameters:

sqlarrayname (required)

See Also:

• plain SQL statements + trivial Tcl idioms

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

sqlarrayname (required)

array reference

Returns:

a SQL statement constructed from the pieces provided via ad_sql_append This is unused and untested code.

See Also:

• ad_sql_append

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

DRB: New code should use the listbuilder. Note: all the variables in this function are named Tblah since we could potentially have namespace collisions

build and return an HTML fragment given an active query and a data definition.

• sql_qry -- The query that should be executed to generate the table.
  You can specify an optional -bind argument to specify an ns_set of bind variables.
• Tdatadef -- the table declaration.

    {
        {column_id "Column_Heading" order_clause display_info}
        ...
    }
    

• column_id -- what to set as orderby for sorting and also is the default variable for the table cell.
• the text for the heading to be wrapped in <th> and </th> tags. I am not entirely happy that things are wrapped automatically since you might not want plain old th tags but I also don;t want to add another field in the structure.
• order_clause -- the order clause for the field. If null it defaults to "column_id $order". It is also interpolated, with orderby and order defined as variables so that:

               {upper(last_name) $order, upper(first_names) $order}
           

  would do the right thing.

  the value "no_sort" should be used for columns which should not allow sorting.

  the value "sort_by_pos" should be used if the columns passed in are column positions rather than column names.

• display_info. If this is a null string you just default to generating <td>column_id</td>. If it is a string in the lookup list then special formatting is applied; this is l r c tf 01 for align=left right center, Yes/No (from tf), Yes/No from 0/1.

  if the display stuff is not any of the above then it is interpolated and the results returned (w/o any <td> tags put in). An example:

      set table_def {
          {ffn "Full Name"
              {upper(last_name) $order, upper(first_names) $order}
              {<td><a href="/admin/users/one?user_id=$user_id">$first_names $last_name</a></td>}}
          {email "e-Mail" {} {<td><a href="mailto:$email">$email</a>}}
          {email_bouncing_p "e-Bouncing?" {} tf}
          {user_state "State" {} {}}
          {last_visit "Last Visit" {} r}
          {actions "Actions" no_sort {<td>
                  <a href="/admin/users/basic-info-update?user_id=$user_id">Edit Info</a> |
                  <a href="/admin/users/password-update?user_id=$user_id">New Password</a> |
              [ad_registration_finite_state_machine_admin_links $user_state $user_id]}}
      }
      

Switches:

-Torder_target_url (optional)

-Torderby (optional)

-Tasc_order_img (optional, defaults to "^")

-Tdesc_order_img (optional, defaults to "v")

-Tmissing_text (optional, defaults to "<em>No data found.</em>")

-Tsuffix (optional)

-Tcolumns (optional)

-Taudit (optional)

-Trows_per_band (optional, defaults to "1")

-Tband_colors (optional, defaults to "{} "#ececec"")

-Tband_classes (optional, defaults to "{even} {odd}")

-Trows_per_page (optional, defaults to "0")

-Tmax_rows (optional, defaults to "0")

-Ttable_extra_html (optional, defaults to "cellpadding=3 cellspacing=0 class="table-display"")

-Theader_row_extra (optional, defaults to "style="background-color:#f8f8f8" class="table-header"")

-Ttable_break_html (optional, defaults to "<br><br>")

-Tpre_row_code (optional)

-Trow_code (optional, defaults to "[subst $Trow_default]")

-Tpost_data_ns_sets (optional)

-Textra_vars (optional)

-Textra_rows (optional)

-bind (optional)

-dbn (optional)

The database name to use. If empty_string, uses the default database.

Parameters:

statement_name (required)

sql_qry (required)

Tdatadef (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

build a list of pointers into the list of column definitions

returns a list of indexes into the columns one per column it found

-sortable from t/f/all

Switches:

-sortable (optional, defaults to "all")

Parameters:

datadef (required)

columns (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

builds a form for choosing the columns to display

columns is a list of the currently selected columns.

allowed is the list of all the displayable columns, if empty all columns are allowed.

Parameters:

datadef (required)

type (optional, defaults to "select")

return_url (optional)

item_group (optional)

item (optional)

columns (optional)

allowed (optional)

See Also:

• ad_form
• template::form
• Generic::Form
• xowiki::Form
• xowiki::FormPage
• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

create the order by clause consistent with the orderby and order variables and the datadef which built the table

Parameters:

datadef (required)

orderby (required)

order (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Called from inside ad_table. returns true if the variable has same value as on the previous row. Always false for 1st row.

Parameters:

varname (required)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

builds a form for setting up custom sorts.

• datadef is the table definition as in ad_table.
• type is select or radio (only select is implemented now)
• return_url is the return url passed through to the page that validates and saves the sort customization.
• item_group is a string identifying the customization "ticket_tracker_main_sort" for example.
• item is the user entered identifier
• sort_spec is the sort specifier as in ad_new_sort_by
• allowed is the list of all the columns allowed, if empty all are allowed.

An example from the ticket system:

      ad_table_sort_form $tabledef select $return_url ticket_tracker_main_sort $ticket_sort $orderby
    

Parameters:

datadef (required)

type (optional, defaults to "select")

return_url (optional)

item_group (optional)

item (optional)

sort_spec (optional)

allowed (optional)

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

given string the function generates a row which spans the whole table.

Parameters:

str (required)

td_html (optional, defaults to "align="left"")

See Also:

• template::list::create
• xo::Table

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Creates a new user in the system. The user_id can be specified as an argument to enable double click protection. If this procedure succeeds, returns the new user_id. Otherwise, returns 0.

Parameters:

email (required)

first_names (required)

last_name (required)

password (required)

password_question (required)

password_answer (required)

url (optional)

email_verified_p (optional, defaults to "t")

member_state (optional, defaults to "approved")

user_id (optional)

username (optional)

authority_id (optional)

screen_name (optional)

See Also:

• auth::create_user
• auth::create_local_account

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

0 if $value contains a / or \, 1 otherwise.

See Also:

• ad_sanitize_filename

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

A check that always returns 0. Useful if you want to disable all access to a page.

Parameters:

value (required)

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

1 if $value is an integer, 0 otherwise. This function is deprecated. Use either template::data::validate::integer or "string is integer -strict" instead.

See Also:

• template::data::validate::integer

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

1 if list contains only numbers, spaces, and commas. Example '5, 3, 1'. Note: it doesn't allow negative numbers, because that could let people sneak in numbers that get treated like math expressions like '1, 5-2'

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (optional)

Returns:

1 regardless of the value. This is useful if you want to set a filter over the entire site, then create a few exceptions. For example: ad_set_typed_form_variable_filter /my-dangerous-page.tcl {user_id nocheck} ad_set_typed_form_variable_filter /*.tcl user_id

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

1 if $value contains any single-quotes

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

1 if $value is a valid number

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

0 if the file contains ".."

See Also:

• ad_sanitize_filename

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Deprecated: too specific to make sense as a public api, can be replaced via a simple tcl oneliner

Parameters:

args (optional)

Returns:

1 if the third path element in the URL is integer.

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

value (required)

Returns:

1 if $value contains only letters, numbers, dashes, and underscores, otherwise returns 0.

See Also:

• ad_page_contract
• ad_include_contract

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the current user's ID. 0 indicates user is not logged in Deprecated since user_id now provided via ad_conn user_id

Switches:

-secure (optional, defaults to "f")

See Also:

• ad_conn

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a list of valid database type keys.

See Also:

• db_known_database_types

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This callback uses the document API to append more text to the stream.

Parameters:

string (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

party_id (required)

Returns:

The email address of the indicated party.

See Also:

• party::email

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

email (required)

Returns:

Returns the user ID for a particular email address, or an empty string if none exists.

See Also:

• party::get_by_email

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the group ID for a particular name, or an empty string if none exists.

Parameters:

name (required)

See Also:

• group::get_id

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

screen_name (required)

Returns:

Returns the user ID for a particular screen name, or an empty string if none exists.

See Also:

• acs_user::get_user_id_by_screen_name

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

stuff to process the data that comes back from the users if the form looked like <input type=text name=yow> and <input type=text name=bar> then after you run this function you'll have Tcl vars $foo and $bar set to whatever the user typed in the form

this uses the initially nauseating but ultimately delicious Tcl system function "uplevel" that lets a subroutine bash the environment and local vars of its caller. It ain't Common Lisp...

This is an ad-hoc check to make sure users aren't trying to pass in "naughty" form variables in an effort to hack the database by passing in SQL. It is called in all instances where a Tcl variable is set from a form variable.

Checks the given variable for against known form variable exploits. If it finds anything objectionable, it throws an error.

Parameters:

name (required)

value (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

db_type_list (required)

Returns:

1 if db_type_list contains the current RDMBS type. A package intended to run with a given RDBMS must note this in its package info file regardless of whether or not it actually uses the database.

See Also:

• apm_package_supports_rdbms_p

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Appends $str to the body property.

Parameters:

str (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Flushes the body (if possible).

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns 1 if there is a document in the global environment.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Finds a master.adp file which can be used as a master template, looking in the directory containing $filename and working our way down the directory tree.

Parameters:

filename (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a property (or an empty string if no such property exists).

Parameters:

name (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Initializes the global environment for document handling.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Return 1 if a property exists, or 0 if not.

Parameters:

name (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Serves the document currently in the environment.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Serves the document in the environment using a particular template.

Parameters:

__template_path (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Sets the mime-type property.

Parameters:

mime_type (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Sets a document property.

Parameters:

name (required)

value (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

contents (required)

params (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

contents (required)

params (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns 1 if the variable name exists in the caller's environment and is equal to the given value. DEPRECATED: the value provided by this proc is arguable, as it can be replaced by a plain tcl oneliner.

Parameters:

varname (required)

value (required)

Author:

Peter Marklund

See Also:

• exists_and_not_null
• plain tcl idioms

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns 1 if the variable name exists in the caller's environment and is not the empty string. Note you should enter the variable name, and not the variable value (varname not $varname which will pass variable varnames value into this function). DEPRECATED: the value provided by this proc is arguable, as it can be replaced by a plain tcl oneliner.

Parameters:

varname (required)

See Also:

• plain tcl idioms

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the contents of the variable if it exists, otherwise returns empty string

Parameters:

varname (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Exports a number of variables as hidden input fields in a form. Specify a list of variable names. The proc will reach up in the caller's name space to grab the value of the variables. Variables that are not defined are silently ignored. You can append :multiple to the name of a variable. In this case, the value will be treated as a list, and each of the elements output separately.

export_vars is now the preferred interface.

Example usage: [export_vars -form -sign {foo bar:multiple baz}]

Switches:

-sign (optional, boolean)

If this flag is set, all the variables output will be signed using ad_sign. These variables should then be verified using the :verify flag to ad_page_contract, which in turn uses ad_verify_signature. This ensures that the value hasn't been tampered with at the user's end.

See Also:

• export_vars

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

export_vars is now the preferred interface. Returns a string of key=value pairs suitable for inclusion in a URL; you can pass it any number of variables as arguments. If any are defined in the caller's environment, they are included. See also export_entire_form_as_url_vars.

Instead of naming a variable you can also say name=value. Note that the value here is not the name of a variable but the literal value you want to export e.g., export_url_vars [ns_urlencode foo]=[ns_urlencode $the_value].

For normal variables, you can say export_url_vars foo:multiple. In this case, the value of foo will be treated as a Tcl list, and each value will be output separately e.g., foo=item0&foo=item1&foo=item2...

You cannot combine the foo=bar syntax with the foo:multiple syntax. Why? Because there's no way we can distinguish between the :multiple being part of the value of foo or being a flag intended for export_url_vars.

Switches:

-sign (optional, boolean)

If this flag is set, all the variables output will be signed using ad_sign. These variables should then be verified using the :verify flag to ad_page_contract, which in turn uses ad_verify_signature. This ensures that the value hasn't been tampered with at the user's end.

See Also:

• export_vars

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns:

referrer from the request headers.

See Also:

• util::get_referrer

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the maximum of a list of numbers. Example: max 2 3 1.5 returns 3. DEPRECATED: this proc does not respect OpenACS naming convention.

Author:

Lars Pind <lars@pinds.com>

Created:

31 August 2000

See Also:

• util::max

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Merges a form with a query string. DEPRECATED: this proc does not comply with OpenACS naming convention. Furthermore, ns_formvalueput supports a limited number of HTML variants and input tag types and is subject to various other limitations. For a modern implementation addressing the use-case of this proc one should probably use tools such as tDOM.

Switches:

-bind (optional)

A ns_set stuffed with bind variables for the sql_qry.

Parameters:

form (required)

the form to be stuffed.

statement_name (required)

An identifier for the sql_qry to be executed.

sql_qry (required)

The sql that must be executed.

See Also:

• tDOM
• https://panoptic.com/wiki/aolserver/Ns_formvalueput

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the minimum of a list of numbers. Example: min 2 3 1.5 returns 1.5. DEPRECATED: this proc does not respect OpenACS naming convention.

Author:

Ken Mayer <kmayer@bitwrangler.com>

Created:

26 September 2002

See Also:

• util::min

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

deprecated proc, functionality dropped between AOLserver 2 and AOLserver 3 returnvalues: -1 = Not there or value was "" 0 = NULL, set value to NULL. 1 = Got value, set value to it.

Parameters:

formdata (required)

column (required)

type (required)

valuebyref (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

deprecated proc, functionality dropped between AOLserver 2 and AOLserver 3

Parameters:

htmlform (required)

column (required)

type (required)

value (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

deprecated proc, functionality dropped between AOLserver 2 and AOLserver 3

Parameters:

conn (required)

ignored (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Load up user information

Switches:

-user_id (required)

-array (required)

See Also:

• acs_user::get

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Wrapper for ad_permission to allow us to bypass having to specify the read privilege Deprecated: just another wrapper for permission::permission_p

Switches:

-user_id (optional)

-privilege (optional, defaults to "read")

Parameters:

party_id (required)

Author:

Michael Bryzek <mbryzek@arsdigita.com>

Created:

10/2000

See Also:

• permission::permission_p

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This proc does exactly the same as ns_quotehtml. Use that instead. This one will be deleted eventually.

Parameters:

arg (required)

See Also:

• ns_quotehtml

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Parameters:

package_key (required)

Returns:

A server-root relative path to the directory for a package. Usually, /packages/package-key

See Also:

• acs_package_root_dir

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

A synonym for ad_proc (to support legacy code).

See Also:

• ad_proc

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Return a pseudo-random number between 0 and 1. DEPRECATED: this proc does not respect OpenACS naming convention

See Also:

• util::random

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

seed the random number generator. DEPRECATED: this proc does not respect OpenACS naming convention

Parameters:

seed (required)

See Also:

• util::random_init

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns a pseudo-random number between 0 and range. DEPRECATED: this proc does not respect OpenACS naming convention

Parameters:

range (required)

Returns:

integer

See Also:

• util::random_range

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Creates and returns a new ns_set without any null value fields DEPRECATED: does not comply with OpenACS naming convention.

Parameters:

old_set_id (required)

Returns:

new ns_set

See Also:

• util_remove_nulls_from_ns_set

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Maps a hostname to the corresponding subdirectory. DEPRECATED: this proc does not comply with OpenACS naming convention.

Parameters:

host (required)

See Also:

• acs::root_of_host

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This proc adds a query variable to AOLserver's internal ns_getform form, so that it'll be picked up by ad_page_contract and other procs that look at the query variables or form supplied. This is useful when you do an rp_internal_redirect to a new page, and you want to feed that page with certain query variables. Note that the variable will just be appended to the form ns_set which may not be what you want, if it exists already you will now have two entries in the ns_set which may cause ad_page_contract to break. Also, only simple variables may be added, not arrays. DEPRECATED: this proc is a trivial wrapper over NaviServer functionalities. One should use the native api directly.

Parameters:

name (required)

value (required)

Returns:

the form ns_set, in case you're interested. Mostly you will want to discard the result.

Author:

Lars Pind <lars@pinds.com>

Created:

August 20, 2002

See Also:

• ns_getform
• ns_set

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Identical to rp_form_put, but uses ns_set update instead. DEPRECATED: this proc is a trivial wrapper over NaviServer functionalities. One should use the native api directly.

Parameters:

name (required)

value (required)

Returns:

the form ns_set, in case you're interested. Mostly you will want to discard the result.

See Also:

• ns_getform
• ns_set

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

This proc is a simple wrapper around AOLserver's standard ns_getform proc, that will create the form if it doesn't exist, so that you can then add values to that form. This is useful in conjunction with rp_internal_redirect to redirect to a different page with certain query variables set. DEPRECATED: modern ns_getform from NaviServer will never return the empty string, assuming that we are in a connection. When we are not in a connection, it makes little sense that we set request variables.

Returns:

the form ns_set, just like ns_getform, except it will always be nonempty.

Author:

Lars Pind <lars@pinds.com>

Created:

August 20, 2002

See Also:

• ns_getform

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Deprecated version of ad_safe_eval

See Also:

• ad_safe_eval

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Adds the element v to the set named s-name in the calling environment, if it isn't already there.

Parameters:

s-name (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the difference of sets $u and $v. (i.e. The set of all members of u that aren't also members of $v.)

Parameters:

u (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Computes the difference of the set stored in the variable named $u-name in the calling environment and the set v, sets the variable named $u-name in the calling environment to that difference, and also returns that difference.

Parameters:

u-name (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the intersection of sets $u and $v.

Parameters:

u (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Computes the intersection of the set stored in the variable named $u-name in the calling environment and the set v, sets the variable named $u-name in the calling environment to that intersection, and also returns that intersection.

Parameters:

u-name (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Tests whether or not $v is a member of set $s.

Parameters:

s (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the union of sets $u and $v.

Parameters:

u (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Computes the union of the set stored in the variable named $u-name in the calling environment and the set v, sets the variable named $u-name in the calling environment to that union, and also returns that union.

Parameters:

u-name (required)

v (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

to be removed.

See Also:

• packages/acs-tcl/tcl/00-database-procs.tcl

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

to be removed.

Parameters:

selection_variable (required)

name_prefix (optional)

See Also:

• packages/acs-tcl/tcl/00-database-procs.tcl

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.