source: extensions/net.sf.basedb.examples/trunk/README @ 1596

Last change on this file since 1596 was 1596, checked in by Nicklas Nordborg, 11 years ago

Fixes #376: Create some example extensions that add list columns

Added three list column examples.

  • Property svn:mime-type set to text/x-trac-wiki
File size: 4.4 KB
[636]1== Requirements ==
[1596]3 1. BASE 3.2 or later.
5== Introduction ==
[683]7This package contains a few simple variants of ''Hello world'' applications
8in the form of extensions to the BASE web client. The package installs
9several examples into the ''Extensions -> Hello world examples'' menu:
[683]11 * Hello world! - A basic example using only javascript
12 * Hello factory world! - An example that uses a custom action factory
13 * Greetings Root! - An example of a custom action factory with parameters
14 * Hello JSP world! - Uses a JSP file to display the message instead of javascript
15 * Hello X-JSP world! - Another variant of a JSP file
16 * Hello Servlet world! - Uses a servlet to generate the message
[1150]17 * Hello Servlet world (alternate)! - Uses an alternative servlet path
[1019]19There are also a few toolbar button extensions:
21 * More info - A toolbar button on all single-item toolbars and
22   displays some information in a popup window about the current item.
23 * Annotation filter - A toolbar button on all list pages for annotatable
24   items which allows a user to show only items with/without annotations.
[1269]26And a edit/save extension:
28 * Sample history data - Two extensions that works together. The first adds
29   a tab to the "Edit sample" dialog were the user can select a file to link
30   with the sample. The second extensions attaches to the save event and
31   saves the link.
[1271]32 * Last updated by - An on-save extension that creates an any-to-any link
33   between any item and the currently logged in user. This is a very simple
34   logging feature that stores information about the last update to an item.
[1596]36And some extra list columns:
38 * Owner registration date - Adds a list column that display the registration
39   date of the owner of the item. The column is added to all list pages that
40   list items that have an owner.
41 * Onwer email - Adds a list column that display the email address of the
42   owner of the item. This uses a custom formatter to create mailto links
43   on the web page and a formatter that convert to upper case when exporting.
44   The column is added to all list pages that list items that have an owner.
45 * Data files - Adds a column to the raw bioassay list that display the
46   data files that are attached to each raw bioassay. This uses a custom
47   action factory and illustrates the possibility to create fullblown HTML
48   for the web page, and a text-only variant for the table exporter.
[1347]50This package contains the following plug-ins:
52 * An importer that pretends to be able to import samples. It will
53   accept any file, but doesn't do anything. Main purpose is to
54   show parameter handling with plug-ins.
55 * An analyser plug-in that does some bogus calculations on a
56   bioassay set. Main purpose is to show how a plug-in can access
57   analysed data, do some calculations and store the result as
58   a new bioassay set.
[636]61== Installation ==
[1392]63 1. Download the base-examples-*.tar.gz file.
64 2. Unpack the downloaded file to a directory of your choice.
65 3. Copy the 'base-examples.jar' file to your BASE plug-ins directory
66    as configured in the base.config[plugins.dir] setting.
67 4. Go to 'Administrate->Plug-ins & Extensions->Overview' page.
68 5. Run the installation wizard and select to install 'base-examples.jar'.
69 6. The ''Hello X-JSP world'' example requires that the X-JSP compiler is installed
[683]70    on the server. Read in the documentation how to do this.
[1392]72 7. Done. You may have to use 'BASE->Reload permissions' from the menu to see the
73    'Extensions' menu.
[636]76== Compiling ==
78To compile this package you also need:
[1433]80 1. Ant 1.8
[636]81 2. Java 1.6
83Follow these instructions:
[691]85 1. Type `ant download-lib` to automatically download the BASE core JAR file that
86    are neeed for compilation. You can also do this manually by copying the
[1537]87    base-core-3.1.0.jar and base-webclient-3.1.0.jar files from the BASE installation
[1346]88    directory (<basedir>/www/WEB-INF/lib/) to the ./lib/compile directory.
[1392]90 2. Type 'ant' to compile the code and generate the 'base-examples.jar'
[1094]91    file in the project directory. This file can be installed into BASE following
92    the intructions above.
[1346]94 3. Use 'ant package' to create a downloadable tar.gz.
96 4. If you create a file called '' and enter a the path to the
97    plug-ins directory under the key 'base.plugins', you can simply type
98    'ant install' to copy the examples to the BASE plug-ins directory.
Note: See TracBrowser for help on using the repository browser.