PHPackages                             fern/form - 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 & Helpers](/categories/utility)
4. /
5. fern/form

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

fern/form
=========

A minimal form storage plugin for wordpress

2.0.2(5mo ago)138MITPHP

Since Oct 27Pushed 5mo agoCompare

[ Source](https://github.com/Olympe-Studio/fern-form)[ Packagist](https://packagist.org/packages/fern/form)[ Docs](https://github.com/Olympe-Studio/fern-form)[ RSS](/packages/fern-form/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (1)Versions (12)Used By (0)

=== Fern Form === Contributors: olympe-studio Tags: forms, form-submissions, developers Requires at least: 6.0 Tested up to: 6.6.2 Requires PHP: 8.0 Stable tag: 1.1.0 License: GPLv2 License URI: Description: A minimal form storage plugin for developers

Fern Form
=========

[](#fern-form)

A lightweight WordPress plugin for handling form submissions for developers. This plugin is made to work with the **Fern framework (WIP).**

Features
--------

[](#features)

- **Data Retention**: Configurable retention period for form submissions to prevent database bloat
- **Notification System**: Visual notifications for unread form submissions
- **Developer Friendly**: Extensive hooks and filters for customization
- **Zero table creation**: This plugin use the native WordPress post type & terms to store the form submissions.

**Be aware that this plugin use the post table to store the form submissions.**

Submissions are cleaned up by a daily wordpress cron job. If you disable the WP\_CRON, the form submissions will not be deleted which could increase the post table size.

Default cleanup is set to 7 day after creation date.

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

[](#requirements)

- WordPress 6.0 or higher
- PHP 8.0 or higher

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

[](#installation)

1. Download the plugin from the GitHub releases.
2. Upload the plugin folder to the `/wp-content/plugins/` directory.
3. Activate the plugin through the 'Plugins' menu in WordPress.

Or, use composer, first edit the `composer.json` file to add the plugin install path :

```
{
  ...
  "extra": {
    "installer-paths": {
      "public/content/plugins/fern-form/": [
        "fern/form"
      ],
    }
  }
```

Then, run the following command:

```
composer require fern/form
```

Then, the plugin will be installed in the `public/content/plugins/fern-form` directory.

Basic Usage
-----------

[](#basic-usage)

Basic Form Submission

```
// needs to be called after init hook
fern_form_store('contact_form', [
  'name' => 'John Doe',
  'email' => 'john@doe.com',
  'message' => 'Hello, world!'
]);

// or using the class
use Fern\Form\Includes\FormSubmission;

$formSubmission = new FormSubmission('contact_form', [
  'name' => 'John Doe',
  'email' => 'john@doe.com',
  'message' => 'Hello, world!'
]);

$entryId = $formSubmission->store();
```

Then, the form data will be stored in the database and visible in the admin dashboard.

Updating a submission

```
$submissionId = 123;

// needs to be called after init hook
fern_form_update($submissionId, [
  'name' => 'John Doe',
  'email' => 'john@doe.com',
  'message' => 'Hello, world! (again)'
]);
```

Deleting a submission

```
$submissionId = 123;
// needs to be called after init hook
fern_form_delete($submissionId);
```

Getting a submission

```
$submissionId = 123;
$submission = fern_form_get_submission_by_id($submissionId);

if (is_null($submission)) {
  return;
}

// do something with the submission
```

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

[](#configuration)

You can configure the plugin by hooking into the `fern:form:config` filter.

```
add_filter('fern:form:config', function(array $config): array {
  return [
    // After 30 days, submissions will be deleted
    'retention_days' => 30,
    // Set the capabilities for the form post type
    'form_capabilities' => [
      'create' => 'edit_posts',
      'read' => 'read',
      'delete' => 'delete_posts'
    ]
  ];
});

// Disable default admin styles
define('FERN_FORM_ASSETS', false);
```

\## Hooks references

You can extend the plugin functionality by hooking into the following actions and filters.

### Actions

[](#actions)

`fern:form:submission_stored`

Triggered after successful submission storage

```
/**
 * @param int    $post_id     The ID of the newly created submission post
 * @param string $form_name   The sanitized form name/slug
 * @param array  $submission  The complete submission data array
 */
add_action('fern:form:submission_stored', function($post_id, $form_name, $submission) {
  // Example: Send email notification
  wp_mail(
    'admin@example.com',
    "New submission from {$form_name}",
    "Submission ID: {$post_id}"
  );
}, 10, 3);
```

`fern:form:submission_error`

Triggered on submission error

```
/**
 * @param WP_Error $error       The WordPress error object
 * @param string   $form_name   The sanitized form name/slug
 * @param array    $submission  The submission data that failed to store
 */
add_action('fern:form:submission_error', function($error, $form_name, $submission) {
  // Example: Log the error
  error_log("Form submission failed for {$form_name}: " . $error->get_error_message());
}, 10, 3);
```

`fern:form:before_delete`

Triggered before deleting a submission

```
/**
 * @param int    $id         The submission post ID
 * @param string $form_name  The form name/slug
 */
add_action('fern:form:before_delete', function($id, $form_name) {
  // Custom logic before deletion
});
```

`fern:form:after_delete`

Triggered after successful deletion

```
/**
 * @param int    $id         The deleted submission ID
 * @param string $form_name  The form name/slug
 */
add_action('fern:form:after_delete', function($id, $form_name) {
  // Post-deletion processing
});
```

`fern:form:update_submission_error`

Triggered on update submission error

```
/**
 * @param int    $id         The submission ID
 * @param string $form_name  The form name/slug
 * @param array  $submission The submission data
 */
add_action('fern:form:update_submission_error', function($id, $form_name, $submission) {
  error_log("Update failed for submission {$id}");
});
```

`fern:form:submission_updated`

Triggered after successful update

```
/**
 * @param int    $id         The submission ID
 * @param string $form_name  The form name/slug
 * @param array  $submission The updated data
 */
add_action('fern:form:submission_updated', function($id, $form_name, $submission) {
  // Post-update processing
});
```

### Filters

[](#filters)

`fern:form:config`

Modify plugin configuration

```
/**
 * @param array $config Default configuration array
 * @return array Modified configuration
 */
add_filter('fern:form:config', function($config) {
  $config['retention_days'] = 60;
  $config['form_capabilities'] = [
    'create' => 'custom_cap',
    'read' => 'read_forms',
    'delete' => 'delete_forms'
  ];
  return $config;
});
```

`fern:form:submission_should_abort`

Allow aborting the submission

```
/**
 * @param bool $shouldAbort
 * @param string $formName
 * @param array $submission
 * @return bool
 */
add_filter('fern:form:submission_should_abort', function($shouldAbort, $formName, $submission) {
  $shouldAbort = ReCaptchaV3::validate($submission['recaptcha_token']);
  return $shouldAbort;
});
```

`fern:form:submission_data`

Modify submission data before storage

```
/**
 * @param array $submission The submission data array
 * @return array Modified submission data
 */
add_filter('fern:form:submission_data', function($submission) {
  // Example: Add timestamp
  $submission['submitted_at'] = current_time('mysql');
  return $submission;
});
```

`fern:form:submission_title`

Customize submission title format (in admin list view)

```
/**
 * @param string $default_title Default title format
 * @param string $form_name     The form name/slug
 * @param array  $submission    The complete submission data
 * @return string Modified title
 */
add_filter('fern:form:submission_title', function($default_title, $form_name, $submission) {
  if (!empty($submission['email'])) {
    return $submission['email'];
  }

  return $default_title;
}, 10, 3);
```

`fern:form:update_submission_should_abort`

Allow aborting the update submission

```
/**
 * @param bool   $should_abort Whether to abort
 * @param string $form_name    The form name/slug
 * @param array  $submission   The submission data
 * @return bool
 */
add_filter('fern:form:update_submission_should_abort', function($should_abort, $form_name, $submission) {
  return $should_abort || !current_user_can('edit_posts');
});
```

`fern:form:update_submission_data`

Modify submission data before update

```
/**
 * @param array $submission The submission data
 * @return array Modified data
 */
add_filter('fern:form:update_submission_data', function($submission) {
  $submission['updated_at'] = current_time('mysql');
  return $submission;
});
```

`fern:form:update_submission_title`

Customize submission title format (in admin list view)

```
/**
 * @param string $current_title Current post title
 * @param string $form_name     The form name/slug
 * @param array  $submission    The submission data
 * @return string New title
 */
add_filter('fern:form:update_submission_title', function($current_title, $form_name, $submission) {
  return $current_title . ' (Updated)';
});
```

`fern:form:delete_submission_should_abort`

Allow aborting the delete submission

```
/**
 * @param bool   $should_abort Whether to abort
 * @param string $form_name    The form name/slug
 * @param array  $submission   The submission data
 * @return bool
 */
add_filter('fern:form:delete_submission_should_abort', function($should_abort, $form_name, $submission) {
  return $should_abort || !current_user_can('delete_posts');
});
```

`fern:form:submission_item_key`

Filter the display key of a submission item.

```
/**
 * @param string $display_key The formatted key to display
 * @param string $full_key    The original full key path
 * @return string
 */
add_filter('fern:form:submission_item_key', function($display_key, $full_key) {
  // Example: Translate specific keys
  if ($full_key === 'user_email') {
    return __('Email Address', 'text-domain');
  }
  return $display_key;
}, 10, 2);
```

`fern:form:submission_item_value`

Filter the display value of a submission item.

```
/**
 * @param string $value       The value to display
 * @param string $display_key The formatted key
 * @param string $full_key    The original full key path
 * @return string
 */
add_filter('fern:form:submission_item_value', function($value, $display_key, $full_key) {
  // Example: Mask sensitive data
  if (strpos($full_key, 'password') !== false) {
    return '********';
  }
  return $value;
}, 10, 3);
```

\## Uninstall

The plugin will automatically remove all data when uninstalled if the `FERN_CLEAR_ON_DEACTIVATE` constant is set to `true`.

```
define('FERN_CLEAR_ON_DEACTIVATE', true);
```

Otherwise, data will be preserved.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance70

Regular maintenance activity

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~55 days

Recently: every ~48 days

Total

8

Last Release

178d ago

Major Versions

1.2.2 → 2.0.02025-11-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/1e023c809df6b93af3af2ccfa47a8ceec987b718446376c3b9c2b334b9e9837a?d=identicon)[Tanguy-Magnaudet](/maintainers/Tanguy-Magnaudet)

---

Top Contributors

[![Tanguy-Magnaudet](https://avatars.githubusercontent.com/u/75493105?v=4)](https://github.com/Tanguy-Magnaudet "Tanguy-Magnaudet (49 commits)")

### Embed Badge

![Health badge](/badges/fern-form/health.svg)

```
[![Health](https://phpackages.com/badges/fern-form/health.svg)](https://phpackages.com/packages/fern-form)
```

###  Alternatives

[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin

Builder plugin for October CMS

17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

374.3k](/packages/humanmade-lottie-lite)

PHPackages © 2026

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