=== Cptify – Custom Post Type, Fields & Layout Builder ===
Contributors: readscope
Tags: custom post type, custom fields, cpt builder, layout builder, field builder
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
No-code WordPress builder for Post Types, Taxonomies, Custom Fields, and Layouts — without writing a single line of code.
 
== Description ==
 
**Cptify** is no-code content builder for WordPress. Instead of juggling 10 different plugins for Team Members, Portfolio, Testimonials, Events, FAQs, and more — Cptify gives you everything in one clean, powerful interface.
 
Whether you are a developer, designer, or a complete beginner, Cptify empowers you to build any type of structured content with a beautiful drag-and-drop admin — no PHP, no custom database work, no frustration.
 
📚 **[Documentation](https://wordpress.org/plugins/cptify/)**
 
---
 
= Why Choose Cptify for Your WordPress Site? =
 
Most WordPress sites need the same types of content — Team Members, Portfolio, Testimonials, Events. Before Cptify, you had to:
 
❌ Install separate plugins for each content type
❌ Learn multiple different interfaces
❌ Deal with plugin conflicts and bloated databases
❌ Pay for multiple premium plugins just to get basic functionality
 
**With Cptify, you get everything in one place:**
 
✅ One plugin for all your custom content needs
✅ Consistent, beautiful drag-and-drop interface
✅ Zero coding required — fully visual
✅ Export & import configurations across sites
✅ Lightweight — only loads assets where needed
✅ Developer-friendly with hooks, filters, and REST API
 
---
 
= What Makes Cptify Stand Out? =
 
Cptify is not just another CPT plugin. It combines four powerful tools — a Post Type Manager, Taxonomy Manager, Custom Field Builder, and Layout Builder — into a single, cohesive workflow. You design your content structure and its display in one place, without ever leaving your WordPress dashboard.
 
Here is what sets it apart:
 
**One-Click Module Library:** Install complete content systems (Team, Portfolio, Testimonials, Events) in seconds — post type, fields, and layout all at once.
 
**15+ Field Types:** From simple Text and Image fields to advanced Repeaters, Relation fields, and Conditional Logic — Cptify covers every use case.
 
**Visual Layout Builder:** Design how your content looks on the frontend by dragging layout blocks — no template files to edit.

**Smart Default Templates:** Every custom post type automatically gets a clean, responsive single post layout — hero image, structured sidebar, and masonry gallery — without any configuration.

**Gutenberg Ready:** Native block support means you can drop your content anywhere in the editor. Elementor support is available in Cptify Pro.
 
**Import / Export:** Move your entire content configuration between WordPress sites with a single JSON file.

---
 
= Who is Cptify Most Useful For? =
 
Cptify is incredibly versatile and useful for a wide range of WordPress users:
 
**Freelancers & Agencies:** Build custom content structures for clients in minutes, not hours. Reuse configurations across projects with Import/Export.
 
**Business Owners:** Add Team Members, Services, Testimonials, and FAQs to your site without hiring a developer.
 
**Bloggers & Content Creators:** Organize your content into structured types — Book Reviews, Recipes, Tutorials — with custom fields for every detail.
 
**Educators & Course Creators:** Build a structured course catalog, instructor directory, or resource library without a dedicated LMS.
 
**Real Estate & Directory Sites:** Create custom listings with Price, Location, Amenities, and filterable archives — all without code.
 
**Portfolio & Agency Sites:** Showcase projects with custom fields for Client, Category, Tools Used, and beautiful grid or masonry layouts.
 
**Event Organizers:** Display upcoming events with Date, Venue, Ticket Links, and a structured archive — easily.
 
**Developers:** Use Cptify as a rapid prototyping tool. Leverage REST API, template overrides, and developer hooks to extend functionality your way.
 
---
 
= 🧱 Post Type Manager =
 
Create unlimited custom post types in seconds from a beautiful admin UI. No `register_post_type()` needed.
 
* Set the post type name, slug, description, and menu icon (Dashicon or custom image)
* Configure supported features: Title, Editor, Thumbnail, Excerpt, Author, Revisions, and more
* Toggle public visibility, archive pages, and REST API support
* Drag and drop to reorder post types in the admin menu
* Duplicate existing post types with one click
* Assign taxonomies directly from the post type screen
 
---
 
= 🏷️ Taxonomy Manager =
 
Build custom categories and tags for any post type — no code required.
 
* Create hierarchical (category-style) or flat (tag-style) taxonomies
* Assign taxonomies to multiple post types at once with toggle switches
* Set custom slugs, singular and plural labels, and URL rewrite slugs
* Toggle public visibility and REST API support per taxonomy
* Quick-edit taxonomy labels directly from the list screen
 
---
 
= 🔧 Custom Field Builder =
 
Create powerful custom fields and assign them to any post type. Cptify supports **15+ field types** out of the box:
 
**Basic Fields**
* Text — Single-line text input
* Textarea — Multi-line text input
* Number — Numeric input with min, max, and step controls
* Email — Email address input with built-in validation
* URL — Website address input
* Phone — Telephone number input
* Password — Secure password input
 
**Choice Fields**
* Select — Dropdown with custom options
* Checkbox — Multiple choice with custom options
* Radio — Single choice with custom options
* Button Group — Stylish button-based option selector
 
**Content Fields**
* WYSIWYG — Full WordPress rich text editor
* oEmbed — Embed any oEmbed-supported content
* Code — Code block input
 
**Date & Time Fields**
* Date — Date picker
* Date & Time — Combined date and time picker
* Time — Time picker
 
**Media Fields**
* Image — Single image with WordPress Media Library
* File — File attachment with Media Library
* Gallery — Multiple image gallery picker
 
**Layout & Advanced Fields**
* Color — Color picker with hex input
* Range — Slider input with min, max, and step
* Link — URL + link text pair
* Repeater — Repeat any group of sub-fields
* Group — Organise related fields together
 
**Relational Fields**
* Post Object — Select any WordPress post
* Taxonomy — Select taxonomy terms
* User — Select WordPress users
* Relationship — Bi-directional post relationship
* Relation — Searchable related post selector
 
**Field Group Features:**
* Drag and drop to reorder fields
* Conditional logic — show or hide fields based on other field values
* Assign field groups to multiple post types
* Set fields as required
* Add placeholder text and descriptions
* Duplicate field groups across post types
* Direct Fields — add fields instantly from the Post Type screen
 
---
 
= 🎨 Layout Builder =
 
Design beautiful archive and single post layouts without touching any template files.
 
* Drag and drop layout blocks: Post Title, Featured Image, Post Content, Excerpt, Post Meta, Custom Field, Custom HTML, and Columns
* Choose from Grid, List, Masonry, or Slider display styles
* Control columns, spacing, and per-page count
* Set ordering (Date, ID, Random) and direction (ASC / DESC)
* Build single post layouts separately from archive layouts
* Template tag system — insert `{{title}}`, `{{meta.field_key}}`, `{{taxonomy.slug}}` into HTML blocks
* Shortcode Generator — build and copy your shortcode with a visual configurator
 
---
 
= 📦 Module Library =
 
Install complete, ready-made content modules with a single click. Each module installs the post type, taxonomies, custom fields, and a default layout — all at once.
 
**Included Modules:**
 
* 👥 **Team Member** — Showcase your team with Photo, Position, Bio, and Social Links. Perfect for About pages and company profiles.
* 🖼️ **Portfolio** — Display projects with Category filter, Client, Tools Used, and a filterable grid layout.
* 💬 **Testimonials** — Beautiful testimonial grids and sliders with Star Rating, Author Name, and Company fields.
* 🔄 **Logo Slider** — Smooth auto-scrolling client, partner, or sponsor logo display.
* 📅 **Events** — Upcoming and past events with Date, Venue, Ticket Link, and organized archive.
* ❓ **FAQ** — Accordion-style frequently asked questions with Category support.
* 📚 **Book Showcase** — Book library with Author, Genre, Publisher, ISBN, and Star Rating fields.
* 🛎️ **Services** — Services grid with Icon, Description, and Price fields.
* 📰 **News** — Structured news archive with Source, Author, and Category fields.
* 🏢 **Business Directory** — Local business listings with Address, Phone, Hours, and Map fields.
* 🎓 **Course** — Online course catalog with Instructor, Duration, Level, and Curriculum fields.
* 💼 **Job Listing** — Job board with Location, Salary, Type, and Application Deadline fields.
* 🍽️ **Recipe** — Recipe cards with Ingredients, Cook Time, Servings, and Cuisine type.
* 🏠 **Property** — Real estate listings with Bedrooms, Bathrooms, Price, and Location fields.
 
---
 
= ⚡ Shortcodes & Blocks =
 
Display any custom post type anywhere on your site with a simple shortcode or Gutenberg block.
 
**Shortcode (by post type slug):**

`[itsmfp_display type="team-member" layout="grid" columns="3"]`

**Shortcode (by module name):**

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

Both `type` and `module` attributes are supported. `type` accepts the post type slug, `module` accepts the module name.

**Shortcode PHP Usage:**

`<?php echo do_shortcode('[itsmfp_display module="team-member" layout="grid" columns="3"]'); ?>`
 
**Available shortcode parameters:**
 
* `module` — The post type slug to display
* `layout` — Display style: `grid`, `list`, `masonry`, or `slider`
* `columns` — Number of columns (1–6)
* `per_page` — Number of posts to show
* `orderby` — Sort by: `date`, `title`, `menu_order`, or `rand`
* `order` — `ASC` or `DESC`
 
**Gutenberg Block:** Search for "CPT Display" in the block inserter and configure your gallery visually.
 
---

= 🔌 Integrations =

* **Gutenberg** — Native block with live preview in the editor
* **Elementor** — Widget available in Cptify Pro
* **Theme Template Override** — Copy templates to your theme folder for full control
* **REST API** — All post types and field data available via `/wp-json/itsmfp/v1/`
* **WordPress Media Library** — Seamless image and file field integration
 
---
 
= 💻 Developer Friendly =
 
Cptify is built with developers in mind:
 
* All functions use the `itsmfp_` prefix — no global namespace pollution
* Helper functions: `itsmfp_get_field()`, `itsmfp_get_repeater()`, `itsmfp_cpt_display()`
* Full REST API: `/wp-json/itsmfp/v1/post-types`, `/taxonomies`, `/field-groups`, `/fields`, `/templates`
* Template override system — copy any template to your theme and customise freely
* Action and filter hooks throughout the codebase
* Well-structured OOP codebase with namespaced classes (`ITSMFP\`)
* Import/Export via JSON for easy deployment across environments
 
---
 
= ⚙️ Settings Overview =
 
**General Settings**
* Plugin prefix for database tables
* Delete data on uninstall (off by default — your data is safe)
* Debug mode

**Style Settings**
* Load CSS globally or only on pages with Cptify content
* Lazy loading for images
* Ajax pagination
* Default thumbnail size
* Default columns, posts per page, and sort order
 
**Import / Export**
* Export all post types, taxonomies, fields, and layout configurations as a JSON file
* Import configurations from another Cptify installation
* Starter templates — one-click apply pre-built configurations (Portfolio, Books, Team, Testimonials)
 
---
 
== Installation ==
 
**Automatic Installation (Recommended)**
 
1. Go to **Plugins → Add New** in your WordPress dashboard
2. Search for **Cptify**
3. Click **Install Now**, then **Activate**
4. Go to **Cptify** in your admin sidebar to get started
 
**Manual Installation**
 
1. Download the plugin zip file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip file and click **Install Now**
4. Activate the plugin through the **Plugins** menu
 
**Getting Started**
 
1. Go to **Cptify → Module Library** and install a ready-made module with one click, OR
2. Go to **Cptify → Post Types → Add New** to create a custom post type from scratch
3. Add custom fields via **Cptify → Field Groups** or from the Post Type's Meta Fields tab
4. Design your layout via **Cptify → Templates**
5. Display your content anywhere using the shortcode `[itsmfp_display module="your-post-type"]`
 
---
 
== Frequently Asked Questions ==
 
= Does Cptify replace ACF (Advanced Custom Fields)? =
Cptify covers the most common use cases for custom fields and is simpler for non-developers to use. It combines fields with post type registration and layout display in one tool. If you need very advanced or highly specialised field configurations, ACF remains a great choice. Cptify is also designed to coexist peacefully alongside other plugins.
 
= Will my content be lost if I deactivate Cptify? =
No. Your post content and meta data stored in the WordPress database remains intact when the plugin is deactivated. However, your custom post types will no longer be registered, so you will not be able to access them from the admin until the plugin is reactivated. Re-activating the plugin immediately restores access to all your content.
 
= Will my data be deleted if I uninstall the plugin? =
No — not by default. Cptify only deletes its data on uninstall if you explicitly enable the "Delete data on uninstall" option in **Cptify → Settings → General**. By default, all your data is preserved.
 
= Can I use Cptify with Elementor? =
Cptify includes a native Gutenberg block. Elementor support is available in Cptify Pro.
 
= Can I use Cptify with Gutenberg (Block Editor)? =
Yes! Cptify includes a native Gutenberg block. Search for "CPT Display" in the block inserter, select your post type and layout, and your content renders live in the editor.
 
= Can I export my configuration and import it to another site? =
Yes. Go to **Cptify → Settings → Export** to download a JSON file containing all your post types, taxonomies, field groups, fields, and templates. Import it on any other WordPress site running Cptify — perfect for agencies managing multiple client sites.
 
= Can I override Cptify templates from my theme? =
Yes! Copy any template file from `/wp-content/plugins/cptify/templates/` to `/wp-content/themes/your-theme/cptify/` and customise it freely. Cptify will automatically use your theme's version.
 
= Does Cptify slow down my website? =
No. Cptify only loads its CSS and JavaScript assets on pages where a shortcode or block is present. On all other pages, there is zero frontend overhead.
 
= How many post types and fields can I create? =
There is no hard limit. You can create as many post types, taxonomies, field groups, and fields as your WordPress installation can handle.
 
= Does Cptify work with my theme? =
Yes. Cptify outputs standard WordPress HTML and uses the template override system, so it works with any properly coded WordPress theme.
 
= Is REST API support included? =
Yes. All Cptify post types are accessible via the WordPress REST API at `/wp-json/itsmfp/v1/`. This makes Cptify suitable for headless WordPress setups.
 
= Is Cptify translation-ready? =
Yes. Cptify is fully internationalised and ready for translation. All strings use the `cptify` text domain.
 
---
 
== Screenshots ==
 
1. **Module Library** — One-click install of ready-made content modules (Team, Portfolio, Events, FAQ, and more)
2. **Post Type Manager** — Create and manage unlimited custom post types with icon picker and drag-to-reorder
3. **Custom Field Builder** — Drag & drop field creation with 15+ field types and conditional logic
4. **Layout Builder** — Design archive and single post layouts visually with drag-and-drop blocks
5. **Gutenberg Block** — Drag and drop the CPT Display block in the block editor with live preview
 
---
 
== External Services ==

This plugin does not connect to any external services.
All features work locally on your WordPress server.

== Changelog ==
 
= 1.0.0 =
* Initial release
* Post Type Manager — create unlimited custom post types with full WordPress feature support
* Taxonomy Manager — create hierarchical and flat taxonomies and assign to multiple post types
* Custom Field Builder — 15+ field types with drag-and-drop reordering and conditional logic
* Layout Builder — visual archive and single post layout designer with drag-and-drop blocks
* Module Library — 14 one-click ready-made content modules (Team Member, Portfolio, Testimonials, Logo Slider, Events, FAQ, Book Showcase, Services, News, Business Directory, Course, Job Listing, Recipe, Property)
* Shortcode system with configurable parameters (layout, columns, per_page, orderby, order)
* Shortcode Generator — visual shortcode builder in the Layout Builder
* Gutenberg Block — native CPT Display block with live preview
* Import / Export — full configuration JSON export and import
* Starter Templates — one-click apply pre-built configurations
* REST API — full CRUD endpoints for all post types, taxonomies, field groups, fields, and templates
* Template override system — customise templates from your theme folder
* Developer helper functions: `itsmfp_get_field()`, `itsmfp_get_repeater()`, `itsmfp_cpt_display()`
* Full internationalisation with `cptify` text domain
* Prefix audit — all functions, options, and hooks use the `itsmfp_` prefix
 
---
 
== Credits ==
 
Cptify's admin interface is powered by the following open-source libraries (all GPL-compatible):
 
* **React** — MIT — https://react.dev/
* **Vite** — MIT — https://vitejs.dev/
* **@dnd-kit** — MIT — https://dndkit.com
* **Framer Motion** — MIT — https://www.framer.com/motion/
* **canvas-confetti** — ISC — https://github.com/catdad/canvas-confetti
* **Axios** — MIT — https://axios-http.com/
* **Lucide Icons** — ISC — https://lucide.dev/
* **React Router** — MIT — https://reactrouter.com/
* **Zustand** — MIT — https://github.com/pmndrs/zustand
* **React Select** — MIT — https://react-select.com/
* **React Hot Toast** — MIT — https://react-hot-toast.com/

== Development Source ==

Unminified source code available at: https://gitlab.com/thereadscope/cptify