Allow site visitors to submit Web App items

Updated on 20-October-2016 at 10:16 AM

Business Catalyst End of life announcement - find out more details.

In this article, you will learn how to create a web app that allows visitors to login, register and submit web app items. For a detailed tutorial on setting up a Web App item submission app, see Building a vistor submission Web App

Item submission is done by submitting a form on the live site. In order for a site visitor to submit a Web App item, the visitor must be logged in to the site. The best way to do this is to create a specific Secure Zone for Web App item submissions. You can optionally log site visitors into the site with a generic login form (i.e Not into any specific secure zone).

Creating the Web App

To create a Web App that allows visitors to submit items, select Web Apps > +Add Web App as you would for creating a standard Web App. In the Details screen under the Customer Permissions for Web App Items section, check the below options:

  • Add New Items
  • Edit Items
  • Delete Items

Enabling these options means allowing site visitors access to add, edit and delete Web App items in this app. By default, a site visitor can only edit an item that they have created or has been assigned to them. If you check the Anyone can edit items option, this means that any logged in user can update an item.

The Requires Approval option can be used to allow a site administrator to first approve all front-end Web App item submissions. For details, see Pre-approving item submissions.

Adding Items

The Next thing you need to do is insert the submission form (also known as the Web App input form) on page.

  1. Select Site Manager > Pages. If you would like to use an existing page, select the page in the tree view. If not, click Add page.
  2. From the Toolbox found on the right of the editor, select Web Apps > Web Apps Input Form.
  3. Select the Web App you created in the first step, then click Insert.
  4. Click Save.

When a logged in visitor views this page and submits this form, a new Web App item is created.

Note: For the best experience using Business Catalyst we recommend creating a maximum of 10000 webapp items. For more details please see the Business Catalyst limitations .

Edit and Delete Items

To allow visitors to edit or delete items, there are two things you need to do. The first is that you need to customize the Web App list layout to add the below tags:

The second thing is that you need to insert the List of Submitted Web App Items module on a page. This module can be found in the Toolbox menu to the right of the editor:

When a logged in user views this page, they will see the Edit and Delete links next to the items they have created.

Viewing who an item is assigned to

You can see which customer a Web App item is assigned to.

  1. Open your Web App by clicking Web Apps and then selecting your app from the list.
  2. Click the name of the item you want to view from the list.
  3. Click to expand the More Options section
  4. The user assigned to this item is shown in the Submitted by section.

Pre-approving item submissions

If you want to set up a pre-approval workflow for customer Web App item submissions, you can select this option in the Web App settings. To approve items, a Role must be assigned to app. For details, see Manage user roles.

  1. Open the Details page of an existing Web App or create a new app.
  2. In the details page, select the option Requires Approval as shown below:
  3. Select the Role that will be approving the items.
  4. Click Save.

When a new item is submitted to this Web App from the front-end of the site, an email is sent to all users of this role. The email contains a link to view the Web App item in the admin and the item is disabled. To approve the item, the admin user can simply enable the item.