Display a List of Entries

Add a list of form entries to a page, post, or widget with a link to edit an entry. Each entry in the list can be linked to a View or the admin entry page. By default, the entry creation date is displayed in the list of entries.

Use the shortcode builder

1. Go to a WordPress page or post.
2. Click on the 'Formidable' button above the content box.
   
3. Click 'List of Entries', then select the form that holds the entries you would like to use and choose from the options below.
   
4. Click the 'Insert into Post' button.

Insert the shortcode manually

Insert the following shortcode in a page, post, widget, or anywhere shortcodes are accepted.

[frm-entry-links id=x]

Use this shortcode to display a list of entries from a particular form. Replace x with the form ID.

Parameters

Required

• id - ID of the form

Optional

• field_key - Include a field key or ID to specify which field will be displayed in place of the entry creation date. This will display the data that has been stored in that field for each entry. For best results, make this field required in your form. Usage:

  [frm-entry-links id=x field_key=adjh29]

• type - Display the entries as a list (default), dropdown, or a collapsed list by using 'list', 'select', or 'collapse'. Use type=collapse to collapse the list by year and by month. Use type=select to insert a dropdown with a list of the entries. Usage:

  [frm-entry-links id=x field_key=y type=select]

• user_id - Determine which entries will be seen by each user. Use user_id=current to only display entries submitted by the current user (this is the default behavior). Use user_id=0 if you would like to display all submitted entries for each user. Usage:

  [frm-entry-links id=x user_id=0]

• order - Customize the order of entries displayed. When this is not included, the entries are ordered by ascending creation date. Usage:

  [frm-entry-links id=x order=DESC]

  To order by a field value, use order=' ORDER BY meta_25 DESC'. Replace 25 with the ID of the field to order by.

• page_id - If you put the entry list on a different page from the form, add the ID of the page where your form is published. Usage:

  [frm-entry-links id=x page_id=5]

• show_delete - Add a delete link next to each list item or next to the dropdown. Include the label for the link in this parameter. Usage:

  [frm-entry-links id=x show_delete="Delete"]

  • confirm - If using the show_delete parameter, you can display a pop-up message to confirm entry deletion. Usage:

    [frm-entry-links id=x show_delete="Delete" confirm="Permanently delete your entry?"]

• link_type - Change the link to point to the admin entry, a different location on the page, or a normal front-end link (default) by using 'admin', 'scroll', or 'page'. If you use 'scroll', you will need a View on the same page. It expects a container with id="[key]". Usage:

  [frm-entry-links id=x link_type=admin]

• drafts - By default, draft entries are not included in this list. To only include drafts, use 1.

  [frm-entry-links id=x drafts=1]

  To only include in progress entries, use 2.

  [frm-entry-links id=x drafts=2]

  To only include abandoned entries, use 3.

  [frm-entry-links id=x drafts=3]

  To only include specific status types, use comma separated values in the shortcode. You can choose from either: 1, 2, or 3 values.

  [frm-entry-links id=x drafts="2,3"]

  To include both drafts and completed entries, use drafts="both".

  [frm-entry-links id=x drafts="both"]

  To include all status types, use drafts="all".

  [frm-entry-links id=x drafts="all"]

• class - Add a class on the highest level object in the returned list.

  [frm-entry-links id=x class="addclasses here"]

PHP Alternative

FrmProEntriesController::entry_link_shortcode(array('id' => x, 'field_key' => 'key_here'));

• 'x' = ID of the form
• 'key_here' = ID or key of the field you would like to display

Additional Customization

If the frm-entry-links shortcode doesn't have enough built-in options to meet your needs, you can create a View to accomplish the same thing. Just set the View to show 'All Entries' and insert the following link into the content box:

<a href="/page-with-form?frm_action=edit&entry=[key]">entry title here</a>

Change 'page-with-form' to the URL of the page where the form is published. When this link is clicked, it takes the user to edit the attached entry.