View Categories

Post Selection Module in Fluent Forms

The Post/CPT (Custom Post Type) Selection module in Fluent Forms is a powerful tool that fetches and displays post-type data from your WordPress site in a dropdown field. This feature is great for scenarios like letting users select a post to edit or perform an action based on available posts.

This article will show you the details of the Post Selection Module feature with Fluent Forms.

What is Post/CPT Selection? #

This feature lets users view and select posts from your site directly in a form dropdown. For example:

  • If you create a post-edit form, you can display all posts authored by the logged-in user for selection.
  • Users can choose a specific post and submit additional data.

You can even customize the posts displayed in the dropdown using Query Parameters.

Add the Post/CPT Selection Field #

Go to your form in Fluent Forms. Add the Post/CPT Selection field from the Advanced Fields section. 

post selection module 01 scaled 48055

A dropdown showing all posts on your site will appear by default. However, you can select any other post-type data on your site.

select post type 02 scaled 48055

Use the Extra Query Parameter field to display specific posts based on author, category, or tags.

Using the Extra Query Parameter #

The Extra Query Parameter field allows you to filter posts using WP_Query. You can see the WP_Query documentation here.

But to run the same queries inside the Extra Query Parameter field, you need to write the queries in a specific format. Go to the WordPress wp query documentation and choose how to display your post, such as author name, category name, tag, etc.

Now, assume I have a post-author named Kevin. We want to show all his posts so we can use this in our query.

Single Parameter #

In wp_query, it works as below-

We will also convert it in our own way. We will grab the key and value from above.

WP Query 03 scaled 48055

You can write this way.

04 4 scaled 48055

Multiple Parameter #

To display posts by a specific author in a category:

  • WP_Query example:
array(

    'author_name' => 'kevin',

    'category_name' => 'news'

)

Format for Fluent Forms:

author_name=kevin&category_name=news

Array Parameters #

For queries with array values, such as posts in multiple categories:

  • WP_Query Example:
array(

    'category_name' => array('news', 'blog')

)

Format for Fluent Forms:

category_name[]=news&category_name[]=blog

Nested Array Parameters #

For nested arrays, such as meta queries:

  • WP_Query Example
array(

    'meta_query' => array(

        array(

            'key' => 'views',

            'value' => '100',

            'compare' => '>='

        )

    )

)
  • Format for Fluent Forms
meta_query[0][key]=views&meta_query[0][value]=100&meta_query[0][compare]=>=

Now, you can use the Post Selection module to create dynamic and user-friendly forms in Fluent Forms! 

If you have any further questions, concerns, or suggestions, please do not hesitate to contact our support team. Thank you.