{{extend 'layout.html'}} {{block sectionclass}}step{{end}}

{{=T('New Application Wizard')}}

{{if request.function=='index':}}

{{=T('Start a new app')}}

{{else:}}

{{=T('Basics')}}

{{=button(URL('index'), T('restart'))}}

App Name: {{=session.app['name']}}

Current settings

{{=button(URL('step1')+'/#xwizard_form', T('Edit'))}}

    {{for key,value in session.app['params']:}}
  • {{=key}}: {{=value}}
    • {{pass}}

Tables

{{=button(URL('step2')+'/#xwizard_form', T('edit all'))}}

    {{for i,table in enumerate(session.app['tables']):}}
  • {{=button(URL('step3',args=[i])+'/#xwizard_form', T('Edit'))}} {{=table}}
    • {{pass}}

Pages

{{=button(URL('step4')+'/#xwizard_form', T('edit all'))}}

    {{for i,page in enumerate(session.app['pages']):}}
  • {{=button(URL('step5',args=i)+'/#xwizard_form', T('Edit'))}} {{=page}}
    • {{pass}}

{{=T('Generate')}}

{{=button(URL('step6')+'/#xwizard_form', T('go!'))}}

{{pass}}
  {{if 'step' in request.function:}}

{{=T('Step')}} {{=step}}

{{if request.function!='step1':}} {{=button(URL('step' + str(int(request.function[-1])-1)) + '/#xwizard_form', T('back'))}} {{pass}} {{else:}}

{{=T('Begin')}}

{{pass}} {{if request.function in ('step1','step2','step3','step4','step5'):}} {{=button(URL('step6') + '/#xwizard_form', T('skip to generate'))}} {{pass}}

{{if request.function in ('step1','step6'):}} {{pass}} {{if request.function!='step6':}}
{{=form.custom.begin}} {{ for fieldname in form.table.fields: }} {{if fieldname is not 'id':}} {{=form.custom.widget[fieldname]}} {{if fieldname=='layout_theme':}} {{pass}} {{pass}} {{pass}}
{{=form.custom.end}}
{{else:}}
{{=form.custom.begin}} {{ for fieldname in form.table.fields: }} {{if fieldname is not 'id':}}
{{pass}} {{pass}}
{{=form.custom.end}}
{{pass}}

Instructions

{{if request.function=='index':}}
  • Insert the name of a new app.
  • If the app exists and was created with the wizard, you will be able to edit it, but any manual editing to the app will be lost.
{{elif request.function=='step1':}}
  • This Wizard will help you build a new web2py app.
  • You can create an app with a name that already exists.
  • If you do not have an email server set email server to "logging".
  • If you want to use Janrain Engage for login: 1) Sign up for a Janrain Engage account; 2) Register you hostname, domain, and obtain an api key; 3) Set Login Config above to "domain:api_key".
  • ATTENTION: you can use the wizard to download plugins BUT we cannot guarantee the stability or backward compatibility of plugins. Moreover plugins may conflict with each other. Anyway, we do recommend installing plugin "wiki" which adds CMS-like capabilities to your app.
{{elif request.function=='step2':}}
  • List the names of table that you need.
  • If you do not need authentication remove the table "auth_user".
  • Press enter to create a new input row.
  • Empty rows are ignored.
  • Other tables for role based access control will be created automatically, and do not need to be listed.
  • You will be able to add fields later.
{{elif request.function=='step3':}}
  • List the fields for this table (do not include an id field, it is automatic), for example "name unique" or "birthday date" or "image upload" or "comments multiple" or "description wiki required"
  • The first keyword(s) for each entry will be used to generate a name for the table field and its label. You can use spaces an other unicode characters.
  • Keywords "string" (default), "text", "integer", "boolean", "float", "double", "file", "date", "time", "datetime", "file", "upload" will be used to determine the field type and they will not be made part of the field name.
  • For a reference field use a field name, followed by the name of the referenced table.
  • Other special keywords are "required", "notnull" or "notempty", "unique". They map into equivalent validators but (at this time) should only be used with string and text types.
  • The keywords "html" and "wiki" force a text type and set a representation for the field value as sanitized HTML and MARKMIN resepectively.
  • string, integer and reference fields can be "multiple", i.e. multiple values will be allowed
  • For the "auth_user" table do not add attributes to the default fields (username, first_name, last_name, password and email). They are handled automatically.
  • Some fields will be added automatically upon creation and handled automatically: "created_by", "created_on", "modified_by", "modified_on", "active" (only active fields can be selected).
  • For every table "table" another table "table_archive" is created and it contains the previous versions of each record. This is only accessible via appadmin or programmatically.
{{elif request.function=='step4':}}
  • List the names of the pages you want to create.
  • Some pages are listed automatically because they expose Create/Read/Update/Delete for each tables you have created.
  • All pages, except "error" and those with name starting in underscore willbe listed in the menu. You will be able to edit the menu later.
  • You should have page "index", the starting point of your app, and page "error", where web2py will redirect to in case of error.
{{elif request.function=='step5':}}
  • Use the markmin syntax to add text to your pages.
{{elif request.function=='step6':}}
  • Almost done. Click on the button above to create your new app.
  • Once done you will be able to edit it as any normal web2py app.
{{pass}}