2017 © Pedro Peláez
 

library kirby-form

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

image

mzur/kirby-form

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  • Wednesday, November 8, 2017
  • by mzur
  • Repository
  • 1 Watchers
  • 0 Stars
  • 952 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 12 Versions
  • 8 % Grown

The README.md

Kirby Form

Tests, (*1)

This is a fork of jevets\kirby-form., (*2)

A helper library for working with Kirby forms, using the Post/Redirect/Get design pattern., (*3)

Quick Example

$form = new Form([
    'name' => [
        'rules'     => ['required'],
        'message'   => ['Name is required']
    ],
    'phone' => [],
]);

if ($form->validates()) {
    // Validation passed
    // Do something with the data
}

Installation

Install with composer:, (*4)

# Kirby 2
composer require mzur/kirby-form:^1.0
# Kirby 3
composer require mzur/kirby-form:^2.0

Basic Example

This example assumes you're using page controllers in Kirby and that your page's URI is /my-page., (*5)

// site/templates/my-page.php



    <?php snippet('form-errors', ['form' => $form]) ?>

    <form method="POST">
        <input name="name" value="<?= $form->old('name') ?>">
        <input name="phone" value="<?= $form->old('phone') ?>">
        <?= csrf_field() ?>
        <input type="submit" value="Submit">
    </form>



// site/snippets/form-errors.php

errors()) > 0): ?>
    <div class="alert alert-error">
        <?php foreach ($form->errors() as $key => $errors): ?>
            <div><?= implode('<br>', $errors) ?></div>
        <?php endforeach ?>
    </div>


// site/controllers/my-page.php

use Jevets\Kirby\Form;

return function ($kirby) {

    // Initialize the Form
    $form = new Form([
        'name' => [
            'rules'     => ['required'],
            'message'   => ['Name is required']
        ],
        'phone' => [],
    ]);

    // Process the form on POST requests
    if ($kirby->request()->is('POST')) {
        if ($form->validates()) {
            // Show a thanks page
        } else {
            // Redirect back to the GET form
            go('/my-page');
        }
    }

    return compact('form');
};

Contributing

Feel free to send a pull request!, (*6)

Issues/Bugs

Please use the GitHub issue tracker., (*7)

The Versions

08/11 2017

dev-master

9999999-dev

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

08/11 2017

v1.3.5

1.3.5.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

14/10 2017

v1.3.4

1.3.4.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

14/10 2017

v1.3.3

1.3.3.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

14/10 2017

v1.3.2

1.3.2.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

19/09 2017

v1.3.1

1.3.1.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

20/08 2017

v1.3.0

1.3.0.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

12/08 2017

v1.2.0

1.2.0.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

12/08 2017

v1.1.0

1.1.0.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

05/02 2017

v1.0.0

1.0.0.0

A form helper for Kirby-based websites, using the Post/Redirect/Get pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Steve Jamesson
by Martin Zurowietz

form kirby

26/01 2017

v0.1.1

0.1.1.0

A form helper for Kirby-based websites, using the GET/POST/GET pattern.

  Sources   Download

MIT

The Requires

 

by Steve Jamesson
by Martin Zurowietz

form kirby

26/01 2017

0.1.0

0.1.0.0

A form helper for Kirby-based websites, using the GET/POST/GET pattern.

  Sources   Download

The Requires

 

by Steve Jamesson
by Martin Zurowietz

form kirby