[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4. First use

We will guide you on a step by step tour of the Catalog functionalities. This tour assumes that you've successfully completed the setup , See section Setup.

During all the tour the machine name taken in example will be www.mymachine.org, an anonymous GNU Linux box.

4.1 Control Panel  
4.2 Creation form  
4.3 Catalog editing  
4.4 Inserting entries  
4.5 Browsing  
4.6 Conclusion  


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.1 Control Panel

First display the control panel using the URL

http://www.mymachine.org/cgi-bin/Catalog?context=ccontrol_panel.

images/controlpanel

Click on the Yes, setup a catalog button to create the administrative tables needed by Catalog. The page displayed in response should be something like :

images/controlpanel2

The line beginning with Create ... shows a menu that contains the list of all the tables of the current database. In this example we've used the mysql database, which is the default database created when you install MySQL.

The Create a demo table link at the bottom of the page creates a sample table for the purpose of the demo. This table, named urldemo contains two fields : an URL and a COMMENT. Click on the link to create the table. When the table is created, the control panel is displayed again. You can now see the urldemo table when scrolling the menu that lists all the tables of the database.

images/controlpanel3

Please chose the urldemo item in the menu and click on the Create it button on the right of the menu.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.2 Creation form

The catalog creation page shows all the information that describe the catalog being created. In this case we will just fill the name of the catalog with urlcatalog as shown below.

images/catalogcreate

You should then click on the Create it button and the catalog will be created. As a result the program will display the control panel and you should see a line for the newly created catalog.

images/controlpanel4


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.3 Catalog editing

Now that the catalog urlcatalog is ready for classifying the records of the table urldemo, we would like to create categories and put entries in them. First click on the edit link on the control panel to get the catalog editing screen that shows the root of the catalog.

images/rootedit

At present the catalog does not contain anything, therefore the editing screen does not show much. Our first step will be to create three categories, Software, Sport and Movies. To create the first category, click on the

images/open
icon and type Software in the Category name field.

images/categoryinsert

Then click on the Create it! button. Repeat the same procedure for the Sport and Movies categories. When finished you should get the following screen:

images/categoryinsert2

You can then click on the Software link to insert sub categories of the Software category in the same way you created the top level categories Software, Sport and Movies. Let's insert the sub categories Language and Freeware. Note that the path of the current category is shown before the Sub categories label so that you know where you're inserting categories.

images/categoryinsert3


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.4 Inserting entries

Now that we've created a category tree, we can populate it with entries. Let's assume we are editing the Software category.

images/categoryinsert3

Since the urldemo table is empty we should create an new record and place it in the Software category. The

images/new
icon does exactly this. Please click on it to get the following screen:

images/entryinsert

This is an insertion form for the urldemo table. Fill the url and comment field as shown on the screen shot and click on insert. The Software category is displayed again and the newly created entry is shown.

images/entryinsert2


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.5 Browsing

Although our catalog does not contain a lot of entries, we are now able to browse it to see it from the user point of view instead of the administrator point of view. You can go back to the Control Panel using the link at the bottom of the screen and then click on browse link.

images/browse


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.6 Conclusion

This short demonstration demonstrates how to initialize a new catalog from scratch. In the following chapter is a complete guide based on a ready to use example.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by root on November, 18 2003 using texi2html