Skip to content

DOCS: Document the fluentform/openai_model filter - #23

Open
HrDelwar wants to merge 1 commit into
mainfrom
docs/openai-model-filter
Open

HrDelwar wants to merge 1 commit into
mainfrom
docs/openai-model-filter

Conversation

@HrDelwar

Copy link
Copy Markdown
Collaborator

What does this PR do and why?

Fluent Forms Pro 6.2.17 adds the fluentform/openai_model filter so sites can change the OpenAI model without waiting for a release, and pick a model per form for ChatGPT feeds. This documents it on the Dynamic Fields filters page, next to the other ChatGPT filters.

Refs Lounge task #23570.

Paired free/pro PR: https://github.com/fluentform/fluentformpro/pull/399

Key changes

  • src/hooks/filters/dynamic-fields.md — new fluentform/openai_model entry: what it controls (API verification, Create Using AI, ChatGPT feeds), the gpt-5.6-luna default, the fallback for empty values, what happens with an unsupported model, the $formId parameter (form ID for feeds, null for verification and Create Using AI), a global and a per-form example, and the source location. Page badge 9 → 10.

How to test

Docs-only: run the docs site locally and check that the entry renders on Hooks → Filters → Dynamic Fields.

Merge checklist

  • PHPCS clean (or violations not increased vs base — see gate) — N/A, docs only
  • PHPStan clean at the project's configured level (no new @phpstan-ignore) — N/A, docs only
  • Tests added or updated; coverage not decreased — N/A, docs only
  • No debug code (error_log, var_dump, dd, print_r, console.log in shipped paths)
  • No secrets committed (keys, license keys, customer data)
  • Backward compatibility preserved, or migration documented — N/A, docs only
  • Customer-facing strings i18n'd (if applicable) — N/A
  • Changelog entry added under Unreleased — N/A, the docs site has no changelog for filter entries
  • Dev docs updated in this PR if public hooks/filters/REST/APIs changed
  • Reproduction steps filled in "How to test" + screenshots/recording for UI changes — docs-only

Changes & review routing

  • PHP (backend logic, models, services, hooks)
  • JS/Vue (admin UI, public scripts)
  • Tests
  • Build/config (composer, npm, CI)
  • Docs (READMEs, dev docs, ADRs)
  • ⚠ Security-touching (auth, payments, data handling, file upload)
  • ⚠ Database schema change (tables, columns, indexes, activation migration)
  • ⚠ Public API add/signature change (hook, filter, REST endpoint)
  • ⚠ Architecture decision (link the ADR)
  • ⚠ Cross-product / cross-repo dependency (free ↔ pro)
  • None of the ⚠ categories — peer review is sufficient

Anything the reviewer should know?

Merge after fluentformpro#399 (and #388) so the docs don't describe a filter that isn't released yet. The docs site build wasn't run; the entry follows the existing explain-block format on that page.

Adds the fluentform/openai_model filter (Fluent Forms Pro 6.2.17) to the
Dynamic Fields filters page, next to the other ChatGPT filters (now 10).
It sets the OpenAI model for API verification, AI form building and
ChatGPT feeds; the default is gpt-5.6-luna. Feeds pass the form ID so
each form can use its own model; verification and AI form building pass
null.
@HrDelwar HrDelwar self-assigned this Oct 29, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying fluentform-developers with  Cloudflare Pages  Cloudflare Pages

Latest commit: 479e0f6
Status: ✅  Deploy successful!
Preview URL: https://bab77509.fluentform-developers.pages.dev
Branch Preview URL: https://docs-openai-model-filter.fluentform-developers.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant