PHPackages                             xima-media/xm\_formcycle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. xima-media/xm\_formcycle

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

xima-media/xm\_formcycle
========================

TYPO3 extension to include your formcycle forms

10.0.3(1mo ago)221.3k↓61.6%3[13 issues](https://github.com/xima-media/xm_formcycle/issues)[14 PRs](https://github.com/xima-media/xm_formcycle/pulls)GPL-2.0+PHPPHP ^8.2CI passing

Since Feb 13Pushed 3w ago10 watchersCompare

[ Source](https://github.com/xima-media/xm_formcycle)[ Packagist](https://packagist.org/packages/xima-media/xm_formcycle)[ Docs](https://www.xima.de)[ RSS](/packages/xima-media-xm-formcycle/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (32)Versions (50)Used By (0)

[![Extension icon](Resources/Public/Icons/Extension.svg)](Resources/Public/Icons/Extension.svg)

TYPO3 extension `xm_formcycle`
==============================

[](#typo3-extension-xm_formcycle)

[![Latest version](https://camo.githubusercontent.com/2fd8062b5cb6d5b054ec508b44b38ea4b687bd55b8b7265fee8d5cd9dbb16954/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f76657273696f6e2f736869656c64732e737667)](https://extensions.typo3.org/extension/xm_formcycle)[![Supported TYPO3 versions](https://camo.githubusercontent.com/29ec5192f253fd5ca2d48a60081dda53adb49e9b4bfad81da810838a739201e7/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f7479706f332f736869656c64732e737667)](https://extensions.typo3.org/extension/xm_formcycle)[![Total downloads](https://camo.githubusercontent.com/c1fc3f278c6ae67160806e410203fbcd4c6d868d11a368a4491e01b699597ebd/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f646f776e6c6f6164732f736869656c64732e737667)](https://packagist.org/packages/xima-media/xm_formcycle/stats)[![TYPO3 extension](https://camo.githubusercontent.com/e3a1034c5ba2397d9faf0e4029b86f8ab920fe17f6edab8a7d770f156dbe7082/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f657874656e73696f6e2f736869656c64732e737667)](https://extensions.typo3.org/extension/xm_formcycle)[![Tests](https://github.com/xima-media/xm_formcycle/actions/workflows/tests.yml/badge.svg)](https://github.com/xima-media/xm_formcycle/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/b0249b5a3ccd5af5ddb91c02cb1f853c262e1893d193f32588c9956f222f6325/68747470733a2f2f636f6465636f762e696f2f67682f78696d612d6d656469612f786d5f666f726d6379636c652f67726170682f62616467652e7376673f746f6b656e3d56554d51354555473032)](https://codecov.io/gh/xima-media/xm_formcycle)[![Composer](https://camo.githubusercontent.com/b7bfa4ae6951860181d6b666392a27bc7f7a3e460011b53e844d5c36fda86c88/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f636f6d706f7365722f736869656c64732e737667)](https://packagist.org/packages/xima/xima-typo3-formcycle)

A TYPO3 extension that connects to [formcycle](https://www.formcycle.eu/). Select your created forms and embed them into your TYPO3 site.

Requirements
------------

[](#requirements)

- formcycle version 8 + installed plugin `Formularliste`
- PHP 8.1+

Installation
------------

[](#installation)

### Composer

[](#composer)

```
composer require xima/xima-typo3-formcycle
```

### TER

[](#ter)

[![TER version](https://camo.githubusercontent.com/2fd8062b5cb6d5b054ec508b44b38ea4b687bd55b8b7265fee8d5cd9dbb16954/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f786d5f666f726d6379636c652f76657273696f6e2f736869656c64732e737667)](https://extensions.typo3.org/extension/xm_formcycle)

Download the zip file from [TYPO3 extension repository (TER)](https://extensions.typo3.org/extension/xm_formcycle).

Configuration in TYPO3 v13
--------------------------

[](#configuration-in-typo3-v13)

The configuration of formcycle has been moved to the [Site Sets](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets.html). Just add the Formcycle Site Set to your Site Configuration:

[![Site set](./Documentation/Images/site_set.png)](./Documentation/Images/site_set.png)

After that, you can enter your Formcycle credentials via the Site Settings module:

[![Site settings](./Documentation/Images/site_settings.png)](./Documentation/Images/site_settings.png)

### Form import

[](#form-import)

By default the extension fetches the list of available forms from the formcycle server on every request (cached). Alternatively you can import the forms into the TYPO3 database once and serve them locally — this avoids remote calls during frontend rendering and enables the form list/detail display mode and the link wizard.

**1. Define a storage folder**

Create a sysfolder that will hold the imported form records and set its page id as the `formcycle.storagePid` site setting (Site Settings module, *Formcycle*category). As soon as a storage PID is configured, forms are read from the local database instead of the remote server.

Optionally set `formcycle.detailPid` to the page that contains the form detail plugin, so list entries can link to their detail view.

**2. Run the import**

Import the forms for all configured sites via the CLI command:

```
typo3 formcycle:import-forms
```

The command creates new form records, updates changed ones and removes forms that no longer exist on the formcycle server. Schedule it (e.g. via cron or the scheduler) to keep the local data in sync.

### Route Enhancer

[](#route-enhancer)

The route enhancer provides SEO-friendly URLs for the form detail view (`/{form_id}`). In v14 it is loaded automatically via the site set. In v13 you need to import the route enhancer configuration into your site configuration manually:

```
imports:
    - { resource: 'EXT:xm_formcycle/Configuration/Sets/Formcycle/route-enhancers.yaml' }
```

### Link wizard page restriction

[](#link-wizard-page-restriction)

To restrict the page tree in the link wizard to only show pages with formcycle form records, you can set it in you page TSconfig of your sitepackage:

```
// all configuration options are optional
TCEMAIN.linkHandler.formcycleForm {
    configuration {
        storagePid = 42
        pageTreeMountPoints = 42
        hidePageTree = 1
    }
}

```

Configuration in TYPO3 v11 &amp; v12
------------------------------------

[](#configuration-in-typo3-v11--v12)

After installation, enter your login data via extension configuration and include the TypoScript template for the frontend rendering.

### 1. Extension configuration

[](#1-extension-configuration)

Set your formcycle credentials in the extension configuration via TYPO3 backend or in your `config/system/settings.php`:

```
'EXTENSIONS' => [
    'xm_formcycle' => [
        'formcycleUrl' => 'https://pro.formcloud.de/formcycle/',
        'formcycleClientId' => '4231',
    ],
]
```

### 2. TypoScript include

[](#2-typoscript-include)

Include the static TypoScript template "formcycle" or directly import it in your sitepackage:

```
@import 'EXT:xm_formcycle/Configuration/TypoScript/setup.typoscript'

```

Developer
---------

[](#developer)

If you want to modify the [fluid template](Resources/Private/Templates/Formcycle.html), add template paths via TypoScript constants:

```
plugin.tx_xmformcycle {
    view {
        templateRootPath = EXT:your_ext/Resources/Private/Templates
        partialRootPath = EXT:your_ext/Resources/Private/Partials
        layoutRootPath = EXT:your_ext/Resources/Private/Layouts
    }
}

```

Copy and modify the `Formcycle.html` to the Templates directory.

Migration from version 9 to 10
------------------------------

[](#migration-from-version-9-to-10)

If you are upgrading from version 9 to 10 (TYPO3 v12 to v13), you need to perform the following steps:

### 1. Migrate Extension configuration

[](#1-migrate-extension-configuration)

The extension configuration of the formcycle URL and formcycle client ID have been moved to the TYPO3 system settings. You need to manually migrate the settings from `$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['xm_formcycle']` to the `config/settings//settings.yaml`.

### 2. Run Upgrade wizard

[](#2-run-upgrade-wizard)

In version 10 of this extension, the flexform settings have been moved to regular TCA fields. To migrate your existing content elements, run the Upgrade Wizard in the TYPO3 backend or via CLI:

```
typo3 upgrade:run xmFormcycle_flexformMigrationddev
```

License
-------

[](#license)

This project is licensed under [GNU General Public License 2.0 (or later)](LICENSE.md).

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance73

Regular maintenance activity

Popularity31

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity89

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 72.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Recently: every ~90 days

Total

29

Last Release

53d ago

Major Versions

v8.0.1 → 9.0.02024-03-11

9.1.3 → 10.0.02024-12-16

9.1.4 → 10.0.12025-05-15

10.0.2 → v12.x-dev2025-05-23

9.1.5 → 10.0.32026-05-11

PHP version history (2 changes)9.0.0PHP ^8.1

10.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/847890ddab205b4421b159071ae9c72f113f3f7786e2393c6403406fc52dc5f5?d=identicon)[ximamedia](/maintainers/ximamedia)

---

Top Contributors

[![maikschneider](https://avatars.githubusercontent.com/u/696865?v=4)](https://github.com/maikschneider "maikschneider (166 commits)")[![FireLizard](https://avatars.githubusercontent.com/u/7585164?v=4)](https://github.com/FireLizard "FireLizard (48 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (7 commits)")[![JulianXIMA](https://avatars.githubusercontent.com/u/85174321?v=4)](https://github.com/JulianXIMA "JulianXIMA (4 commits)")[![abaXIMA](https://avatars.githubusercontent.com/u/98809474?v=4)](https://github.com/abaXIMA "abaXIMA (3 commits)")[![rvock](https://avatars.githubusercontent.com/u/209159?v=4)](https://github.com/rvock "rvock (1 commits)")[![woemar](https://avatars.githubusercontent.com/u/42969992?v=4)](https://github.com/woemar "woemar (1 commits)")

---

Tags

formcycletypo3typo3-cms-extensionTYPO3 CMSXimaFormCycle

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/xima-media-xm-formcycle/health.svg)

```
[![Health](https://phpackages.com/badges/xima-media-xm-formcycle/health.svg)](https://phpackages.com/packages/xima-media-xm-formcycle)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[derhansen/sf_event_mgt

Event management and registration - Configurable event management and registration extension based on ExtBase and Fluid

66338.4k10](/packages/derhansen-sf-event-mgt)[brotkrueml/schema

Embedding schema.org vocabulary - API and view helpers for schema.org markup

34653.7k16](/packages/brotkrueml-schema)[yoast-seo-for-typo3/yoast_seo

Yoast SEO for TYPO3

511.7M9](/packages/yoast-seo-for-typo3-yoast-seo)[jweiland/events2

Events 2 - Create single and recurring events

2166.7k3](/packages/jweiland-events2)[t3sbs/t3sbootstrap

Startup extension to use bootstrap 5 classes, components and more out of the box. Example and info: \[www.t3sbootstrap.de\](https://www.t3sbootstrap.de)

2416.4k](/packages/t3sbs-t3sbootstrap)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
