{"slug":"fluentform-feed-integration","title":"fluentform-feed-integration","summary":"Builds and audits configurable third-party Fluent Forms feed integrations with IntegrationManagerController. Covers addon/global settings, per-form feed UI, field mapping, conditional execution, smart-code parsing, synchronous versus asynchronous dispatch, ff_scheduled_actions, A","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-16T14:51:51.412067Z","repo":{"url":"https://github.com/Lonsdale201/wp-agent-skills","stars":22,"forks":2,"license":"MIT","updatedAt":"2026-09-21T19:53:59Z"},"bodyHtml":"
\n

name: fluentform-feed-integration\ndescription: >-\nBuilds and audits configurable third-party Fluent Forms feed integrations with\nIntegrationManagerController. Covers addon/global settings, per-form feed UI,\nfield mapping, conditional execution, smart-code parsing, synchronous versus\nasynchronous dispatch, ff_scheduled_actions, Action Scheduler, result logging,\ncredential handling, retries, and idempotency. Use when adding a CRM, webhook,\nmessaging, storage, or external API connector; extending\nfluentform/get_available_form_integrations; handling\nfluentform/integration_notify_*; or reviewing an integration that currently\nsends remote requests directly from fluentform/submission_inserted.\nmetadata:\nwp-skills-author: \"Soczó Kristóf\"\nwp-skills-contact: \"mailto:lonsdale201@hotmail.com\"\nwp-skills-plugin: \"fluentform\"\nwp-skills-plugin-version-tested: \"6.2.7\"\nwp-skills-wp-version-tested: \"7.0.2\"\nwp-skills-php-min: \"7.4\"\nwp-skills-last-updated: \"2026-07-20\"

\n

Fluent Forms feed integrations

\n

Use the Free-core feed manager when administrators need credentials, reusable\nper-form feeds, field mapping, conditions, logs, and background delivery. Use a\nplain submission_inserted listener only for small, non-configurable local work.

\n

Read integration-contract.md before\nimplementing the manager class or deciding retry/idempotency behavior.

\n

Availability contract

\n

FluentForm\\App\\Http\\Controllers\\IntegrationManagerController, feed metadata,\nthe notification manager, ff_scheduled_actions, and bundled Action Scheduler\nare Free-core surfaces in 6.2.7. Mailchimp is a Free reference implementation.\nMany shipped connectors under fluentformpro/src/Integrations are Pro-only, but\ntheir existence does not make a third-party integration manager require Pro.

\n

Use the current controller directly. These aliases are deprecated in 6.2.7:

\n\n

Decision point

\n

Use a feed manager when at least one applies:

\n\n

Use a direct hook for bounded local metadata/state changes with no settings UI.\nDo not build a feed abstraction around a single pure calculation.

\n

Registration workflow

\n
    \n
  1. Bootstrap once on fluentform/loaded; require the controller class.
    2. \n
  2. Choose three stable identifiers:\n\n
    3. \n
  3. Extend IntegrationManagerController, call the parent constructor, set the\ndescription/logo/category, then call registerAdminHooks().
    4. \n
  4. Implement global settings and verify credentials server-side before setting\nstatus => true.
    5. \n
  5. Implement integration availability, feed defaults, settings fields, and merge\nfields. Keep enabled and conditionals in the feed schema.
    6. \n
  6. Implement notify($feed, $formData, $entry, $form) as an idempotent operation.
    7. \n
  7. Report every terminal result through fluentform/integration_action_result.
    8. \n
  8. Test disabled, unconfigured, condition-false, sync, async, timeout, retry, and\nduplicate delivery paths.
    9. \n
\n

Bootstrap

\n
use FluentForm\\App\\Http\\Controllers\\IntegrationManagerController;\n\nadd_action('fluentform/loaded', static function ($app): void {\n    if (!class_exists(IntegrationManagerController::class)) {\n        return;\n    }\n\n    new Acme_FluentForm_Integration($app);\n}, 20, 1);\n
\n

The constructor should use stable, namespaced keys:

\n
parent::__construct(\n    $app,\n    __('Acme CRM', 'acme-addon'),\n    'acme_crm',\n    '_acme_ff_crm_settings',\n    'acme_crm_feeds',\n    20\n);\n\n$this->description = __('Send selected entries to Acme CRM.', 'acme-addon');\n$this->category    = 'crm';\n$this->logo        = plugins_url('assets/acme.svg', ACME_ADDON_FILE);\n$this->registerAdminHooks();\n
\n

Do not change these keys after release without migrating the global option and\nall form-meta feed rows.

\n

Notification contract

\n
public function notify($feed, $formData, $entry, $form)\n{\n    $entryId = (int) $entry->id;\n    $values  = isset($feed['processedValues']) && is_array($feed['processedValues'])\n        ? $feed['processedValues']\n        : [];\n\n    try {\n        $result = $this->client()->upsertContact([\n            'external_key' => 'ff-entry-' . $entryId,\n            'email'        => sanitize_email((string) ($values['fieldEmailAddress'] ?? '')),\n        ]);\n\n        if (empty($result['ok'])) {\n            throw new \\RuntimeException('Remote service rejected the request.');\n        }\n\n        do_action(\n            'fluentform/integration_action_result',\n            $feed,\n            'success',\n            __('Delivered to Acme CRM.', 'acme-addon')\n        );\n    } catch (\\Throwable $error) {\n        do_action(\n            'fluentform/integration_action_result',\n            $feed,\n            'failed',\n            __('Acme CRM delivery failed.', 'acme-addon')\n        );\n\n        // Log bounded, redacted diagnostics; never expose credentials or payloads.\n    }\n}\n
\n

processedValues contains the feed settings after Fluent Forms smart-code\nparsing. $formData is the stored response data, and $entry is its parsed entry\nview. Map explicit keys; do not forward the complete arrays by default.

\n

Async and failure semantics

\n

Feeds default to asynchronous delivery. Fluent Forms writes a row to\nff_scheduled_actions, queues fluentform/schedule_feed through Action\nScheduler, marks the row processing, then dispatches\nfluentform/integration_notify_{settingsKey}.

\n
add_filter(\n    'fluentform/notifying_async_acme_crm',\n    static fn($async, $formId) => true,\n    10,\n    2\n);\n
\n

The filter suffix is the integration key, while the notify action suffix is the\nfeed settings key. Do not interchange them.

\n

Do not advertise automatic delivery guarantees that the implementation does not\nprovide. In 6.2.7 the queue increments retry_count and marks processing, but\nthe integration callback must still record a terminal result, and exception or\nprocess-death recovery needs explicit testing. Use a stable remote idempotency key\nderived from the entry/feed, bounded timeouts, and a documented retry policy.

\n

Security and data rules

\n\n

Pro boundary

\n

Custom feed infrastructure is Free. A connector is Pro-dependent only when it\nuses a Pro class, field, payment object, user-registration feed, post feed, or\nother Pro-only capability. Guard that exact dependency with class_exists() or\nmethod_exists() and provide a clear disabled state in the integration UI.

\n

Cross-references

\n\n

References

\n\n","files":[{"path":"agents/openai.yaml","sizeBytes":322,"isText":true},{"path":"references/integration-contract.md","sizeBytes":7537,"isText":true},{"path":"SKILL.md","sizeBytes":9092,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-16T14:55:52.584624Z","sha256":"099D7BAFA238EF3E349017DFABF1A2F759826525F58F2B97D095B6562EF642E8","sizeBytes":7359},"review":null,"source":{"repositoryUrl":"https://github.com/Lonsdale201/wp-agent-skills","path":"fluentform/fluentform-feed-integration","license":"MIT","commit":"8820ff3c301066297e696611e3bc4ebeb47d1851","subtreeSha":"7657476BC175CD7506BF767169494C90B72435372BA28275DB8CCF7F043EC7C1","lastSyncedAt":"2026-09-22T13:51:11.366991Z"},"reviewedAt":"2026-09-16T15:12:08.350823Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Lonsdale201/wp-agent-skills/tree/main/fluentform/fluentform-feed-integration"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install lonsdale201-wp-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/Lonsdale201/wp-agent-skills.git"}]}