PHPackages                             tearoom1/uniform-contact-block - 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. tearoom1/uniform-contact-block

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

tearoom1/uniform-contact-block
==============================

Kirby plugin for a uniform based contact form block

3.3.0(5mo ago)41311MITPHPCI passing

Since Nov 17Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/tearoom1/uniform-contact-block)[ Packagist](https://packagist.org/packages/tearoom1/uniform-contact-block)[ Docs](https://github.com/tearoom1/uniform-contact-block)[ Fund](https://buymeacoffee.com/tearoom1)[ Fund](https://github.com/sponsors/tearoom1)[ RSS](/packages/tearoom1-uniform-contact-block/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (33)Used By (0)

Contact Form Block Plugin for Kirby
===================================

[](#contact-form-block-plugin-for-kirby)

This plugin implements a contact form block using Martin Zurowietz' [`kirby-uniform`](https://github.com/mzur/kirby-uniform) plugin for Kirby. The block can be easly added to your blueprints and is fully configurable.

It comes with a simple captcha guard and a spam word guard to prevent spam submissions. It also has the uniform honeypot and honeytime guards enabled by default.

The panel block allows adjustments of the labels of the form.

[![Screenshot](screenshot.jpg)](https://github.com/tearoom1/kirby-content-watch)

---

Features
--------

[](#features)

- Works out of the box with minimal setup
- Comes with an optional basic theme
- Choose from 3 layout styles
- Optional labels and placeholders
- Works with and without JS
- Multiple guards already included and mostly ready to go

Getting started
---------------

[](#getting-started)

Use one of the following methods to install & use `tearoom1/uniform-contact-block`:

### Composer

[](#composer)

```
composer require tearoom1/uniform-contact-block

```

### Git submodule

[](#git-submodule)

If you know your way around Git, you can download this plugin as a [submodule](https://github.com/blog/2104-working-with-submodules):

```
git submodule add https://github.com/tearoom1/uniform-contact-block.git site/plugins/uniform-contact-block

```

### Clone or download

[](#clone-or-download)

1. Clone or download this repository from github:
2. Unzip / Move the folder to `site/plugins`.

> If you install the plugin without composer, you have to manually install the dependencies (see below)

Dependencies
------------

[](#dependencies)

- [Kirby](https://getkirby.com)
- [Kirby Uniform](https://github.com/mzur/kirby-uniform)
- [Uniform Simple Captcha](https://codeberg.org/refbw/uniform-simple-captcha)
- [Uniform Spam Words](https://github.com/tearoom1/uniform-spam-words)

> Note: Check the corresponding documentation for further information and required configuration. Specifically the uniform.honeytime guard from kirby-uniform is used and needs configuration in your `config.php`

Multi language requirement
--------------------------

[](#multi-language-requirement)

This plugin requires a Kirby multi-language setup. It uses routes that expect the language code as the first segment of the URL. It can easily be stripped down to a single language setup by removing the language code from the routes and a few adjustments.

Usage
-----

[](#usage)

Use the block by adding it to you blueprints fieldsets if they are defined:

```
fieldsets:
  - uniform-contact
```

Add the javascript to all pages that use this block. E.g. before the closing body tag in the `footer.php`

```