Version 39 (modified by Abhishek Mishra, 14 years ago) ( diff )

table is unhashable type, while tablename seems to be the right thing.


How to add a new module?


  • Copy an existing module, paste & edit.
  • Good modules to look at to start with are or & cr as these are simplest & standard.


Add module to models/

Activate it in models/

This makes it visible on the front page & the menu.

Create a file /models/<MODULE NAME>.py

Add tables to this file, as-required for your resources.
To avoid namespace clashes, use the format: db.module_table

e.g. if building a Vehicle Management System, create db.veh_vehicle:

module = 'veh'
resource = 'vehicle'

tablename = module + '_' + resource
table = db.define_table(tablename, timestamp, uuidstamp,
table.uuid.requires = IS_NOT_IN_DB(db, '%s.uuid' % table) = IS_NOT_EMPTY() = SPAN("*", _class="req")

Add the messages for your resources:

s3.crud_strings[tablename] = Storage(
    title_create = T('Add Vehicle'),
    title_display = T('Vehicle Details'),
    title_list = T('List Vehicles'),
    title_update = T('Edit Vehicle'),
    title_search = T('Search Vehicles'),
    subtitle_create = T('Add New Vehicle'),
    subtitle_list = T('Vehicles'),
    label_list_button = T('List Vehicles'),
    label_create_button = T('Add Vehicle'),
    label_delete_button = T('Delete Vehicle'),
    msg_record_created = T('Vehicle added'),
    msg_record_modified = T('Vehicle updated'),
    msg_record_deleted = T('Vehicle deleted'),
    msg_list_empty = T('No Vehicles currently registered'))


Create a file: /controllers/<MODULE NAME>.py

Add the S3 framework functions:

module = 'veh'

# Options Menu (available in all Functions' Views)
response.menu_options = [
    [T("Home"), False, URL(r=request, f="index")],
    [T("Add Vehicle"), False, URL(r=request, f="vehicle", args="create")],
    [T("List Vehicles"), False, URL(r=request, f="vehicle")],
    [T("Search Vehicles"), False, URL(r=request, f="vehicle", args="search")]

Add CRUD functions for your tables:

def vehicle():
    "RESTful CRUD controller"
    return shn_rest_controller(module, "vehicle")

Manual method for if/when you need more control: DeveloperGuidelinesCreateReadUpdateDelete


Add HTML templates for any custom functions: /views/<MODULE NAME>/<FUNCTION NAME>.html

NB Only index.html is required to start with since the RESTful controller normally re-uses standard views.
If Custom Views are wanted they are detected automatically if files are found in /views/<MODULE NAME>/<RESOURCE>_<METHOD>.html


Note: See TracWiki for help on using the wiki.