Index: openacs-4/packages/acs-content-repository/www/doc/guide/items.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-content-repository/www/doc/guide/items.adp,v diff -u -r1.4.2.1 -r1.4.2.2 --- openacs-4/packages/acs-content-repository/www/doc/guide/items.adp 3 Sep 2021 09:14:41 -0000 1.4.2.1 +++ openacs-4/packages/acs-content-repository/www/doc/guide/items.adp 13 Jul 2023 12:47:28 -0000 1.4.2.2 @@ -12,29 +12,35 @@
Content items are initialized using the content_item.new function. A name is the only parameter required to create an item:
-item_id := content_item.new( name => 'my_item' );+
+item_id := content_item.new( name => 'my_item' ); +
The name represents the tail of the URL for that content item. In most cases you will want to create items in a particular context with the repository hierarchy:
-item_id := content_item.new( ++item_id := content_item.new( name => 'my_item', parent_id => :parent_id -);+); +
The parent ID must be another content item, or a subclass of content item such as a folder.
The content_item.new function accepts a number of other optional parameters. The standard creation_date, creation_user and creation_ip should be specified for auditing purposes. You can also create the initial revision and publish text items in a single step:
-item_id := content_item.new( ++item_id := content_item.new( name => 'my_item', parent_id => :parent_id, title => 'My Item', text => 'Once upon a time Goldilocks crossed the street. Here comes a car...uh oh! The End', is_live => 't' -);+); +
If either the title or text are not null, the function will create the first revision of the item. It will also mark the item as live if the is_live parameter is true. The @@ -44,7 +50,9 @@
If a content item has at least one revision, then it can be published by calling the content_item.set_live_revision procedure, which takes as input a revision_id:
-content_item.set_live_revision( revision_id => :revision_id );+
+content_item.set_live_revision( revision_id => :revision_id ); +
Last Modified: $Id: items.html,v 1.2 2017/08/07 23:47:47 gustafn