FlexiPost Documentation

What is FlexiPost?

FlexiPost is an all-in-one no-code content builder for WordPress. It combines four powerful tools into a single, cohesive admin interface — so you can go from idea to a live, structured content gallery without writing any code.

Database Tables

FlexiPost creates 5 custom tables on activation. Field values entered by users are stored as standard wp_postmeta.

Installation

Automatic (Recommended)

Manual Upload

1. Plugins → Add New → Upload Plugin
2. Upload flexipost.zip
3. Click Install Now → Activate

Requirements

Quick Start Guide

Option A — Module Library (Fastest)

[cpt_display module="team-member" layout="grid" columns="3"]

Option B — Build from Scratch

[cpt_display module="books" layout="grid" columns="3" per_page="9"]

Post Type Manager

Go to FlexiPost → Post Types → Add New to create a custom post type without writing any code.

Tabs Overview

List Operations

Taxonomy Manager

Go to FlexiPost → Taxonomies → Add New to create custom categories and tags.

Assign taxonomies to post types using the toggle switches on the taxonomy edit screen — no save button needed, changes apply instantly.

Custom Field Builder

Two Ways to Add Fields

Creating a Field

Click Add Field — a two-step modal opens:

Conditional Logic

Show or hide any field based on the value of another field.

Field Types Reference

Basic Fields

Choice Fields

Media Fields

Date & Time

Relational Fields

Advanced Fields

PHP Retrieval Examples

// Single field
$value = get_post_meta( $post_id, 'itsmfp_field_key', true );

// Image field (get URL)
$img_id = get_post_meta( $post_id, 'itsmfp_cover_image', true );
echo wp_get_attachment_image( $img_id, 'medium' );

// Date field (formatted)
$date = get_post_meta( $post_id, 'itsmfp_event_date', true );
echo date_i18n( get_option('date_format'), strtotime( $date ) );

// Repeater field
$rows = itsmfp_get_repeater( $post_id, 'itsmfp_ingredients' );
foreach ( $rows as $row ) {
    echo esc_html( $row['ingredient_name'] ?? '' );
}

Layout Builder / Templates

Go to FlexiPost → Templates to design how your content looks on the frontend — no PHP template files needed.

Template Types

Layout Blocks

Template Tags

Use these inside Custom HTML blocks:

{{title}}           Post title
{{content}}         Full post content
{{excerpt}}         Post excerpt
{{thumbnail}}       Featured image HTML
{{date}}            Publish date
{{author}}          Author name
{{permalink}}       Post URL
{{id}}              Post ID

{{meta.field_key}}          Custom field value
{{taxonomy.genre}}          Taxonomy terms (comma-separated)

Example Custom HTML Block

<div class="book-card">
  <div class="cover">{{thumbnail}}</div>
  <h2>{{title}}</h2>
  <p class="author">by {{meta.author_name}}</p>
  <p class="genre">{{taxonomy.genre}}</p>
  <a href="{{permalink}}">View Book →</a>
</div>

Module Library

One-click installs that create the post type, taxonomies, fields, and default layout all at once.

Shortcodes

Basic Usage

[cpt_display module="post-type-slug"]

All Parameters

Examples

// Grid with 3 columns
[cpt_display module="portfolio" layout="grid" columns="3"]

// Slider testimonials
[cpt_display module="testimonial" layout="slider" per_page="10"]

// Events — soonest first
[cpt_display module="event" orderby="date" order="ASC" per_page="6"]

// Filter by taxonomy
[cpt_display module="portfolio" taxonomy="portfolio-category" term="web-design"]

// Random 3, no date
[cpt_display module="team-member" columns="3" orderby="rand" per_page="3" show_date="false"]

PHP Usage

<?php echo do_shortcode( '[cpt_display module="portfolio" layout="grid" columns="3"]' ); ?>

Gutenberg Block

FlexiPost registers two native Gutenberg blocks.

CPT Display Block

Submission Form Block

Lets logged-in users submit posts from any page built in Gutenberg.

Elementor Widget

Two Elementor widgets are registered when Elementor is active.

Find both widgets by searching FlexiPost in the Elementor widget panel.

Frontend Submission Form

Allow logged-in users to create posts from the frontend without accessing the WordPress admin.

Shortcode

[itsmfp_submit_form post_type="books"]

How It Works

Import / Export

Exporting

Go to FlexiPost → Settings → Export. Downloads a .json file containing all post types, taxonomies, field groups, fields, and templates.

Import Modes

Starter Templates

Apply a pre-built configuration from Settings → Starter Templates:

Settings

Go to FlexiPost → Settings.

General Tab

Style Tab

AI Post Type Generator

Describe your content in plain English — AI builds a complete post type with fields and taxonomies.

Supported Providers

Setup

REST API Reference

Base URL: /wp-json/itsmfp/v1/

Auth: Include X-WP-Nonce header. User must have manage_options capability.

Post Types

Taxonomies

Fields

Utilities

Developer Reference

Helper Functions

// Get a single field value
$value = itsmfp_get_field( 'isbn_number', $post_id );

// Get repeater rows
$rows = itsmfp_get_repeater( $post_id, 'itsmfp_ingredients' );
foreach ( $rows as $row ) {
    echo esc_html( $row['ingredient_name'] ?? '' );
}

// Render a gallery programmatically
echo itsmfp_cpt_display([
    'module'   => 'portfolio',
    'layout'   => 'grid',
    'columns'  => 3,
    'per_page' => 6,
]);

Hooks & Filters

Constants

Template Override System

Customise any FlexiPost template from your theme — overrides are never lost on plugin update.

How It Works

// Plugin template (DO NOT edit directly)
/wp-content/plugins/flexipost/modules/team-member/templates/grid.php

// Your theme override (edit this)
/wp-content/themes/your-theme/flexipost/team-member/grid.php

FlexiPost checks for a theme override before using its own template. Copy the file → edit the copy → done.

Available Template Variables

$post       // WP_Post object
$fields     // Array of field objects
$atts       // Shortcode attributes array
$post_type  // Post type slug string

// Retrieve field values:
$value = get_post_meta( $post->ID, 'itsmfp_field_key', true );

Troubleshooting

Custom post types not showing on frontend

Fields not saving in the editor

Check these in order:

1. Field slug contains non-ASCII characters → check Field Groups for the warning banner
2. Nonce expired → refresh the page and try again
3. PHP error intercepting the save → check your PHP error log

Shortcode shows nothing

Verify:

1. The module slug matches exactly (case-sensitive)
2. You have published posts of that post type
3. Post type is set to Public
4. Try per_page="100" to rule out pagination hiding results

Admin shows a blank screen

AI Generator not available

Check: valid API key saved in Settings → AI, the key has been verified with the Verify button, and you have FlexiPost Pro active.

Uninstall deleted my data