Custom Tables

Templates can define their own custom models without needing to touch the core code.

1. Create a file with S3Model(s) in, just as if it was going into s3db/ although change the s3 import path to from s3 import *

2. Add this to mytemplate/__init__.py, e.g. for a module called 'custom':

   __all__ = ("custom",
              )
   
   import templates.mytemplate.custom
   

3. Add to mytemplate/config.py:

   settings.base.custom_models = {"custom": "mytemplate",
                                  }
   settings.modules["custom"] = {"name_nice": T("My Custom Module"), "module_type": 10}
   

4. If wanting to have a REST controller for them, then see S3/S3REST/s3_rest_controller

i.e. add an entry to mytemplate/config.py:

settings.base.rest_controllers = {("custom", resourcename): ("custom", resourcename)}