Generate a name with a potentially inserted parent name

Switches:

-parent_id

(optional)

parent_id (for now just for download)

Parameters:

name - name of the wiki page

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

Testcases:

xowiki_test_cases

Construct a folder path from a hierarchy of xowiki objects. It is designed to work with linked objects, respecting logical and physical parent IDs. The result is URL encoded, unless path_encode is set to false.

Switches:

-parent_id

(optional)

-context_url

(optional)

-folder_ids

(optional)

-path_encode

(boolean) (defaults to "true") (optional)

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

Testcases:

link_tests

The page_reference is either an item_id, a fully qualified URL path or the name exactly as stored in the content repository ("name" attribute in the database, requires parent_id to be provided as well)

Switches:

-parent_id

(optional)

optional, only needed in legacy cases, when page_reference is provided as page name

Parameters:

page_references - item_ids, paths or names to be resolved as item_ids

Returns:

list of valid item_ids

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

Testcases:

No testcase defined.

Resolves configurable parameters according to the following precedence: (1) values specifically set per page {{set-parameter ...}} (2) query parameter (3) form fields from the parameter_page FormPage (4) standard OpenACS package parameter The specified attribute can be of the form "name:value_constraint"

Switches:

-check_query_parameter

(defaults to "true") (optional)

-nocache

(optional)

-type

(optional)

Parameters:

attribute
default (optional)

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

Testcases:

create_form_with_form_instance

Try to get the parameter from the named parameter_page.

Switches:

-parameter_page_name

(optional)

Parameters:

parameter
default (optional)

Returns:

parameter value or empty

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

Testcases:

xowiki_test_cases

import the specified pages into the xowiki instance

Switches:

-user_id

(optional)

-parent_id

(defaults to "0") (optional)

-replace

(defaults to "0") (optional)

-objects

(optional)

-create_user_ids

(defaults to "0") (optional)

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

Testcases:

No testcase defined.

An item_ref refers to an item (existing or non-existing) in the content repository relative to some parent_id. The item might be either a folder or some kind of "page" (e.g. a file). An item_ref might be complex, i.e. consist of a path of simple_item_refs, separated by "/". An item_ref stops at the first unknown part in the path and returns item_id == 0 and the appropriate parent_id (and name etc.) for insertion.

Switches:

-use_package_path

(defaults to "false") (optional)

-use_site_wide_pages

(defaults to "false") (optional)

-normalize_name

(defaults to "true") (optional)

-default_lang

(required)

-parent_id

(required)

Parameters:

link

Returns:

item info containing link_type form prefix stripped_name item_id parent_id

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

Testcases:

xowiki_test_cases, path_resolve

Lookup name (with maybe cross-package references) from a given parent_id or from the list of configured instances (obtained via package_path).

Switches:

-use_package_path

(defaults to "true") (optional)

-use_site_wide_pages

(defaults to "false") (optional)

-default_lang

(optional)

-name

(required)

-parent_id

(optional)

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

Testcases:

path_resolve

Creates conditionally a link for use in xowiki. When the generated link will be activated, the specified method of the object will be invoked. make_link checks in advance, whether the actual user has enough rights to invoke the method. If not, this method returns empty.

Switches:

-with_entities

(defaults to "0") (optional)

-privilege

(optional)

When provided, the privilege can be "public" (do not check rights) or a privilege to be checked on the package_id and the current user. When this parameter is not specified, the policy is used to determine the rights to be checked.

-link

(optional)

When this parameter is specified, is used used as base link for export_vars when applied on pages (or for packages as next segment under the package url). When not specified, the base url for pages is the current url, and for packages it is the package url.

Parameters:

object - The object to which the link refers to. If it is a package_id it will base to the root_url of the package_id. If it is a page, it will base to the page_url
method (optional) - Which method to use. This will be appended as "m=method" to the url. Examples for methods:

• view: To view and existing page
• edit: To edit an existing page
• revisions: To view the revisions of an existing page

args - List of attributes to be append to the link. Every element can be an attribute name, or a "name value" pair. Behaves like export_vars.

Returns:

The link or empty

See Also:

• export_vars

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

Testcases:

xowiki_test_cases

Generate a (minimal) link to a wiki page with the specified name. Practically all links in the xowiki systems are generated through this method. The method returns the URL path urlencoded, unless "-path_encode" is set to false.

Switches:

-anchor

(optional)

anchor to be added to the link

-query

(optional)

query parameters to be added literally to the resulting URL

-absolute

(boolean) (defaults to "false") (optional)

make an absolute link (including protocol and host)

-siteurl

(optional)

-lang

(optional)

use the specified 2 character language code (rather than computing the value)

-parent_id

(optional)

parent_id

-download

(boolean) (defaults to "false") (optional)

create download link (without m=download)

-context_url

(optional)

-folder_ids

(optional)

-path_encode

(boolean) (defaults to "true") (optional)

control URL encoding of the path segmemts

-page

(optional)

Parameters:

name - name of the wiki page

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

Testcases:

link_tests

Reparent a wiki page from one parent page to another one. The function changes the parent_id in cr_items, updates the cr-child-rels, and clears the caches. The function does not require the item to be instantiated. Limitations: The method does not perform permission checks (whether the actual user has rights to move the page to another parent folder), which should be implemented by the calling methods. Currently, the method does not perform cycle checks. It might be recommended to make sure the target parent is in the same package instance.

