Index: openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html,v diff -u -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html 11 Nov 2003 12:54:57 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html 19 Nov 2003 15:44:51 -0000 1.15 @@ -1,13 +1,12 @@ -Creating a Package

Creating a Package

- by Joel Aufrecht
+Creating a Package

Creating a Package

by Joel Aufrecht

OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. -

The intended page map

...

Overview

To start developing new code in OpenACS, we build a new +

The intended page map

Overview

To start developing new code in OpenACS, we build a new package. A package is a a discrete collection of web pages, tcl code, and database tables and procedures. A package - with user interface is called an application; a package which provides + with user interface is called an application; a package which provides functions to other packages and has no direct interface, a - service. A package + service. A package can be installed, upgraded, and removed. It communicates with other packages through an API. This chapter walks you through the minimum steps to create a useful package, including writing @@ -22,11 +21,11 @@

In this tutorial, we will make an application package for displaying a list of text notes. -

Before you begin

You will need:

  • A computer with a working installation of +

Before you begin

You will need:

  • A computer with a working installation of OpenACS. If you don't have this, see Chapter�2, Installation Overview.

  • Example files, which are included in the standard OpenACS 5.0.0b1 distribution. -

Figure�7.1.�Assumptions in this section

Fully qualified domain name of your serveryourserver.test
URL of your serverhttp://yourserver.test:8000
Name of development accountservice0
New Package keymyfirstpackage

Use the APM to initialize a new package

We use the ACS Package Manager (APM) to add, remove, and +

Figure�7.1.�Assumptions in this section

Fully qualified domain name of your serveryourserver.test
URL of your serverhttp://yourserver.test:8000
Name of development accountservice0
New Package keymyfirstpackage

Use the APM to initialize a new package

We use the ACS Package Manager (APM) to add, remove, and upgrade packages. It handles package meta-data, such as lists of files that belong in the package. Each package is uniquely identified by a package key. To start developing a new @@ -55,7 +54,7 @@

This creates a package rooted at /var/lib/aolserver/service0/packages/myfirstpackage. This is the "home directory" of our new package, and all - files in the package will be within this directory.

Mount the package in the site map

In order to see your work in progress, you must create a + files in the package will be within this directory.

Mount the package in the site map

In order to see your work in progress, you must create a map between the URL space of incoming requests and the package. You do this by mounting the package in the Site Map. This creates a link between the incoming URL and an