install-procs.tcl

Procs which may be invoked using similarly named elements in an install.xml file.

Location:
packages/acs-tcl/tcl/install-procs.tcl
Created:
2004-06-16
Author:
Lee Denison <lee@thaum.net>
CVS Identification:
$Id: install-procs.tcl,v 1.40 2024/12/28 15:39:56 gustafn Exp $

Procedures in this file

Detailed information

install::xml::action::add-subsite-admin (public)

 install::xml::action::add-subsite-admin node

Add a member to a subsite's admins group.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::add-subsite-member (public)

 install::xml::action::add-subsite-member node

Add a member to a subsites application group.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::ats-page (public)

 install::xml::action::ats-page node

Creates an ATS Page.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::call-tcl-proc (private)

 install::xml::action::call-tcl-proc node

Call an arbitrary Tcl library procedure. Parameters which have a name are called using the "-param" syntax. If there's no name given, the value is passed directly as a positional parameter. It is the user's responsibility to list all named parameters before any positional parameter (as is necessary if the proc is declared using ad_proc). If a named parameter has an XML attribute declaring its type to be boolean, and the value is blank, the switch is passed without a value. Otherwise, the boolparam=value syntax is used. You can cheat and use this to execute arbitrary Tcl code if you dare, since Tcl commands are just procs ...

Parameters:
node (required)
Author:
Don Baccus donb@pacifier.com
Created:
2008-12-04

Testcases:
No testcase defined.

install::xml::action::create-package (public)

 install::xml::action::create-package node

Create a relation type.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::create-user (public)

 install::xml::action::create-user node

Create a new user. local-p should be set to true when this action is used in the bootstrap install.xml - this ensures we call the auth::local api directly while the service contract has not been setup.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::install (public)

 install::xml::action::install node

Installs a package including dependencies.

<install package="package-key />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::instantiate-object (private)

 install::xml::action::instantiate-object node

Instantiate an object using package_instantiate_object. This will work for both PostgreSQL and Oracle if the proper object package and new() function have been defined.

Parameters:
node (required)
Author:
Don Baccus donb@pacifier.com
Created:
2008-12-04

Testcases:
No testcase defined.

install::xml::action::location (public)

 install::xml::action::location node

Creates a URL location object.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::mount (public)

 install::xml::action::mount node

Mounts a package on a specified node.

<mount package="package-key instance-name="name" mount-point="url" />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::mount-existing (public)

 install::xml::action::mount-existing node

Mounts an existing package on a specified node.

<mount-existing package-id="package-id mount-point="url" />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::register-parameter (public)

 install::xml::action::register-parameter node

Registers a package parameter.

<register-parameter name="parameter" description="description" package-key="package-key" scope="instance or global" default-value="default-value" datatype="datatype" [ [ [ section="section" ] min-n-values="min-n-values" ] max-n-values="max-n-values" ] [ callback="callback" ] [ parameter-id="parameter-id" ]

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::relation-add (public)

 install::xml::action::relation-add node

Create a relation.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::relation-type (public)

 install::xml::action::relation-type node

Create a relation type.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::rename-instance (public)

 install::xml::action::rename-instance node

Change the instance name of an existing package (such as the main subsite). Either the url (if it's mounted) or package_id of the package may be given.

<rename-instance package-id="package-id" url="url" instance-name="new instance name" />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-id (public)

 install::xml::action::set-id node

set a name/id pair for use in other install xml things

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-join-policy (public)

 install::xml::action::set-join-policy node

Set the join policy of a group.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-parameter (public)

 install::xml::action::set-parameter node

Sets a package parameter.

<set-parameter name="parameter" [ package="package-key | url="package-url" ] type="[id|literal]" value="value" />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-parameter-default (public)

 install::xml::action::set-parameter-default node

Sets a package parameter default value <set-parameter-default name="parameter" package-key="package-key" value="val">

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-permission (public)

 install::xml::action::set-permission node

Sets permissions on an object.

<set-permissions grantee="party" privilege="package-key />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::set-theme (public)

 install::xml::action::set-theme node

Sets a theme for a subsite. If no subsite is specified it defaults to the main subsite "/". Valid themes are e.g. "openacs_bootstrap5", "openacs_bootstrap3", "default_plain", or default "tabbed".

<set-theme theme="theme" [ package="subsite ]

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::source (private)

 install::xml::action::source node

Source an install.xml file, SQL file or Tcl script during execution of the current install.xml. If no type attribute is specified then this tag will attempt to guess type of the sourced script from the file extension, otherwise it defaults to install.xml. The type of the sourced script may be explicitly declared as 'tcl', 'sql' or 'install.xml' using the type attribute.

Parameters:
node (required)
Author:
Lee Denison lee@xarg.co.uk
Created:
2005-02-04

Testcases:
No testcase defined.

install::xml::action::text (public)

 install::xml::action::text node

A documentation element which ignores its contents and does no processing.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::unset-permission (public)

 install::xml::action::unset-permission node

Revokes a permissions on an object - has no effect if the permission is not granted directly (i.e. does not act as negative permissions).

<unset-permissions grantee="party" privilege="package-key />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::action::wizard (public)

 install::xml::action::wizard node

Creates a wizard using the subtags for each step.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::object_id::admin-group (public)

 install::xml::object_id::admin-group node
Parameters:
node (required)
Returns:
an object_id for an admin group of a given package.

Testcases:
No testcase defined.

install::xml::object_id::application-group (public)

 install::xml::object_id::application-group node

Returns an object_id for an application group or relational segment of a given package. The node name is ignored so any node which provides the correct attributes may be used.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::object_id::group (public)

 install::xml::object_id::group node

Returns an object_id for a group or relational segment. The node name is ignored so any node which provides the correct attributes may be used.

<group id="group_id" [ type="group type" relation="relation-type" ] />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::object_id::member-group (public)

 install::xml::object_id::member-group node
Parameters:
node (required)
Returns:
an object_id for a member group of a given package.

Testcases:
No testcase defined.

install::xml::object_id::object (public)

 install::xml::object_id::object node

Returns a literal object_id for an object. use <object id="-100"> to return the literal id -100.

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::object_id::package (public)

 install::xml::object_id::package node

Returns an object_id for a package specified in node. The node name is ignored so any node which provides the correct attributes may be used.

<package [ id="id" | key="package-key" | url="package-url" ] />

Parameters:
node (required)

Testcases:
No testcase defined.

install::xml::util::get_id (public)

 install::xml::util::get_id id

Returns an id from the global ids variable if it exists and attempts to find an acs_magic_object if not.

Parameters:
id (required)

Testcases:
No testcase defined.
[ show source ]