Switches:

-item_id

(optional)

item_id of the item to be moved

-new_parent_id

(optional)

item_id of the target parent

-allowed_parent_types

(defaults to "::xowiki::FormPage ::xowiki::Page") (optional)

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

Testcases:

No testcase defined.

Make sure, the root folder for the given package exists. If not, create it and register all allowed content types.

Switches:

-parent_id

(defaults to "-100") (optional)

-content_types

(optional)

-name

(required)

Returns:

folder_id

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

Testcases:

create_form_with_form_instance

Try to resolve from object (path) and query parameter the called object (might be a package or page) and the method to be called.

Switches:

-use_package_path

(defaults to "true") (optional)

-simple

(boolean) (defaults to "false") (optional)

when set, do not try to resolve using item refs, prototype pages or package_path

-lang

(optional)

language used for resolving

Parameters:

object - element name to be resolved (not an XOTcl object)
method_var - output variable for method to be called on the object

Returns:

instantiated object (Page or Package) or empty

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

Testcases:

xowiki_test_cases, path_resolve

This web-callable method changes the page order for pages by renumbering and filling gaps. The parameter "clean" is just used for page inserts. This method is typically called via AJAX.

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

Testcases:

No testcase defined.

This web-callable "delete" method does not require an instantiated object, while the class-specific delete methods in xowiki-procs need these. If a (broken) object can't be instantiated, it cannot be deleted. Therefore, we need this package level delete method. While the class specific methods are used from the application pages, the package_level method is used from the admin pages. If no "item_id", "name" or "return_url" are given, take it from the query parameters.

Switches:

-item_id

(optional)

-name

(optional)

-parent_id

(optional)

-return_url

(optional)

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

Testcases:

xowiki_test_cases

This web-callable method redirects the caller to the category admin page for a certain category tree. The "object_id" and "tree_id" have to be provided as a query parameter.

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

Testcases:

No testcase defined.

This web-callable method can be used to create new pages in the current package. The behavior can be influenced by the query parameters "object_type", "autoname", "parent_id" and "source_item_id". Finally, it calls "www-edit" for the freshly created page.

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

Testcases:

create_form_with_form_instance

This web-callable method reports the content of xowiki folder in google site map format https://www.google.com/webmasters/sitemaps/docs/en/protocol.html

Switches:

-max_entries

(optional)

maximum number of entries retrieved

-changefreq

(defaults to "daily") (optional)

changefreq as defined by google

-priority

(defaults to "0.5") (optional)

priority as defined by google

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

Testcases:

No testcase defined.

This web-callable method calls "google_sitemapindex" for producing a sitemap index.

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

Testcases:

No testcase defined.

This web-callable method is designed for admin to ease the import of prototpye pages. When called via web, the query parameter "import-prototype-page" determines the page for the import.

Switches:

-add_revision

(boolean) (defaults to "true") (optional)

-lang

(defaults to "en") (optional)

-parent_id

(optional)

Parameters:

prototype_name (optional)

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

Testcases:

create_form_with_form_instance

This web-callable method redirects the caller to the category admin page configured for the current package. The "object_id" has to be provided as a query parameter.

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

Testcases:

No testcase defined.

This web-callable method forces a refresh of a login and do a redirect. Intended for use from ajax.

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

Testcases:

No testcase defined.

This web-callable method can be used to reindex all items of this package by adding all pages of this package to the search queue.

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

Testcases:

No testcase defined.

This web-callable method reports the content of xowiki folder in rss 2.0 format. The reporting order is descending by date. The title of the feed is taken from the title, the description is taken from the description field of the folder object.

Switches:

-maxentries

(optional)

maximum number of entries retrieved

-name_filter

(optional)

-entries_of

(optional)

-title

(optional)

-days

(optional)

report entries changed in specified last days

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

Testcases:

No testcase defined.

This web-callable method can be used to update the page references between all items of this package instance. Call with e.g. xowiki/?update-references

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

Testcases:

No testcase defined.

Obtain the package_id from either the item_id or the revision_id of a page

Switches:

-revision_id

(defaults to "0") (optional)

-item_id

(defaults to "0") (optional)

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

Testcases:

create_workflow_with_instance

Get the full URL from a page in situations, where the context is not set up.

Switches:

-item_id

(defaults to "0") (optional)

-revision_id

(defaults to "0") (optional)

See Also:

• instantiate_page_from_id

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

Testcases:

No testcase defined.

This method provides a sitemap index of all xowiki instances in google site map format https://www.google.com/webmasters/sitemaps/docs/en/protocol.html

Switches:

-changefreq

(defaults to "daily") (optional)

changefreq as defined by google

-priority

(defaults to "priority") (optional)

priority as defined by google

-package

(optional)

to determine the delivery instance

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

Testcases:

No testcase defined.

Instantiate a page in situations, where the connection context is not set up (e.g. we have no package object). This call is convenient when testing e.g. from the developer shell.

Switches:

-revision_id

(defaults to "0") (optional)

-item_id

(defaults to "0") (optional)

-user_id

(defaults to "-1") (optional)

-parameter

(optional)

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

Testcases:

create_workflow_with_instance

A small stunt to detect if a package is a descendant of xowiki.

Parameters:

package_id

Returns:

boolean

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

Testcases:

parameter__check_procs