PHPackages                             hamaka/userforms-cleanupsubmissions - 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. hamaka/userforms-cleanupsubmissions

ActiveSilverstripe-vendormodule

hamaka/userforms-cleanupsubmissions
===================================

Cleanup user submitted data in Silverstripe Userforms

v5.1.5(6mo ago)44.0k1BSD-3-ClausePHPPHP ^8.1

Since Sep 19Pushed 6mo ago3 watchersCompare

[ Source](https://github.com/hamaka/userforms-cleanupsubmissions)[ Packagist](https://packagist.org/packages/hamaka/userforms-cleanupsubmissions)[ Docs](https://github.com/hamaka/userforms-cleanupsubmissions)[ RSS](/packages/hamaka-userforms-cleanupsubmissions/feed)WikiDiscussions 5 Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (20)Used By (0)

Silverstripe UserForms: clean up form submissions
=================================================

[](#silverstripe-userforms-clean-up-form-submissions)

Simple task to automatically cleanup userdata

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

[](#installation)

To install run `composer require hamaka/userforms-cleanupsubmissions`.

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

[](#requirements)

- Silverstripe ^5.0
- UserForms ^6

**Note:** For Silverstripe 3, please use the [3.x release line](https://github.com/hamaka/userforms-cleanupsubmissions/tree/3), for Silverstripe 4, please use the [4.x release line](https://github.com/hamaka/userforms-cleanupsubmissions/tree/4).

Features
--------

[](#features)

- **Per-form retention policies**: Set individual retention periods for each UserDefinedForm
- **Elemental support**: Configure retention policies for both UserDefinedForm and Elemental UserForm elements
- **Flexible retention options**: Choose from predefined periods (1 day to 6 months) or set to "Never delete"
- **i18n support**: Built-in translations for English and Dutch
- **Configurable options**: Override retention options per project

Configuration
-------------

[](#configuration)

### Global retention period (fallback)

[](#global-retention-period-fallback)

By default, the module will clean up entries older than 31 days. You can change this fallback via yml:

```
Hamaka\Tasks\UserFormsCleanupOldEntriesTask:
  days_retention: 90
```

This is used as a fallback for submissions that have no associated form retention policy.

### Per-form retention policies (recommended)

[](#per-form-retention-policies-recommended)

Since version 5.1, you can set individual retention policies per form. This is the recommended approach.

#### For UserDefinedForm

[](#for-userdefinedform)

Edit any UserDefinedForm in the CMS and navigate to the **Settings** tab. You'll find a **Submission Retention Policy** dropdown where you can select:

- 1 day
- 2 days
- 1 week
- 2 weeks
- 1 month
- 2 months
- 6 months
- Never delete (default)

#### For Elemental UserForm elements

[](#for-elemental-userform-elements)

The same retention policy field is available when editing Elemental UserForm elements.

### Customizing retention options

[](#customizing-retention-options)

You can customize the available retention options in your project's `_config.yml`:

```
Hamaka\UserForms\Model\UserFormRetentionExtension:
  # Override this in your project's _config.yml to customize
  retention_options:
    1: '1 day'
    2: '2 days'
    7: '1 week'
    14: '2 weeks'
    31: '1 month'
    62: '2 months'
    182: '6 months'
    -1: 'Never delete'
```

Running the cleanup task
------------------------

[](#running-the-cleanup-task)

The cleanup task can be run manually via the command line:

```
sake dev/tasks/userforms-cleanup

```

Or you can set it up to run automatically via a cron job:

```
*/1 * * * * cd /path/to/project && sake dev/tasks/userforms-cleanup
```

Translations
------------

[](#translations)

The module includes built-in translations for:

- English (en)
- Dutch (nl)

To add additional translations, create language files in your project and override the translation keys.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance66

Regular maintenance activity

Popularity26

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% 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 ~63 days

Recently: every ~0 days

Total

19

Last Release

197d ago

Major Versions

v1.0.0 → v2.0.12022-09-19

v2.0.2 → 3.x-dev2022-09-19

v1.0.2 → v2.12022-12-02

v2.1 → 4.x-dev2022-12-02

4.x-dev → v5.02023-05-10

PHP version history (2 changes)v0.1.1PHP >=7.1

v5.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/49ddb5d6d831cd9da798b71aa782907ea160b2424c61af2cceb64a42b5d6d927?d=identicon)[sandervanscheepen](/maintainers/sandervanscheepen)

![](https://www.gravatar.com/avatar/2e123ed9e1c2129227143b133e170c540509c89a27bd560d0eb2ba3445e446cf?d=identicon)[baukezwaan](/maintainers/baukezwaan)

---

Top Contributors

[![baukezwaan](https://avatars.githubusercontent.com/u/795238?v=4)](https://github.com/baukezwaan "baukezwaan (12 commits)")[![lerni](https://avatars.githubusercontent.com/u/472115?v=4)](https://github.com/lerni "lerni (1 commits)")

---

Tags

silverstripeuserformsgdprprivacy

### Embed Badge

![Health badge](/badges/hamaka-userforms-cleanupsubmissions/health.svg)

```
[![Health](https://phpackages.com/badges/hamaka-userforms-cleanupsubmissions/health.svg)](https://phpackages.com/packages/hamaka-userforms-cleanupsubmissions)
```

PHPackages © 2026

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