Login | Register
My pages Projects Community openCollabNet

Newsbruiser Entry CGIs

Leonard Richardson <leonardr@segfault.org>

There are four CGIs whose purpose is to view and manipulate categories in various ways. All of these CGIs take a category as part of the PATH_INFO, after the notebook name; this is the current category.

  • category.cgi shows the category tree for a notebook, rooted at the current category. If you specify the value "edit" for the cgi argument mode, you will also see links to the other category CGIs.

    If the current category has entries filed under it, those entries will be displayed beneath the category tree. If mode is "edit", the entries will have edit buttons.

    http://[host]/[NewsBruiser directory]/category.cgi/mynotebook will show you the entire category tree for the 'mynotebook' notebook.

    http://[host]/[NewsBruiser directory]/category.cgi/mynotebook/books will show you a tree of the subcategories of the 'books' category, and all entries filed under 'books'.

    http://[host]/[NewsBruiser directory]/category.cgi/mynotebook/books/sci-fi will show you a tree of the subcategories of the 'sci-fi' subcategory of the 'books' category, and all entries filed under 'books/sci-fi'.

    http://[host]/[NewsBruiser directory]/category.cgi/mynotebook/books?mode=edit will show you a tree of the subcategories of the 'books' category, with links to the category manipulation CGIs. It will also show all entries filed under 'books', with an edit button for each entry.

  • category-add.cgi adds a subcategory underneath the current category. If you do not specify a current category, it will add a top-level category. You must enter the notebook password to add a category.

  • category-edit.cgi allows you to rename the current category or move it to a different parent. You must enter the notebook password to edit a category.

  • category-delete.cgi allows you to delete the current category. When you delete a category, all the entries filed under that category are removed from the category, but the entries themselves are not deleted. You cannot delete a category that has subcategories (so delete the subcategories first). You must enter the notebook password to delete a category.

Back to the main documentation