README

Adds an ISBN-10/ISBN-13 field type for Kirby including a rendered barcode preview of the code in the panel.

Installation

Kirby CLI

kirby plugin:install scottboms/isbn-field

Git submodule

git submodule add https://github.com/scottboms/kirby-isbn-field.git site/plugins/isbn-field

Copy and Paste

1. Download the contents of this repository as Zip file.
2. Rename the extracted folder to isbn-field and copy it into the site/plugins/ directory in your Kirby project.

Usage

Blueprints

In a Page blueprint, add a new field with the type isbn. The field supports numerous properties that control the rendered barcode preview in the panel and that map to the JsBarcode library that handles the preview.

  isbn:
    label: ISBN
    type: isbn
    height: 80
    font: monospace
    fontsize: 20
    textalign: center
    textposition: bottom
    margins: 10
    margintop: 0
    marginleft: 0
    marginbottom: 0
    marginright: 0
    displayvalue: true
    background: '#fff'
    linecolor: '#000'
    flat: false
    barwidth: 2

Field Properties

Using in Templates

To output the simple text value of the field:

<?= $page->isbn() ?>

Or utilize the toIsbn() field method and pass 'svg' or 'html' and output an SVG or HTML representation of the code. Pass 'text' to output the raw field value.

<?php $page->isbn->toIsbn('svg') ?>

Validators

The field type also includes a new Validator for Kirby that supports ISBN-10 and -13 formats (essentially UPC, EAN-13). You can access it in your templates like so:

<?php
  $isbn = $page->isbn();
  if(V::isbn($isbn)) {
    echo "<p>Valid ISBN: </p>" . $isbn;
  } else {
    echo "<p>Invalid ISBN.</p>";
  }
?>

Compatibility

• Kirby 4.x
• Kirby 5.x

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test before using it in a production environment. If you identify an issue, typo, etc, please create a new issue so I can investigate.

License

MIT