# Listings

{% hint style="info" %}
**Tip:** Read the [Quick start](#quick-start) guide to get your first listing up and running quickly.
{% endhint %}

### About

This Add-on allows you to display contact entries on your front-end in a table like fashion (list). Hence the name "Listings". A quick preview of how a listing might look on your Front-end:

<figure><img src="https://852124118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6Kz0R6S7z3Fb6KLZYVE%2Fuploads%2FUp9nWOBP1kFsdS8AOo9m%2Ffront-end-listing-table-entries.png?alt=media&#x26;token=584f634b-b7e5-4fd1-8fc2-8cf62151142f" alt="A table/list on the WordPress front-end displaying contact entries (form submissions)."><figcaption><p>A table/list on the WordPress front-end displaying contact entries (form submissions).</p></figcaption></figure>

{% hint style="info" %}
You can try this Add-on for 15 days for free by going to **Super Forms > Add-ons** in your WordPress dashboard.
{% endhint %}

### Quick start

The Add-on comes with a 15 day free trial, so you can try it out for free. To enable the trial, login to your WordPress site and navigate to **Super Forms > Licenses**. On this page you can start the 15 day trial for the **Listings** Add-on. Once the trial is activated, you can navigate to any of your existing forms via **Super Forms > Your forms**, or create a new form **Super Forms > Create form**.

Now click on the **\[Listings]** TAB at the top of the builder page:

<div align="left"><figure><img src="https://852124118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6Kz0R6S7z3Fb6KLZYVE%2Fuploads%2FZzvATqnjtd6IUzZX5qHf%2Fconfigure-listings-settings-for-your-form.JPG?alt=media&#x26;token=777e136d-66ad-43cc-9073-8c72ec0da04e" alt="Creating and configuring a listing for your WordPress form."><figcaption><p>Creating and configuring a listing for your WordPress form.</p></figcaption></figure></div>

Here you will find all the settings and options for the Add-on. To create your first listing, you can check the option **Enable listings for this form**. To edit your listings settings you can click the cogwheell icon as shown below:

<div align="left"><figure><img src="https://852124118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6Kz0R6S7z3Fb6KLZYVE%2Fuploads%2FRyC9vSrQgxf0dQoSNaNX%2Fediting-existing-listings.png?alt=media&#x26;token=8b7d5ce8-0a90-4214-828d-317d95f59b30" alt="Edit an existing listing from the back-end."><figcaption><p>Edit an existing listing from the back-end.</p></figcaption></figure></div>

{% hint style="info" %}
**Tip:** you most likely will want to setup a page with a Fullwidth layout (if your theme supports it), this way the most columns can be visible at once (in case you have many columns defined to be displayed)
{% endhint %}

Depending on your settings your listing should be visible (or not) and might look something like this:

<figure><img src="https://852124118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6Kz0R6S7z3Fb6KLZYVE%2Fuploads%2FUp9nWOBP1kFsdS8AOo9m%2Ffront-end-listing-table-entries.png?alt=media&#x26;token=584f634b-b7e5-4fd1-8fc2-8cf62151142f" alt="Example of how the list/table might look on your WordPress site."><figcaption><p>Example of how the list/table might look on your WordPress site.</p></figcaption></figure>

### Settings

There are many settings that give you control over what and how the listing will be displayed to the end-user, such as:

* Control to who the listing will be displayed and display an optional message to other users that can't view it;
* Control from which forms entries should be retrieved, e.g. "Current form", "All forms", or "Specific form ID's";
* Only retrieve entries between a specific date range (from/till), you can leave from or till blank to have no limit on either side;
* Control who can see which entries
* Optionally display a message to the user if no entries are found
* Allow/Disallow administrators or other roles/ID's to **view** any entries
* Allow/Disallow users to **view** their own entries
* Allow/Disallow administrators or other roles/ID's to **edit** any entries
* Allow/Disallow users to **edit** their own entries
* Allow/Disallow administrators or other roles/ID's to **delete** any entries
* Allow/Disallow users to **delete** their own entries
* Show custom columns that will be mapped to your form fields and whether or not they can filter/sort this column
* Show predefined columns and whether or not they can filter/sort this column
  * Entry title;
  * Entry status;
  * Entry date;
  * WC order *(Add-on required)*;
  * WC order status *(Add-on required)*;
  * PayPal order *(Add-on required)*;
  * PayPal order status *(Add-on required)*;
  * PayPal subscription *(Add-on required)*;
  * Created post title *(Add-on required)*;
  * Created post status *(Add-on required)*;
  * Generated PDF *(Add-on required)*;
  * Author username *(if user was logged in during form submission)*;
  * Author first name *(if user was logged in during form submission)*;
  * Author last name *(if user was logged in during form submission)*;
  * Author full name *(if user was logged in during form submission)*;
  * Author nickname *(if user was logged in during form submission)*;
  * Author display name *(if user was logged in during form submission)*;
  * Author E-mail *(if user was logged in during form submission)*;
  * Author ID *(if user was logged in during form submission)*;
* For each column you can define if the value should have a link to one of the following options
  * None (no link);
  * Edit the contact entry (backend);
  * WooCommerce order (backend);
  * WooCommerce order (front-end);
  * PayPal order (backend);
  * PayPal subscription (backend);
  * Generated PDF file;
  * Created post/page (backend);
  * Created post/page (front-end);
  * The author page (front-end);
  * The author profile (backend);
  * Author E-mail address (mailto:);
  * E-mail address (mailto:);
  * Custom URL;

### Pricing

<table><thead><tr><th width="152">Volume</th><th width="189">Price per license</th><th>Total</th></tr></thead><tbody><tr><td>1+</td><td>$5</td><td>1 license would cost $5 p/m</td></tr><tr><td>5+</td><td>$3</td><td>5 licenses would cost $15 p/m</td></tr><tr><td>10+</td><td>$2.5</td><td>10 licenses would cost $25 p/m</td></tr><tr><td>20+</td><td>$2</td><td>20 licenses would cost $40 p/m</td></tr><tr><td>40+</td><td>$1.5</td><td>40 licenses would cost $60 p/m</td></tr></tbody></table>